Índice
00 — Índice
Guia normativo para criar um novo projeto web no padrão Evológica/Curio. Consolidado a partir de investigação de código real, não de teoria — cada decisão aqui foi verificada contra uma implementação de verdade antes de virar regra. Não é tutorial de React. É o manual de padrões do time.
Como ler
Leia na ordem. Cada documento assume os anteriores.
| # | Documento | Decide |
|---|---|---|
| 01 | Stack e decisões | O que é fixo, o que é negociável |
| 02 | Bootstrap | Do git init até a tela de login rodando |
| 03 | Estrutura de pastas | Onde cada arquivo mora |
| 04 | Ambientes e config |
config/*.json, public/config.json, .env
|
| 05 | Curio: conexão e sessão | Login, sessão, expiração, logout |
| 06 | Caso de uso | Como chamar o backend |
| 07 | React Query | Cache, erro global, query keys |
| 08 | Componentes | Regra dos 3 arquivos, catálogo common/
|
| 09 | Layout e menu lateral | Shell, menuTree, abas |
| 10 | Rotas e proteção |
paths / routes / guards |
| 11 | Formulários e validação | react-hook-form + zod |
| 12 | Tema e estilo | MUI, sx vs styled
|
| 13 | Convenções | Nomenclatura, _Prefixo, PT-BR vs inglês |
| 14 | Qualidade e pré-commit | ESLint, Prettier, husky, lint-staged |
| 15 | Build e deploy | Builds por ambiente, ISAPI |
| 16 | Template de CLAUDE.md | Arquivo pronto para colar |
| 17 | Primeira tela | Receita end-to-end verificável |
| 18 | Harness | Disciplina de sessão entre devs |
| 19 | init.sh e Definition of Done | Verificação de baseline |
| 20 | Ciclo de desenvolvimento | Issue → branch → commits → MR → merge |
| 21 | Catálogo de hooks | Os 12 hooks/módulos reutilizáveis de src/hooks/
|
| 22 | Testes E2E com Playwright | Setup do zero, login reutilizável, Page Object Model |
Os documentos 00–19 seguem a numeração planejada em PROMPT.md. O 20, 21 e 22 foram acrescentados depois — processo de trabalho, catálogo de hooks e testes E2E não estavam no plano original, e todos são pré-requisito para o time operar, não só para o código compilar.
Convenção destes documentos
- Todo snippet traz o caminho de destino no topo e é colável sem edição.
- Exemplos usam a entidade fictícia
Fornecedor, não o domínio de nenhum projeto real.
Checklist — projeto novo pronto
Marque quando cada item estiver verificado, não quando parecer feito.
Fundação
Configuração
Curio
Aplicação
Qualidade
Testes E2E
Harness
Aviso sobre usar código existente como referência
Nenhuma implementação real é um exemplar perfeito. Antes de copiar de um projeto existente, confira a lista de anti-padrões recorrentes em 13-CONVENCOES.md — são inconsistências reais que já apareceram mais de uma vez e não devem ser replicadas.