How haribalaji96/eduvault works
EduVault is a role-based education platform for administrators, teachers, and students. Users enter through the routed frontend, authenticate, then work with school administration, classrooms, assessments, or coding practice. The assessment workflow spans teacher authoring and publishing, student attempts and answers, and teacher review; classroom workflows cover enrollment, posts, and assignment submissions. The map preserves documented-by-routes capabilities where implementation excerpts are absent; those links are dashed when their exact runtime wiring is not shown.
Main entry points: App.tsx Role-based routes · client.ts API client · teacher Teacher screens · ClassroomService.java Classroom operations
Components 25
Web application
- Role-based routes
frontend/src/App.tsx - API client
frontend/src/api/client.ts
Identity and access
- Auth state
frontend/src/context/AuthContext.tsx - Authentication API
backend/src/main/java/com/psgtech/eduvault/controller/AuthController.java - JWT security
backend/src/main/java/com/psgtech/eduvault/security
School administration
- Admin screens
frontend/src/pages/admin - Admin API
backend/src/main/java/com/psgtech/eduvault/controller/AdminController.java
Classrooms
- Teacher screens
frontend/src/pages/teacher - Teacher classroom API
backend/src/main/java/com/psgtech/eduvault/controller/ClassroomController.java - Classroom operations
backend/src/main/java/com/psgtech/eduvault/service/ClassroomService.java
Assessments and practice
- Student screens
frontend/src/pages/student - Assessment API
frontend/src/services/assessmentApi.ts - Assessment authoring
backend/src/main/java/com/psgtech/eduvault/service/AssessmentTeacherService.java - Assessment attempts
backend/src/main/java/com/psgtech/eduvault/service/AssessmentStudentService.java - Coding practice
backend/src/main/java/com/psgtech/eduvault/controller/PracticeController.java
Backend services
- User administration
backend/src/main/java/com/psgtech/eduvault/service/StudentService.java - Code execution
backend/src/main/java/com/psgtech/eduvault/service/CodeExecutionService.java - File handling
backend/src/main/java/com/psgtech/eduvault/service/FileStorageService.java - Classroom records
backend/src/main/java/com/psgtech/eduvault/entity/Classroom.java - User records
backend/src/main/java/com/psgtech/eduvault/entity/User.java - Classroom repository
backend/src/main/java/com/psgtech/eduvault/repository/ClassroomRepository.java - User repository
backend/src/main/java/com/psgtech/eduvault/repository/UserRepository.java - Assessment records
backend/src/main/java/com/psgtech/eduvault/entity/Assessment.java - Submission records
backend/src/main/java/com/psgtech/eduvault/entity/Submission.java
Other components
- Admin · Teacher · Student
Connections 28
- Admin · Teacher · Student → Role-based routes: use roles
frontend/src/App.tsx - Role-based routes → Auth state: wraps routes
frontend/src/App.tsx - Role-based routes → Admin screens: routes admin
frontend/src/App.tsx - Role-based routes → Teacher screens: routes teacher
frontend/src/App.tsx - Role-based routes → Student screens: routes student
frontend/src/App.tsx - Auth state → API client: stores credentials
- Admin screens → API client: calls API
frontend/src/pages/admin/StudentManagement.tsx - Teacher screens → API client: calls API
frontend/src/pages/teacher/ClassroomDetail.tsx - Teacher screens → Assessment API: uses assessment API
frontend/src/pages/teacher/ClassroomDetail.tsx - Student screens → Assessment API: uses assessment API
- API client → Admin API: HTTP requests
- API client → Teacher classroom API: HTTP requests
- Assessment API → Assessment authoring: HTTP requests
- Admin API → User administration: delegates
backend/src/main/java/com/psgtech/eduvault/controller/AdminController.java - Admin API → Classroom operations: delegates
backend/src/main/java/com/psgtech/eduvault/controller/AdminController.java - Teacher classroom API → Classroom operations: delegates
backend/src/main/java/com/psgtech/eduvault/controller/ClassroomController.java - Classroom operations → Classroom repository: reads records
backend/src/main/java/com/psgtech/eduvault/service/ClassroomService.java - Classroom operations → User repository: looks up users
backend/src/main/java/com/psgtech/eduvault/service/ClassroomService.java - User administration → User repository: saves users
backend/src/main/java/com/psgtech/eduvault/service/StudentService.java - Authentication API → JWT security: issues credentials
- JWT security → User repository: loads identity
backend/src/main/java/com/psgtech/eduvault/security/CustomUserDetailsService.java - Assessment authoring → Assessment records: manages assessments
backend/src/main/java/com/psgtech/eduvault/service/AssessmentTeacherService.java - Assessment attempts → Submission records: creates attempts
backend/src/main/java/com/psgtech/eduvault/service/AssessmentStudentService.java - Assessment attempts → Code execution: runs submitted code
backend/src/main/java/com/psgtech/eduvault/service/AssessmentStudentService.java - Coding practice → Code execution: delegates execution
- Classroom records → Classroom repository: persisted through
backend/src/main/java/com/psgtech/eduvault/repository/ClassroomRepository.java - User records → User repository: persisted through
backend/src/main/java/com/psgtech/eduvault/repository/UserRepository.java - Teacher screens → File handling: uploads files