Adiciona o frontend Next.js em frontend/ (setup, design system, autenticação/tema, layout/navegação, área master, área tenant completa: clientes, produtos, vendas, recebimentos, whatsapp, e-mail, alertas, equipe e perfil). Estende o backend de forma aditiva e autorizada: cookie httpOnly para refresh token (Etapa 13) e CRUD de equipe + edição de perfil do tenant (Etapa 18, módulo src/modules/equipe/ novo e PUT /tenant/perfil). Detalhes completos em Etapas/V2/*. Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
3.9 KiB
3.9 KiB
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 — Backend
01-setup-projeto.md— estrutura base, Docker Compose, Postgres, Prisma02-autenticacao-rls.md— login master/tenant, JWT, RLS03-painel-master-tenants.md— CRUD de tenants, planos, faturas04-integracoes-evolution-email.md— Evolution API, instâncias WhatsApp, SMTP05-painel-tenant-customers-produtos.md— CRUD de clientes e produtos/serviços06-vendas-dashboards.md— vendas, parcelas, resumos07-motor-de-alertas.md— BullMQ, templates, disparo e logs08-personalizacao-whitelabel.md— logo/cor por tenant, ajustes finais
Controle de progresso: 09-controle-de-progresso.md
Ordem obrigatória — Frontend
Pré-requisito: backend concluído (ou ao menos as etapas cujos endpoints
cada tela consome). Arquitetura de referência:
10-frontend-schema-arquitetura.md.
11-frontend-setup-projeto.md— Next.js, Tailwind, tokens, estrutura12-frontend-design-system.md— biblioteca de componentes base13-frontend-autenticacao-tema.md— login, sessão, tema dinâmico whitelabel14-frontend-layout-navegacao.md— sidebar/topbar/drawer/bottom-nav15-frontend-area-master.md— telas de negócio do painel master16-frontend-area-tenant-cadastros.md— dashboard, clientes, produtos17-frontend-area-tenant-vendas.md— vendas, parcelas, financeiro18-frontend-area-tenant-integracoes-perfil.md— WhatsApp, e-mail, alertas, equipe, whitelabel19-frontend-polimento-testes.md— responsividade, acessibilidade, E2E
Controle de progresso: 20-controle-de-progresso-frontend.md
Arquivos de controle de progresso (obrigatórios)
09-controle-de-progresso.md (backend) e
20-controle-de-progresso-frontend.md (frontend) são o estado oficial
de cada parte do projeto. Regras:
- Sempre envie o arquivo correspondente junto com o prompt de cada etapa (o de backend para as etapas 1–8, o de frontend para as etapas 11–19).
- 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