207.371
linhas de código
- TypeScript
- Lua
- SQL
- JS
207.371 linhas de código
São dois produtos, não um: 143.782 linhas no painel web e 63.589 no recurso que roda dentro do jogo, em 1.068 arquivos.
O universo
do jogo
começa aqui.
Moeda, itens e vantagens conectados ao GTA RP: pagos no site, entregues no personagem, sem ninguém no meio.
Next.js 16React 19TypeScriptPrismaMySQLFiveM
O que é
Do checkout ao inventário.
Real compra moeda, moeda compra item, e o item fica no inventário do site até o jogador pedir, aí chega no personagem, dentro do servidor. O que sobrar volta ao mercado.
- 01Real compra moeda
- 02Moeda compra item
- 03O item chega no servidor
- 04E volta ao mercado
A escala
Os números são do código, não da vitrine.
Tudo abaixo foi contado em arquivo do produto real, numa auditoria de código em agosto de 2026. Nada aqui é estimativa.
175
rotas de API
- 98 do painel
175 rotas de API
98 delas existem só para o painel de operação. Mais da metade da API é o backoffice, não a vitrine.
54
modelos de dados
- Prisma
- MySQL
54 modelos de dados
Catálogo, pedidos, inventário, moeda e auditoria: o banco guarda a operação inteira, não só o carrinho.
41
telas no painel do operador
- Pedidos
- Catálogo
- BCoin
- Relatórios
41 telas no painel do operador
O dono do servidor muda preço, monta kit, libera VIP e acompanha entrega sem abrir uma linha de código.
5
frameworks na mesma ponte
- vRP
- ESX
- QBCore
- QBox
- standalone
5 frameworks na mesma ponte
O recurso detecta qual dos cinco o servidor usa e se adapta sozinho. A única exigência é o oxmysql.
Por que é sistema
Seis decisões separam uma loja de um sistema.
Nenhuma delas é escolha de layout. São seis decisões lidas direto no código do produto, e são elas que explicam por que isto é um sistema e não um checkout com tema.
Pedido e entrega
Pago≠Entregue
7 estados de pedido × 5 de entrega, em duas máquinas separadas, porque na prática elas falham separado.
painel › pedidosComando
O quê≠Como
O item declara give_vehicle; não sabe a sintaxe do servidor. O modelo traduz para addcar {playerId} {model}, e cada modelo conta os próprios usos.
painel › comandosFila
Disparar e esquecer≠Fila durável
Cada comando é gravado com horário, status e contador de tentativas. Se o servidor falha, a tentativa conta e o erro fica guardado, o comando espera, não se perde.
fila de comandosSaldo
Duas cópias≠Uma fonte só
O site fala com dois bancos, o dele e o do servidor do jogo, e o saldo de BCoin é escrito num ponto só: direto no banco do jogo, que é a fonte de verdade.
banco do site + banco do jogoPagamento
Ter credencial≠Expor o método
Credencial técnica numa aba, ativação comercial em outra. PIX, cartão, boleto e PayPal, por três provedores: Mercado Pago, AbacatePay e PayPal.
configurações › pagamentosExclusão
Apagar≠Poder recuperar
Soft delete em 14 domínios, com data de exclusão e janela para expirar. Recuperação central, não destruição.
painel › lixeira
Do checkout ao seu personagem.
Cada compra vira um comando no servidor do jogo.
Adicione BCoin
Compre BCoin no nosso checkout seguro, de forma simples e prática.Por dentro: o aviso do provedor de pagamento é conferido, e o saldo de BCoin cai direto no banco do jogo.
Escolha seus itens
Use seus BCoin para adquirir veículos, roupas, propriedades e muito mais na loja da Blackout.Por dentro: o item vai para o inventário do site e espera, o jogador pede a entrega quando quiser, um por um ou em lote.
Receba no jogo
Seus itens são entregues diretamente no seu personagem através da nossa integração com o servidor.Por dentro: o comando entra na fila do servidor; se falhar, a tentativa é contada e o admin pode reenviar.
O painel em números
Cada parte da operação tem a sua ferramenta.
Do relatório ao alerta no Discord: o que o dono do servidor usa no dia a dia, contado nas telas do produto.
14 Abas de análise
Financeiro, pedidos, entregas, jogadores, VIP, guildas e mais, com exportação em PDF, escolhendo logo, cor e tema.
10 Filtros num registro só
Pedido, pagamento, entrega, erro, usuário, kit, marketplace, admin, o que o jogo enviou e o ID do jogador, com busca e exportação em CSV.
6 Etiquetas de mensagem
Suporte, orçamento, parceria, feedback, preço de item e outro. E um alerta quando um item aparece no site sem preço.
5 Meios de pagamento
PIX em dois provedores, cartão, PayPal e boleto, cada um liga e desliga no painel.
6 Canais de aviso
Um por tipo de evento: pedidos, pagamentos aprovados, erros de entrega, contas novas e ações do admin, entre outros. O endereço fica criptografado no banco.
- 01Relatórios
- 02Central de logs
- 03Central de contato
- 04Pagamentos
- 05Discord
Por trás da loja, uma operação completa.
Pedidos, catálogo, BCoin, entregas, relatórios e comunicação em um único painel.
Operação
41 telas: pedidos, catálogo, VIPs e kits.
Conteúdo
Catálogo e lixeira com 14 tipos de registro.
Integrações
5 integrações e 5 meios de pagamento.
Relatórios
14 abas de análise e logs por jogador.
Automação
Expiração automática e 6 canais no Discord.
Entrega no jogo
O site vende. O servidor do jogo entrega.
Cada compra vira um comando numa fila. Se o jogador estiver offline, se o servidor cair ou se o comando vier errado, nada se perde: a tentativa é contada, o erro fica guardado e o admin decide o que fazer.
- Pago
- Comando
- Fila
- Servidor
- Personagem
- pagoPagamento confirmado pelo aviso do provedor.
- comandoaddcar {playerId} {model}
- validadoComando conferido antes de rodar no servidor.
- filaPENDING · aguardando o horário de execução.
- servidorTentativa 1 · falhou · erro guardado.
- servidorTentativa 2 · executado.
- personagemItem no jogo · e-mail de entrega enviado.
Quando falha, o admin decide
- ReenviarPõe o comando de volta na fila.
- ReverterDesfaz uma entrega já feita.
- ConfirmarDá baixa numa entrega conferida no jogo.
- ManualEntrega pelo admin, fora da fila.
- ForçarExecuta agora, sem esperar o horário.
- Comando validadoConferido antes de rodar, ele executa dentro de um servidor de jogo.
- Pagamento uma vez sóSe o aviso do provedor chegar duas vezes, a compra não é processada duas vezes.
- Inventário que esperaO item fica guardado no inventário do site e vai para o jogo quando o jogador pedir, um por um ou em lote.
Marketplace
Item repetido não fica parado no inventário.
Quem tem um item sobrando escolhe: vender na hora para o site, com preço garantido, ou anunciar para outros jogadores e esperar um preço melhor. Liquidez ou preço, e quem compra recebe o item dentro do jogo.
Vender ao site
- O site recompra por um preço calculado pela raridade.
- Preço garantido, valor menor.
Anunciar para jogadores
- Preço sugerido pela raridade, para o anúncio não sair da curva.
- Pode ser anônimo; depende de alguém comprar.
- Preço do anúncio
- 400 BC
- Taxa do site (5%)
- 20 BC
- O vendedor recebe
- 380 BC
5% é a taxa padrão do código, e o dono do servidor pode mudar.
- Venda anônimaO vendedor anuncia sem mostrar o nome para quem compra.
- Anúncio com prazoCada anúncio tem data para expirar e sai do ar sozinho.
- Proteção do mercadoO mercado tem um módulo de proteção próprio, e o preço sugerido pela raridade mantém o anúncio dentro da curva.
- Entrega no jogoQuem compra recebe o item no inventário e manda para o personagem, como qualquer compra da loja.
As tecnologias
Do que é feito, peça por peça
Uma loja de servidor de GTA RP inteira: a vitrine, o carrinho, três jeitos de pagar, a entrega dentro do jogo e o painel do dono. Escolha uma peça para ver o que ela faz aqui e em que arquivo está.
24tecnologias, em 5 camadas
Tela
Servidor
Dados
Pagamento
Integrações
Dentro do produto
68 telas, em quatro caminhos.
Da vitrine ao painel: as telas do produto, separadas pelo caminho de quem usa, o jogador comprando, o jogador com seus kits, o operador cuidando da loja e o dono olhando os dados.
A loja · Início
Tela 1 de 15: Início
Protótipo
Dá para entrar e mexer.
O protótipo navegável roda sem backend: um service worker intercepta as mesmas URLs da API real dentro do navegador e devolve um banco fictício no formato que as telas já esperavam. São 3.154 linhas de dados falsos, com semente fixa, todo visitante vê os mesmos gráficos.
Não tem login: o visitante já entra autenticado.
Protótipo pronto
Abrir em tela cheia
Dados fictícios, declarados na própria interface.