# sheersh03/md-classes-backend architecture

> Architecture diagram of the GitHub repository sheersh03/md-classes-backend, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-06). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/sheersh03/md-classes-backend
- Repository: https://github.com/sheersh03/md-classes-backend

## Overview

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: [`src/main/java/md_classes/portal/repository`](https://github.com/sheersh03/md-classes-backend/tree/main/src/main/java/md_classes/portal/repository) (People persistence), [`src/main/java/md_classes/portal/service/AuthService.java`](https://github.com/sheersh03/md-classes-backend/blob/main/src/main/java/md_classes/portal/service/AuthService.java) (Auth service), [`src/main/java/md_classes/portal/service/StudentService.java`](https://github.com/sheersh03/md-classes-backend/blob/main/src/main/java/md_classes/portal/service/StudentService.java) (Student service), [`src/main/java/md_classes/portal/controller/ParentDashboardApiController.java`](https://github.com/sheersh03/md-classes-backend/blob/main/src/main/java/md_classes/portal/controller/ParentDashboardApiController.java) (Parent dashboard API)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_identity["Identity and security"]
  node_auth_api["Auth API"]
  node_auth_service["Auth service<br/>[AuthService.java]"]
  node_jwt["JWT service<br/>[JwtService.java]"]
  node_security["JWT security<br/>[JwtAuthFilter.java]"]
  node_error_handler["API error handler"]
end

subgraph group_people["Student and parent services"]
  node_student_api["Student API"]
  node_student_service["Student service"]
  node_parent_api["Parent dashboard API"]
  node_student_api_dash["Student dashboard API"]
  node_people_store[("People persistence")]
  node_people_models["People entities"]
end

subgraph group_learning["Learning and assessment"]
  node_question_service["Question service"]
  node_quiz_attempt["Quiz attempt service"]
  node_learning_api["Learning APIs"]
  node_learning_store[("Learning persistence")]
end

subgraph group_operations["Fees and dashboards"]
  node_fee_api["Fee controller"]
  node_fee_store[("Fee persistence")]
  node_dashboard_views["Dashboard views"]
end

node_caller(("Portal user"))

node_caller -->|"registers or logs in"| node_auth_api
node_auth_api -.->|"handles auth"| node_auth_service
node_auth_service -->|"creates tokens"| node_jwt
node_auth_service -->|"reads and saves users"| node_people_store
node_caller -->|"requests student data"| node_student_api
node_student_api -.->|"delegates requests"| node_student_service
node_student_service -->|"reads and writes students"| node_people_store
node_student_service -->|"updates profiles"| node_people_models
node_parent_api -->|"reads parent and student data"| node_people_store
node_student_api_dash -->|"reads student data"| node_people_store
node_question_service -->|"reads and saves questions"| node_learning_store
node_question_service -->|"uses quiz entities"| node_people_models
node_quiz_attempt -->|"loads and saves attempts"| node_learning_store
node_quiz_attempt -->|"scores quiz answers"| node_people_models
node_caller -.->|"uses learning endpoints"| node_learning_api
node_fee_api -->|"reads and records fees"| node_fee_store
node_caller -.->|"views parent dashboard"| node_parent_api
node_caller -.->|"views student dashboard"| node_student_api_dash
node_dashboard_views -.->|"dashboard interaction"| node_student_api_dash
node_dashboard_views -.->|"dashboard interaction"| node_parent_api
node_error_handler -->|"returns API errors"| node_caller

click node_auth_api "https://github.com/sheersh03/md-classes-backend/blob/main/src/main/java/md_classes/portal/controller/AuthController.java"
click node_auth_service "https://github.com/sheersh03/md-classes-backend/blob/main/src/main/java/md_classes/portal/service/AuthService.java"
click node_jwt "https://github.com/sheersh03/md-classes-backend/blob/main/src/main/java/md_classes/portal/service/JwtService.java"
click node_security "https://github.com/sheersh03/md-classes-backend/blob/main/src/main/java/md_classes/portal/config/JwtAuthFilter.java"
click node_student_api "https://github.com/sheersh03/md-classes-backend/blob/main/src/main/java/md_classes/portal/controller/StudentController.java"
click node_student_service "https://github.com/sheersh03/md-classes-backend/blob/main/src/main/java/md_classes/portal/service/StudentService.java"
click node_parent_api "https://github.com/sheersh03/md-classes-backend/blob/main/src/main/java/md_classes/portal/controller/ParentDashboardApiController.java"
click node_student_api_dash "https://github.com/sheersh03/md-classes-backend/blob/main/src/main/java/md_classes/portal/controller/StudentDashboardApiController.java"
click node_people_store "https://github.com/sheersh03/md-classes-backend/tree/main/src/main/java/md_classes/portal/repository"
click node_people_models "https://github.com/sheersh03/md-classes-backend/tree/main/src/main/java/md_classes/portal/domain"
click node_question_service "https://github.com/sheersh03/md-classes-backend/blob/main/src/main/java/md_classes/portal/service/QuestionService.java"
click node_quiz_attempt "https://github.com/sheersh03/md-classes-backend/blob/main/src/main/java/md_classes/portal/service/QuizAttemptService.java"
click node_learning_api "https://github.com/sheersh03/md-classes-backend/tree/main/src/main/java/md_classes/portal/controller"
click node_learning_store "https://github.com/sheersh03/md-classes-backend/tree/main/src/main/java/md_classes/portal/repository"
click node_fee_api "https://github.com/sheersh03/md-classes-backend/blob/main/src/main/java/md_classes/portal/controller/StudentFeeController.java"
click node_fee_store "https://github.com/sheersh03/md-classes-backend/tree/main/src/main/java/md_classes/portal/repository"
click node_dashboard_views "https://github.com/sheersh03/md-classes-backend/tree/main/src/main/resources/static/js"
click node_error_handler "https://github.com/sheersh03/md-classes-backend/blob/main/src/main/java/md_classes/portal/exception/ApiExceptionHandler.java"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_auth_api,node_auth_service,node_jwt,node_security,node_error_handler,node_caller toneBlue
class node_student_api,node_student_service,node_parent_api,node_student_api_dash,node_people_store,node_people_models toneAmber
class node_question_service,node_quiz_attempt,node_learning_api,node_learning_store toneMint
class node_fee_api,node_fee_store,node_dashboard_views toneRose
```

## Components

### Identity and security

- [Auth API](https://github.com/sheersh03/md-classes-backend/blob/main/src/main/java/md_classes/portal/controller/AuthController.java): `src/main/java/md_classes/portal/controller/AuthController.java`
- [Auth service](https://github.com/sheersh03/md-classes-backend/blob/main/src/main/java/md_classes/portal/service/AuthService.java): `src/main/java/md_classes/portal/service/AuthService.java`
- [JWT service](https://github.com/sheersh03/md-classes-backend/blob/main/src/main/java/md_classes/portal/service/JwtService.java): `src/main/java/md_classes/portal/service/JwtService.java`
- [JWT security](https://github.com/sheersh03/md-classes-backend/blob/main/src/main/java/md_classes/portal/config/JwtAuthFilter.java): `src/main/java/md_classes/portal/config/JwtAuthFilter.java`
- [API error handler](https://github.com/sheersh03/md-classes-backend/blob/main/src/main/java/md_classes/portal/exception/ApiExceptionHandler.java): `src/main/java/md_classes/portal/exception/ApiExceptionHandler.java`

### Student and parent services

- [Student API](https://github.com/sheersh03/md-classes-backend/blob/main/src/main/java/md_classes/portal/controller/StudentController.java): `src/main/java/md_classes/portal/controller/StudentController.java`
- [Student service](https://github.com/sheersh03/md-classes-backend/blob/main/src/main/java/md_classes/portal/service/StudentService.java): `src/main/java/md_classes/portal/service/StudentService.java`
- [Parent dashboard API](https://github.com/sheersh03/md-classes-backend/blob/main/src/main/java/md_classes/portal/controller/ParentDashboardApiController.java): `src/main/java/md_classes/portal/controller/ParentDashboardApiController.java`
- [Student dashboard API](https://github.com/sheersh03/md-classes-backend/blob/main/src/main/java/md_classes/portal/controller/StudentDashboardApiController.java): `src/main/java/md_classes/portal/controller/StudentDashboardApiController.java`
- [People persistence](https://github.com/sheersh03/md-classes-backend/tree/main/src/main/java/md_classes/portal/repository): `src/main/java/md_classes/portal/repository`
- [People entities](https://github.com/sheersh03/md-classes-backend/tree/main/src/main/java/md_classes/portal/domain): `src/main/java/md_classes/portal/domain`

### Learning and assessment

- [Question service](https://github.com/sheersh03/md-classes-backend/blob/main/src/main/java/md_classes/portal/service/QuestionService.java): `src/main/java/md_classes/portal/service/QuestionService.java`
- [Quiz attempt service](https://github.com/sheersh03/md-classes-backend/blob/main/src/main/java/md_classes/portal/service/QuizAttemptService.java): `src/main/java/md_classes/portal/service/QuizAttemptService.java`
- [Learning APIs](https://github.com/sheersh03/md-classes-backend/tree/main/src/main/java/md_classes/portal/controller): `src/main/java/md_classes/portal/controller`
- [Learning persistence](https://github.com/sheersh03/md-classes-backend/tree/main/src/main/java/md_classes/portal/repository): `src/main/java/md_classes/portal/repository`

### Fees and dashboards

- [Fee controller](https://github.com/sheersh03/md-classes-backend/blob/main/src/main/java/md_classes/portal/controller/StudentFeeController.java): `src/main/java/md_classes/portal/controller/StudentFeeController.java`
- [Fee persistence](https://github.com/sheersh03/md-classes-backend/tree/main/src/main/java/md_classes/portal/repository): `src/main/java/md_classes/portal/repository`
- [Dashboard views](https://github.com/sheersh03/md-classes-backend/tree/main/src/main/resources/static/js): `src/main/resources/static/js`

### Other components

- **Portal user**

## Connections

- Portal user → Auth API: registers or logs in (evidence: `README.md`)
- Auth API → Auth service: handles auth
- Auth service → JWT service: creates tokens (evidence: `src/main/java/md_classes/portal/service/AuthService.java`)
- Auth service → People persistence: reads and saves users (evidence: `src/main/java/md_classes/portal/service/AuthService.java`)
- Portal user → Student API: requests student data (evidence: `README.md`)
- Student API → Student service: delegates requests
- Student service → People persistence: reads and writes students (evidence: `src/main/java/md_classes/portal/service/StudentService.java`)
- Student service → People entities: updates profiles (evidence: `src/main/java/md_classes/portal/service/StudentService.java`)
- Parent dashboard API → People persistence: reads parent and student data (evidence: `src/main/java/md_classes/portal/controller/ParentDashboardApiController.java`)
- Student dashboard API → People persistence: reads student data (evidence: `src/main/java/md_classes/portal/controller/StudentDashboardApiController.java`)
- Question service → Learning persistence: reads and saves questions (evidence: `src/main/java/md_classes/portal/service/QuestionService.java`)
- Question service → People entities: uses quiz entities (evidence: `src/main/java/md_classes/portal/service/QuestionService.java`)
- Quiz attempt service → Learning persistence: loads and saves attempts (evidence: `src/main/java/md_classes/portal/service/QuizAttemptService.java`)
- Quiz attempt service → People entities: scores quiz answers (evidence: `src/main/java/md_classes/portal/service/QuizAttemptService.java`)
- Portal user → Learning APIs: uses learning endpoints
- Fee controller → Fee persistence: reads and records fees (evidence: `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 (evidence: `README.md`)
