Cena 06 · Outros projetos · 2026
NFe Hub — uma API fiscal com cliente Delphi
API fiscal em Node e TypeScript que gera chave e XML de NF-e, consumida por um cliente Delphi.
Rascunho — texto em revisão
- Papel
- Autor único.
- Stack
- Node.js · TypeScript · Fastify · Zod · PostgreSQL · Delphi · Jest · Testcontainers · Docker · GitHub Actions
- Links
O que é
Um projeto de estudo, feito para praticar o tipo de integração que muitas empresas brasileiras ainda rodam: um sistema desktop em Delphi conversando com uma API moderna.
O que eu construí
- uma API em Fastify que valida CNPJ/CPF, gera a chave de acesso de 44 dígitos (módulo 11) e o XML da NF-e no layout 4.00;
- as notas ficam no PostgreSQL e a trilha de eventos no MongoDB;
- um cliente desktop em Delphi VCL consome a API por HTTP/JSON.
Decisões
Testes contra bancos de verdade. Os testes de integração sobem PostgreSQL e MongoDB em containers (Testcontainers), em vez de simular os bancos.
Pronto para rodar em qualquer lugar. Imagem Docker multi-stage publicada no GHCR e CI no GitHub Actions; a justificativa de cada escolha de arquitetura está no README.
Em números
- 24 testes, unitários e de integração
- 2 workflows de CI/CD