landing page describes this product An objective is now required to build a session, not only asked for in the interface — the interface asks, and this is the same rule where it cannot be walked past. Only where there is something to choose: a deployment with no exams, and the first administrator of a fresh one, must still be able to build a session. A rule that locks an empty site is not a rule, it is a fault. Saving a question into a folder is one box that searches what you have and offers to make what you do not. It used to say "make one in the question bank" and leave you to go and do it, which means leaving the question you were reading and coming back to find your place. A name that already exists exactly is not offered twice; a partial match offers both, because wanting a narrower folder called "cardio" is not the same as wanting the one called "Cardiology misses". The landing page is rebuilt. Its copy described a product from months ago — "upload a PDF, AI extracts questions", which is one feature of many now — and it was 568 lines of inline style objects, which cannot express a hover, a media query or a keyframe. The figures come from /api/public/stats and count up; a failed fetch renders the section without them rather than showing noughts, which would be a lie about an empty bank. Motion is CSS and SVG, and prefers-reduced-motion turns all of it off — including forcing the scroll-revealed elements visible, since a hidden element with its animation removed is how respecting that setting turns into a blank page. Two smaller ones from the screenshots: the collections shelf is boxed rather than scrolling past everything else on the page, and its rows no longer carry the entire stem — lab tables and all — in a native tooltip that covered half the screen and could not be dismissed. 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 | ||
| services.md | ||
| study-recommendations.md | ||
| tied-conditions.md | ||
| TODO.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 |
Quick Links
- Main README: ../README.md
- Backend .env template: ../backend/.env.example
- Docker Compose: ../docker-compose.yml