How harsh1999-wp/school-management works
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: StudentService.java Student operations · repository JPA repositories · StudentController.java Student API · DepartmentService.java Department operations
Components 15
API and transport
- Student API
src/main/java/com/harsh/School/controller/StudentController.java - Department API
src/main/java/com/harsh/School/controller/DepartmentController.java - Teacher API
src/main/java/com/harsh/School/controller/TeacherController.java - Student DTOs
src/main/java/com/harsh/School/dto/CreateStudentRequestDto.java
School operations
- Student operations
src/main/java/com/harsh/School/service/StudentService.java - Department operations
src/main/java/com/harsh/School/service/DepartmentService.java - Teacher operations
src/main/java/com/harsh/School/service/TeacherService.java
Domain and persistence
- JPA repositories
src/main/java/com/harsh/School/repository - School entities
src/main/java/com/harsh/School/entity - Database
Cross-cutting
- API exceptions
src/main/java/com/harsh/School/exception - Request filters
src/main/java/com/harsh/School/filter - Timing aspect
src/main/java/com/harsh/School/aspect/LoggingOffTime.java - Timing annotation
src/main/java/com/harsh/School/annotation/TimeTrack.java
Other components
- API client
Connections 16
- API client → Student API: sends requests
src/main/java/com/harsh/School/controller/StudentController.java - Student API → Student operations: dispatches
src/main/java/com/harsh/School/controller/StudentController.java - Student API → Student DTOs: accepts and returns
src/main/java/com/harsh/School/controller/StudentController.java - Student operations → JPA repositories: queries and saves
src/main/java/com/harsh/School/service/StudentService.java - Student operations → School entities: maps and updates
src/main/java/com/harsh/School/service/StudentService.java - Student operations → Student DTOs: maps to response
src/main/java/com/harsh/School/service/StudentService.java - Student operations → API exceptions: throws
src/main/java/com/harsh/School/service/StudentService.java - Department API → Department operations: dispatches
src/main/java/com/harsh/School/controller/DepartmentController.java - Department operations → JPA repositories: saves
src/main/java/com/harsh/School/service/DepartmentService.java - Department operations → School entities: builds relations
src/main/java/com/harsh/School/service/DepartmentService.java - Teacher API → Teacher operations: dispatches
src/main/java/com/harsh/School/controller/TeacherController.java - JPA repositories → School entities: persists and loads
src/main/java/com/harsh/School/repository/StudentRepository.java - JPA repositories → Database: reads and writes
- Timing aspect → Timing annotation: advises
src/main/java/com/harsh/School/aspect/LoggingOffTime.java - Student operations → Timing annotation: marks operation
src/main/java/com/harsh/School/service/StudentService.java - API exceptions → API client: formats errors