# its-tao/spring-boot-project architecture

> Architecture diagram of the GitHub repository its-tao/spring-boot-project, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-22). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/its-tao/spring-boot-project
- Repository: https://github.com/its-tao/spring-boot-project

## Overview

The tree indicates a Spring-based academic management application with course, lecturer, student, and user areas, plus authentication and authorization components. A likely request flow is an external client reaching a controller, then a service and repository to access domain data. No README or source excerpts were provided, so these relationships and the runtime role of the security components are unverified; dashed edges mark that limitation rather than asserting inspected call paths.

Main entry points: [`src/main/java/com/example/demo/service/StudentService.java`](https://github.com/its-tao/spring-boot-project/blob/main/src/main/java/com/example/demo/service/StudentService.java) (Student Service), [`src/main/java/com/example/demo/controller/CourseController.java`](https://github.com/its-tao/spring-boot-project/blob/main/src/main/java/com/example/demo/controller/CourseController.java) (Course Controller), [`src/main/java/com/example/demo/controller/LecturerController.java`](https://github.com/its-tao/spring-boot-project/blob/main/src/main/java/com/example/demo/controller/LecturerController.java) (Lecturer Controller), [`src/main/java/com/example/demo/controller/StudentController.java`](https://github.com/its-tao/spring-boot-project/blob/main/src/main/java/com/example/demo/controller/StudentController.java) (Student Controller)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_api["HTTP API"]
  node_course_controller["Course Controller"]
  node_lecturer_controller["Lecturer Controller"]
  node_student_controller["Student Controller"]
  node_user_controller["User Controller"]
end

subgraph group_domain["Domain Services"]
  node_course_service["Course Service<br/>[CourseService.java]"]
  node_lecturer_service["Lecturer Service"]
  node_student_service["Student Service"]
  node_user_service["User Service<br/>[UserService.java]"]
  node_student_not_found["Student Not Found"]
  node_course_model["Course Model<br/>[Course.java]"]
  node_lecturer_model["Lecturer Model<br/>[Lecturer.java]"]
  node_student_model["Student Model<br/>[Student.java]"]
  node_user_model["User Model<br/>[User.java]"]
end

subgraph group_persistence["Persistence"]
  node_course_repository["Course Repository"]
  node_lecturer_repository["Lecturer Repository"]
  node_student_repository["Student Repository"]
  node_user_repository["User Repository"]
end

subgraph group_security["Security"]
  node_user_details["User Details Service"]
  node_security_config["Security Configuration"]
end

node_client(("API Client"))
node_application["Application Bootstrap"]

node_client -.->|"sends requests"| node_course_controller
node_client -.->|"sends requests"| node_lecturer_controller
node_client -.->|"sends requests"| node_student_controller
node_client -.->|"sends requests"| node_user_controller
node_course_controller -.->|"delegates to"| node_course_service
node_lecturer_controller -.->|"delegates to"| node_lecturer_service
node_student_controller -.->|"delegates to"| node_student_service
node_user_controller -.->|"delegates to"| node_user_service
node_course_service -.->|"accesses data"| node_course_repository
node_lecturer_service -.->|"accesses data"| node_lecturer_repository
node_student_service -.->|"accesses data"| node_student_repository
node_user_service -.->|"accesses data"| node_user_repository
node_student_service -.->|"may raise"| node_student_not_found
node_course_repository -.->|"handles entity"| node_course_model
node_lecturer_repository -.->|"handles entity"| node_lecturer_model
node_student_repository -.->|"handles entity"| node_student_model
node_user_repository -.->|"handles entity"| node_user_model
node_security_config -.->|"configures auth"| node_user_details
node_application -.->|"starts application"| node_security_config

click node_application "https://github.com/its-tao/spring-boot-project/blob/main/src/main/java/com/example/demo/DemoApplication.java"
click node_course_controller "https://github.com/its-tao/spring-boot-project/blob/main/src/main/java/com/example/demo/controller/CourseController.java"
click node_lecturer_controller "https://github.com/its-tao/spring-boot-project/blob/main/src/main/java/com/example/demo/controller/LecturerController.java"
click node_student_controller "https://github.com/its-tao/spring-boot-project/blob/main/src/main/java/com/example/demo/controller/StudentController.java"
click node_user_controller "https://github.com/its-tao/spring-boot-project/blob/main/src/main/java/com/example/demo/controller/UserController.java"
click node_course_service "https://github.com/its-tao/spring-boot-project/blob/main/src/main/java/com/example/demo/service/CourseService.java"
click node_lecturer_service "https://github.com/its-tao/spring-boot-project/blob/main/src/main/java/com/example/demo/service/LecturerService.java"
click node_student_service "https://github.com/its-tao/spring-boot-project/blob/main/src/main/java/com/example/demo/service/StudentService.java"
click node_user_service "https://github.com/its-tao/spring-boot-project/blob/main/src/main/java/com/example/demo/service/UserService.java"
click node_student_not_found "https://github.com/its-tao/spring-boot-project/blob/main/src/main/java/com/example/demo/exception/StudentNotFoundException.java"
click node_course_repository "https://github.com/its-tao/spring-boot-project/blob/main/src/main/java/com/example/demo/repository/CourseRepository.java"
click node_lecturer_repository "https://github.com/its-tao/spring-boot-project/blob/main/src/main/java/com/example/demo/repository/LecturerRepository.java"
click node_student_repository "https://github.com/its-tao/spring-boot-project/blob/main/src/main/java/com/example/demo/repository/StudentRepository.java"
click node_user_repository "https://github.com/its-tao/spring-boot-project/blob/main/src/main/java/com/example/demo/repository/UserRepository.java"
click node_course_model "https://github.com/its-tao/spring-boot-project/blob/main/src/main/java/com/example/demo/model/Course.java"
click node_lecturer_model "https://github.com/its-tao/spring-boot-project/blob/main/src/main/java/com/example/demo/model/Lecturer.java"
click node_student_model "https://github.com/its-tao/spring-boot-project/blob/main/src/main/java/com/example/demo/model/Student.java"
click node_user_model "https://github.com/its-tao/spring-boot-project/blob/main/src/main/java/com/example/demo/model/User.java"
click node_user_details "https://github.com/its-tao/spring-boot-project/blob/main/src/main/java/com/example/demo/security/CustomUserDetailsService.java"
click node_security_config "https://github.com/its-tao/spring-boot-project/blob/main/src/main/java/com/example/demo/security/SecurityConfig.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_course_controller,node_lecturer_controller,node_student_controller,node_user_controller,node_client toneBlue
class node_course_service,node_lecturer_service,node_student_service,node_user_service,node_student_not_found,node_course_model,node_lecturer_model,node_student_model,node_user_model toneAmber
class node_course_repository,node_lecturer_repository,node_student_repository,node_user_repository toneMint
class node_user_details,node_security_config toneRose
class node_application toneTeal
```

## Components

### HTTP API

- [Course Controller](https://github.com/its-tao/spring-boot-project/blob/main/src/main/java/com/example/demo/controller/CourseController.java): `src/main/java/com/example/demo/controller/CourseController.java`
- [Lecturer Controller](https://github.com/its-tao/spring-boot-project/blob/main/src/main/java/com/example/demo/controller/LecturerController.java): `src/main/java/com/example/demo/controller/LecturerController.java`
- [Student Controller](https://github.com/its-tao/spring-boot-project/blob/main/src/main/java/com/example/demo/controller/StudentController.java): `src/main/java/com/example/demo/controller/StudentController.java`
- [User Controller](https://github.com/its-tao/spring-boot-project/blob/main/src/main/java/com/example/demo/controller/UserController.java): `src/main/java/com/example/demo/controller/UserController.java`

### Domain Services

- [Course Service](https://github.com/its-tao/spring-boot-project/blob/main/src/main/java/com/example/demo/service/CourseService.java): `src/main/java/com/example/demo/service/CourseService.java`
- [Lecturer Service](https://github.com/its-tao/spring-boot-project/blob/main/src/main/java/com/example/demo/service/LecturerService.java): `src/main/java/com/example/demo/service/LecturerService.java`
- [Student Service](https://github.com/its-tao/spring-boot-project/blob/main/src/main/java/com/example/demo/service/StudentService.java): `src/main/java/com/example/demo/service/StudentService.java`
- [User Service](https://github.com/its-tao/spring-boot-project/blob/main/src/main/java/com/example/demo/service/UserService.java): `src/main/java/com/example/demo/service/UserService.java`
- [Student Not Found](https://github.com/its-tao/spring-boot-project/blob/main/src/main/java/com/example/demo/exception/StudentNotFoundException.java): `src/main/java/com/example/demo/exception/StudentNotFoundException.java`
- [Course Model](https://github.com/its-tao/spring-boot-project/blob/main/src/main/java/com/example/demo/model/Course.java): `src/main/java/com/example/demo/model/Course.java`
- [Lecturer Model](https://github.com/its-tao/spring-boot-project/blob/main/src/main/java/com/example/demo/model/Lecturer.java): `src/main/java/com/example/demo/model/Lecturer.java`
- [Student Model](https://github.com/its-tao/spring-boot-project/blob/main/src/main/java/com/example/demo/model/Student.java): `src/main/java/com/example/demo/model/Student.java`
- [User Model](https://github.com/its-tao/spring-boot-project/blob/main/src/main/java/com/example/demo/model/User.java): `src/main/java/com/example/demo/model/User.java`

### Persistence

- [Course Repository](https://github.com/its-tao/spring-boot-project/blob/main/src/main/java/com/example/demo/repository/CourseRepository.java): `src/main/java/com/example/demo/repository/CourseRepository.java`
- [Lecturer Repository](https://github.com/its-tao/spring-boot-project/blob/main/src/main/java/com/example/demo/repository/LecturerRepository.java): `src/main/java/com/example/demo/repository/LecturerRepository.java`
- [Student Repository](https://github.com/its-tao/spring-boot-project/blob/main/src/main/java/com/example/demo/repository/StudentRepository.java): `src/main/java/com/example/demo/repository/StudentRepository.java`
- [User Repository](https://github.com/its-tao/spring-boot-project/blob/main/src/main/java/com/example/demo/repository/UserRepository.java): `src/main/java/com/example/demo/repository/UserRepository.java`

### Security

- [User Details Service](https://github.com/its-tao/spring-boot-project/blob/main/src/main/java/com/example/demo/security/CustomUserDetailsService.java): `src/main/java/com/example/demo/security/CustomUserDetailsService.java`
- [Security Configuration](https://github.com/its-tao/spring-boot-project/blob/main/src/main/java/com/example/demo/security/SecurityConfig.java): `src/main/java/com/example/demo/security/SecurityConfig.java`

### Other components

- **API Client**
- [Application Bootstrap](https://github.com/its-tao/spring-boot-project/blob/main/src/main/java/com/example/demo/DemoApplication.java): `src/main/java/com/example/demo/DemoApplication.java`

## Connections

- API Client → Course Controller: sends requests
- API Client → Lecturer Controller: sends requests
- API Client → Student Controller: sends requests
- API Client → User Controller: sends requests
- Course Controller → Course Service: delegates to
- Lecturer Controller → Lecturer Service: delegates to
- Student Controller → Student Service: delegates to
- User Controller → User Service: delegates to
- Course Service → Course Repository: accesses data
- Lecturer Service → Lecturer Repository: accesses data
- Student Service → Student Repository: accesses data
- User Service → User Repository: accesses data
- Student Service → Student Not Found: may raise
- Course Repository → Course Model: handles entity
- Lecturer Repository → Lecturer Model: handles entity
- Student Repository → Student Model: handles entity
- User Repository → User Model: handles entity
- Security Configuration → User Details Service: configures auth
- Application Bootstrap → Security Configuration: starts application
