How jeymsdrei/hris-fingerprint works
This repository is a Laravel HR and payroll system paired with a Windows fingerprint-attendance client. Its main workflow is staff attendance capture and processing, followed by payroll calculation and employee-facing records; administrators also manage staff, schedules, reports, archives, and related HR services. The fingerprint client synchronizes employee data with the HRIS. Several controller and service implementations are only partially sampled or unsampled, and the README is empty, so connections not established by the source index or excerpts are omitted or marked unverified.
Main entry points: AttendanceService.php Attendance processing · web.php Web entry points · BiometricController.php Biometric endpoints · ReportController.php Reports and exports
Components 28
Access and HR
- Staff records
system/app/Models/Employee.php - Accounts and roles
system/app/Models/User.php - Departments
system/app/Models/Department.php - HR administration
system/app/Http/Controllers/EmployeeController.php - Employee self-service
system/app/Http/Controllers/EmployeeSelfServiceController.php - Web entry points
system/routes/web.php
Attendance
- Attendance management
system/app/Http/Controllers/AttendanceController.php - Attendance processing
system/app/Services/AttendanceService.php - Attendance records
system/app/Models/Attendance.php - Work schedules
system/app/Models/TeachingSchedule.php - Staff schedules
system/app/Models/WorkSchedule.php - Make-up classes
system/app/Models/MakeUpClass.php - Biometric endpoints
system/app/Http/Controllers/BiometricController.php - Biometric service
system/app/Services/BiometricService.php - Device registry
system/app/Models/BiometricDevice.php
Payroll and reporting
- Payroll management
system/app/Http/Controllers/PayrollController.php - Payroll calculations
system/app/Services/PayrollService.php - Payroll records
system/app/Models/Payroll.php - Payroll periods
system/app/Models/PayrollPeriod.php - Reports and exports
system/app/Http/Controllers/ReportController.php - Report queries
system/app/Services/ReportService.php - Records archive
system/app/Http/Controllers/ArchiveController.php
Fingerprint client
- Fingerprint desktop
system/fingerprint/Demo2/Form1.cs - Local device data
system/fingerprint/Demo2/Data/DatabaseHelper.cs - HRIS API client
system/fingerprint/Demo2/Integration/HrisApiClient.cs
Other components
- HRIS server
- HR staff
- Employee
Connections 25
- HR staff → Web entry points: uses
- Web entry points → HR administration: routes to
- Web entry points → Attendance management: routes to
- Web entry points → Payroll management: routes to
- Web entry points → Reports and exports: routes to
- Employee → Employee self-service: uses
- HR administration → Staff records: manages
- Attendance management → Attendance processing: delegates
- Attendance processing → Attendance records: reads and writes
system/app/Services/AttendanceService.php - Attendance processing → Work schedules: reads
system/app/Services/AttendanceService.php - Attendance processing → Staff schedules: reads
system/app/Services/AttendanceService.php - Attendance processing → Make-up classes: reads
system/app/Services/AttendanceService.php - Biometric endpoints → Biometric service: delegates
system/app/Http/Controllers/BiometricController.php - Biometric endpoints → Attendance processing: uses
system/app/Http/Controllers/BiometricController.php - Biometric endpoints → Device registry: reads and writes
system/app/Http/Controllers/BiometricController.php - Payroll management → Payroll calculations: delegates
- Payroll calculations → Payroll records: writes
- Payroll records → Payroll periods: belongs to
system/app/Models/Payroll.php - Reports and exports → Report queries: queries
system/app/Http/Controllers/ReportController.php - Reports and exports → Payroll periods: reads
system/app/Http/Controllers/ReportController.php - Records archive → Attendance processing: uses
system/app/Http/Controllers/ArchiveController.php - Records archive → Staff records: reads
system/app/Http/Controllers/ArchiveController.php - Fingerprint desktop → Local device data: stores locally
- Fingerprint desktop → HRIS API client: uses
- HRIS API client → HRIS server: synchronizes with
system/fingerprint/Demo2/Integration/HrisApiClient.cs