# allover555/leave-management-system architecture

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

- Interactive diagram: https://gitdiagram.com/allover555/leave-management-system
- Repository: https://github.com/allover555/leave-management-system

## Overview

This is a role-based university leave-management system: students register, submit applications with attachments, follow multi-stage approvals, and request cancellation/leave-close review; counselors approve and view class activity, while administrators configure users, classes, leave types, and approval flows. Vue pages call a Spring Boot API backed by JPA persistence, with JWT access control, messaging, statistics, and Excel export. The leave submission, approval advancement, and notification calls are visible in the sampled service; broader capability links rely on README documentation because many modules were not excerpted.

Main entry points: [`backend/src/main/java/com/leave/service/LeaveApplicationService.java`](https://github.com/allover555/leave-management-system/blob/main/backend/src/main/java/com/leave/service/LeaveApplicationService.java) (Application and approval logic), [`backend/src/main/java/com/leave/repository`](https://github.com/allover555/leave-management-system/tree/main/backend/src/main/java/com/leave/repository) (JPA repositories), [`frontend/src/api`](https://github.com/allover555/leave-management-system/tree/main/frontend/src/api) (API clients), [`frontend/src/router/index.js`](https://github.com/allover555/leave-management-system/blob/main/frontend/src/router/index.js) (Role-aware routes)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Web client"]
  node_router["Role-aware routes<br/>[index.js]"]
  node_leaveui["Leave and approval pages"]
  node_adminui["Admin and statistics pages"]
  node_api["API clients"]
end

subgraph group_identity["Identity and access"]
  node_authcontroller["Authentication endpoints"]
  node_authservice["Registration and login<br/>[AuthService.java]"]
  node_security["JWT authorization"]
end

subgraph group_leave["Leave workflow"]
  node_leavecontroller["Leave endpoints"]
  node_leaveservice["Application and approval logic"]
  node_attachments["Uploaded attachments"]
  node_cancellation["Cancellation review"]
end

subgraph group_operations["Administration and insight"]
  node_admincontroller["Administration endpoints"]
  node_userservice["User management<br/>[UserService.java]"]
  node_statistics["Statistics and export"]
  node_files["File download endpoints"]
end

subgraph group_data["Persistence and messaging"]
  node_messages["Message notifications"]
  node_leaveentities["Leave and flow records"]
  node_userentities["User and role records<br/>[SysUser.java]"]
  node_repository["JPA repositories"]
  node_database[("MySQL database")]
end

node_user(("Students and staff"))

node_user -->|"opens pages"| node_router
node_router -->|"routes to"| node_leaveui
node_router -->|"routes to"| node_adminui
node_user -.->|"uses"| node_api
node_api -.->|"calls API"| node_authcontroller
node_api -.->|"calls API"| node_leavecontroller
node_api -.->|"calls API"| node_admincontroller
node_authcontroller -->|"delegates to"| node_authservice
node_authservice -->|"loads and saves"| node_userentities
node_authservice -->|"generates token"| node_security
node_user -.->|"submits or reviews"| node_leavecontroller
node_leavecontroller -->|"delegates leave actions"| node_leaveservice
node_leaveservice -->|"persists applications"| node_leaveentities
node_leaveservice -->|"saves files"| node_attachments
node_leaveservice -->|"handles close requests"| node_cancellation
node_leaveservice -->|"sends notifications"| node_messages
node_admincontroller -->|"reads and writes configuration"| node_repository
node_admincontroller -.->|"manages users"| node_userservice
node_user -.->|"views reports"| node_statistics
node_statistics -.->|"queries leave data"| node_repository
node_statistics -.->|"exports Excel"| node_user
node_files -.->|"serves uploads"| node_attachments
node_repository -.->|"reads and writes"| node_database
node_repository -->|"maps records"| node_leaveentities
node_repository -->|"maps records"| node_userentities

click node_router "https://github.com/allover555/leave-management-system/blob/main/frontend/src/router/index.js"
click node_leaveui "https://github.com/allover555/leave-management-system/tree/main/frontend/src/views"
click node_adminui "https://github.com/allover555/leave-management-system/tree/main/frontend/src/views/admin"
click node_api "https://github.com/allover555/leave-management-system/tree/main/frontend/src/api"
click node_authcontroller "https://github.com/allover555/leave-management-system/blob/main/backend/src/main/java/com/leave/controller/AuthController.java"
click node_authservice "https://github.com/allover555/leave-management-system/blob/main/backend/src/main/java/com/leave/service/AuthService.java"
click node_security "https://github.com/allover555/leave-management-system/tree/main/backend/src/main/java/com/leave/security"
click node_leavecontroller "https://github.com/allover555/leave-management-system/blob/main/backend/src/main/java/com/leave/controller/LeaveController.java"
click node_leaveservice "https://github.com/allover555/leave-management-system/blob/main/backend/src/main/java/com/leave/service/LeaveApplicationService.java"
click node_attachments "https://github.com/allover555/leave-management-system/blob/main/backend/src/main/java/com/leave/service/LeaveApplicationService.java"
click node_cancellation "https://github.com/allover555/leave-management-system/blob/main/backend/src/main/java/com/leave/service/LeaveApplicationService.java"
click node_admincontroller "https://github.com/allover555/leave-management-system/blob/main/backend/src/main/java/com/leave/controller/AdminController.java"
click node_userservice "https://github.com/allover555/leave-management-system/blob/main/backend/src/main/java/com/leave/service/UserService.java"
click node_statistics "https://github.com/allover555/leave-management-system/tree/main/backend/src/main/java/com/leave/service"
click node_files "https://github.com/allover555/leave-management-system/blob/main/backend/src/main/java/com/leave/controller/FileController.java"
click node_messages "https://github.com/allover555/leave-management-system/blob/main/backend/src/main/java/com/leave/service/MessageService.java"
click node_leaveentities "https://github.com/allover555/leave-management-system/blob/main/backend/src/main/java/com/leave/entity/LeaveApplication.java"
click node_userentities "https://github.com/allover555/leave-management-system/blob/main/backend/src/main/java/com/leave/entity/SysUser.java"
click node_repository "https://github.com/allover555/leave-management-system/tree/main/backend/src/main/java/com/leave/repository"

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_router,node_leaveui,node_adminui,node_api toneBlue
class node_authcontroller,node_authservice,node_security toneAmber
class node_leavecontroller,node_leaveservice,node_attachments,node_cancellation toneMint
class node_admincontroller,node_userservice,node_statistics,node_files toneRose
class node_messages,node_leaveentities,node_userentities,node_repository,node_database,node_user toneIndigo
```

## Components

### Web client

- [Role-aware routes](https://github.com/allover555/leave-management-system/blob/main/frontend/src/router/index.js): `frontend/src/router/index.js`
- [Leave and approval pages](https://github.com/allover555/leave-management-system/tree/main/frontend/src/views): `frontend/src/views`
- [Admin and statistics pages](https://github.com/allover555/leave-management-system/tree/main/frontend/src/views/admin): `frontend/src/views/admin`
- [API clients](https://github.com/allover555/leave-management-system/tree/main/frontend/src/api): `frontend/src/api`

### Identity and access

- [Authentication endpoints](https://github.com/allover555/leave-management-system/blob/main/backend/src/main/java/com/leave/controller/AuthController.java): `backend/src/main/java/com/leave/controller/AuthController.java`
- [Registration and login](https://github.com/allover555/leave-management-system/blob/main/backend/src/main/java/com/leave/service/AuthService.java): `backend/src/main/java/com/leave/service/AuthService.java`
- [JWT authorization](https://github.com/allover555/leave-management-system/tree/main/backend/src/main/java/com/leave/security): `backend/src/main/java/com/leave/security`

### Leave workflow

- [Leave endpoints](https://github.com/allover555/leave-management-system/blob/main/backend/src/main/java/com/leave/controller/LeaveController.java): `backend/src/main/java/com/leave/controller/LeaveController.java`
- [Application and approval logic](https://github.com/allover555/leave-management-system/blob/main/backend/src/main/java/com/leave/service/LeaveApplicationService.java): `backend/src/main/java/com/leave/service/LeaveApplicationService.java`
- [Uploaded attachments](https://github.com/allover555/leave-management-system/blob/main/backend/src/main/java/com/leave/service/LeaveApplicationService.java): `backend/src/main/java/com/leave/service/LeaveApplicationService.java`
- [Cancellation review](https://github.com/allover555/leave-management-system/blob/main/backend/src/main/java/com/leave/service/LeaveApplicationService.java): `backend/src/main/java/com/leave/service/LeaveApplicationService.java`

### Administration and insight

- [Administration endpoints](https://github.com/allover555/leave-management-system/blob/main/backend/src/main/java/com/leave/controller/AdminController.java): `backend/src/main/java/com/leave/controller/AdminController.java`
- [User management](https://github.com/allover555/leave-management-system/blob/main/backend/src/main/java/com/leave/service/UserService.java): `backend/src/main/java/com/leave/service/UserService.java`
- [Statistics and export](https://github.com/allover555/leave-management-system/tree/main/backend/src/main/java/com/leave/service): `backend/src/main/java/com/leave/service`
- [File download endpoints](https://github.com/allover555/leave-management-system/blob/main/backend/src/main/java/com/leave/controller/FileController.java): `backend/src/main/java/com/leave/controller/FileController.java`

### Persistence and messaging

- [Message notifications](https://github.com/allover555/leave-management-system/blob/main/backend/src/main/java/com/leave/service/MessageService.java): `backend/src/main/java/com/leave/service/MessageService.java`
- [Leave and flow records](https://github.com/allover555/leave-management-system/blob/main/backend/src/main/java/com/leave/entity/LeaveApplication.java): `backend/src/main/java/com/leave/entity/LeaveApplication.java`
- [User and role records](https://github.com/allover555/leave-management-system/blob/main/backend/src/main/java/com/leave/entity/SysUser.java): `backend/src/main/java/com/leave/entity/SysUser.java`
- [JPA repositories](https://github.com/allover555/leave-management-system/tree/main/backend/src/main/java/com/leave/repository): `backend/src/main/java/com/leave/repository`
- **MySQL database**

### Other components

- **Students and staff**

## Connections

- Students and staff → Role-aware routes: opens pages (evidence: `frontend/src/router/index.js`)
- Role-aware routes → Leave and approval pages: routes to (evidence: `frontend/src/router/index.js`)
- Role-aware routes → Admin and statistics pages: routes to (evidence: `frontend/src/router/index.js`)
- Students and staff → API clients: uses (evidence: `README.md`)
- API clients → Authentication endpoints: calls API (evidence: `README.md`)
- API clients → Leave endpoints: calls API (evidence: `README.md`)
- API clients → Administration endpoints: calls API (evidence: `README.md`)
- Authentication endpoints → Registration and login: delegates to (evidence: `backend/src/main/java/com/leave/controller/AuthController.java`)
- Registration and login → User and role records: loads and saves (evidence: `backend/src/main/java/com/leave/service/AuthService.java`)
- Registration and login → JWT authorization: generates token (evidence: `backend/src/main/java/com/leave/service/AuthService.java`)
- Students and staff → Leave endpoints: submits or reviews (evidence: `README.md`)
- Leave endpoints → Application and approval logic: delegates leave actions (evidence: `backend/src/main/java/com/leave/controller/LeaveController.java`)
- Application and approval logic → Leave and flow records: persists applications (evidence: `backend/src/main/java/com/leave/service/LeaveApplicationService.java`)
- Application and approval logic → Uploaded attachments: saves files (evidence: `backend/src/main/java/com/leave/service/LeaveApplicationService.java`)
- Application and approval logic → Cancellation review: handles close requests (evidence: `backend/src/main/java/com/leave/controller/LeaveController.java`)
- Application and approval logic → Message notifications: sends notifications (evidence: `backend/src/main/java/com/leave/service/LeaveApplicationService.java`)
- Administration endpoints → JPA repositories: reads and writes configuration (evidence: `backend/src/main/java/com/leave/controller/AdminController.java`)
- Administration endpoints → User management: manages users (evidence: `README.md`)
- Students and staff → Statistics and export: views reports (evidence: `README.md`)
- Statistics and export → JPA repositories: queries leave data (evidence: `README.md`)
- Statistics and export → Students and staff: exports Excel (evidence: `README.md`)
- File download endpoints → Uploaded attachments: serves uploads (evidence: `README.md`)
- JPA repositories → MySQL database: reads and writes (evidence: `README.md`)
- JPA repositories → Leave and flow records: maps records (evidence: `backend/src/main/java/com/leave/repository/LeaveApplicationRepository.java`)
- JPA repositories → User and role records: maps records (evidence: `backend/src/main/java/com/leave/repository/SysUserRepository.java`)
