How mattpocock/ai-engineer-workshop-2026-project works
Cadence is a full-stack course platform. Learners browse courses, purchase or redeem access, then study lessons and track progress; quizzes support assessment. Instructors create and manage course content, while admins manage users, courses, and categories. SQLite/Drizzle provides persistent domain state. The route table documents the app’s route-to-screen structure, but most route/service calls were not shown in the excerpts, so those relationships are left unasserted. Optional integrations and some runtime wiring are consequently shown only as unverified where useful.
Main entry points: routes.ts Route table · services Domain services · courses.$slug.lessons.$lessonId.tsx Lesson player · youtube-player.tsx YouTube player
Components 21
App routing
- Route table
app/routes.ts
Learner experience
- Course catalog
app/routes/courses.tsx - Course details
app/routes/courses.$slug.tsx - Purchase flow
app/routes/courses.$slug.purchase.tsx - Coupon redemption
app/routes/redeem.$code.tsx - Learner dashboard
app/routes/dashboard.tsx - Lesson player
app/routes/courses.$slug.lessons.$lessonId.tsx - YouTube player
app/components/youtube-player.tsx - Video tracking API
app/routes/api.video-tracking.ts
Course operations
- Course authoring
app/routes/instructor.$courseId.tsx - Lesson and quiz editing
app/routes/instructor.$courseId.lessons.$lessonId.quiz.tsx - Admin management
app/routes/admin.users.tsx
Domain services
- Domain services
app/services - Quiz scoring
app/services/quizScoringService.ts
Persistence and session
- Session handling
app/lib/session.ts - SQLite database
app/db/index.ts - Domain schema
app/db/schema.ts
Other components
- Learner
- Instructor
- Administrator
- YouTube iframe API
Connections 26
- Route table → Course catalog: routes to
app/routes.ts - Route table → Course details: routes to
app/routes.ts - Route table → Purchase flow: routes to
app/routes.ts - Route table → Coupon redemption: routes to
app/routes.ts - Route table → Learner dashboard: routes to
app/routes.ts - Route table → Lesson player: routes to
app/routes.ts - Route table → Course authoring: routes to
app/routes.ts - Route table → Lesson and quiz editing: routes to
app/routes.ts - Route table → Admin management: routes to
app/routes.ts - Lesson player → YouTube player: embeds player
- YouTube player → YouTube iframe API: loads API
app/components/youtube-player.tsx - YouTube player → Video tracking API: sends tracking
- Lesson and quiz editing → Quiz scoring: submits answers
- Course catalog → Domain services: uses domain logic
- Purchase flow → Domain services: processes purchase
- Coupon redemption → Domain services: validates coupon
- Lesson player → Domain services: records progress
- Course authoring → Domain services: manages courses
- Admin management → Domain services: manages users
- Domain services → SQLite database: reads and writes
- Quiz scoring → SQLite database: scores attempts
app/services/quizScoringService.ts - SQLite database → Domain schema: uses schema
app/db/index.ts - Learner → Route table: navigates
- Instructor → Route table: navigates
- Administrator → Route table: navigates
- Lesson player → Session handling: checks identity