RMN Tutor
Site educacional em que estudantes de Química interpretam espectros de RMN de ¹H com um tutor socrático (Claude). O aluno abre um exercício ou envia seu espectro (imagem + lista de picos); o tutor pergunta, dá pistas graduais e confronta hipóteses com dados medidos por ferramentas determinísticas e checagens de estrutura com RDKit.
⚠️ Os exercícios usam dados didáticos simulados ainda não revisados. Veja docs/exercises/REVIEW.md.
Arquitetura
Navegador ──► Vercel (projeto rmn-tutor)
├── /api/* → backend/ FastAPI · Anthropic SDK · RDKit · SQLAlchemy (Postgres) · Vercel Blob
└── /* → frontend/ Next.js 16 · Tailwind 4 · Plotly
backend/app: nmr_engine (picos, simulação) · chem (RDKit) · nmr_tools (tools do Claude) · tutor (loop) · store · api
Rodar localmente
# backend
cd backend
python -m venv .venv && .venv/Scripts/python -m pip install -r requirements-dev.txt # Linux/macOS: .venv/bin/python
cp .env.example .env # FAKE_LLM=true: tutor simulado, sem custo
.venv/Scripts/python -m uvicorn main:app --port 8000
# frontend (outro terminal)
cd frontend && npm install && npm run dev # http://localhost:3000 (proxy de /api para :8000)
Para usar o Claude de verdade localmente, defina ANTHROPIC_API_KEY e FAKE_LLM=false no backend/.env.
Testes
| Comando |
|---|
| Backend | cd backend && python -m pytest -q && ruff check . |
| Frontend | cd frontend && npm run lint && npm test && npm run build |
| E2E (Playwright, tutor simulado) | cd frontend && PYTHON=.venv/Scripts/python npm run e2e |
| Eval do tutor (Claude real, custa) | cd backend && python scripts/tutor_eval.py --base-url <url> |
Deploy
Push em main publica em produção pela integração Git da Vercel; branches e PRs geram previews. Variáveis na Vercel: DATABASE_URL (Neon via Marketplace), Blob privado (BLOB_READ_WRITE_TOKEN), BLOB_BACKEND=vercel, SESSION_SECRET, ANTHROPIC_API_KEY, TUTOR_MODEL, TUTOR_EFFORT. Migrações: python -m app.admin migrate com o env de produção carregado.
Operação
- Limpeza de sessões:
docs/operations/limpeza-de-sessoes.md
- Revisão química:
docs/exercises/REVIEW.md
- Documentos de concepção:
rmn-tutor-project-docs/
