Projeto

Ledger: um servidor só para vender todos os meus apps

O servidor de vendas e licenças dos meus produtos: checkout com Pix e cartão, chaves, funil de e-mails, campanhas, programa de criadores e painel. Node 22 com uma dependência só, e um banco trocado com as vendas no ar.

Criador e desenvolvedor

Todo app que eu lanço precisa da mesma coisa por trás: vender, emitir a licença, revogar quando há reembolso, lembrar quem abandonou o carrinho e mostrar o que está acontecendo. O Ledger é esse servidor, um só para todos os produtos. Hoje ele atende o Mutto e o Doca e registra as vendas do Sorteia Lá. É uma peça interna: quem compra só vê o site do produto, e o resto acontece aqui.

O que ele faz

  • Vendas. Stripe Checkout com Pix e cartão, em real e em dólar. A licença sai quando o pagamento confirma, inclusive no Pix, que pode confirmar depois do checkout.
  • Licenças. Emite uma chave assinada para cada compra, com um par de chaves por produto. Reembolso total e contestação no cartão revogam.
  • Funil de e-mails. Teste grátis, carrinho abandonado, cliente e beta, em português e inglês, com os textos editáveis no painel.
  • Combos e campanhas. Um checkout só que entrega uma chave por produto, e campanhas com período, cupom e faixa no site.
  • Cupons, indicação e criadores. Um programa com regras por produto, uma área própria para o criador acompanhar o que vendeu e o fechamento do Pix do mês.
  • Painel. Funil por dia, saúde de cada app (uso, versões, retenção, fim do teste, por que desinstalaram) e a jornada de uma pessoa numa ficha só.
  • Métricas para fora. Manda os números ao Sentinela, meu monitoramento, e o funil, sem dado pessoal, ao Analisa, meu analytics.

Trocar de banco com as vendas no ar

O Ledger nasceu num PocketBase compartilhado com outros sistemas. Em menos de duas semanas foi para um Postgres próprio, com o site vendendo. Reescrever todas as consultas seria o caminho mais arriscado, então o resto do código nem ficou sabendo da troca.

  • A mesma API, traduzida para SQL. O db.mjs fala a parte do REST do PocketBase que o código usa e devolve tudo igual: datas no mesmo formato, texto vazio no lugar de nulo, os mesmos erros. Todo valor vai como parâmetro.
  • Migração que pode rodar quantas vezes for preciso. É idempotente por id e tem um modo que só compara as contagens. A segunda passada apenas atualiza.
  • Ensaio antes, em staging. Antes de copiar os dados, desliguei os lembretes do funil, senão ele mandaria e-mail para clientes de verdade. Depois do corte, esses dados saíram do staging.
  • O corte levou cerca de 20 minutos, em 23 de outubro de 2026, com alguns minutos fora do ar até o certificado sair.
  • O ensaio não pegou tudo. A compra real feita logo depois falhou: o staging usava o sandbox de outra conta da Stripe, numa versão mais antiga da API. Corrigi, conferi compra e reembolso até a revogação, e o staging passou para o sandbox da mesma conta da produção.

Decisões que valeram a pena

Uma dependência em produção. O servidor só tem o pg. Stripe é fetch, o envio por SMTP e o QR Code foram escritos aqui, e a imagem leva apenas o servidor, os textos e o catálogo. O preço é manter esse código, em troca de quase nada de terceiros rodando num sistema que mexe com dinheiro.

Um par de chaves por produto. Com uma chave só seria mais simples. Com um par para cada produto, um vazamento não atravessa produtos. O combo paga essa conta: um checkout gera uma chave por produto, no mesmo e-mail.

Testar a venda inteira sem sair da máquina, e a chave contra o app de verdade. Stripe, Resend, SMTP, Kit e Sentinela têm versões de mentira nos testes, e o Postgres é o PGlite. O mesmo servidor roda a compra e o funil de ponta a ponta. Como o app é C# e o servidor é JavaScript, um teste separado usa o próprio código de licença do app para conferir que a chave emitida aqui é aceita lá.

Uma conta só, e nada de inventar número. Visão geral, dia a dia e métricas contam a partir da mesma função, com as mesmas exclusões, e os testes conferem os totais contra valores escritos à mão. Quando um dado não existe, a tela diz isso: as visitas são guardadas por dia, sem hora, então "ontem até esta hora" não aparece para elas.

Arquitetura

  • Multiproduto pelo catálogo. Um produto novo entra pelo produtos.json, com seus textos de e-mail, o site e as variáveis. Toda tabela tem a coluna produto, e toda consulta filtra por ela.
  • Produtos web também entram. O Sorteia Lá vende no checkout dele, sem chave nem app: o Ledger só registra a venda pelo webhook da Stripe e mostra os números ao lado dos outros.
  • Sites fora do Ledger. Cada site é HTML estático no próprio repositório e pede ao Ledger só o que muda. Se o Ledger cair, a página sai com a última resposta boa.
  • Banco que só cresce. Ao subir, o servidor cria as tabelas, colunas e índices que faltam, e nada é tirado nem mudado.

Números

  • 478 commits entre 12 e 31 de outubro de 2026.
  • ~16 mil linhas de JavaScript no servidor, ~6 mil de painel (HTML, CSS e JS) e ~18 mil em testes e ferramentas.
  • 65 arquivos de teste, com cerca de 490 casos.
  • 1 dependência em produção.
  • Dois apps e um produto web no catálogo.
Ficha técnica
Papel
Criador e desenvolvedor
Stack

Node.js 22 · PostgreSQL · pg · Stripe Checkout · PGlite · Docker · Railway

Status
ativo

Código privado: o case detalha a arquitetura e as decisões técnicas.

Quer algo assim?

Eu também desenvolvo sistemas sob medida. Me conta o que você precisa.

Trabalhe comigo

Veja também