# selvacoding/student-details architecture

> Architecture diagram of the GitHub repository selvacoding/student-details, 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/selvacoding/student-details
- Repository: https://github.com/selvacoding/student-details

## Overview

This Spring Boot application exposes REST operations for creating, listing, retrieving, searching, and deleting students, plus creating and listing schools. The student workflow validates request data, maps DTOs to entities, persists through Spring Data JPA, and maps results back to response DTOs; school operations follow a similar service-and-repository pattern. The README identifies PostgreSQL as the database. The graph reflects the sampled student implementation and indexed school references; unsampled wiring is not inferred.

Main entry points: [`restful/src/main/java/com/restful/restful/student/Student.java`](https://github.com/selvacoding/student-details/blob/main/restful/src/main/java/com/restful/restful/student/Student.java) (Student Entity), [`restful/src/main/java/com/restful/restful/student/StudentController.java`](https://github.com/selvacoding/student-details/blob/main/restful/src/main/java/com/restful/restful/student/StudentController.java) (Student Controller), [`restful/src/main/java/com/restful/restful/school/SchoolController.java`](https://github.com/selvacoding/student-details/blob/main/restful/src/main/java/com/restful/restful/school/SchoolController.java) (School Controller), [`restful/src/main/java/com/restful/restful/student/StudentService.java`](https://github.com/selvacoding/student-details/blob/main/restful/src/main/java/com/restful/restful/student/StudentService.java) (Student Service)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_api["REST API"]
  node_student_controller["Student Controller"]
  node_school_controller["School Controller"]
  node_student_dto["Student DTOs<br/>[StudentDto.java]"]
  node_school_dto["School DTOs<br/>[SchoolDto.java]"]
end

subgraph group_services["Domain Services"]
  node_student_service["Student Service"]
  node_school_service["School Service<br/>[SchoolService.java]"]
  node_student_mapper["Student Mapper<br/>[StudentMapper.java]"]
  node_school_mapper["School Mapper<br/>[SchoolMapper.java]"]
end

subgraph group_persistence["Persistence Model"]
  node_student_repository["Student Repository"]
  node_school_repository["School Repository"]
  node_student_entity["Student Entity<br/>[Student.java]"]
  node_school_entity["School Entity<br/>[School.java]"]
  node_profile_entity["Student Profile"]
end

node_client(("API Client"))
node_postgres[("PostgreSQL")]

node_client -->|"calls REST"| node_student_controller
node_client -.->|"calls REST"| node_school_controller
node_student_controller -->|"delegates to"| node_student_service
node_school_controller -->|"delegates to"| node_school_service
node_student_controller -->|"accepts and returns"| node_student_dto
node_school_controller -->|"accepts and returns"| node_school_dto
node_student_service -->|"maps data"| node_student_mapper
node_student_service -->|"queries and saves"| node_student_repository
node_school_service -->|"maps data"| node_school_mapper
node_school_service -->|"queries and saves"| node_school_repository
node_student_mapper -->|"creates and reads"| node_student_entity
node_student_mapper -->|"maps to and from"| node_student_dto
node_school_mapper -->|"maps entity"| node_school_entity
node_school_mapper -->|"maps to and from"| node_school_dto
node_student_repository -->|"persists"| node_student_entity
node_school_repository -->|"persists"| node_school_entity
node_student_repository -->|"JPA storage"| node_postgres
node_school_repository -->|"JPA storage"| node_postgres
node_student_entity -->|"references school"| node_school_entity
node_student_entity -->|"one-to-one relation"| node_profile_entity

click node_student_controller "https://github.com/selvacoding/student-details/blob/main/restful/src/main/java/com/restful/restful/student/StudentController.java"
click node_school_controller "https://github.com/selvacoding/student-details/blob/main/restful/src/main/java/com/restful/restful/school/SchoolController.java"
click node_student_service "https://github.com/selvacoding/student-details/blob/main/restful/src/main/java/com/restful/restful/student/StudentService.java"
click node_school_service "https://github.com/selvacoding/student-details/blob/main/restful/src/main/java/com/restful/restful/school/SchoolService.java"
click node_student_mapper "https://github.com/selvacoding/student-details/blob/main/restful/src/main/java/com/restful/restful/student/StudentMapper.java"
click node_school_mapper "https://github.com/selvacoding/student-details/blob/main/restful/src/main/java/com/restful/restful/school/SchoolMapper.java"
click node_student_dto "https://github.com/selvacoding/student-details/blob/main/restful/src/main/java/com/restful/restful/student/StudentDto.java"
click node_school_dto "https://github.com/selvacoding/student-details/blob/main/restful/src/main/java/com/restful/restful/school/SchoolDto.java"
click node_student_repository "https://github.com/selvacoding/student-details/blob/main/restful/src/main/java/com/restful/restful/student/StudentRepository.java"
click node_school_repository "https://github.com/selvacoding/student-details/blob/main/restful/src/main/java/com/restful/restful/school/SchoolRepository.java"
click node_student_entity "https://github.com/selvacoding/student-details/blob/main/restful/src/main/java/com/restful/restful/student/Student.java"
click node_school_entity "https://github.com/selvacoding/student-details/blob/main/restful/src/main/java/com/restful/restful/school/School.java"
click node_profile_entity "https://github.com/selvacoding/student-details/blob/main/restful/src/main/java/com/restful/restful/student_profile/StudentProfile.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_school_controller,node_student_dto,node_school_dto,node_client toneBlue
class node_student_service,node_school_service,node_student_mapper,node_school_mapper,node_postgres toneAmber
class node_student_repository,node_school_repository,node_student_entity,node_school_entity,node_profile_entity toneMint
```

## Components

### REST API

- [Student Controller](https://github.com/selvacoding/student-details/blob/main/restful/src/main/java/com/restful/restful/student/StudentController.java): `restful/src/main/java/com/restful/restful/student/StudentController.java`
- [School Controller](https://github.com/selvacoding/student-details/blob/main/restful/src/main/java/com/restful/restful/school/SchoolController.java): `restful/src/main/java/com/restful/restful/school/SchoolController.java`
- [Student DTOs](https://github.com/selvacoding/student-details/blob/main/restful/src/main/java/com/restful/restful/student/StudentDto.java): `restful/src/main/java/com/restful/restful/student/StudentDto.java`
- [School DTOs](https://github.com/selvacoding/student-details/blob/main/restful/src/main/java/com/restful/restful/school/SchoolDto.java): `restful/src/main/java/com/restful/restful/school/SchoolDto.java`

### Domain Services

- [Student Service](https://github.com/selvacoding/student-details/blob/main/restful/src/main/java/com/restful/restful/student/StudentService.java): `restful/src/main/java/com/restful/restful/student/StudentService.java`
- [School Service](https://github.com/selvacoding/student-details/blob/main/restful/src/main/java/com/restful/restful/school/SchoolService.java): `restful/src/main/java/com/restful/restful/school/SchoolService.java`
- [Student Mapper](https://github.com/selvacoding/student-details/blob/main/restful/src/main/java/com/restful/restful/student/StudentMapper.java): `restful/src/main/java/com/restful/restful/student/StudentMapper.java`
- [School Mapper](https://github.com/selvacoding/student-details/blob/main/restful/src/main/java/com/restful/restful/school/SchoolMapper.java): `restful/src/main/java/com/restful/restful/school/SchoolMapper.java`

### Persistence Model

- [Student Repository](https://github.com/selvacoding/student-details/blob/main/restful/src/main/java/com/restful/restful/student/StudentRepository.java): `restful/src/main/java/com/restful/restful/student/StudentRepository.java`
- [School Repository](https://github.com/selvacoding/student-details/blob/main/restful/src/main/java/com/restful/restful/school/SchoolRepository.java): `restful/src/main/java/com/restful/restful/school/SchoolRepository.java`
- [Student Entity](https://github.com/selvacoding/student-details/blob/main/restful/src/main/java/com/restful/restful/student/Student.java): `restful/src/main/java/com/restful/restful/student/Student.java`
- [School Entity](https://github.com/selvacoding/student-details/blob/main/restful/src/main/java/com/restful/restful/school/School.java): `restful/src/main/java/com/restful/restful/school/School.java`
- [Student Profile](https://github.com/selvacoding/student-details/blob/main/restful/src/main/java/com/restful/restful/student_profile/StudentProfile.java): `restful/src/main/java/com/restful/restful/student_profile/StudentProfile.java`

### Other components

- **API Client**
- **PostgreSQL**

## Connections

- API Client → Student Controller: calls REST (evidence: `restful/src/main/java/com/restful/restful/student/StudentController.java`)
- API Client → School Controller: calls REST
- Student Controller → Student Service: delegates to (evidence: `restful/src/main/java/com/restful/restful/student/StudentController.java`)
- School Controller → School Service: delegates to (evidence: `restful/src/main/java/com/restful/restful/school/SchoolController.java`)
- Student Controller → Student DTOs: accepts and returns (evidence: `restful/src/main/java/com/restful/restful/student/StudentController.java`)
- School Controller → School DTOs: accepts and returns (evidence: `restful/src/main/java/com/restful/restful/school/SchoolController.java`)
- Student Service → Student Mapper: maps data (evidence: `restful/src/main/java/com/restful/restful/student/StudentService.java`)
- Student Service → Student Repository: queries and saves (evidence: `restful/src/main/java/com/restful/restful/student/StudentService.java`)
- School Service → School Mapper: maps data (evidence: `restful/src/main/java/com/restful/restful/school/SchoolService.java`)
- School Service → School Repository: queries and saves (evidence: `restful/src/main/java/com/restful/restful/school/SchoolService.java`)
- Student Mapper → Student Entity: creates and reads (evidence: `restful/src/main/java/com/restful/restful/student/StudentMapper.java`)
- Student Mapper → Student DTOs: maps to and from (evidence: `restful/src/main/java/com/restful/restful/student/StudentMapper.java`)
- School Mapper → School Entity: maps entity (evidence: `restful/src/main/java/com/restful/restful/school/SchoolMapper.java`)
- School Mapper → School DTOs: maps to and from (evidence: `restful/src/main/java/com/restful/restful/school/SchoolMapper.java`)
- Student Repository → Student Entity: persists (evidence: `restful/src/main/java/com/restful/restful/student/StudentRepository.java`)
- School Repository → School Entity: persists (evidence: `restful/src/main/java/com/restful/restful/school/SchoolRepository.java`)
- Student Repository → PostgreSQL: JPA storage (evidence: `README.md`)
- School Repository → PostgreSQL: JPA storage (evidence: `README.md`)
- Student Entity → School Entity: references school (evidence: `restful/src/main/java/com/restful/restful/student/Student.java`)
- Student Entity → Student Profile: one-to-one relation (evidence: `restful/src/main/java/com/restful/restful/student/Student.java`)
