# harsh1999-wp/school-management architecture

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

- Interactive diagram: https://gitdiagram.com/harsh1999-wp/school-management
- Repository: https://github.com/harsh1999-wp/school-management

## Overview

School-Management is a Spring-based school records API. Its clearest workflow is student HTTP requests routed through a controller to services, which validate and map student data, use repositories, and return DTOs. The code also includes department operations, teacher scaffolding, shared entity models, exception handling, request filters, and timing instrumentation. The README provides no further capability details; some peripheral components are represented by their source directories because their individual behavior is not shown.

Main entry points: [`src/main/java/com/harsh/School/service/StudentService.java`](https://github.com/harsh1999-wp/school-management/blob/main/src/main/java/com/harsh/School/service/StudentService.java) (Student operations), [`src/main/java/com/harsh/School/repository`](https://github.com/harsh1999-wp/school-management/tree/main/src/main/java/com/harsh/School/repository) (JPA repositories), [`src/main/java/com/harsh/School/controller/StudentController.java`](https://github.com/harsh1999-wp/school-management/blob/main/src/main/java/com/harsh/School/controller/StudentController.java) (Student API), [`src/main/java/com/harsh/School/service/DepartmentService.java`](https://github.com/harsh1999-wp/school-management/blob/main/src/main/java/com/harsh/School/service/DepartmentService.java) (Department operations)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_api["API and transport"]
  node_student_controller["Student API"]
  node_department_controller["Department API"]
  node_teacher_controller["Teacher API"]
  node_student_dto["Student DTOs"]
end

subgraph group_logic["School operations"]
  node_student_service["Student operations"]
  node_department_service["Department operations"]
  node_teacher_service["Teacher operations"]
end

subgraph group_data["Domain and persistence"]
  node_repositories["JPA repositories"]
  node_school_entities["School entities"]
  node_database[("Database")]
end

subgraph group_crosscut["Cross-cutting"]
  node_exceptions["API exceptions"]
  node_filters["Request filters"]
  node_time_tracking["Timing aspect"]
  node_time_annotation["Timing annotation<br/>[TimeTrack.java]"]
end

node_client(("API client"))

node_client -->|"sends requests"| node_student_controller
node_student_controller -->|"dispatches"| node_student_service
node_student_controller -->|"accepts and returns"| node_student_dto
node_student_service -->|"queries and saves"| node_repositories
node_student_service -->|"maps and updates"| node_school_entities
node_student_service -->|"maps to response"| node_student_dto
node_student_service -->|"throws"| node_exceptions
node_department_controller -->|"dispatches"| node_department_service
node_department_service -->|"saves"| node_repositories
node_department_service -->|"builds relations"| node_school_entities
node_teacher_controller -->|"dispatches"| node_teacher_service
node_repositories -->|"persists and loads"| node_school_entities
node_repositories -.->|"reads and writes"| node_database
node_time_tracking -->|"advises"| node_time_annotation
node_student_service -->|"marks operation"| node_time_annotation
node_exceptions -.->|"formats errors"| node_client

click node_student_controller "https://github.com/harsh1999-wp/school-management/blob/main/src/main/java/com/harsh/School/controller/StudentController.java"
click node_department_controller "https://github.com/harsh1999-wp/school-management/blob/main/src/main/java/com/harsh/School/controller/DepartmentController.java"
click node_teacher_controller "https://github.com/harsh1999-wp/school-management/blob/main/src/main/java/com/harsh/School/controller/TeacherController.java"
click node_student_dto "https://github.com/harsh1999-wp/school-management/blob/main/src/main/java/com/harsh/School/dto/CreateStudentRequestDto.java"
click node_student_service "https://github.com/harsh1999-wp/school-management/blob/main/src/main/java/com/harsh/School/service/StudentService.java"
click node_department_service "https://github.com/harsh1999-wp/school-management/blob/main/src/main/java/com/harsh/School/service/DepartmentService.java"
click node_teacher_service "https://github.com/harsh1999-wp/school-management/blob/main/src/main/java/com/harsh/School/service/TeacherService.java"
click node_repositories "https://github.com/harsh1999-wp/school-management/tree/main/src/main/java/com/harsh/School/repository"
click node_school_entities "https://github.com/harsh1999-wp/school-management/tree/main/src/main/java/com/harsh/School/entity"
click node_exceptions "https://github.com/harsh1999-wp/school-management/tree/main/src/main/java/com/harsh/School/exception"
click node_filters "https://github.com/harsh1999-wp/school-management/tree/main/src/main/java/com/harsh/School/filter"
click node_time_tracking "https://github.com/harsh1999-wp/school-management/blob/main/src/main/java/com/harsh/School/aspect/LoggingOffTime.java"
click node_time_annotation "https://github.com/harsh1999-wp/school-management/blob/main/src/main/java/com/harsh/School/annotation/TimeTrack.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_student_controller,node_department_controller,node_teacher_controller,node_student_dto,node_client toneBlue
class node_student_service,node_department_service,node_teacher_service toneAmber
class node_repositories,node_school_entities,node_database toneMint
class node_exceptions,node_filters,node_time_tracking,node_time_annotation toneRose
```

## Components

### API and transport

- [Student API](https://github.com/harsh1999-wp/school-management/blob/main/src/main/java/com/harsh/School/controller/StudentController.java): `src/main/java/com/harsh/School/controller/StudentController.java`
- [Department API](https://github.com/harsh1999-wp/school-management/blob/main/src/main/java/com/harsh/School/controller/DepartmentController.java): `src/main/java/com/harsh/School/controller/DepartmentController.java`
- [Teacher API](https://github.com/harsh1999-wp/school-management/blob/main/src/main/java/com/harsh/School/controller/TeacherController.java): `src/main/java/com/harsh/School/controller/TeacherController.java`
- [Student DTOs](https://github.com/harsh1999-wp/school-management/blob/main/src/main/java/com/harsh/School/dto/CreateStudentRequestDto.java): `src/main/java/com/harsh/School/dto/CreateStudentRequestDto.java`

### School operations

- [Student operations](https://github.com/harsh1999-wp/school-management/blob/main/src/main/java/com/harsh/School/service/StudentService.java): `src/main/java/com/harsh/School/service/StudentService.java`
- [Department operations](https://github.com/harsh1999-wp/school-management/blob/main/src/main/java/com/harsh/School/service/DepartmentService.java): `src/main/java/com/harsh/School/service/DepartmentService.java`
- [Teacher operations](https://github.com/harsh1999-wp/school-management/blob/main/src/main/java/com/harsh/School/service/TeacherService.java): `src/main/java/com/harsh/School/service/TeacherService.java`

### Domain and persistence

- [JPA repositories](https://github.com/harsh1999-wp/school-management/tree/main/src/main/java/com/harsh/School/repository): `src/main/java/com/harsh/School/repository`
- [School entities](https://github.com/harsh1999-wp/school-management/tree/main/src/main/java/com/harsh/School/entity): `src/main/java/com/harsh/School/entity`
- **Database**

### Cross-cutting

- [API exceptions](https://github.com/harsh1999-wp/school-management/tree/main/src/main/java/com/harsh/School/exception): `src/main/java/com/harsh/School/exception`
- [Request filters](https://github.com/harsh1999-wp/school-management/tree/main/src/main/java/com/harsh/School/filter): `src/main/java/com/harsh/School/filter`
- [Timing aspect](https://github.com/harsh1999-wp/school-management/blob/main/src/main/java/com/harsh/School/aspect/LoggingOffTime.java): `src/main/java/com/harsh/School/aspect/LoggingOffTime.java`
- [Timing annotation](https://github.com/harsh1999-wp/school-management/blob/main/src/main/java/com/harsh/School/annotation/TimeTrack.java): `src/main/java/com/harsh/School/annotation/TimeTrack.java`

### Other components

- **API client**

## Connections

- API client → Student API: sends requests (evidence: `src/main/java/com/harsh/School/controller/StudentController.java`)
- Student API → Student operations: dispatches (evidence: `src/main/java/com/harsh/School/controller/StudentController.java`)
- Student API → Student DTOs: accepts and returns (evidence: `src/main/java/com/harsh/School/controller/StudentController.java`)
- Student operations → JPA repositories: queries and saves (evidence: `src/main/java/com/harsh/School/service/StudentService.java`)
- Student operations → School entities: maps and updates (evidence: `src/main/java/com/harsh/School/service/StudentService.java`)
- Student operations → Student DTOs: maps to response (evidence: `src/main/java/com/harsh/School/service/StudentService.java`)
- Student operations → API exceptions: throws (evidence: `src/main/java/com/harsh/School/service/StudentService.java`)
- Department API → Department operations: dispatches (evidence: `src/main/java/com/harsh/School/controller/DepartmentController.java`)
- Department operations → JPA repositories: saves (evidence: `src/main/java/com/harsh/School/service/DepartmentService.java`)
- Department operations → School entities: builds relations (evidence: `src/main/java/com/harsh/School/service/DepartmentService.java`)
- Teacher API → Teacher operations: dispatches (evidence: `src/main/java/com/harsh/School/controller/TeacherController.java`)
- JPA repositories → School entities: persists and loads (evidence: `src/main/java/com/harsh/School/repository/StudentRepository.java`)
- JPA repositories → Database: reads and writes
- Timing aspect → Timing annotation: advises (evidence: `src/main/java/com/harsh/School/aspect/LoggingOffTime.java`)
- Student operations → Timing annotation: marks operation (evidence: `src/main/java/com/harsh/School/service/StudentService.java`)
- API exceptions → API client: formats errors
