# sushanth0711-source/hrms architecture

> Architecture diagram of the GitHub repository sushanth0711-source/hrms, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-07). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/sushanth0711-source/hrms
- Repository: https://github.com/sushanth0711-source/hrms

## Overview

HRMS is a role-based employee, attendance, leave, and payroll REST application. Users authenticate and then use role-appropriate APIs for employee records, attendance, leave requests, and payslips; HR/Admin workflows also manage departments, holidays, users, and payroll. The documented backend follows Controller → Service → Repository → JPA Entity → MySQL. Major capabilities are represented even where their implementation was not sampled; those links are documented rather than inferred from unseen code. The repository tree shows only a shared static JavaScript file, so the broader UI is not mapped.

Main entry points: [`src/main/java/com/company/hrms/repository`](https://github.com/sushanth0711-source/hrms/tree/main/src/main/java/com/company/hrms/repository) (JPA repositories), [`src/main/java/com/company/hrms/service/AttendanceService.java`](https://github.com/sushanth0711-source/hrms/blob/main/src/main/java/com/company/hrms/service/AttendanceService.java) (Attendance and summaries), [`src/main/java/com/company/hrms/service/UserService.java`](https://github.com/sushanth0711-source/hrms/blob/main/src/main/java/com/company/hrms/service/UserService.java) (User accounts), [`src/main/java/com/company/hrms/service/AuthService.java`](https://github.com/sushanth0711-source/hrms/blob/main/src/main/java/com/company/hrms/service/AuthService.java) (Authentication service)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_access["Identity and Access"]
  node_auth_api["Authentication API"]
  node_auth_service["Authentication service<br/>[AuthService.java]"]
  node_jwt["JWT filter and utility<br/>[JwtAuthFilter.java]"]
  node_user_api["User administration API"]
  node_user_service["User accounts<br/>[UserService.java]"]
end

subgraph group_people["People Management"]
  node_employee_api["Employee API"]
  node_employee_service["Employee records"]
  node_department_api["Department API"]
  node_department_service["Department management"]
end

subgraph group_work["Work and Leave"]
  node_attendance_api["Attendance API"]
  node_attendance_service["Attendance and summaries"]
  node_leave_api["Leave API"]
  node_leave_service["Leave requests and balances<br/>[LeaveService.java]"]
  node_holiday_api["Holiday API"]
  node_holiday_service["Holiday calendar"]
  node_calendar["Working-day calendar"]
end

subgraph group_pay["Payroll"]
  node_payroll_api["Payroll and payslip API"]
  node_payroll_service["Payroll calculation"]
  node_salary_api["Salary component API"]
  node_salary_service["Salary components"]
end

subgraph group_platform["Persistence and API"]
  node_repositories["JPA repositories"]
  node_entities["HR domain entities"]
  node_mysql[("MySQL database")]
end

node_user(("HRMS users"))

node_user -->|"signs in"| node_auth_api
node_auth_api -->|"delegates to"| node_auth_service
node_auth_service -->|"looks up account"| node_user_service
node_auth_service -->|"checks credentials"| node_repositories
node_auth_service -->|"issues token"| node_jwt
node_jwt -.->|"authenticates requests"| node_user
node_user_api -.->|"manages accounts"| node_user_service
node_employee_api -->|"delegates to"| node_employee_service
node_employee_service -->|"reads and writes"| node_repositories
node_employee_service -->|"creates employee login"| node_user_service
node_department_api -.->|"manages departments"| node_department_service
node_attendance_api -->|"delegates to"| node_attendance_service
node_attendance_service -->|"reads and writes"| node_repositories
node_attendance_service -->|"gets working dates"| node_calendar
node_attendance_service -->|"resolves employee"| node_user_service
node_leave_api -->|"delegates to"| node_leave_service
node_leave_service -->|"reads and writes"| node_repositories
node_leave_service -->|"counts working days"| node_calendar
node_leave_service -->|"resolves employee"| node_user_service
node_holiday_api -.->|"manages holidays"| node_holiday_service
node_holiday_service -.->|"persists calendar"| node_repositories
node_payroll_api -->|"delegates to"| node_payroll_service
node_payroll_service -->|"reads and writes"| node_repositories
node_payroll_service -->|"gets month summary"| node_attendance_service
node_payroll_service -->|"resolves payroll month"| node_calendar
node_salary_api -->|"delegates to"| node_salary_service
node_salary_service -.->|"manages components"| node_repositories
node_repositories -->|"maps records"| node_entities
node_entities -->|"stored in"| node_mysql

click node_auth_api "https://github.com/sushanth0711-source/hrms/blob/main/src/main/java/com/company/hrms/controller/AuthController.java"
click node_auth_service "https://github.com/sushanth0711-source/hrms/blob/main/src/main/java/com/company/hrms/service/AuthService.java"
click node_jwt "https://github.com/sushanth0711-source/hrms/blob/main/src/main/java/com/company/hrms/security/JwtAuthFilter.java"
click node_user_api "https://github.com/sushanth0711-source/hrms/blob/main/src/main/java/com/company/hrms/controller/UserController.java"
click node_user_service "https://github.com/sushanth0711-source/hrms/blob/main/src/main/java/com/company/hrms/service/UserService.java"
click node_employee_api "https://github.com/sushanth0711-source/hrms/blob/main/src/main/java/com/company/hrms/controller/EmployeeController.java"
click node_employee_service "https://github.com/sushanth0711-source/hrms/blob/main/src/main/java/com/company/hrms/service/EmployeeService.java"
click node_department_api "https://github.com/sushanth0711-source/hrms/blob/main/src/main/java/com/company/hrms/controller/DepartmentController.java"
click node_department_service "https://github.com/sushanth0711-source/hrms/blob/main/src/main/java/com/company/hrms/service/DepartmentService.java"
click node_attendance_api "https://github.com/sushanth0711-source/hrms/blob/main/src/main/java/com/company/hrms/controller/AttendanceController.java"
click node_attendance_service "https://github.com/sushanth0711-source/hrms/blob/main/src/main/java/com/company/hrms/service/AttendanceService.java"
click node_leave_api "https://github.com/sushanth0711-source/hrms/blob/main/src/main/java/com/company/hrms/controller/LeaveController.java"
click node_leave_service "https://github.com/sushanth0711-source/hrms/blob/main/src/main/java/com/company/hrms/service/LeaveService.java"
click node_holiday_api "https://github.com/sushanth0711-source/hrms/blob/main/src/main/java/com/company/hrms/controller/HolidayController.java"
click node_holiday_service "https://github.com/sushanth0711-source/hrms/blob/main/src/main/java/com/company/hrms/service/HolidayService.java"
click node_calendar "https://github.com/sushanth0711-source/hrms/blob/main/src/main/java/com/company/hrms/service/WorkCalendarService.java"
click node_payroll_api "https://github.com/sushanth0711-source/hrms/blob/main/src/main/java/com/company/hrms/controller/PayrollController.java"
click node_payroll_service "https://github.com/sushanth0711-source/hrms/blob/main/src/main/java/com/company/hrms/service/PayrollService.java"
click node_salary_api "https://github.com/sushanth0711-source/hrms/blob/main/src/main/java/com/company/hrms/controller/SalaryComponentController.java"
click node_salary_service "https://github.com/sushanth0711-source/hrms/blob/main/src/main/java/com/company/hrms/service/SalaryComponentService.java"
click node_repositories "https://github.com/sushanth0711-source/hrms/tree/main/src/main/java/com/company/hrms/repository"
click node_entities "https://github.com/sushanth0711-source/hrms/tree/main/src/main/java/com/company/hrms/entity"

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_auth_api,node_auth_service,node_jwt,node_user_api,node_user_service,node_user toneBlue
class node_employee_api,node_employee_service,node_department_api,node_department_service toneAmber
class node_attendance_api,node_attendance_service,node_leave_api,node_leave_service,node_holiday_api,node_holiday_service,node_calendar toneMint
class node_payroll_api,node_payroll_service,node_salary_api,node_salary_service toneRose
class node_repositories,node_entities,node_mysql toneIndigo
```

## Components

### Identity and Access

- [Authentication API](https://github.com/sushanth0711-source/hrms/blob/main/src/main/java/com/company/hrms/controller/AuthController.java): `src/main/java/com/company/hrms/controller/AuthController.java`
- [Authentication service](https://github.com/sushanth0711-source/hrms/blob/main/src/main/java/com/company/hrms/service/AuthService.java): `src/main/java/com/company/hrms/service/AuthService.java`
- [JWT filter and utility](https://github.com/sushanth0711-source/hrms/blob/main/src/main/java/com/company/hrms/security/JwtAuthFilter.java): `src/main/java/com/company/hrms/security/JwtAuthFilter.java`
- [User administration API](https://github.com/sushanth0711-source/hrms/blob/main/src/main/java/com/company/hrms/controller/UserController.java): `src/main/java/com/company/hrms/controller/UserController.java`
- [User accounts](https://github.com/sushanth0711-source/hrms/blob/main/src/main/java/com/company/hrms/service/UserService.java): `src/main/java/com/company/hrms/service/UserService.java`

### People Management

- [Employee API](https://github.com/sushanth0711-source/hrms/blob/main/src/main/java/com/company/hrms/controller/EmployeeController.java): `src/main/java/com/company/hrms/controller/EmployeeController.java`
- [Employee records](https://github.com/sushanth0711-source/hrms/blob/main/src/main/java/com/company/hrms/service/EmployeeService.java): `src/main/java/com/company/hrms/service/EmployeeService.java`
- [Department API](https://github.com/sushanth0711-source/hrms/blob/main/src/main/java/com/company/hrms/controller/DepartmentController.java): `src/main/java/com/company/hrms/controller/DepartmentController.java`
- [Department management](https://github.com/sushanth0711-source/hrms/blob/main/src/main/java/com/company/hrms/service/DepartmentService.java): `src/main/java/com/company/hrms/service/DepartmentService.java`

### Work and Leave

- [Attendance API](https://github.com/sushanth0711-source/hrms/blob/main/src/main/java/com/company/hrms/controller/AttendanceController.java): `src/main/java/com/company/hrms/controller/AttendanceController.java`
- [Attendance and summaries](https://github.com/sushanth0711-source/hrms/blob/main/src/main/java/com/company/hrms/service/AttendanceService.java): `src/main/java/com/company/hrms/service/AttendanceService.java`
- [Leave API](https://github.com/sushanth0711-source/hrms/blob/main/src/main/java/com/company/hrms/controller/LeaveController.java): `src/main/java/com/company/hrms/controller/LeaveController.java`
- [Leave requests and balances](https://github.com/sushanth0711-source/hrms/blob/main/src/main/java/com/company/hrms/service/LeaveService.java): `src/main/java/com/company/hrms/service/LeaveService.java`
- [Holiday API](https://github.com/sushanth0711-source/hrms/blob/main/src/main/java/com/company/hrms/controller/HolidayController.java): `src/main/java/com/company/hrms/controller/HolidayController.java`
- [Holiday calendar](https://github.com/sushanth0711-source/hrms/blob/main/src/main/java/com/company/hrms/service/HolidayService.java): `src/main/java/com/company/hrms/service/HolidayService.java`
- [Working-day calendar](https://github.com/sushanth0711-source/hrms/blob/main/src/main/java/com/company/hrms/service/WorkCalendarService.java): `src/main/java/com/company/hrms/service/WorkCalendarService.java`

### Payroll

- [Payroll and payslip API](https://github.com/sushanth0711-source/hrms/blob/main/src/main/java/com/company/hrms/controller/PayrollController.java): `src/main/java/com/company/hrms/controller/PayrollController.java`
- [Payroll calculation](https://github.com/sushanth0711-source/hrms/blob/main/src/main/java/com/company/hrms/service/PayrollService.java): `src/main/java/com/company/hrms/service/PayrollService.java`
- [Salary component API](https://github.com/sushanth0711-source/hrms/blob/main/src/main/java/com/company/hrms/controller/SalaryComponentController.java): `src/main/java/com/company/hrms/controller/SalaryComponentController.java`
- [Salary components](https://github.com/sushanth0711-source/hrms/blob/main/src/main/java/com/company/hrms/service/SalaryComponentService.java): `src/main/java/com/company/hrms/service/SalaryComponentService.java`

### Persistence and API

- [JPA repositories](https://github.com/sushanth0711-source/hrms/tree/main/src/main/java/com/company/hrms/repository): `src/main/java/com/company/hrms/repository`
- [HR domain entities](https://github.com/sushanth0711-source/hrms/tree/main/src/main/java/com/company/hrms/entity): `src/main/java/com/company/hrms/entity`
- **MySQL database**

### Other components

- **HRMS users**

## Connections

- HRMS users → Authentication API: signs in (evidence: `README.md`)
- Authentication API → Authentication service: delegates to (evidence: `src/main/java/com/company/hrms/service/AuthService.java`)
- Authentication service → User accounts: looks up account (evidence: `src/main/java/com/company/hrms/service/AuthService.java`)
- Authentication service → JPA repositories: checks credentials (evidence: `src/main/java/com/company/hrms/service/AuthService.java`)
- Authentication service → JWT filter and utility: issues token (evidence: `src/main/java/com/company/hrms/service/AuthService.java`)
- JWT filter and utility → HRMS users: authenticates requests
- User administration API → User accounts: manages accounts (evidence: `src/main/java/com/company/hrms/controller/UserController.java`)
- Employee API → Employee records: delegates to (evidence: `src/main/java/com/company/hrms/controller/EmployeeController.java`)
- Employee records → JPA repositories: reads and writes (evidence: `src/main/java/com/company/hrms/service/EmployeeService.java`)
- Employee records → User accounts: creates employee login (evidence: `src/main/java/com/company/hrms/service/EmployeeService.java`)
- Department API → Department management: manages departments (evidence: `src/main/java/com/company/hrms/controller/DepartmentController.java`)
- Attendance API → Attendance and summaries: delegates to (evidence: `src/main/java/com/company/hrms/controller/AttendanceController.java`)
- Attendance and summaries → JPA repositories: reads and writes (evidence: `src/main/java/com/company/hrms/service/AttendanceService.java`)
- Attendance and summaries → Working-day calendar: gets working dates (evidence: `src/main/java/com/company/hrms/service/AttendanceService.java`)
- Attendance and summaries → User accounts: resolves employee (evidence: `src/main/java/com/company/hrms/service/AttendanceService.java`)
- Leave API → Leave requests and balances: delegates to (evidence: `src/main/java/com/company/hrms/controller/LeaveController.java`)
- Leave requests and balances → JPA repositories: reads and writes (evidence: `src/main/java/com/company/hrms/service/LeaveService.java`)
- Leave requests and balances → Working-day calendar: counts working days (evidence: `src/main/java/com/company/hrms/service/LeaveService.java`)
- Leave requests and balances → User accounts: resolves employee (evidence: `src/main/java/com/company/hrms/service/LeaveService.java`)
- Holiday API → Holiday calendar: manages holidays
- Holiday calendar → JPA repositories: persists calendar
- Payroll and payslip API → Payroll calculation: delegates to (evidence: `src/main/java/com/company/hrms/controller/PayrollController.java`)
- Payroll calculation → JPA repositories: reads and writes (evidence: `src/main/java/com/company/hrms/service/PayrollService.java`)
- Payroll calculation → Attendance and summaries: gets month summary (evidence: `src/main/java/com/company/hrms/service/PayrollService.java`)
- Payroll calculation → Working-day calendar: resolves payroll month (evidence: `src/main/java/com/company/hrms/service/PayrollService.java`)
- Salary component API → Salary components: delegates to (evidence: `src/main/java/com/company/hrms/controller/SalaryComponentController.java`)
- Salary components → JPA repositories: manages components (evidence: `src/main/java/com/company/hrms/service/SalaryComponentService.java`)
- JPA repositories → HR domain entities: maps records (evidence: `README.md`)
- HR domain entities → MySQL database: stored in (evidence: `README.md`)
