João Augusto

Problema

Reunir cotação, contratação e rastreamento de transportadoras com regras e respostas diferentes, mantendo a consistência entre envio, cobrança e etiqueta.

Solução

Painel web e aplicativo Expo para cotações, envios, destinatários, clientes e carteira. O backend integra transportadoras, canais de e-commerce e recargas via PIX.

Minha participação

Desenvolvimento e manutenção de backend, interface web e app Expo; integrações de frete e e-commerce, fluxos financeiros e tratamento de erros operacionais.

Arquitetura e desafios técnicos

Monólito modular NestJS/TypeScript, com domínio, casos de uso e adaptadores separados. PostgreSQL/TypeORM persistem a operação; Bull/Redis executam filas e rotinas agendadas. Outbox/inbox liga eventos a efeitos como emissão de etiquetas após confirmação de PIX. React/Next.js e Expo consomem a API com TanStack Query.

Qualidade e confiabilidade

Validação HTTP, autenticação e permissões por contexto. Transações, consumidores idempotentes, verificação de webhooks e retries com backoff tratam reenvios e falhas externas. Há testes Jest de fluxos e adaptadores, métricas operacionais e ambiente Docker.

Entregas

• Cotação, emissão, rastreamento, destinatários e gestão de envios no painel e no app.
• Carteira, recargas PIX e retomada da emissão vinculada à confirmação do pagamento.
• Webhooks de e-commerce persistidos antes do enfileiramento, com recuperação após falhas de Redis.

Situação atual

Produto em operação e manutenção, com evoluções em desenvolvimento. Conectores como Tray e Bling têm implementação técnica e validações documentadas; homologação e aceite externo são acompanhados separadamente.

• Painel web

  Cotação, etiquetas, rastreamento, pedidos, destinatários e carteira.

• App Expo

  Sessão, loja ativa, envios, destinatários, carteira e simulação de frete.

  

Problema

Organizar a contratação e a rotina de prestadores: agenda, clientes, cobranças e acompanhamento dos atendimentos.

Solução

Marketplace e gestão de serviços com web e app mobile. O sistema inclui agendamentos, cadastro de clientes, financeiro e integrações de pagamento e comunicação.

Minha participação

Fundador e desenvolvedor do produto, com atuação na definição dos fluxos, modelagem, backend NestJS, aplicação Next.js e app Expo.

Arquitetura e desafios técnicos

NestJS com PostgreSQL/Prisma atende web e mobile. Better Auth integra usuários e sessões; guards aplicam vínculo e permissões por empresa. Filas BullMQ/Redis recebem tarefas e automações. A integração Mercado Pago usa identificadores de idempotência e tratamento de webhooks.

Qualidade e confiabilidade

Escopo de dados por empresa, validação de acesso e transações nas operações financeiras. Há testes de permissões, isolamento entre empresas, pagamentos e automações, além de testes de interface. Recursos sujeitos a provedores e feature flags dependem da configuração de cada empresa.

Entregas

• Fluxos de agendamento, clientes, atendimentos, cobranças e relatórios.
• Web e mobile utilizando a mesma API e as mesmas regras de acesso.
• Infraestrutura de automações enfileiradas e integrações de comunicação e pagamento.

Situação atual

Produto próprio em desenvolvimento e manutenção, com web pública ativa. O código inclui evoluções locais ainda em validação; integrações e automações não são apresentadas como universalmente habilitadas.

• Web pública

  Marketplace, aquisição, páginas institucionais e suporte.

• App mobile Expo

  Agenda, clientes, financeiro, orçamentos, cobranças e equipe.

Problema

Registrar movimentações de encomendas a partir de capturas NFC, evitando efeitos duplicados e preservando o motivo de cada decisão.

Solução

API experimental do TCC de Engenharia da Computação na SATC. A main pública implementa pedidos, vínculos de etiquetas UID/NDEF, avaliação de capturas e histórico logístico.

Minha participação

Desenvolvimento da API, modelagem de pedidos e provisionamento, casos de uso, persistência, outbox e testes de confiabilidade.

Arquitetura e desafios técnicos

Monólito NestJS/TypeScript com domínio e aplicação independentes do framework, adaptadores TypeORM e PostgreSQL. Uma Unit of Work grava captura, decisão, estado e outbox na mesma transação; a auditoria é alimentada por um consumidor com inbox.

Qualidade e confiabilidade

Bloqueios transacionais e índices únicos controlam concorrência. Reenvios com o mesmo UUID e conteúdo recuperam a decisão original; conteúdo divergente gera conflito. Testes unitários e de integração exercitam rollback, idempotência e recuperação da outbox. Docker, migrations e OpenAPI documentam a reprodução.

Entregas

• Máquina de estados logística, vínculos de etiquetas e decisões preservadas em histórico append-only.
• Persistência transacional de eventos e processamento assíncrono auditável.

Situação atual

Protótipo acadêmico. A main pública é uma versão de laboratório sem login. Autenticação, SDM e sincronização offline têm incrementos em branches/PRs de desenvolvimento; integração final e aceite em hardware real permanecem pendentes.

Evidências públicas

• Arquitetura e decisões da main
• Testes de idempotência e outbox
• Incrementos em revisão (PR #20)