448bfdd71c
Two halves of one TODO, settled with a measurement rather than a guess. *Shrunk readiness* was already done — `CandidateRanking.accuracy()` pulls a topic towards NEUTRAL_RECALL by PRIOR_ANSWERS, so one miss does not read as 0% — and there is now a test pinning it, because the note claiming otherwise outlived the fix by weeks. *Difficulty as a dimension the session moves along* cannot be built, and the reason is a number: all 2,924 questions have a NULL `difficulty`, and the empirical route is no better at 788 answers over 706 questions from 5 learners, about one answer each. A ladder scored against that would be scoring noise while looking as though it worked. What is built instead is honesty in the control that already exists: the Difficulty facet counts each level under the other filters and disables one that would empty the bank, so nobody picks Hard and watches the count fall to zero with no explanation. Reopen the ordering when something writes that column. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01TqXevQJhxFrM7jJg82cgZN |
||
|---|---|---|
| .. | ||
| quiz-revamp | ||
| adaptive-sessions.md | ||
| api-reference.md | ||
| architecture.md | ||
| deployment.md | ||
| frontend.md | ||
| migrations.md | ||
| quiz-revamp-plan.md | ||
| quiz-revamp-progress.md | ||
| README.md | ||
| reranking.md | ||
| retrieval-thresholds.md | ||
| services.md | ||
| study-recommendations.md | ||
| tied-conditions.md | ||
| TODO.md | ||
| writing-articles.md | ||
PedsHub Documentation
Deep technical documentation for the PedsHub pediatric learning platform.
Pages
| Document | Description |
|---|---|
| Architecture | System overview, database schema, multi-worker setup, vector search, auth, rate limiting, concurrent quiz protection |
| API Reference | Every endpoint: method, path, auth, request/response, notes |
| Services | Backend service layer: AI extraction, embedding, vector search, PDF processing, email, reminders |
| Frontend | React app structure, pages, components, state patterns, runtime config |
| Deployment | Docker setup, environment variables, HTTPS, rebuilding, monitoring, troubleshooting, scaling |
| Adaptive sessions | What the Adaptive toggle selects, where the code is, and what it deliberately ignores |
| Study recommendations | How focus areas are ranked and what readiness means |
| Writing articles | Cross-reference links, key-point highlights, teaching tips, the three views, linking questions, and what deleting does |
| Reranking | Where the cross-encoder is applied and where it deliberately is not |
| Retrieval thresholds | The numbers behind sourced / adjacent / open answers |
Quick Links
- Main README: ../README.md
- Backend .env template: ../backend/.env.example
- Docker Compose: ../docker-compose.yml