How tharunbalajis/edu-saas-platform works
EduOS is a role-based education platform for college administration, faculty, and students. Users sign in, then use role-specific screens to manage classrooms and academic activity, maintain student profiles and resumes, view results and placement information, and access administrative analytics. The frontend uses a shared authenticated API client to reach a modular backend. The excerpts establish several frontend routes, auth flows, and storage calls; many feature modules are represented from the tree and source index, so uncertain service-to-service links are omitted.
Main entry points: StudentDashboardPage.tsx Student workspace · ClassroomDetailPage.tsx Faculty workspace · AnalyticsPage.tsx Admin workspace · AppRoutes.tsx Role routes
Components 27
Web application
- Role-based app
frontend/src/App.tsx - Role routes
frontend/src/routes/AppRoutes.tsx - Faculty workspace
frontend/src/modules/faculty/pages/ClassroomDetailPage.tsx - Student workspace
frontend/src/modules/student/pages/StudentDashboardPage.tsx - Admin workspace
frontend/src/modules/super-admin/pages/AnalyticsPage.tsx - Shared API client
frontend/src/shared/lib/apiClient.ts
Identity and access
- Login and session
frontend/src/shared/context/AuthContext.tsx - Authentication service
backend/src/modules/auth/auth.service.ts - Role permissions
backend/src/modules/rbac/rbac.service.ts
Learning and student services
- Classroom service
backend/src/modules/classroom/classroom.service.ts - Academic records
backend/src/modules/academics/academics.service.ts - Assignments
backend/src/modules/submissions/submissions.service.ts - Student profiles
backend/src/modules/profiles/profiles.service.ts - Resume service
backend/src/modules/resume/resume.service.ts - Results service
backend/src/modules/results/results.service.ts - Placement service
backend/src/modules/placement/placement.service.ts - AI chatbot
backend/src/modules/chatbot/chatbot.service.ts
College administration
- Analytics
backend/src/modules/analytics/analytics.service.ts - College management
backend/src/modules/colleges/colleges.service.ts - User management
backend/src/modules/users/users.service.ts - Notifications
backend/src/modules/notifications/notifications.service.ts
Backend platform
- File storage service
backend/src/modules/storage/storage.service.ts - Supabase Storage
- PostgreSQL data
- Redis
- NVIDIA AI service
Other components
- Platform user
Connections 32
- Platform user → Role-based app: uses
- Role-based app → Role routes: renders
frontend/src/App.tsx - Role routes → Login and session: routes login
frontend/src/routes/AppRoutes.tsx - Role routes → Faculty workspace: routes faculty
frontend/src/routes/AppRoutes.tsx - Role routes → Student workspace: routes student
frontend/src/routes/AppRoutes.tsx - Role routes → Admin workspace: routes admin
frontend/src/routes/AppRoutes.tsx - Login and session → Shared API client: calls
frontend/src/shared/context/AuthContext.tsx - Faculty workspace → Shared API client: calls
- Student workspace → Shared API client: calls
- Admin workspace → Shared API client: calls
- Shared API client → Authentication service: HTTP auth requests
- Authentication service → Role permissions: gets permissions
backend/src/modules/auth/auth.service.ts - Authentication service → Redis: checks token state
backend/src/modules/auth/auth.service.ts - Faculty workspace → Classroom service: uses classroom features
- Student workspace → Classroom service: uses classroom features
- Faculty workspace → Academic records: uses academic features
- Faculty workspace → Assignments: reviews submissions
- Student workspace → Assignments: submits work
- Student workspace → Student profiles: edits profile
- Student workspace → Resume service: uses resume tools
- Student workspace → Results service: views results
- Student workspace → Placement service: views placement
- Role-based app → AI chatbot: offers chatbot
- Admin workspace → Analytics: views analytics
- Admin workspace → College management: manages colleges
- Admin workspace → User management: manages users
- Admin workspace → Notifications: broadcasts notices
- Faculty workspace → File storage service: uploads classroom files
- Student workspace → File storage service: uploads submission files
- File storage service → Supabase Storage: stores files
- File storage service → PostgreSQL data: records file metadata
- AI chatbot → NVIDIA AI service: uses AI provider