Termômetro do Semestre · app
Site: termometro-psi.vercel.app. A tela do Termômetro do Semestre, feita com vibe coding no v0: reprovação e desistência nas 15 disciplinas mais cursadas do ciclo básico da UFRN (2015 a 2019), a curva por carga do semestre, as combinações de disciplinas que parecem perigosas e os achados com suas limitações. A análise, os dados e a validação ficam no outro repositório; este só mostra os resultados.
Como foi feito
- Escrevi o prompt com regras, não só com o desenho (
prompts/01-prompt-enviado.md). As decisões que o prompt carrega são minhas:
- os dados reais vêm por URL de um JSON do repositório de análise, e não colados no código, para a tela não congelar números;
- nada de número inventado nem cálculo na tela, só formatação;
- nenhuma frase que recomende evitar ou escolher disciplinas;
- o visual é o mesmo do front do GradMent: fundo
#F4F7F1, verde escuro como cor primária, fonte Inter, cantos bem arredondados e barra lateral flutuante.
- O v0 gerou o app numa única geração. Na geração, o v0 criou 18 arquivos e editou 5 (o commit inicial,
8aa8a0c, tem 39 arquivos contando os do template), e ele mesmo testou a página no navegador: sem rolagem horizontal a 360 px, abas e cliques funcionando nos temas claro e escuro, segundo o relatório dele. O prompt foi enviado pelo Claude no navegador integrado, a meu pedido. Eu publiquei o site no v0, e o repositório foi criado pelo v0 por um clique do Claude no navegador, também a meu pedido.
- Os números da tela foram conferidos contra o JSON, por um script no console do navegador, depois da publicação. Para as 15 disciplinas, a reprovação e a desistência exibidas batem com o arquivo (arredondadas na casa decimal), e batem também o total de matrículas, o de calouros, a diferença de cada um dos 3 pares sobreviventes e o texto do aviso ético.
- O que ficou por conta do Claude Code depois do v0:
- A rota
/api/explicar: recebe números já calculados e devolve uma explicação em linguagem simples do Gemini. Se o texto trouxer algum número que não estava nos dados enviados, ele é descartado (uma nova tentativa, depois erro). Tem 12 testes (node --test app/api/explicar/explicar.test.mjs).
- A validação de tipos no build (o v0 deixa
ignoreBuildErrors: true; desliguei depois de conferir que tsc --noEmit e next build passam).
- O nome do pacote (o v0 usa
my-project), este README e o .env.example.
O que o v0 não fez
- A rota
/api/explicar. Pedi que ela não fosse criada, porque já estava escrita; o v0 só chama a rota, e o seu próprio relatório diz que, sem ela, o botão "Explicar" mostra o estado de erro.
- Testes de interface. Não existem testes automáticos da tela; a conferência foi manual e por script de console, uma vez.
Rodar localmente
pnpm install # ou npm install
pnpm dev
Precisa de internet, porque os dados vêm do GitHub. Para o botão "Explicar" funcionar, crie .env.local com GEMINI_API_KEY (chave gratuita do Google AI Studio; veja .env.example). Sem a chave, a rota responde que o serviço de explicação não está configurado, e o resto da página funciona.
Stack
Next.js 16, React 19, TypeScript, Tailwind CSS 4, shadcn/ui (base-ui), Recharts. Dados: dados/termometro.json, revalidados a cada hora.
Estrutura
app/: página, layout e a rota api/explicar.components/: seções (disciplinas, carga, combinações, achados), cartão de destaque, barra lateral e rodapé.lib/: busca dos dados, tipos e formatação.prompts/: o prompt enviado ao v0.
