# tejapragada/hr_employee_management_system architecture

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

- Interactive diagram: https://gitdiagram.com/tejapragada/hr_employee_management_system
- Repository: https://github.com/tejapragada/hr_employee_management_system

## Overview

HR Employee Management is a Spring Boot REST application for managing departments, employees, attendance, leave, and performance reviews. Administrators and employees use authenticated APIs to maintain records, search and review data, and submit or decide leave; leave approval also updates attendance. The graph includes the documented nightly absence scheduler and an internal service/persistence layer. Some controllers and service implementations were not excerpted, so their links are shown only where the README or source index supports them.

Main entry points: [`src/main/java/com/hr/employeemanagement/service/impl`](https://github.com/tejapragada/hr_employee_management_system/tree/master/src/main/java/com/hr/employeemanagement/service/impl) (Domain Services), [`src/main/java/com/hr/employeemanagement/entity/Employee.java`](https://github.com/tejapragada/hr_employee_management_system/blob/master/src/main/java/com/hr/employeemanagement/entity/Employee.java) (Employee Records), [`src/main/java/com/hr/employeemanagement/repository`](https://github.com/tejapragada/hr_employee_management_system/tree/master/src/main/java/com/hr/employeemanagement/repository) (JPA Repositories), [`src/main/java/com/hr/employeemanagement/entity/Attendance.java`](https://github.com/tejapragada/hr_employee_management_system/blob/master/src/main/java/com/hr/employeemanagement/entity/Attendance.java) (Attendance Records)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_api["REST API"]
  node_security["Authentication"]
  node_employee_api["Employee API"]
  node_department_api["Department API"]
  node_attendance_api["Attendance API"]
  node_leave_api["Leave API"]
  node_review_api["Review API"]
end

subgraph group_workforce["Workforce Records"]
  node_employees["Employee Records<br/>[Employee.java]"]
  node_departments["Department Records<br/>[Department.java]"]
end

subgraph group_operations["Attendance and Leave"]
  node_attendance["Attendance Records<br/>[Attendance.java]"]
  node_leave["Leave Requests<br/>[LeaveRequest.java]"]
  node_scheduler["Absence Scheduler"]
end

subgraph group_reviews["Performance Reviews"]
  node_reviews["Review Records"]
end

subgraph group_core["Application Core"]
  node_services["Domain Services"]
  node_repositories["JPA Repositories"]
  node_database[("MySQL Database")]
  node_mappers["DTO Mappers"]
  node_pagination["Page Validation<br/>[PageUtil.java]"]
end

node_users(("Admin / Employee"))

node_users -->|"authenticates"| node_security
node_users -->|"uses APIs"| node_employee_api
node_users -->|"uses APIs"| node_department_api
node_users -->|"uses APIs"| node_attendance_api
node_users -->|"uses APIs"| node_leave_api
node_users -->|"uses APIs"| node_review_api
node_employee_api -->|"delegates to"| node_services
node_department_api -->|"delegates to"| node_services
node_leave_api -->|"delegates to"| node_services
node_review_api -->|"delegates to"| node_services
node_services -.->|"queries and saves"| node_repositories
node_repositories -->|"persists records"| node_database
node_services -->|"maps DTOs"| node_mappers
node_services -->|"updates on approval"| node_attendance
node_scheduler -->|"finds missing check-ins"| node_repositories
node_scheduler -->|"marks absent"| node_attendance
node_pagination -.->|"validates paging"| node_services
node_employees -->|"belongs to"| node_departments
node_employees -->|"has records"| node_attendance
node_employees -->|"has requests"| node_leave
node_employees -->|"has reviews"| node_reviews

click node_security "https://github.com/tejapragada/hr_employee_management_system/blob/master/src/main/java/com/hr/employeemanagement/config/SecurityConfig.java"
click node_employee_api "https://github.com/tejapragada/hr_employee_management_system/blob/master/src/main/java/com/hr/employeemanagement/controller/EmployeeController.java"
click node_department_api "https://github.com/tejapragada/hr_employee_management_system/blob/master/src/main/java/com/hr/employeemanagement/controller/DepartmentController.java"
click node_attendance_api "https://github.com/tejapragada/hr_employee_management_system/blob/master/src/main/java/com/hr/employeemanagement/controller/AttendanceController.java"
click node_leave_api "https://github.com/tejapragada/hr_employee_management_system/blob/master/src/main/java/com/hr/employeemanagement/controller/LeaveController.java"
click node_review_api "https://github.com/tejapragada/hr_employee_management_system/blob/master/src/main/java/com/hr/employeemanagement/controller/PerformanceReviewController.java"
click node_employees "https://github.com/tejapragada/hr_employee_management_system/blob/master/src/main/java/com/hr/employeemanagement/entity/Employee.java"
click node_departments "https://github.com/tejapragada/hr_employee_management_system/blob/master/src/main/java/com/hr/employeemanagement/entity/Department.java"
click node_attendance "https://github.com/tejapragada/hr_employee_management_system/blob/master/src/main/java/com/hr/employeemanagement/entity/Attendance.java"
click node_leave "https://github.com/tejapragada/hr_employee_management_system/blob/master/src/main/java/com/hr/employeemanagement/entity/LeaveRequest.java"
click node_scheduler "https://github.com/tejapragada/hr_employee_management_system/blob/master/src/main/java/com/hr/employeemanagement/scheduler/AttendanceScheduler.java"
click node_reviews "https://github.com/tejapragada/hr_employee_management_system/blob/master/src/main/java/com/hr/employeemanagement/entity/PerformanceReview.java"
click node_services "https://github.com/tejapragada/hr_employee_management_system/tree/master/src/main/java/com/hr/employeemanagement/service/impl"
click node_repositories "https://github.com/tejapragada/hr_employee_management_system/tree/master/src/main/java/com/hr/employeemanagement/repository"
click node_mappers "https://github.com/tejapragada/hr_employee_management_system/tree/master/src/main/java/com/hr/employeemanagement/mapper"
click node_pagination "https://github.com/tejapragada/hr_employee_management_system/blob/master/src/main/java/com/hr/employeemanagement/util/PageUtil.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_security,node_employee_api,node_department_api,node_attendance_api,node_leave_api,node_review_api toneBlue
class node_employees,node_departments toneAmber
class node_attendance,node_leave,node_scheduler toneMint
class node_reviews toneRose
class node_services,node_repositories,node_database,node_mappers,node_pagination,node_users toneIndigo
```

## Components

### REST API

- [Authentication](https://github.com/tejapragada/hr_employee_management_system/blob/master/src/main/java/com/hr/employeemanagement/config/SecurityConfig.java): `src/main/java/com/hr/employeemanagement/config/SecurityConfig.java`
- [Employee API](https://github.com/tejapragada/hr_employee_management_system/blob/master/src/main/java/com/hr/employeemanagement/controller/EmployeeController.java): `src/main/java/com/hr/employeemanagement/controller/EmployeeController.java`
- [Department API](https://github.com/tejapragada/hr_employee_management_system/blob/master/src/main/java/com/hr/employeemanagement/controller/DepartmentController.java): `src/main/java/com/hr/employeemanagement/controller/DepartmentController.java`
- [Attendance API](https://github.com/tejapragada/hr_employee_management_system/blob/master/src/main/java/com/hr/employeemanagement/controller/AttendanceController.java): `src/main/java/com/hr/employeemanagement/controller/AttendanceController.java`
- [Leave API](https://github.com/tejapragada/hr_employee_management_system/blob/master/src/main/java/com/hr/employeemanagement/controller/LeaveController.java): `src/main/java/com/hr/employeemanagement/controller/LeaveController.java`
- [Review API](https://github.com/tejapragada/hr_employee_management_system/blob/master/src/main/java/com/hr/employeemanagement/controller/PerformanceReviewController.java): `src/main/java/com/hr/employeemanagement/controller/PerformanceReviewController.java`

### Workforce Records

- [Employee Records](https://github.com/tejapragada/hr_employee_management_system/blob/master/src/main/java/com/hr/employeemanagement/entity/Employee.java): `src/main/java/com/hr/employeemanagement/entity/Employee.java`
- [Department Records](https://github.com/tejapragada/hr_employee_management_system/blob/master/src/main/java/com/hr/employeemanagement/entity/Department.java): `src/main/java/com/hr/employeemanagement/entity/Department.java`

### Attendance and Leave

- [Attendance Records](https://github.com/tejapragada/hr_employee_management_system/blob/master/src/main/java/com/hr/employeemanagement/entity/Attendance.java): `src/main/java/com/hr/employeemanagement/entity/Attendance.java`
- [Leave Requests](https://github.com/tejapragada/hr_employee_management_system/blob/master/src/main/java/com/hr/employeemanagement/entity/LeaveRequest.java): `src/main/java/com/hr/employeemanagement/entity/LeaveRequest.java`
- [Absence Scheduler](https://github.com/tejapragada/hr_employee_management_system/blob/master/src/main/java/com/hr/employeemanagement/scheduler/AttendanceScheduler.java): `src/main/java/com/hr/employeemanagement/scheduler/AttendanceScheduler.java`

### Performance Reviews

- [Review Records](https://github.com/tejapragada/hr_employee_management_system/blob/master/src/main/java/com/hr/employeemanagement/entity/PerformanceReview.java): `src/main/java/com/hr/employeemanagement/entity/PerformanceReview.java`

### Application Core

- [Domain Services](https://github.com/tejapragada/hr_employee_management_system/tree/master/src/main/java/com/hr/employeemanagement/service/impl): `src/main/java/com/hr/employeemanagement/service/impl`
- [JPA Repositories](https://github.com/tejapragada/hr_employee_management_system/tree/master/src/main/java/com/hr/employeemanagement/repository): `src/main/java/com/hr/employeemanagement/repository`
- **MySQL Database**
- [DTO Mappers](https://github.com/tejapragada/hr_employee_management_system/tree/master/src/main/java/com/hr/employeemanagement/mapper): `src/main/java/com/hr/employeemanagement/mapper`
- [Page Validation](https://github.com/tejapragada/hr_employee_management_system/blob/master/src/main/java/com/hr/employeemanagement/util/PageUtil.java): `src/main/java/com/hr/employeemanagement/util/PageUtil.java`

### Other components

- **Admin / Employee**

## Connections

- Admin / Employee → Authentication: authenticates (evidence: `README.md`)
- Admin / Employee → Employee API: uses APIs (evidence: `README.md`)
- Admin / Employee → Department API: uses APIs (evidence: `README.md`)
- Admin / Employee → Attendance API: uses APIs (evidence: `README.md`)
- Admin / Employee → Leave API: uses APIs (evidence: `README.md`)
- Admin / Employee → Review API: uses APIs (evidence: `README.md`)
- Employee API → Domain Services: delegates to (evidence: `src/main/java/com/hr/employeemanagement/controller/EmployeeController.java`)
- Department API → Domain Services: delegates to (evidence: `src/main/java/com/hr/employeemanagement/controller/DepartmentController.java`)
- Leave API → Domain Services: delegates to (evidence: `src/main/java/com/hr/employeemanagement/controller/LeaveController.java`)
- Review API → Domain Services: delegates to (evidence: `src/main/java/com/hr/employeemanagement/controller/PerformanceReviewController.java`)
- Domain Services → JPA Repositories: queries and saves (evidence: `src/main/java/com/hr/employeemanagement/service/impl/PerformanceReviewServiceImpl.java`)
- JPA Repositories → MySQL Database: persists records (evidence: `README.md`)
- Domain Services → DTO Mappers: maps DTOs (evidence: `src/main/java/com/hr/employeemanagement/service/impl/PerformanceReviewServiceImpl.java`)
- Domain Services → Attendance Records: updates on approval (evidence: `src/main/java/com/hr/employeemanagement/service/impl/LeaveServiceImpl.java`)
- Absence Scheduler → JPA Repositories: finds missing check-ins (evidence: `src/main/java/com/hr/employeemanagement/repository/EmployeeRepository.java`)
- Absence Scheduler → Attendance Records: marks absent (evidence: `README.md`)
- Page Validation → Domain Services: validates paging (evidence: `src/main/java/com/hr/employeemanagement/service/impl/PerformanceReviewServiceImpl.java`)
- Employee Records → Department Records: belongs to (evidence: `src/main/java/com/hr/employeemanagement/entity/Employee.java`)
- Employee Records → Attendance Records: has records (evidence: `src/main/java/com/hr/employeemanagement/entity/Employee.java`)
- Employee Records → Leave Requests: has requests (evidence: `src/main/java/com/hr/employeemanagement/entity/Employee.java`)
- Employee Records → Review Records: has reviews (evidence: `src/main/java/com/hr/employeemanagement/entity/Employee.java`)
