How small-fish-qaq/hy3-study-clinic works
Hy3 Study Clinic is a local, course-centred learning app: learners import their own material, confirm a course plan, study generated explanations and exercises, ask a tutor follow-ups, and revisit mistakes or formal results. The graph follows that documented workflow and includes source-grounding, model-provider, persistence, and review capabilities. README statements support the product-level flow; sampled server excerpts establish app route registration. Most service internals and route-to-service calls were not sampled, so those links are omitted rather than inferred.
Main entry points: curriculum.ts Curriculum planning · repositories Learning repositories · App.tsx Course interface · prompts.ts Teaching generation
Components 20
Learner experience
- Course interface
apps/web/src/App.tsx - Web API client
apps/web/src/api.ts - Study session UI
apps/web/src/views/StudySessionView.tsx
Course preparation
- Material ingestion
apps/server/src/ingestion/ingest.ts - Curriculum planning
apps/server/src/services/curriculum.ts - Curriculum evidence
apps/server/src/services/curriculumEvidence.ts - Source authority
packages/shared/src/domain/sourceAuthority.ts
Teaching and assessment
- Teaching generation
apps/server/src/llm/prompts.ts - Model provider
apps/server/src/llm/provider.ts - Lessons and practice
apps/server/src/services/lessons.ts - Tutor support
apps/server/src/services/tutor.ts - Practice recovery
apps/server/src/services/practiceRecovery.ts - Formal assessment
apps/server/src/services/formalAssessments.ts - Spaced review
apps/server/src/services/reviewSuccessor.ts
Server platform
- HTTP application
apps/server/src/app.ts - API routes
apps/server/src/routes - Learning repositories
apps/server/src/repositories - SQLite database
apps/server/src/db/database.ts
Shared domain
- Shared domain contracts
packages/shared/src/domain
Other components
- Learner
Connections 22
- Learner → Course interface: uses
README.md - Course interface → Web API client: requests data
apps/web/src/App.tsx - Course interface → Study session UI: presents study
- Web API client → HTTP application: calls API
- HTTP application → API routes: registers routes
apps/server/src/app.ts - Learner → Material ingestion: provides materials
README.md - Material ingestion → Curriculum planning: prepares course
- Learner → Curriculum planning: confirms plan
README.md - Curriculum planning → Curriculum evidence: grounds selection
- Curriculum evidence → Source authority: uses authority
- Curriculum planning → Teaching generation: prepares instruction
README.md - Teaching generation → Model provider: generates content
apps/server/src/llm/prompts.ts - Learner → Lessons and practice: studies lessons
README.md - Learner → Tutor support: asks follow-ups
README.md - Learner → Practice recovery: retries mistakes
README.md - Learner → Formal assessment: submits assessment
README.md - Learner → Spaced review: resumes learning
README.md - Lessons and practice → Learning repositories: saves learning
- Formal assessment → Learning repositories: records results
README.md - Learning repositories → SQLite database: persists state
apps/server/src/repositories/reviewSuccessor.ts - Spaced review → Learning repositories: updates review
apps/server/src/services/reviewSuccessor.ts - Teaching generation → Shared domain contracts: uses contracts