How sheersh03/md-classes-backend works
MD-Classes Portal is a Spring Boot REST backend for student, parent, and staff workflows. The documented foundation workflow is register or log in, receive JWTs, then make role-restricted student requests. The tree also contains learning assessments, fee management, dashboards, and curriculum endpoints; sampled assessment and fee code confirms those are implemented paths, while other controllers indicate additional API areas. Source excerpts were incomplete, so relationships for unsampled controllers and dashboard behavior are limited to explicit README or source-index evidence.
Main entry points: repository People persistence · AuthService.java Auth service · StudentService.java Student service · ParentDashboardApiController.java Parent dashboard API
Components 19
Identity and security
- Auth API
src/main/java/md_classes/portal/controller/AuthController.java - Auth service
src/main/java/md_classes/portal/service/AuthService.java - JWT service
src/main/java/md_classes/portal/service/JwtService.java - JWT security
src/main/java/md_classes/portal/config/JwtAuthFilter.java - API error handler
src/main/java/md_classes/portal/exception/ApiExceptionHandler.java
Student and parent services
- Student API
src/main/java/md_classes/portal/controller/StudentController.java - Student service
src/main/java/md_classes/portal/service/StudentService.java - Parent dashboard API
src/main/java/md_classes/portal/controller/ParentDashboardApiController.java - Student dashboard API
src/main/java/md_classes/portal/controller/StudentDashboardApiController.java - People persistence
src/main/java/md_classes/portal/repository - People entities
src/main/java/md_classes/portal/domain
Learning and assessment
- Question service
src/main/java/md_classes/portal/service/QuestionService.java - Quiz attempt service
src/main/java/md_classes/portal/service/QuizAttemptService.java - Learning APIs
src/main/java/md_classes/portal/controller - Learning persistence
src/main/java/md_classes/portal/repository
Fees and dashboards
- Fee controller
src/main/java/md_classes/portal/controller/StudentFeeController.java - Fee persistence
src/main/java/md_classes/portal/repository - Dashboard views
src/main/resources/static/js
Other components
- Portal user
Connections 21
- Portal user → Auth API: registers or logs in
README.md - Auth API → Auth service: handles auth
- Auth service → JWT service: creates tokens
src/main/java/md_classes/portal/service/AuthService.java - Auth service → People persistence: reads and saves users
src/main/java/md_classes/portal/service/AuthService.java - Portal user → Student API: requests student data
README.md - Student API → Student service: delegates requests
- Student service → People persistence: reads and writes students
src/main/java/md_classes/portal/service/StudentService.java - Student service → People entities: updates profiles
src/main/java/md_classes/portal/service/StudentService.java - Parent dashboard API → People persistence: reads parent and student data
src/main/java/md_classes/portal/controller/ParentDashboardApiController.java - Student dashboard API → People persistence: reads student data
src/main/java/md_classes/portal/controller/StudentDashboardApiController.java - Question service → Learning persistence: reads and saves questions
src/main/java/md_classes/portal/service/QuestionService.java - Question service → People entities: uses quiz entities
src/main/java/md_classes/portal/service/QuestionService.java - Quiz attempt service → Learning persistence: loads and saves attempts
src/main/java/md_classes/portal/service/QuizAttemptService.java - Quiz attempt service → People entities: scores quiz answers
src/main/java/md_classes/portal/service/QuizAttemptService.java - Portal user → Learning APIs: uses learning endpoints
- Fee controller → Fee persistence: reads and records fees
src/main/java/md_classes/portal/controller/StudentFeeController.java - Portal user → Parent dashboard API: views parent dashboard
- Portal user → Student dashboard API: views student dashboard
- Dashboard views → Student dashboard API: dashboard interaction
- Dashboard views → Parent dashboard API: dashboard interaction
- API error handler → Portal user: returns API errors
README.md