How dorkochavi/unlock-app works
UNLOCK is a Hebrew-first adaptive learning application. Learners access courses, answer scheduled or manual-practice questions, and build progress over time; the product describes the learner model and next-best action as central. Instructors create and manage courses and questions, with import and learner-analysis capabilities. The README documents an app → application → domain layering, with infrastructure implementing persistence/provider boundaries. Source excerpts show concrete course and daily-plan wiring; several other feature branches are represented by their documented modules, but their internal calls were not sampled.
Main entry points: courses Course API · route.ts Today plan API · course Course and question authoring · dailyPlan Daily plan service
Components 19
Learner experience
- Learner screens
src/app/(learner) - Today plan API
src/app/api/daily-plan/today/route.ts - Today plan handler
src/app/api/daily-plan/today/handle-get-daily-plan-today.ts - Manual practice
src/application/practice - Learning progress
src/application/progress
Course authoring
- Instructor screens
src/app/instructor - Course API
src/app/api/courses - Course and question authoring
src/application/course - Material import
src/application/import - Course insights
src/application/insights
Application and domain
- Learning model
src/domain/learning - Daily plan service
src/application/dailyPlan
Persistence and identity
- Supabase authentication
src/infrastructure/supabase/require-authenticated-user.ts - Postgres pool
src/infrastructure/postgres/pg-pool.ts - Course repositories
src/infrastructure/postgres/course-repository.ts - Membership repository
src/infrastructure/postgres/course-membership-repository.ts - Daily plan repository
src/infrastructure/postgres/daily-plan-repository.ts
Other components
- Learner
- Instructor
Connections 19
- Learner → Learner screens: uses
README.md - Learner screens → Today plan API: requests plan
- Today plan API → Today plan handler: dispatches
src/app/api/daily-plan/today/route.ts - Today plan handler → Daily plan service: invokes
src/app/api/daily-plan/today/route.ts - Instructor → Instructor screens: uses
README.md - Instructor screens → Course API: requests authoring
- Course API → Course and question authoring: dispatches
src/app/api/courses/[courseId]/manage/route.ts - Course and question authoring → Material import: supports import
- Course and question authoring → Course insights: supports analysis
- Manual practice → Learning model: uses learning rules
README.md - Daily plan service → Learning model: uses learning rules
README.md - Learning progress → Learning model: uses learning model
README.md - Today plan API → Supabase authentication: authenticates via
src/app/api/daily-plan/today/route.ts - Today plan API → Postgres pool: constructs on demand
src/app/api/daily-plan/today/route.ts - Course API → Supabase authentication: authenticates via
src/app/api/courses/route.ts - Course API → Postgres pool: constructs on demand
src/app/api/courses/route.ts - Course API → Course repositories: wires repository
src/app/api/courses/mine/route.ts - Course API → Membership repository: wires repository
src/app/api/courses/mine/route.ts - Daily plan service → Daily plan repository: persists plans
src/infrastructure/postgres/daily-plan-repository.ts