How rahulkumar971/hr-management-system works
HRMS is a full-stack human-resources application: a Next.js interface for employee and HR/admin tasks, backed by a Spring Boot REST API and MySQL. Users authenticate, then manage employee records and use domain workflows including attendance, leave, onboarding, recruitment, payroll, performance, training, and notifications. The backend separates request controllers, business services, repositories, and persistent entities. The README documents the three-tier stack and the source index shows selected controller-to-service and service-to-repository dependencies; many feature-specific implementations were not sampled, so their internal links are not expanded.
Main entry points: controller REST controllers · EmployeeRepository.java Employee persistence · app Role-based workspace · lib API clients
Components 19
Web experience
- Role-based workspace
frontend/src/app - API clients
frontend/src/lib
Identity and employees
- Authentication
backend/hrms/src/main/java/com/hrms/service/AuthService.java - Employee records
backend/hrms/src/main/java/com/hrms/service/EmployeeService.java - Employee persistence
backend/hrms/src/main/java/com/hrms/repository/EmployeeRepository.java - Employee identity model
backend/hrms/src/main/java/com/hrms/entity/Employee.java
Workforce operations
- Attendance and reports
backend/hrms/src/main/java/com/hrms/service/AttendanceService.java - Leave management
backend/hrms/src/main/java/com/hrms/service/LeaveService.java - Payroll and payslips
backend/hrms/src/main/java/com/hrms/service/PayrollService.java
Talent lifecycle
- Onboarding and documents
backend/hrms/src/main/java/com/hrms/service/OnboardingService.java - Recruitment
backend/hrms/src/main/java/com/hrms/service/RecruitmentService.java - Performance reviews
backend/hrms/src/main/java/com/hrms/service/PerformanceService.java - Training and enrollment
backend/hrms/src/main/java/com/hrms/service/TrainingService.java
Backend platform
- REST controllers
backend/hrms/src/main/java/com/hrms/controller - Notifications and greetings
backend/hrms/src/main/java/com/hrms/service/NotificationService.java - Email delivery
backend/hrms/src/main/java/com/hrms/service/EmailService.java - Request security
backend/hrms/src/main/java/com/hrms/security/JwtAuthFilter.java
Other components
- HR and employees
- MySQL database
Connections 20
- HR and employees → Role-based workspace: use
README.md - Role-based workspace → API clients: requests through
- API clients → REST controllers: calls API
- REST controllers → Authentication: delegates auth
backend/hrms/src/main/java/com/hrms/controller/AuthController.java - REST controllers → Employee records: delegates employee tasks
- REST controllers → Attendance and reports: delegates attendance
- REST controllers → Leave management: delegates leave
backend/hrms/src/main/java/com/hrms/controller/LeaveController.java - REST controllers → Onboarding and documents: delegates onboarding
backend/hrms/src/main/java/com/hrms/controller/OnboardingController.java - REST controllers → Payroll and payslips: delegates payroll
- REST controllers → Recruitment: delegates hiring
- REST controllers → Performance reviews: delegates reviews
- REST controllers → Training and enrollment: delegates training
backend/hrms/src/main/java/com/hrms/controller/TrainingController.java - REST controllers → Notifications and greetings: delegates notifications
- Authentication → Employee persistence: looks up accounts
backend/hrms/src/main/java/com/hrms/service/AuthService.java - Employee records → Employee persistence: reads and writes
backend/hrms/src/main/java/com/hrms/service/EmployeeService.java - Employee persistence → Employee identity model: persists
backend/hrms/src/main/java/com/hrms/repository/EmployeeRepository.java - REST controllers → Email delivery: sends OTP mail
backend/hrms/src/main/java/com/hrms/controller/AuthController.java - REST controllers → MySQL database: persists through backend
- REST controllers → Request security: protected by
- HR and employees → REST controllers: authenticate and manage
README.md