How sushanth0711-source/hrms works
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: repository JPA repositories · AttendanceService.java Attendance and summaries · UserService.java User accounts · AuthService.java Authentication service
Components 24
Identity and Access
- Authentication API
src/main/java/com/company/hrms/controller/AuthController.java - Authentication service
src/main/java/com/company/hrms/service/AuthService.java - JWT filter and utility
src/main/java/com/company/hrms/security/JwtAuthFilter.java - User administration API
src/main/java/com/company/hrms/controller/UserController.java - User accounts
src/main/java/com/company/hrms/service/UserService.java
People Management
- Employee API
src/main/java/com/company/hrms/controller/EmployeeController.java - Employee records
src/main/java/com/company/hrms/service/EmployeeService.java - Department API
src/main/java/com/company/hrms/controller/DepartmentController.java - Department management
src/main/java/com/company/hrms/service/DepartmentService.java
Work and Leave
- Attendance API
src/main/java/com/company/hrms/controller/AttendanceController.java - Attendance and summaries
src/main/java/com/company/hrms/service/AttendanceService.java - Leave API
src/main/java/com/company/hrms/controller/LeaveController.java - Leave requests and balances
src/main/java/com/company/hrms/service/LeaveService.java - Holiday API
src/main/java/com/company/hrms/controller/HolidayController.java - Holiday calendar
src/main/java/com/company/hrms/service/HolidayService.java - Working-day calendar
src/main/java/com/company/hrms/service/WorkCalendarService.java
Payroll
- Payroll and payslip API
src/main/java/com/company/hrms/controller/PayrollController.java - Payroll calculation
src/main/java/com/company/hrms/service/PayrollService.java - Salary component API
src/main/java/com/company/hrms/controller/SalaryComponentController.java - Salary components
src/main/java/com/company/hrms/service/SalaryComponentService.java
Persistence and API
- JPA repositories
src/main/java/com/company/hrms/repository - HR domain entities
src/main/java/com/company/hrms/entity - MySQL database
Other components
- HRMS users
Connections 29
- HRMS users → Authentication API: signs in
README.md - Authentication API → Authentication service: delegates to
src/main/java/com/company/hrms/service/AuthService.java - Authentication service → User accounts: looks up account
src/main/java/com/company/hrms/service/AuthService.java - Authentication service → JPA repositories: checks credentials
src/main/java/com/company/hrms/service/AuthService.java - Authentication service → JWT filter and utility: issues token
src/main/java/com/company/hrms/service/AuthService.java - JWT filter and utility → HRMS users: authenticates requests
- User administration API → User accounts: manages accounts
src/main/java/com/company/hrms/controller/UserController.java - Employee API → Employee records: delegates to
src/main/java/com/company/hrms/controller/EmployeeController.java - Employee records → JPA repositories: reads and writes
src/main/java/com/company/hrms/service/EmployeeService.java - Employee records → User accounts: creates employee login
src/main/java/com/company/hrms/service/EmployeeService.java - Department API → Department management: manages departments
src/main/java/com/company/hrms/controller/DepartmentController.java - Attendance API → Attendance and summaries: delegates to
src/main/java/com/company/hrms/controller/AttendanceController.java - Attendance and summaries → JPA repositories: reads and writes
src/main/java/com/company/hrms/service/AttendanceService.java - Attendance and summaries → Working-day calendar: gets working dates
src/main/java/com/company/hrms/service/AttendanceService.java - Attendance and summaries → User accounts: resolves employee
src/main/java/com/company/hrms/service/AttendanceService.java - Leave API → Leave requests and balances: delegates to
src/main/java/com/company/hrms/controller/LeaveController.java - Leave requests and balances → JPA repositories: reads and writes
src/main/java/com/company/hrms/service/LeaveService.java - Leave requests and balances → Working-day calendar: counts working days
src/main/java/com/company/hrms/service/LeaveService.java - Leave requests and balances → User accounts: resolves employee
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
src/main/java/com/company/hrms/controller/PayrollController.java - Payroll calculation → JPA repositories: reads and writes
src/main/java/com/company/hrms/service/PayrollService.java - Payroll calculation → Attendance and summaries: gets month summary
src/main/java/com/company/hrms/service/PayrollService.java - Payroll calculation → Working-day calendar: resolves payroll month
src/main/java/com/company/hrms/service/PayrollService.java - Salary component API → Salary components: delegates to
src/main/java/com/company/hrms/controller/SalaryComponentController.java - Salary components → JPA repositories: manages components
src/main/java/com/company/hrms/service/SalaryComponentService.java - JPA repositories → HR domain entities: maps records
README.md - HR domain entities → MySQL database: stored in
README.md