João Pombo

## Módulos

• Financeiro: contratos, cobranças e baixas
• CRM de prospecção
• Tarefas e agenda
• Portal do cliente
• Relatórios
• Roteiros de conteúdo

## Integrações

• Meta Ads e Vercel, via API
• Rotinas agendadas (cron) e webhooks

## Stack

• TypeScript
• Next.js (App Router, Server Components e Server Actions)
• Drizzle ORM
• PostgreSQL (Neon)
• Clerk
• Tailwind e shadcn/ui
• Deploy na Vercel

## Decisões de arquitetura

1. Módulos em fatias verticais, cada um com uma porta pública única.
2. Acesso ao banco só pela camada de dados, com a autorização verificada dentro de cada função.
3. DTOs em vez de linhas cruas do banco.
4. Sem acoplamento por dados entre módulos.
5. Situação financeira derivada, em vez de guardada.

## O que faz

• Quadro de campanhas por ritmo: acima da meta, no ritmo, abaixo da meta, parada ou sem entrega
• Avisos em cada campanha: custo por lead subiu ou caiu, meta batida, sem entrega, atrasada
• Meta de leads por dia definida pela equipe; sem ela, o ritmo é medido contra a média dos últimos 7 dias
• Relatório no portal do cliente, com comparação com o período anterior e os anúncios que mais trouxeram leads

## Decisões técnicas

1. Campanhas, gasto e leads são lidos ao vivo da Insights API, com cache de 15 minutos; só a meta de leads mora no banco.
2. O token da Meta fica no servidor e nunca entra no DTO da página.
3. Paginação com teto de páginas, para a consulta não virar um laço sem fim.
4. O período personalizado nasce da URL, então é validado e limitado a 90 dias antes de virar consulta.
5. A Meta entrega as imagens dos criativos em URLs que expiram: o sistema baixa cada uma para um Blob privado depois da resposta, e só as que a tela mostra.
6. A conta de anúncio sai do acesso conferido no servidor, não da URL: trocar o id no endereço não abre a conta de outro cliente.
7. Ritmo, comparação de períodos e custo por lead são funções puras, cobertas por testes.

## Problema

• Pedidos de prazo longo se perdiam e se desorganizavam até a entrega.

## O que resolve

• Acompanhamento organizado dos pedidos do início à entrega
• Organização das notas fiscais para conferência
• Organização da compra de produtos

## Detalhes técnicos

• Autenticação própria: senhas derivadas e sessões revogáveis no banco
• Comprovantes privados no Vercel Blob, entregues por rota autenticada
• Leitura do XML das notas fiscais
• Migrações rodam no build de produção; se falharem, a versão anterior continua no ar
• Avisos por web push e resumos agendados (cron)

## Stack

• TypeScript
• Next.js (App Router)
• React
• Drizzle ORM
• PostgreSQL (Neon)
• Zod
• Vercel Blob
• Tailwind CSS
• Vitest e Playwright
• Deploy na Vercel