58 lines
2.7 KiB
Markdown
58 lines
2.7 KiB
Markdown
# 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
|