# jeymsdrei/hris-fingerprint architecture

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

- Interactive diagram: https://gitdiagram.com/jeymsdrei/hris-fingerprint
- Repository: https://github.com/jeymsdrei/hris-fingerprint

## Overview

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: [`system/app/Services/AttendanceService.php`](https://github.com/jeymsdrei/hris-fingerprint/blob/main/system/app/Services/AttendanceService.php) (Attendance processing), [`system/routes/web.php`](https://github.com/jeymsdrei/hris-fingerprint/blob/main/system/routes/web.php) (Web entry points), [`system/app/Http/Controllers/BiometricController.php`](https://github.com/jeymsdrei/hris-fingerprint/blob/main/system/app/Http/Controllers/BiometricController.php) (Biometric endpoints), [`system/app/Http/Controllers/ReportController.php`](https://github.com/jeymsdrei/hris-fingerprint/blob/main/system/app/Http/Controllers/ReportController.php) (Reports and exports)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_access["Access and HR"]
  node_staff[("Staff records<br/>[Employee.php]")]
  node_accounts[("Accounts and roles<br/>[User.php]")]
  node_departments[("Departments<br/>[Department.php]")]
  node_hr_admin["HR administration"]
  node_self_service["Employee self-service"]
  node_access_routes["Web entry points<br/>[web.php]"]
end

subgraph group_attendance["Attendance"]
  node_attendance_ui["Attendance management"]
  node_attendance_logic["Attendance processing"]
  node_attendance_records[("Attendance records<br/>[Attendance.php]")]
  node_schedules[("Work schedules")]
  node_work_schedule[("Staff schedules<br/>[WorkSchedule.php]")]
  node_makeup[("Make-up classes<br/>[MakeUpClass.php]")]
  node_biometric_api["Biometric endpoints"]
  node_biometric_logic["Biometric service"]
  node_biometric_devices[("Device registry")]
end

subgraph group_payroll["Payroll and reporting"]
  node_payroll_ui["Payroll management"]
  node_payroll_logic["Payroll calculations<br/>[PayrollService.php]"]
  node_payroll_records[("Payroll records<br/>[Payroll.php]")]
  node_pay_periods[("Payroll periods<br/>[PayrollPeriod.php]")]
  node_reporting["Reports and exports"]
  node_report_logic["Report queries<br/>[ReportService.php]"]
  node_archive["Records archive"]
end

subgraph group_fingerprint["Fingerprint client"]
  node_desktop["Fingerprint desktop<br/>[Form1.cs]"]
  node_device_store[("Local device data<br/>[DatabaseHelper.cs]")]
  node_sync_client["HRIS API client<br/>[HrisApiClient.cs]"]
end

node_hris(("HRIS server"))
node_staff_actor(("HR staff"))
node_employee_actor(("Employee"))

node_staff_actor -.->|"uses"| node_access_routes
node_access_routes -.->|"routes to"| node_hr_admin
node_access_routes -.->|"routes to"| node_attendance_ui
node_access_routes -.->|"routes to"| node_payroll_ui
node_access_routes -.->|"routes to"| node_reporting
node_employee_actor -.->|"uses"| node_self_service
node_hr_admin -.->|"manages"| node_staff
node_attendance_ui -.->|"delegates"| node_attendance_logic
node_attendance_logic -->|"reads and writes"| node_attendance_records
node_attendance_logic -->|"reads"| node_schedules
node_attendance_logic -->|"reads"| node_work_schedule
node_attendance_logic -->|"reads"| node_makeup
node_biometric_api -->|"delegates"| node_biometric_logic
node_biometric_api -->|"uses"| node_attendance_logic
node_biometric_api -->|"reads and writes"| node_biometric_devices
node_payroll_ui -.->|"delegates"| node_payroll_logic
node_payroll_logic -.->|"writes"| node_payroll_records
node_payroll_records -->|"belongs to"| node_pay_periods
node_reporting -->|"queries"| node_report_logic
node_reporting -->|"reads"| node_pay_periods
node_archive -->|"uses"| node_attendance_logic
node_archive -->|"reads"| node_staff
node_desktop -.->|"stores locally"| node_device_store
node_desktop -.->|"uses"| node_sync_client
node_sync_client -->|"synchronizes with"| node_hris

click node_staff "https://github.com/jeymsdrei/hris-fingerprint/blob/main/system/app/Models/Employee.php"
click node_accounts "https://github.com/jeymsdrei/hris-fingerprint/blob/main/system/app/Models/User.php"
click node_departments "https://github.com/jeymsdrei/hris-fingerprint/blob/main/system/app/Models/Department.php"
click node_hr_admin "https://github.com/jeymsdrei/hris-fingerprint/blob/main/system/app/Http/Controllers/EmployeeController.php"
click node_self_service "https://github.com/jeymsdrei/hris-fingerprint/blob/main/system/app/Http/Controllers/EmployeeSelfServiceController.php"
click node_access_routes "https://github.com/jeymsdrei/hris-fingerprint/blob/main/system/routes/web.php"
click node_attendance_ui "https://github.com/jeymsdrei/hris-fingerprint/blob/main/system/app/Http/Controllers/AttendanceController.php"
click node_attendance_logic "https://github.com/jeymsdrei/hris-fingerprint/blob/main/system/app/Services/AttendanceService.php"
click node_attendance_records "https://github.com/jeymsdrei/hris-fingerprint/blob/main/system/app/Models/Attendance.php"
click node_schedules "https://github.com/jeymsdrei/hris-fingerprint/blob/main/system/app/Models/TeachingSchedule.php"
click node_work_schedule "https://github.com/jeymsdrei/hris-fingerprint/blob/main/system/app/Models/WorkSchedule.php"
click node_makeup "https://github.com/jeymsdrei/hris-fingerprint/blob/main/system/app/Models/MakeUpClass.php"
click node_biometric_api "https://github.com/jeymsdrei/hris-fingerprint/blob/main/system/app/Http/Controllers/BiometricController.php"
click node_biometric_logic "https://github.com/jeymsdrei/hris-fingerprint/blob/main/system/app/Services/BiometricService.php"
click node_biometric_devices "https://github.com/jeymsdrei/hris-fingerprint/blob/main/system/app/Models/BiometricDevice.php"
click node_payroll_ui "https://github.com/jeymsdrei/hris-fingerprint/blob/main/system/app/Http/Controllers/PayrollController.php"
click node_payroll_logic "https://github.com/jeymsdrei/hris-fingerprint/blob/main/system/app/Services/PayrollService.php"
click node_payroll_records "https://github.com/jeymsdrei/hris-fingerprint/blob/main/system/app/Models/Payroll.php"
click node_pay_periods "https://github.com/jeymsdrei/hris-fingerprint/blob/main/system/app/Models/PayrollPeriod.php"
click node_reporting "https://github.com/jeymsdrei/hris-fingerprint/blob/main/system/app/Http/Controllers/ReportController.php"
click node_report_logic "https://github.com/jeymsdrei/hris-fingerprint/blob/main/system/app/Services/ReportService.php"
click node_archive "https://github.com/jeymsdrei/hris-fingerprint/blob/main/system/app/Http/Controllers/ArchiveController.php"
click node_desktop "https://github.com/jeymsdrei/hris-fingerprint/blob/main/system/fingerprint/Demo2/Form1.cs"
click node_device_store "https://github.com/jeymsdrei/hris-fingerprint/blob/main/system/fingerprint/Demo2/Data/DatabaseHelper.cs"
click node_sync_client "https://github.com/jeymsdrei/hris-fingerprint/blob/main/system/fingerprint/Demo2/Integration/HrisApiClient.cs"

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_staff,node_accounts,node_departments,node_hr_admin,node_self_service,node_access_routes toneBlue
class node_attendance_ui,node_attendance_logic,node_attendance_records,node_schedules,node_work_schedule,node_makeup,node_biometric_api,node_biometric_logic,node_biometric_devices toneAmber
class node_payroll_ui,node_payroll_logic,node_payroll_records,node_pay_periods,node_reporting,node_report_logic,node_archive,node_hris toneMint
class node_desktop,node_device_store,node_sync_client toneRose
class node_staff_actor,node_employee_actor toneIndigo
```

## Components

### Access and HR

- [Staff records](https://github.com/jeymsdrei/hris-fingerprint/blob/main/system/app/Models/Employee.php): `system/app/Models/Employee.php`
- [Accounts and roles](https://github.com/jeymsdrei/hris-fingerprint/blob/main/system/app/Models/User.php): `system/app/Models/User.php`
- [Departments](https://github.com/jeymsdrei/hris-fingerprint/blob/main/system/app/Models/Department.php): `system/app/Models/Department.php`
- [HR administration](https://github.com/jeymsdrei/hris-fingerprint/blob/main/system/app/Http/Controllers/EmployeeController.php): `system/app/Http/Controllers/EmployeeController.php`
- [Employee self-service](https://github.com/jeymsdrei/hris-fingerprint/blob/main/system/app/Http/Controllers/EmployeeSelfServiceController.php): `system/app/Http/Controllers/EmployeeSelfServiceController.php`
- [Web entry points](https://github.com/jeymsdrei/hris-fingerprint/blob/main/system/routes/web.php): `system/routes/web.php`

### Attendance

- [Attendance management](https://github.com/jeymsdrei/hris-fingerprint/blob/main/system/app/Http/Controllers/AttendanceController.php): `system/app/Http/Controllers/AttendanceController.php`
- [Attendance processing](https://github.com/jeymsdrei/hris-fingerprint/blob/main/system/app/Services/AttendanceService.php): `system/app/Services/AttendanceService.php`
- [Attendance records](https://github.com/jeymsdrei/hris-fingerprint/blob/main/system/app/Models/Attendance.php): `system/app/Models/Attendance.php`
- [Work schedules](https://github.com/jeymsdrei/hris-fingerprint/blob/main/system/app/Models/TeachingSchedule.php): `system/app/Models/TeachingSchedule.php`
- [Staff schedules](https://github.com/jeymsdrei/hris-fingerprint/blob/main/system/app/Models/WorkSchedule.php): `system/app/Models/WorkSchedule.php`
- [Make-up classes](https://github.com/jeymsdrei/hris-fingerprint/blob/main/system/app/Models/MakeUpClass.php): `system/app/Models/MakeUpClass.php`
- [Biometric endpoints](https://github.com/jeymsdrei/hris-fingerprint/blob/main/system/app/Http/Controllers/BiometricController.php): `system/app/Http/Controllers/BiometricController.php`
- [Biometric service](https://github.com/jeymsdrei/hris-fingerprint/blob/main/system/app/Services/BiometricService.php): `system/app/Services/BiometricService.php`
- [Device registry](https://github.com/jeymsdrei/hris-fingerprint/blob/main/system/app/Models/BiometricDevice.php): `system/app/Models/BiometricDevice.php`

### Payroll and reporting

- [Payroll management](https://github.com/jeymsdrei/hris-fingerprint/blob/main/system/app/Http/Controllers/PayrollController.php): `system/app/Http/Controllers/PayrollController.php`
- [Payroll calculations](https://github.com/jeymsdrei/hris-fingerprint/blob/main/system/app/Services/PayrollService.php): `system/app/Services/PayrollService.php`
- [Payroll records](https://github.com/jeymsdrei/hris-fingerprint/blob/main/system/app/Models/Payroll.php): `system/app/Models/Payroll.php`
- [Payroll periods](https://github.com/jeymsdrei/hris-fingerprint/blob/main/system/app/Models/PayrollPeriod.php): `system/app/Models/PayrollPeriod.php`
- [Reports and exports](https://github.com/jeymsdrei/hris-fingerprint/blob/main/system/app/Http/Controllers/ReportController.php): `system/app/Http/Controllers/ReportController.php`
- [Report queries](https://github.com/jeymsdrei/hris-fingerprint/blob/main/system/app/Services/ReportService.php): `system/app/Services/ReportService.php`
- [Records archive](https://github.com/jeymsdrei/hris-fingerprint/blob/main/system/app/Http/Controllers/ArchiveController.php): `system/app/Http/Controllers/ArchiveController.php`

### Fingerprint client

- [Fingerprint desktop](https://github.com/jeymsdrei/hris-fingerprint/blob/main/system/fingerprint/Demo2/Form1.cs): `system/fingerprint/Demo2/Form1.cs`
- [Local device data](https://github.com/jeymsdrei/hris-fingerprint/blob/main/system/fingerprint/Demo2/Data/DatabaseHelper.cs): `system/fingerprint/Demo2/Data/DatabaseHelper.cs`
- [HRIS API client](https://github.com/jeymsdrei/hris-fingerprint/blob/main/system/fingerprint/Demo2/Integration/HrisApiClient.cs): `system/fingerprint/Demo2/Integration/HrisApiClient.cs`

### Other components

- **HRIS server**
- **HR staff**
- **Employee**

## Connections

- 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 (evidence: `system/app/Services/AttendanceService.php`)
- Attendance processing → Work schedules: reads (evidence: `system/app/Services/AttendanceService.php`)
- Attendance processing → Staff schedules: reads (evidence: `system/app/Services/AttendanceService.php`)
- Attendance processing → Make-up classes: reads (evidence: `system/app/Services/AttendanceService.php`)
- Biometric endpoints → Biometric service: delegates (evidence: `system/app/Http/Controllers/BiometricController.php`)
- Biometric endpoints → Attendance processing: uses (evidence: `system/app/Http/Controllers/BiometricController.php`)
- Biometric endpoints → Device registry: reads and writes (evidence: `system/app/Http/Controllers/BiometricController.php`)
- Payroll management → Payroll calculations: delegates
- Payroll calculations → Payroll records: writes
- Payroll records → Payroll periods: belongs to (evidence: `system/app/Models/Payroll.php`)
- Reports and exports → Report queries: queries (evidence: `system/app/Http/Controllers/ReportController.php`)
- Reports and exports → Payroll periods: reads (evidence: `system/app/Http/Controllers/ReportController.php`)
- Records archive → Attendance processing: uses (evidence: `system/app/Http/Controllers/ArchiveController.php`)
- Records archive → Staff records: reads (evidence: `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 (evidence: `system/fingerprint/Demo2/Integration/HrisApiClient.cs`)
