How theebajber/maymanah works
Maymanah is a Quran-learning nonprofit platform connecting students with volunteer teachers, with administrators and donors supporting the service. The principal workflow is account creation and verification, course-based learning and assessment, then teacher pairing, scheduling, live lessons, and progress tracking. The graph also preserves the Mushaf, messaging, administration, and donation branches. Evidence is limited to the README, source index references, and sampled excerpts; unsampled subsystem links are omitted where their callers are not shown.
Main entry points: db.ts PostgreSQL database · page.tsx Public site · [id]/route.ts Lesson sessions · messages/route.ts Messages
Components 34
Public and identity
- Public site
app/(home)/page.tsx - Authentication
app/(auth)/register/page.tsx - Account security API
app/api/account/route.ts - Donations
app/(home)/donate/page.tsx
Student learning
- Student portal
app/(portal)/dashboard/page.tsx - Courses and lessons
app/(portal)/courses - Assessments and certificates
app/api/exams - Mushaf reader
app/(portal)/mushaf - Quran content API
app/api/quran
Teaching and scheduling
- Teacher portal
app/(portal)/students - Availability
app/api/availability/route.ts - Lesson sessions
app/api/appointments/[id]/route.ts - Live session services
lib/live-session.ts - Meeting integrations
lib/meetings.ts - Messages
app/api/messages/route.ts
Administration and support
- Admin portal
app/admin - Reports and analytics
app/admin/analytics/AnalyticsDashboard.tsx
Platform services
- Authentication service
lib/auth.ts - Session resolution
lib/session.ts - PostgreSQL database
lib/db.ts - Notifications
lib/notifications.ts - Transactional email
lib/mailer.ts - Text utilities
lib/text.ts - Validation
lib/validation.ts - Button UI
app/ui/button.tsx - Typography
app/ui/fonts.ts - Girih decoration
app/ui/girih.tsx - Glass UI
app/ui/glass.tsx - Input UI
app/ui/input.tsx
Other components
- Visitor
- Student
- Volunteer teacher
- Donor
- Administrator
Connections 36
- Visitor → Public site: explores
- Public site → Authentication: starts enrollment
app/(home)/page.tsx - Student → Authentication: registers
- Authentication → Authentication service: authenticates
- Authentication service → PostgreSQL database: reads and writes
lib/auth.ts - Authentication service → Transactional email: sends codes
lib/auth.ts - Account security API → Authentication service: checks identity
app/api/account/route.ts - Account security API → Session resolution: resolves user
app/api/account/route.ts - Session resolution → PostgreSQL database: loads user
lib/session.ts - Student → Student portal: uses
- Student portal → Courses and lessons: opens learning
- Courses and lessons → Assessments and certificates: takes assessments
- Student → Mushaf reader: reads Quran
- Mushaf reader → Quran content API: requests content
- Volunteer teacher → Teacher portal: manages students
- Teacher portal → Availability: sets availability
- Availability → PostgreSQL database: stores slots
app/api/availability/route.ts - Volunteer teacher → Lesson sessions: manages lessons
- Lesson sessions → PostgreSQL database: reads and updates
app/api/appointments/[id]/route.ts - Lesson sessions → Meeting integrations: invalidates room
app/api/appointments/[id]/route.ts - Lesson sessions → Notifications: notifies student
app/api/appointments/[id]/route.ts - Lesson sessions → Live session services: supports lesson room
- Student → Messages: communicates
- Messages → PostgreSQL database: reads and writes
app/api/messages/route.ts - Messages → Notifications: notifies recipient
app/api/messages/route.ts - Administrator → Admin portal: administers platform
- Admin portal → Reports and analytics: reviews analytics
- Donor → Donations: supports service
- Donations → PostgreSQL database: records donations
- Glass UI → Girih decoration: uses
app/ui/glass.tsx - Student portal → PostgreSQL database: loads dashboard data
app/(portal)/dashboard/page.tsx - Messages → Text utilities: formats content
app/api/messages/route.ts - Public site → Button UI: renders
app/(home)/page.tsx - Public site → Typography: uses typography
app/(home)/page.tsx - Public site → Girih decoration: renders decoration
app/(home)/page.tsx - Authentication → Input UI: renders fields
app/(auth)/register/page.tsx