Riccardo Nóbrega: plataforma de questões
Plataforma de estudo do Professor Riccardo Nóbrega para concursos policiais do Ceará (PCCE, Guarda Municipal de Fortaleza, CFO PMCE).
O aluno resolve questões de múltipla escolha e de certo ou errado, revisa flashcards, lê as leis no Vade Mecum, acompanha o desempenho e disputa o ranking.
Grátis: 5 questões por dia. Assinatura mensal (Mercado Pago) libera tudo.
Stack: Next.js 16, TypeScript, Tailwind v4, Drizzle, Turso (SQLite), Better Auth, ts-fsrs, Recharts, Vercel.
Onde parou e o que falta: docs/ESTADO-ATUAL.md. Regras do código: CLAUDE.md. Roteiro: PLANO.md.
Rodar localmente
Requisitos: Node.js 20 ou superior.
npm install
O .env.local não vai pelo git (tem as senhas). Copie o do outro computador ou crie a partir do .env.example.
Se o .env.local apontar para o Turso de produção, rode o servidor de desenvolvimento com o banco local para não mexer no site real:
# PowerShell
$env:TURSO_DATABASE_URL="file:local.db"; $env:TURSO_AUTH_TOKEN=""; npm run dev
# Git Bash
TURSO_DATABASE_URL=file:local.db TURSO_AUTH_TOKEN= npm run dev
Sem local.db ainda? Crie com o mesmo prefixo: npm run setup (tabelas + 1.000 questões de exemplo).
Para ver o desempenho com dados: npm run simular -- [email protected] 300.
Alimentar com questões
- Pelo site:
/admin > Questões (gera o prompt, confere e importa o arquivo da IA). Passo a passo em docs/PROMPT-GERAR-QUESTOES.md.
- Prompts para usar direto no Claude:
docs/PROMPT-CLAUDE-QUESTOES.md e docs/PROMPT-CLAUDE-CERTO-ERRADO.md.
- Formato do arquivo:
docs/FORMATO-QUESTOES.md.
- Produção automática com o Claude Code:
/gerar-lote.
Documentos
| Arquivo | Para quê |
|---|
docs/ESTADO-ATUAL.md | o que está no ar, o que falta e como continuar em outra máquina |
CLAUDE.md | contexto e regras para o Claude Code (lido automaticamente) |
PLANO.md | roteiro por fases (/proxima-tarefa pega a próxima) |
docs/FORMATO-QUESTOES.md | contrato do arquivo de questões |
docs/PROMPT-*.md | prompts para gerar questões com IA |
docs/ERRO-PENA-QUESTOES.md | erro das questões focadas em pena e as regras para não repetir |
docs/FALTA-CERTO-ERRADO.md | áreas sem certo ou errado (levantamento de 22/10) |
Comandos do Claude Code
/proxima-tarefa [número]: pega uma tarefa do PLANO.md, implementa e marca como feita./gerar-lote: um ciclo da produção automática de questões./importar-questoes arquivo: ajuda a converter um banco para o formato de importação./revisar-performance: audita as consultas pensando em 1 milhão de questões e na cota do Turso.
