# ayeshaahmed1573/student-management-system architecture

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

## Overview

This appears to be a Spring CRUD application for student records, with related department, marks, and profile resources, plus authentication and department reporting. The likely user workflow is to call the student API, have its service layer operate on persisted records, and receive a response; authentication and scheduled reporting are separate capabilities. The tree supports these component roles, but no README or source excerpts were supplied, so the relationships below are dashed and unverified rather than asserted as observed calls.

Main entry points: [`src/main/java/com/example/crudApp/controller/StudentController.java`](https://github.com/ayeshaahmed1573/student-management-system/blob/master/src/main/java/com/example/crudApp/controller/StudentController.java) (Student API), [`src/main/java/com/example/crudApp/controller/StudentDepartmentController.java`](https://github.com/ayeshaahmed1573/student-management-system/blob/master/src/main/java/com/example/crudApp/controller/StudentDepartmentController.java) (Department API), [`src/main/java/com/example/crudApp/controller/StudentMarksController.java`](https://github.com/ayeshaahmed1573/student-management-system/blob/master/src/main/java/com/example/crudApp/controller/StudentMarksController.java) (Marks API), [`src/main/java/com/example/crudApp/controller/StudentProfileController.java`](https://github.com/ayeshaahmed1573/student-management-system/blob/master/src/main/java/com/example/crudApp/controller/StudentProfileController.java) (Profile API)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_api["API"]
  node_student_api["Student API"]
  node_department_api["Department API"]
  node_marks_api["Marks API"]
  node_profile_api["Profile API"]
end

subgraph group_domain["Student domain"]
  node_student_service["Student service"]
  node_department_service["Department service"]
  node_marks_service["Marks service"]
  node_profile_service["Profile service"]
  node_student_repository["Student repository"]
  node_department_repository["Department repository"]
  node_marks_repository["Marks repository"]
  node_profile_repository["Profile repository"]
end

subgraph group_identity["Identity"]
  node_auth_api["Authentication API"]
  node_auth_service["Authentication service"]
  node_security["JWT security<br/>[JwtAuthFilter.java]"]
end

subgraph group_reporting["Reporting and integrations"]
  node_report_job["Report job<br/>[ReportJob.java]"]
  node_report_repository["Report repository"]
  node_email_service["Email service"]
end

node_caller(("API caller"))
node_database[("Application database")]
node_email_provider(("Email provider"))

node_caller -.->|"calls"| node_student_api
node_caller -.->|"calls"| node_department_api
node_caller -.->|"calls"| node_marks_api
node_caller -.->|"calls"| node_profile_api
node_student_api -.->|"delegates to"| node_student_service
node_department_api -.->|"delegates to"| node_department_service
node_marks_api -.->|"delegates to"| node_marks_service
node_profile_api -.->|"delegates to"| node_profile_service
node_student_service -.->|"accesses"| node_student_repository
node_department_service -.->|"accesses"| node_department_repository
node_marks_service -.->|"accesses"| node_marks_repository
node_profile_service -.->|"accesses"| node_profile_repository
node_student_repository -.->|"persists data"| node_database
node_department_repository -.->|"persists data"| node_database
node_marks_repository -.->|"persists data"| node_database
node_profile_repository -.->|"persists data"| node_database
node_caller -.->|"authenticates"| node_auth_api
node_auth_api -.->|"delegates to"| node_auth_service
node_report_job -.->|"uses"| node_report_repository
node_email_service -.->|"sends mail"| node_email_provider

click node_student_api "https://github.com/ayeshaahmed1573/student-management-system/blob/master/src/main/java/com/example/crudApp/controller/StudentController.java"
click node_department_api "https://github.com/ayeshaahmed1573/student-management-system/blob/master/src/main/java/com/example/crudApp/controller/StudentDepartmentController.java"
click node_marks_api "https://github.com/ayeshaahmed1573/student-management-system/blob/master/src/main/java/com/example/crudApp/controller/StudentMarksController.java"
click node_profile_api "https://github.com/ayeshaahmed1573/student-management-system/blob/master/src/main/java/com/example/crudApp/controller/StudentProfileController.java"
click node_student_service "https://github.com/ayeshaahmed1573/student-management-system/blob/master/src/main/java/com/example/crudApp/service/serviceimpl/StudentServiceImpl.java"
click node_department_service "https://github.com/ayeshaahmed1573/student-management-system/blob/master/src/main/java/com/example/crudApp/service/serviceimpl/StudentDepartmentServiceImpl.java"
click node_marks_service "https://github.com/ayeshaahmed1573/student-management-system/blob/master/src/main/java/com/example/crudApp/service/serviceimpl/StudentMarksServiceImpl.java"
click node_profile_service "https://github.com/ayeshaahmed1573/student-management-system/blob/master/src/main/java/com/example/crudApp/service/serviceimpl/StudentProfileServiceImpl.java"
click node_student_repository "https://github.com/ayeshaahmed1573/student-management-system/blob/master/src/main/java/com/example/crudApp/repository/StudentRepository.java"
click node_department_repository "https://github.com/ayeshaahmed1573/student-management-system/blob/master/src/main/java/com/example/crudApp/repository/StudentDepartmentRepository.java"
click node_marks_repository "https://github.com/ayeshaahmed1573/student-management-system/blob/master/src/main/java/com/example/crudApp/repository/StudentMarksRepository.java"
click node_profile_repository "https://github.com/ayeshaahmed1573/student-management-system/blob/master/src/main/java/com/example/crudApp/repository/StudentProfileRepository.java"
click node_auth_api "https://github.com/ayeshaahmed1573/student-management-system/blob/master/src/main/java/com/example/crudApp/controller/AuthController.java"
click node_auth_service "https://github.com/ayeshaahmed1573/student-management-system/blob/master/src/main/java/com/example/crudApp/service/serviceimpl/AuthServiceImpl.java"
click node_security "https://github.com/ayeshaahmed1573/student-management-system/blob/master/src/main/java/com/example/crudApp/security/JwtAuthFilter.java"
click node_report_job "https://github.com/ayeshaahmed1573/student-management-system/blob/master/src/main/java/com/example/crudApp/job/ReportJob.java"
click node_report_repository "https://github.com/ayeshaahmed1573/student-management-system/blob/master/src/main/java/com/example/crudApp/repository/DepartmentReportRepository.java"
click node_email_service "https://github.com/ayeshaahmed1573/student-management-system/blob/master/src/main/java/com/example/crudApp/service/serviceimpl/EmailServiceImpl.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_api,node_department_api,node_marks_api,node_profile_api toneBlue
class node_student_service,node_department_service,node_marks_service,node_profile_service,node_student_repository,node_department_repository,node_marks_repository,node_profile_repository,node_database toneAmber
class node_auth_api,node_auth_service,node_security,node_caller toneMint
class node_report_job,node_report_repository,node_email_service toneRose
class node_email_provider toneIndigo
```

## Components

### API

- [Student API](https://github.com/ayeshaahmed1573/student-management-system/blob/master/src/main/java/com/example/crudApp/controller/StudentController.java): `src/main/java/com/example/crudApp/controller/StudentController.java`
- [Department API](https://github.com/ayeshaahmed1573/student-management-system/blob/master/src/main/java/com/example/crudApp/controller/StudentDepartmentController.java): `src/main/java/com/example/crudApp/controller/StudentDepartmentController.java`
- [Marks API](https://github.com/ayeshaahmed1573/student-management-system/blob/master/src/main/java/com/example/crudApp/controller/StudentMarksController.java): `src/main/java/com/example/crudApp/controller/StudentMarksController.java`
- [Profile API](https://github.com/ayeshaahmed1573/student-management-system/blob/master/src/main/java/com/example/crudApp/controller/StudentProfileController.java): `src/main/java/com/example/crudApp/controller/StudentProfileController.java`

### Student domain

- [Student service](https://github.com/ayeshaahmed1573/student-management-system/blob/master/src/main/java/com/example/crudApp/service/serviceimpl/StudentServiceImpl.java): `src/main/java/com/example/crudApp/service/serviceimpl/StudentServiceImpl.java`
- [Department service](https://github.com/ayeshaahmed1573/student-management-system/blob/master/src/main/java/com/example/crudApp/service/serviceimpl/StudentDepartmentServiceImpl.java): `src/main/java/com/example/crudApp/service/serviceimpl/StudentDepartmentServiceImpl.java`
- [Marks service](https://github.com/ayeshaahmed1573/student-management-system/blob/master/src/main/java/com/example/crudApp/service/serviceimpl/StudentMarksServiceImpl.java): `src/main/java/com/example/crudApp/service/serviceimpl/StudentMarksServiceImpl.java`
- [Profile service](https://github.com/ayeshaahmed1573/student-management-system/blob/master/src/main/java/com/example/crudApp/service/serviceimpl/StudentProfileServiceImpl.java): `src/main/java/com/example/crudApp/service/serviceimpl/StudentProfileServiceImpl.java`
- [Student repository](https://github.com/ayeshaahmed1573/student-management-system/blob/master/src/main/java/com/example/crudApp/repository/StudentRepository.java): `src/main/java/com/example/crudApp/repository/StudentRepository.java`
- [Department repository](https://github.com/ayeshaahmed1573/student-management-system/blob/master/src/main/java/com/example/crudApp/repository/StudentDepartmentRepository.java): `src/main/java/com/example/crudApp/repository/StudentDepartmentRepository.java`
- [Marks repository](https://github.com/ayeshaahmed1573/student-management-system/blob/master/src/main/java/com/example/crudApp/repository/StudentMarksRepository.java): `src/main/java/com/example/crudApp/repository/StudentMarksRepository.java`
- [Profile repository](https://github.com/ayeshaahmed1573/student-management-system/blob/master/src/main/java/com/example/crudApp/repository/StudentProfileRepository.java): `src/main/java/com/example/crudApp/repository/StudentProfileRepository.java`

### Identity

- [Authentication API](https://github.com/ayeshaahmed1573/student-management-system/blob/master/src/main/java/com/example/crudApp/controller/AuthController.java): `src/main/java/com/example/crudApp/controller/AuthController.java`
- [Authentication service](https://github.com/ayeshaahmed1573/student-management-system/blob/master/src/main/java/com/example/crudApp/service/serviceimpl/AuthServiceImpl.java): `src/main/java/com/example/crudApp/service/serviceimpl/AuthServiceImpl.java`
- [JWT security](https://github.com/ayeshaahmed1573/student-management-system/blob/master/src/main/java/com/example/crudApp/security/JwtAuthFilter.java): `src/main/java/com/example/crudApp/security/JwtAuthFilter.java`

### Reporting and integrations

- [Report job](https://github.com/ayeshaahmed1573/student-management-system/blob/master/src/main/java/com/example/crudApp/job/ReportJob.java): `src/main/java/com/example/crudApp/job/ReportJob.java`
- [Report repository](https://github.com/ayeshaahmed1573/student-management-system/blob/master/src/main/java/com/example/crudApp/repository/DepartmentReportRepository.java): `src/main/java/com/example/crudApp/repository/DepartmentReportRepository.java`
- [Email service](https://github.com/ayeshaahmed1573/student-management-system/blob/master/src/main/java/com/example/crudApp/service/serviceimpl/EmailServiceImpl.java): `src/main/java/com/example/crudApp/service/serviceimpl/EmailServiceImpl.java`

### Other components

- **API caller**
- **Application database**
- **Email provider**

## Connections

- API caller → Student API: calls
- API caller → Department API: calls
- API caller → Marks API: calls
- API caller → Profile API: calls
- Student API → Student service: delegates to
- Department API → Department service: delegates to
- Marks API → Marks service: delegates to
- Profile API → Profile service: delegates to
- Student service → Student repository: accesses
- Department service → Department repository: accesses
- Marks service → Marks repository: accesses
- Profile service → Profile repository: accesses
- Student repository → Application database: persists data
- Department repository → Application database: persists data
- Marks repository → Application database: persists data
- Profile repository → Application database: persists data
- API caller → Authentication API: authenticates
- Authentication API → Authentication service: delegates to
- Report job → Report repository: uses
- Email service → Email provider: sends mail
