SeConectai_Vendas/Etapas/00-README-ordem-das-etapas.md

SeConectai Vendas — Prompts de Build Faseado

Este pacote contém 8 prompts sequenciais e autocontidos para entregar a uma IA de geração de código (Claude Code, Cursor, Windsurf etc). Cada arquivo pode ser colado como um prompt único — eles já trazem o contexto necessário para não depender de memória de conversa anterior.

Ordem obrigatória

1. 01-setup-projeto.md — estrutura base, Docker Compose, Postgres, Prisma
2. 02-autenticacao-rls.md — login master/tenant, JWT, RLS
3. 03-painel-master-tenants.md — CRUD de tenants, planos, faturas
4. 04-integracoes-evolution-email.md — Evolution API, instâncias WhatsApp, SMTP
5. 05-painel-tenant-customers-produtos.md — CRUD de clientes e produtos/serviços
6. 06-vendas-dashboards.md — vendas, parcelas, resumos
7. 07-motor-de-alertas.md — BullMQ, templates, disparo e logs
8. 08-personalizacao-whitelabel.md — logo/cor por tenant, ajustes finais

Arquivo de controle de progresso (obrigatório)

09-controle-de-progresso.md é o estado oficial do projeto. Regras:

• Sempre envie esse arquivo junto com o prompt de cada etapa.
• A IA deve lê-lo antes de começar e recusar iniciar uma etapa se a anterior não estiver 100% concluída na checklist.
• Ao final de cada etapa, a IA deve devolver o arquivo atualizado (itens marcados, status geral e observações preenchidas) — é esse arquivo atualizado que você guarda e reenvia na próxima etapa/sessão.
• Sem esse arquivo, uma IA nova (em outra sessão) não tem como saber o que já foi feito — por isso ele substitui a necessidade de repetir todo o histórico da conversa.

Como usar cada prompt

• Rode nessa ordem — cada etapa assume que a anterior está pronta e funcionando (migrations aplicadas, testes passando).
• Ao final de cada etapa, confira o checklist de "Critérios de aceite" antes de avançar para a próxima. Se algo não for atendido, peça correção antes de seguir.
• O arquivo seconectai-vendas-schema.sql é a fonte de verdade do modelo de dados — qualquer etapa que crie migration deve refletir exatamente essas tabelas (a IA pode adaptar para sintaxe Prisma, mas a estrutura, nomes de campo e tipos devem ser preservados).
• Cada prompt já repete o essencial do contexto (stack, convenções), então eles funcionam mesmo em uma conversa nova/sessão nova com a IA.

Stack fixada em todas as etapas

• Node.js 20+ / TypeScript
• NestJS (modular por domínio)
• PostgreSQL 16 + Prisma ORM
• Redis + BullMQ (a partir da etapa 7)
• Docker + Docker Compose
• Autenticação: JWT (access curto) + refresh token com rotação, senha com argon2id
• Multi-tenancy: banco único, isolamento por tenant_id + Row Level Security do Postgres