Padrão Evológica/Curio — Novo Projeto Web
Guia normativo para criar um novo projeto web no padrão Evológica/Curio. Base de referência para bootstrap de projetos React + @curio/client.
Índice
00 — Índice Guia normativo para criar um novo projeto web no padrão Evológica/Curio. Consolid...
Fundação
Stack, bootstrap, estrutura de pastas e configuração de ambientes.
01 — Stack e decisões
01 — Stack e decisões Define a stack fixa do projeto web e o que cada peça resolve. Itens mar...
02 — Bootstrap
02 — Bootstrap Do repositório vazio até npm run dev servindo a aplicação. Siga na ordem; cada...
03 — Estrutura de pastas
03 — Estrutura de pastas Árvore canônica de src/, a responsabilidade de cada pasta e o que não...
04 — Ambientes e configuração
04 — Ambientes e configuração Como o projeto descobre em runtime a qual backend falar. Dois m...
21 — Catálogo de hooks
21 — Catálogo de hooks Os hooks reutilizáveis que todo projeto web deste padrão deve ter em sr...
Qualidade e Processo
Convenções, pré-commit, build/deploy, harness e Definition of Done.
13 — Convenções
13 — Convenções Nomenclatura de arquivos, dados, hooks, handlers e constantes. A regra que go...
14 — Qualidade e pré-commit
14 — Qualidade e pré-commit Três gates: vite-plugin-checker durante o dev, pre-commit no commi...
15 — Build e deploy
15 — Build e deploy Builds por ambiente, o artefato gerado e como ele é servido atrás do ISAPI...
16 — Template de `CLAUDE.md`
16 — Template de CLAUDE.md Arquivo pronto para colar na raiz do projeto novo. Substitua tudo...
17 — Primeira tela
17 — Primeira tela Receita end-to-end: uma tela de busca + cadastro de Fornecedor, tocando tod...
18 — Harness
18 — Harness Disciplina de sessão: guias versionados, estado por branch, tudo versionado excet...
19 — `init.sh` e Definition of Done
19 — init.sh e Definition of Done Um script que verifica o baseline do projeto antes e depois ...
20 — Ciclo de desenvolvimento
20 — Ciclo de desenvolvimento Do recebimento da tarefa ao merge na master: issue, branch, comm...
22 — Testes E2E com Playwright
22 — Testes E2E com Playwright Guia para configurar Playwright do zero em projeto Vite + React...
UI
Componentes, layout/menu, rotas, formulários e tema.
08 — Componentes
08 — Componentes A regra dos três arquivos, o catálogo de common/ e quando criar em vez de rea...
09 — Layout e menu lateral
09 — Layout e menu lateral O shell da aplicação: AppBar, Drawer com menu em árvore, área de co...
10 — Rotas e proteção
10 — Rotas e proteção Três arquivos de dados (paths.ts, routes.ts, menuTree.ts) e um de compor...
11 — Formulários e validação
11 — Formulários e validação react-hook-form + zod, sempre via useValidatedForm. Schema é a f...
12 — Tema e estilo
12 — Tema e estilo Um createTheme central, locale pt-BR, e a regra de quando usar sx versus st...
Backend (Curio)
Conexão e sessão Curio, caso de uso e React Query.
05 — Curio: conexão e sessão
05 — Curio: conexão e sessão Como o front autentica, mantém e encerra a sessão com o backend C...
06 — Caso de uso
06 — Caso de uso Como uma tela fala com o backend Curio. Padrão vigente: UseCaseManager envol...
07 — React Query
07 — React Query Cache, tratamento global de erro e convenção de query keys. Versão 5.x (01) ...