# jjm-devs/jjm-hrms architecture

> Architecture diagram of the GitHub repository jjm-devs/jjm-hrms, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-16). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/jjm-devs/jjm-hrms
- Repository: https://github.com/jjm-devs/jjm-hrms

## Overview

JJM Brain HRMS is a role-based workforce platform with Super Admin, HR, and employee experiences. The documented employee journey runs from onboarding and daily operations through payroll, growth, and offboarding; HR scope controls access across organizational units. The graph preserves the README’s major modules, using sampled model and service references where available. Most screens and integrations were not sampled, so their connections are documented at a high level rather than inferred as detailed call sequences.

Main entry points: [`app/Livewire/Hr`](https://github.com/jjm-devs/jjm-hrms/tree/main/app/Livewire/Hr) (HR Panel), [`app/Models/Employee.php`](https://github.com/jjm-devs/jjm-hrms/blob/main/app/Models/Employee.php) (Employee Records), [`app/Models/LeaveApplication.php`](https://github.com/jjm-devs/jjm-hrms/blob/main/app/Models/LeaveApplication.php) (Leave Management), [`app/Livewire/Employee`](https://github.com/jjm-devs/jjm-hrms/tree/main/app/Livewire/Employee) (Employee Portal)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_experience["Role Experiences"]
  node_admin["Super Admin"]
  node_hr["HR Panel"]
  node_employee["Employee Portal"]
end

subgraph group_lifecycle["Employee Lifecycle"]
  node_onboarding["Onboarding"]
  node_employee_record[("Employee Records<br/>[Employee.php]")]
  node_transfers[("Transfers")]
  node_service_book[("Service Book<br/>[ServiceBook.php]")]
end

subgraph group_operations["HR Operations"]
  node_attendance["Attendance<br/>[Index.php]"]
  node_leave[("Leave Management")]
  node_payroll_ui["Payroll Operations"]
  node_payroll_generation["Payroll Generation"]
  node_payroll_batch[("Payroll Batches<br/>[PayrollBatch.php]")]
  node_payroll_item[("Payroll Items<br/>[PayrollItem.php]")]
  node_documents[("Documents<br/>[Document.php]")]
  node_reports["HR Reports<br/>[Index.php]"]
  node_workflows[("Approval Workflows")]
end

subgraph group_foundation["Access &amp; Configuration"]
  node_scope["HR Scope<br/>[HrScopeService.php]"]
  node_org_units[("Org Structure<br/>[OrgUnit.php]")]
  node_master_data["Master Data"]
  node_user[("User &amp; Roles<br/>[User.php]")]
end

node_admin -->|"configures"| node_master_data
node_hr -->|"manages"| node_onboarding
node_employee -->|"applies for"| node_leave
node_employee -->|"uploads"| node_documents
node_employee -->|"views payslips"| node_payroll_item
node_onboarding -->|"creates profiles"| node_employee_record
node_hr -->|"processes"| node_attendance
node_hr -->|"approves"| node_leave
node_hr -->|"runs batches"| node_payroll_ui
node_payroll_ui -.->|"generates"| node_payroll_generation
node_payroll_generation -->|"creates"| node_payroll_batch
node_payroll_batch -->|"has items"| node_payroll_item
node_payroll_item -->|"belongs to"| node_employee_record
node_hr -->|"manages"| node_transfers
node_employee_record -->|"has history"| node_service_book
node_hr -->|"generates"| node_reports
node_hr -->|"approves through"| node_workflows
node_scope -->|"filters by"| node_org_units
node_scope -->|"checks assignments"| node_user
node_employee_record -->|"belongs to"| node_org_units
node_employee_record -->|"has documents"| node_documents
node_leave -->|"belongs to"| node_employee_record
node_payroll_generation -->|"reads leave"| node_leave

click node_admin "https://github.com/jjm-devs/jjm-hrms/tree/main/app/Filament/Resources"
click node_hr "https://github.com/jjm-devs/jjm-hrms/tree/main/app/Livewire/Hr"
click node_employee "https://github.com/jjm-devs/jjm-hrms/tree/main/app/Livewire/Employee"
click node_onboarding "https://github.com/jjm-devs/jjm-hrms/tree/main/app/Livewire/Hr/Employees"
click node_employee_record "https://github.com/jjm-devs/jjm-hrms/blob/main/app/Models/Employee.php"
click node_attendance "https://github.com/jjm-devs/jjm-hrms/blob/main/app/Livewire/Hr/Attendance/Index.php"
click node_leave "https://github.com/jjm-devs/jjm-hrms/blob/main/app/Models/LeaveApplication.php"
click node_payroll_ui "https://github.com/jjm-devs/jjm-hrms/tree/main/app/Livewire/Hr/Payroll"
click node_payroll_generation "https://github.com/jjm-devs/jjm-hrms/blob/main/app/Services/Payroll/PayrollGenerationService.php"
click node_payroll_batch "https://github.com/jjm-devs/jjm-hrms/blob/main/app/Models/PayrollBatch.php"
click node_payroll_item "https://github.com/jjm-devs/jjm-hrms/blob/main/app/Models/PayrollItem.php"
click node_documents "https://github.com/jjm-devs/jjm-hrms/blob/main/app/Models/Document.php"
click node_transfers "https://github.com/jjm-devs/jjm-hrms/blob/main/app/Models/TransferRequest.php"
click node_service_book "https://github.com/jjm-devs/jjm-hrms/blob/main/app/Models/ServiceBook.php"
click node_reports "https://github.com/jjm-devs/jjm-hrms/blob/main/app/Livewire/Hr/Reports/Index.php"
click node_workflows "https://github.com/jjm-devs/jjm-hrms/blob/main/app/Models/WorkflowInstance.php"
click node_scope "https://github.com/jjm-devs/jjm-hrms/blob/main/app/Services/Hr/HrScopeService.php"
click node_org_units "https://github.com/jjm-devs/jjm-hrms/blob/main/app/Models/OrgUnit.php"
click node_master_data "https://github.com/jjm-devs/jjm-hrms/tree/main/app/Filament/Resources"
click node_user "https://github.com/jjm-devs/jjm-hrms/blob/main/app/Models/User.php"

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_admin,node_hr,node_employee toneBlue
class node_onboarding,node_employee_record,node_transfers,node_service_book toneAmber
class node_attendance,node_leave,node_payroll_ui,node_payroll_generation,node_payroll_batch,node_payroll_item,node_documents,node_reports,node_workflows toneMint
class node_scope,node_org_units,node_master_data,node_user toneRose
```

## Components

### Role Experiences

- [Super Admin](https://github.com/jjm-devs/jjm-hrms/tree/main/app/Filament/Resources): `app/Filament/Resources`
- [HR Panel](https://github.com/jjm-devs/jjm-hrms/tree/main/app/Livewire/Hr): `app/Livewire/Hr`
- [Employee Portal](https://github.com/jjm-devs/jjm-hrms/tree/main/app/Livewire/Employee): `app/Livewire/Employee`

### Employee Lifecycle

- [Onboarding](https://github.com/jjm-devs/jjm-hrms/tree/main/app/Livewire/Hr/Employees): `app/Livewire/Hr/Employees`
- [Employee Records](https://github.com/jjm-devs/jjm-hrms/blob/main/app/Models/Employee.php): `app/Models/Employee.php`
- [Transfers](https://github.com/jjm-devs/jjm-hrms/blob/main/app/Models/TransferRequest.php): `app/Models/TransferRequest.php`
- [Service Book](https://github.com/jjm-devs/jjm-hrms/blob/main/app/Models/ServiceBook.php): `app/Models/ServiceBook.php`

### HR Operations

- [Attendance](https://github.com/jjm-devs/jjm-hrms/blob/main/app/Livewire/Hr/Attendance/Index.php): `app/Livewire/Hr/Attendance/Index.php`
- [Leave Management](https://github.com/jjm-devs/jjm-hrms/blob/main/app/Models/LeaveApplication.php): `app/Models/LeaveApplication.php`
- [Payroll Operations](https://github.com/jjm-devs/jjm-hrms/tree/main/app/Livewire/Hr/Payroll): `app/Livewire/Hr/Payroll`
- [Payroll Generation](https://github.com/jjm-devs/jjm-hrms/blob/main/app/Services/Payroll/PayrollGenerationService.php): `app/Services/Payroll/PayrollGenerationService.php`
- [Payroll Batches](https://github.com/jjm-devs/jjm-hrms/blob/main/app/Models/PayrollBatch.php): `app/Models/PayrollBatch.php`
- [Payroll Items](https://github.com/jjm-devs/jjm-hrms/blob/main/app/Models/PayrollItem.php): `app/Models/PayrollItem.php`
- [Documents](https://github.com/jjm-devs/jjm-hrms/blob/main/app/Models/Document.php): `app/Models/Document.php`
- [HR Reports](https://github.com/jjm-devs/jjm-hrms/blob/main/app/Livewire/Hr/Reports/Index.php): `app/Livewire/Hr/Reports/Index.php`
- [Approval Workflows](https://github.com/jjm-devs/jjm-hrms/blob/main/app/Models/WorkflowInstance.php): `app/Models/WorkflowInstance.php`

### Access & Configuration

- [HR Scope](https://github.com/jjm-devs/jjm-hrms/blob/main/app/Services/Hr/HrScopeService.php): `app/Services/Hr/HrScopeService.php`
- [Org Structure](https://github.com/jjm-devs/jjm-hrms/blob/main/app/Models/OrgUnit.php): `app/Models/OrgUnit.php`
- [Master Data](https://github.com/jjm-devs/jjm-hrms/tree/main/app/Filament/Resources): `app/Filament/Resources`
- [User & Roles](https://github.com/jjm-devs/jjm-hrms/blob/main/app/Models/User.php): `app/Models/User.php`

## Connections

- Super Admin → Master Data: configures (evidence: `README.md`)
- HR Panel → Onboarding: manages (evidence: `README.md`)
- Employee Portal → Leave Management: applies for (evidence: `README.md`)
- Employee Portal → Documents: uploads (evidence: `README.md`)
- Employee Portal → Payroll Items: views payslips (evidence: `README.md`)
- Onboarding → Employee Records: creates profiles (evidence: `README.md`)
- HR Panel → Attendance: processes (evidence: `README.md`)
- HR Panel → Leave Management: approves (evidence: `README.md`)
- HR Panel → Payroll Operations: runs batches (evidence: `README.md`)
- Payroll Operations → Payroll Generation: generates
- Payroll Generation → Payroll Batches: creates (evidence: `app/Services/Payroll/PayrollGenerationService.php`)
- Payroll Batches → Payroll Items: has items (evidence: `app/Models/PayrollBatch.php`)
- Payroll Items → Employee Records: belongs to (evidence: `app/Models/PayrollItem.php`)
- HR Panel → Transfers: manages (evidence: `README.md`)
- Employee Records → Service Book: has history (evidence: `app/Models/Employee.php`)
- HR Panel → HR Reports: generates (evidence: `README.md`)
- HR Panel → Approval Workflows: approves through (evidence: `README.md`)
- HR Scope → Org Structure: filters by (evidence: `app/Services/Hr/HrScopeService.php`)
- HR Scope → User & Roles: checks assignments (evidence: `app/Services/Hr/HrScopeService.php`)
- Employee Records → Org Structure: belongs to (evidence: `app/Models/Employee.php`)
- Employee Records → Documents: has documents (evidence: `app/Models/Employee.php`)
- Leave Management → Employee Records: belongs to (evidence: `app/Models/LeaveApplication.php`)
- Payroll Generation → Leave Management: reads leave (evidence: `app/Services/Payroll/PayrollGenerationService.php`)
