> **ATENÇÃO:** Este projeto foi gerado pelo ForgeAI e contém TODA a documentação necessária.
Loading actions...
ATENÇÃO: Este projeto foi gerado pelo ForgeAI e contém TODA a documentação necessária. VOCÊ DEVE LER E SEGUIR TODAS AS DOCUMENTAÇÕES ANTES DE ESCREVER QUALQUER CÓDIGO.
Estas instruções são compatíveis com: Replit Agent, Cursor, Windsurf, GitHub Copilot, e outros assistentes de IA.
/stylesPROMPT_TECNICO.mdVocê DEVE ler estes arquivos NA ORDEM antes de qualquer ação:
PROMPT_TECNICO.md - Especificações técnicas completasdocs/01-briefing.md - Contexto e requisitos do projetodocs/02-escopo.md - Funcionalidades detalhadasdocs/03-roadmap.md - Fases e cronogramadocs/04-wbs.md - Estrutura analítica (tarefas)docs/guia-de-estilos.md - CORES, FONTES, ESPAÇAMENTOS E CSS - FONTE ÚNICA DE VERDADEApós ler toda documentação, você DEVE:
Criar um plano de execução contendo:
docs/02-escopo.md)docs/guia-de-estilos.md)APRESENTAR o plano ao usuário
AGUARDAR aprovação explícita - Pergunte:
"O plano está aprovado? Posso iniciar a implementação?"
NÃO PROSSIGA sem resposta afirmativa ("sim", "aprovado", "pode iniciar")
Pergunte sobre o banco de dados:
"Deseja usar banco externo (Supabase) ou banco local da plataforma?"
Configure variáveis de ambiente conforme infra/environment/.env.example
docs/guia-de-estilos.mdFONTE ÚNICA DE VERDADE: docs/guia-de-estilos.md
Você DEVE consultar EXCLUSIVAMENTE o arquivo docs/guia-de-estilos.md para:
REGRAS:
.darkStack Principal: React + Vite + TypeScript
ATENÇÃO: A arquitetura, estrutura de pastas e padrões de código para esta stack estão detalhados em
PROMPT_TECNICO.mdna seção "STACK TECNOLÓGICA". SIGA EXATAMENTE a estrutura de pastas e padrões especificados lá. NÃO invente sua própria estrutura.
# 1. Criar projeto Vite + React
npm create vite@latest client -- --template react-ts
# 2. Instalar dependências do frontend
cd client && npm install @tanstack/react-query wouter react-hook-form @hookform/resolvers/zod
# 3. Instalar dependências do backend
cd .. && npm install express drizzle-orm pg zod bcrypt express-session
npm install -D drizzle-kit @types/express @types/pg tsx typescript
# 4. Configurar Shadcn/ui no frontend
cd client && npx shadcn@latest init
# 5. Após configurar DATABASE_URL:
npx drizzle-kit push
IMPORTANTE: Frontend (Vite) e Backend (Express) podem rodar no mesmo processo ou separados. Se separados, configure o proxy adequadamente para redirecionar /api/* para o backend.
/
├── PROMPT_TECNICO.md # Especificações técnicas (LEIA PRIMEIRO!)
├── PROJECT_CHECKLIST.md # Checklist de progresso
├── README.md # Visão geral do projeto
├── replit.md # Este arquivo de instruções
├── manifest.json # Metadados do projeto
│
├── docs/ # Documentação completa
│ ├── 01-briefing.md # Contexto e requisitos
│ ├── 02-escopo.md # Funcionalidades detalhadas
│ ├── 03-roadmap.md # Fases e cronograma
│ ├── 04-wbs.md # Estrutura analítica
│ └── guia-de-estilos.md # FONTE ÚNICA de estilos (cores, fontes, CSS)
│
├── infra/ # Infraestrutura
│ ├── database/ # Schema e seeds SQL
│ └── environment/ # Variáveis de ambiente
│
└── src/ # Código fonte (criar conforme PROMPT_TECNICO.md)
Antes de iniciar a implementação, você DEVE perguntar:
Além do escopo específico do projeto, as funcionalidades abaixo são OBRIGATÓRIAS em todos os projetos. Consulte a seção "FUNCIONALIDADES PADRÃO OBRIGATÓRIAS" no
PROMPT_TECNICO.mdpara detalhes completos.
Resumo das funcionalidades padrão:
Ao finalizar o desenvolvimento, você DEVE configurar testes E2E com Playwright:
npm init playwright@latest
npx playwright install --with-deps chromium
ms-playwright.playwright)Crie o arquivo .vscode/tasks.json com as seguintes tasks:
{
"version": "2.0.0",
"tasks": [
{
"label": "Playwright: Rodar Todos os Testes",
"type": "shell",
"command": "npx playwright test",
"group": {
"kind": "test",
"isDefault": true
},
"presentation": {
"reveal": "always",
"panel": "new"
},
"problemMatcher": []
},
{
"label": "Playwright: Rodar com UI Mode",
"type": "shell",
"command": "npx playwright test --ui",
"group": "test",
"presentation": {
"reveal": "always",
"panel": "new"
},
"problemMatcher": []
},
{
"label": "Playwright: Rodar Teste Atual",
"type": "shell",
"command": "npx playwright test ${relativeFile}",
"group": "test",
"presentation": {
"reveal": "always",
"panel": "new"
},
"problemMatcher": []
},
{
"label": "Playwright: Gerar Código (Codegen)",
"type": "shell",
"command": "npx playwright codegen http://localhost:3000",
"group": "test",
"presentation": {
"reveal": "always",
"panel": "new"
},
"problemMatcher": []
},
{
"label": "Playwright: Ver Relatório",
"type": "shell",
"command": "npx playwright show-report",
"group": "test",
"presentation": {
"reveal": "always",
"panel": "new"
},
"problemMatcher": []
}
]
}
Para executar: pressione Ctrl+Shift+P > "Tasks: Run Task" > escolha a task desejada.
{
"scripts": {
"test:e2e": "npx playwright test",
"test:e2e:ui": "npx playwright test --ui",
"test:e2e:headed": "npx playwright test --headed",
"test:e2e:codegen": "npx playwright codegen http://localhost:3000",
"test:e2e:report": "npx playwright show-report"
}
}
data-testid em todos os elementos interativos (botões, inputs, links)Consulte a seção "QA E2E" no
PROMPT_TECNICO.mdpara detalhes completos, configuração e exemplos.
Projeto gerado pelo ForgeAI - Estas instruções são obrigatórias