Accentio Payments
Resumo
O Accentio Payments é o motor de cobranças e licenças da Accentio Studios. Reúne num ledger os pagamentos, as assinaturas, as licenças e as invoices, sobre Stripe, Mercado Pago, PayPal, NuPay e transferência, e responde a cada app quem tem licença, por consulta ou por webhook. Roda como um processo NestJS 11 sobre Fastify e MongoDB, com um painel de staff em React construído sobre o Excelsior. Está em construção: as fundações, os apps, o catálogo, os titulares e as licenças estão prontos, e os deploys de staging e produção estão escritos e aguardam a primeira execução.
Pontos-chave
Porta com quatro drivers4 drivers de provedor sobre 1 porta, verificados contra simuladores
Desenhou uma porta de provedor atrás da qual os drivers de Stripe, Mercado Pago, PayPal e NuPay traduzem os eventos de cada provedor em comandos do domínio. Cada provedor roda simulado, em sandbox, em live ou desligado, e a inicialização falha se um provedor não tem driver.
Inbox, outbox e retentativas
Construiu o fluxo de eventos: os webhooks de entrada dos provedores chegam a um inbox depois da verificação de assinatura, e os webhooks para os apps saem de um outbox, assinados e com retentativas programadas.
Escritas idempotentes e travas
Tornou as escritas seguras para retentativa com um interceptor de Idempotency-Key, e rodou os jobs de fundo (vencimentos, liquidações, retentativas de webhooks) sob trava para que duas instâncias não rodem o mesmo job.
Motor de fees e invoices
Construiu um motor de fees que calcula cada cobrança para que o total cubra as tarifas do provedor e o imposto, e invoices com link de pagamento próprio e um PDF impresso a partir do mesmo HTML da prévia ao vivo do editor.
Testes, docs e SDKCerca de 10.700 casos de teste em 694 arquivos de spec; 152 rotas HTTP em 41 controllers
Cobriu o motor com testes unitários, de integração, de contrato e visuais, documentou em 240 documentos com Diátaxis e uma referência gerada a partir do código, e escreveu um SDK de NestJS para os apps.