How hibatullahsyauqi/tutoring-platform works
Pedagogical OS is a tutor-facing STEM tutoring platform. The main workflow runs from tutor sign-in and dashboard briefing through student enrollment, scheduling, session logging, and a student learning dossier with conceptual mastery continuity and a copyable presence row. The README also describes multi-curriculum differentiation and contract-aware earnings; the sampled course APIs and dashboard support parts of those capabilities, while other implementation details are not shown. Edges reflect sampled calls, indexed module references, or documented behavior; unsampled financial and pedagogical internals are not inferred.
Main entry points: prisma.ts Prisma Client · app/page.tsx Dashboard & Briefing · [id]/page.tsx Student Dossier · server.ts Supabase Server Client
Components 26
Tutor Operations
- Dashboard & Briefing
src/app/page.tsx - Schedule Page
src/app/schedule/page.tsx - Schedule Calendar
src/app/schedule/ScheduleClientView.tsx - Schedule Actions
src/app/actions/schedule.ts - Presence Clipboard
src/components/CopyPresenceButton.tsx
Learning Records
- New Student Page
src/app/students/new/page.tsx - Student Enrollment Form
src/app/students/new/NewStudentForm.tsx - Student Actions
src/app/actions/student.ts - Student Dossier
src/app/students/[id]/page.tsx - New Session Page
src/app/sessions/new/page.tsx - Session Log Form
src/app/sessions/new/SessionForm.tsx - Session Actions
src/app/actions/session.ts
Curriculum & Resources
- Course Options API
src/app/api/courses/route.ts - Session Options API
src/app/api/session-options/route.ts - Resource Library Page
src/app/library/page.tsx - Resource Library View
src/app/library/LibraryView.tsx - Resource Actions
src/app/actions/resource.ts
Identity & Data
- Auth Actions
src/app/actions/auth.ts - Tutor Login
src/app/login/page.tsx - Auth Callback
src/app/auth/callback/route.ts - Supabase Server Client
src/lib/supabase/server.ts - Prisma Client
src/lib/prisma.ts - PostgreSQL Database
prisma/schema.prisma
Other components
- Tutor
- System Clipboard
- Supabase Auth
Connections 40
- Tutor → Tutor Login: signs in
src/app/login/page.tsx - Tutor Login → Supabase Server Client: authenticates with
src/app/login/page.tsx - Supabase Server Client → Supabase Auth: creates session client
src/lib/supabase/server.ts - Auth Callback → Supabase Server Client: exchanges code
src/app/auth/callback/route.ts - Auth Callback → Prisma Client: syncs tutor profile
src/app/auth/callback/route.ts - Tutor → Dashboard & Briefing: views briefing
README.md - Dashboard & Briefing → Supabase Server Client: checks user
src/app/page.tsx - Dashboard & Briefing → Prisma Client: reads tutor data
src/app/page.tsx - Dashboard & Briefing → Auth Actions: submits sign-out
src/app/page.tsx - Dashboard & Briefing → Student Dossier: opens student
src/app/page.tsx - Tutor → Schedule Page: opens schedule
README.md - Schedule Page → Schedule Calendar: renders
src/app/schedule/page.tsx - Schedule Page → Prisma Client: loads schedule data
src/app/schedule/page.tsx - Schedule Calendar → Schedule Actions: schedules or cancels
src/app/schedule/ScheduleClientView.tsx - Schedule Actions → Prisma Client: updates sessions
src/app/actions/schedule.ts - Tutor → New Student Page: starts enrollment
README.md - New Student Page → Student Enrollment Form: renders
src/app/students/new/page.tsx - New Student Page → Prisma Client: loads enrollment data
src/app/students/new/page.tsx - Student Enrollment Form → Student Actions: submits student
src/app/students/new/NewStudentForm.tsx - Student Actions → Prisma Client: persists student
src/app/actions/student.ts - Tutor → New Session Page: logs lesson
README.md - New Session Page → Session Log Form: renders
src/app/sessions/new/page.tsx - New Session Page → Prisma Client: loads session data
src/app/sessions/new/page.tsx - Session Log Form → Session Actions: submits session log
src/app/sessions/new/SessionForm.tsx - Session Actions → Prisma Client: stores session records
src/app/actions/session.ts - Tutor → Student Dossier: reviews continuity
README.md - Student Dossier → Prisma Client: reads learning history
src/app/students/[id]/page.tsx - Student Dossier → Presence Clipboard: provides row payload
src/app/students/[id]/page.tsx - Presence Clipboard → System Clipboard: copies TSV row
src/components/CopyPresenceButton.tsx - Student Dossier → Student Actions: offers profile deletion
- Tutor → Course Options API: requests course options
- Course Options API → Prisma Client: queries courses
src/app/api/courses/route.ts - Tutor → Session Options API: requests session options
- Session Options API → Prisma Client: queries courses
src/app/api/session-options/route.ts - Tutor → Resource Library Page: opens resources
- Resource Library Page → Resource Library View: renders
src/app/library/page.tsx - Resource Library Page → Prisma Client: loads resource data
src/app/library/page.tsx - Resource Library View → Resource Actions: requests resource changes
src/app/library/LibraryView.tsx - Resource Actions → Prisma Client: updates resources
src/app/actions/resource.ts - Prisma Client → PostgreSQL Database: queries records