Files
SeConectai_Vendas/Etapas/V2/00-README-ordem-das-etapas (1).md
tiagoandClaude Sonnet 5 323912748f Frontend completo (Etapas 11-18) e extensões de backend (Etapas 13 e 18)
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>
2026-08-16 09:41:13 -03:00

3.9 KiB
Raw Permalink Blame History

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

  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

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.

  1. 11-frontend-setup-projeto.md — Next.js, Tailwind, tokens, estrutura
  2. 12-frontend-design-system.md — biblioteca de componentes base
  3. 13-frontend-autenticacao-tema.md — login, sessão, tema dinâmico whitelabel
  4. 14-frontend-layout-navegacao.md — sidebar/topbar/drawer/bottom-nav
  5. 15-frontend-area-master.md — telas de negócio do painel master
  6. 16-frontend-area-tenant-cadastros.md — dashboard, clientes, produtos
  7. 17-frontend-area-tenant-vendas.md — vendas, parcelas, financeiro
  8. 18-frontend-area-tenant-integracoes-perfil.md — WhatsApp, e-mail, alertas, equipe, whitelabel
  9. 19-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