How drnrbj/hotel-employee-management-system works
Blue Lotus Hotel EMS is a role-based HR system. Staff sign in to a React application, use its HR or accounting workflows, and receive operational results such as employee records, attendance and leave decisions, recruitment progress, or processed payslips. Laravel exposes the backend API, whose controllers coordinate domain models and payroll services. The README documents the principal capabilities; sampled source confirms frontend route/auth behavior and selected backend controller-to-model/service calls. Other domain links are documented capabilities, not verified source-level call paths.
Main entry points: PayslipController.php Payslip API · Accounting.tsx Payroll workspace · App.tsx Role-based application · Employees.tsx Employee directory
Components 26
Access and application
- Role-based application
src/App.tsx - Authentication
src/hooks/useAuth.ts
Workforce operations
- Employee directory
src/pages/Employees.tsx - Attendance and timekeeping
src/pages/Attendance.tsx - Leave workflow
src/pages/Leave.tsx
Talent and performance
- Recruitment and onboarding
src/pages/Recruitment.tsx - Applicant pipeline
src/components/recruitment/ApplicantPipeline.tsx - Training management
src/pages/Training.tsx - Performance evaluation
src/pages/Performance.tsx
Payroll and accounting
- Payroll workspace
src/pages/Accounting.tsx
Backend domain and services
- Employee API
backend/app/Http/Controllers/EmployeeController.php - Employee records
backend/app/Models/Employee.php - Attendance service
backend/app/Services/AttendanceService.php - Attendance records
backend/app/Models/Attendance.php - Leave API
backend/app/Http/Controllers/LeaveController.php - Leave requests and balances
backend/app/Models/LeaveRequest.php - Recruitment API
backend/app/Http/Controllers/RecruitmentController.php - Applicant records
backend/app/Models/Applicant.php - Evaluation forms API
backend/app/Http/Controllers/EvaluationFormController.php - Payslip API
backend/app/Http/Controllers/PayslipController.php - Payslip calculation
backend/app/Services/PayslipService.php - Payslips and periods
backend/app/Models/Payslip.php - Payroll audit log
backend/app/Models/PayrollAuditLog.php - Payroll bonuses
backend/app/Http/Controllers/PayrollBonusController.php - Payslip PDF
backend/app/Services/PayslipPDF.php
Other components
- HR and accounting staff
Connections 25
- HR and accounting staff → Role-based application: uses
README.md - Role-based application → Authentication: checks access
src/App.tsx - HR and accounting staff → Employee directory: manages staff
README.md - Employee directory → Employee API: requests records
README.md - Employee API → Employee records: reads and writes
README.md - HR and accounting staff → Attendance and timekeeping: tracks time
README.md - Attendance and timekeeping → Attendance service: requests operations
README.md - Attendance service → Attendance records: reads and writes
backend/app/Services/AttendanceService.php - HR and accounting staff → Leave workflow: manages leave
README.md - Leave workflow → Leave API: requests decisions
README.md - Leave API → Leave requests and balances: reads and writes
backend/app/Http/Controllers/LeaveController.php - HR and accounting staff → Recruitment and onboarding: manages hiring
README.md - Recruitment and onboarding → Applicant pipeline: shows pipeline
README.md - Applicant pipeline → Recruitment API: submits applicant changes
- Recruitment API → Applicant records: queries applicants
backend/app/Http/Controllers/RecruitmentController.php - HR and accounting staff → Training management: assigns training
README.md - HR and accounting staff → Performance evaluation: evaluates staff
README.md - Performance evaluation → Evaluation forms API: manages evaluations
README.md - HR and accounting staff → Payroll workspace: processes payroll
README.md - Payroll workspace → Payslip API: requests payslips
README.md - Payslip API → Payslip calculation: computes payslips
backend/app/Http/Controllers/PayslipController.php - Payslip API → Payslips and periods: reads and updates
backend/app/Http/Controllers/PayslipController.php - Payslip API → Payroll audit log: records approvals
backend/app/Http/Controllers/PayslipController.php - Payroll workspace → Payroll bonuses: manages bonuses
README.md - Payslip API → Payslip PDF: generates PDF
README.md