# codeacc384-coder/hr_hrms architecture

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

- Interactive diagram: https://gitdiagram.com/codeacc384-coder/hr_hrms
- Repository: https://github.com/codeacc384-coder/hr_hrms

## Overview

Horizon HRM is a browser-based HR administration portal: an HR user signs in, enters a protected workspace, and uses pages for workforce administration, attendance, payroll, documents, approvals, and reporting. The pages access Supabase directly; shared profile and workforce helpers support selected views. The README describes a narrower HR Documents/Team Lead package than the routed application shown in `src/App.jsx`; unsampled page behavior and most backend relationships are therefore represented conservatively.

Main entry points: [`src/App.jsx`](https://github.com/codeacc384-coder/hr_hrms/blob/main/src/App.jsx) (Routes and access), [`src/lib/supabase.js`](https://github.com/codeacc384-coder/hr_hrms/blob/main/src/lib/supabase.js) (Supabase client), [`src/utils/workforce.js`](https://github.com/codeacc384-coder/hr_hrms/blob/main/src/utils/workforce.js) (Workforce rules), [`src/pages/dashboard/Dashboard.jsx`](https://github.com/codeacc384-coder/hr_hrms/blob/main/src/pages/dashboard/Dashboard.jsx) (Dashboard)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_access["Access and shell"]
  node_app["Routes and access<br/>[App.jsx]"]
  node_login["Sign in<br/>[Login.jsx]"]
  node_layout["Workspace shell<br/>[AppLayout.jsx]"]
  node_settings["Settings<br/>[Settings.jsx]"]
end

subgraph group_people["Workforce operations"]
  node_dashboard["Dashboard<br/>[Dashboard.jsx]"]
  node_employment["Employment and teams<br/>[Employment.jsx]"]
  node_onboarding["Onboarding<br/>[Onboarding.jsx]"]
  node_attendance["Attendance<br/>[Attendance.jsx]"]
end

subgraph group_pay["Compensation"]
  node_payroll["Payroll<br/>[Payroll.jsx]"]
  node_salary_processing["Salary processing"]
  node_salary_structure["Salary structure"]
  node_payslips["Payslips<br/>[PaySlips.jsx]"]
  node_payroll_modules["Payroll modules<br/>[PayrollModule.jsx]"]
end

subgraph group_oversight["Resources and oversight"]
  node_approvals["Approvals<br/>[Approvals.jsx]"]
  node_complaints["Complaints<br/>[Complaints.jsx]"]
  node_documents["Documents<br/>[Documents.jsx]"]
  node_reports["Reports<br/>[Reports.jsx]"]
  node_notifications["Notifications<br/>[Notifications.jsx]"]
end

subgraph group_platform["Shared services"]
  node_profile["Current profile"]
  node_workforce["Workforce rules<br/>[workforce.js]"]
  node_supabase_client["Supabase client<br/>[supabase.js]"]
  node_supabase[("Supabase services")]
  node_document_storage[("Document storage")]
end

node_hr(("HR user"))

node_hr -->|"opens portal"| node_app
node_app -->|"routes to"| node_login
node_app -->|"protects workspace"| node_layout
node_app -->|"routes to"| node_dashboard
node_app -->|"routes to"| node_employment
node_app -->|"routes to"| node_onboarding
node_app -->|"routes to"| node_attendance
node_app -->|"routes to"| node_payroll
node_app -->|"routes to"| node_salary_processing
node_app -->|"routes to"| node_salary_structure
node_app -->|"routes to"| node_payslips
node_app -->|"routes to"| node_approvals
node_app -->|"routes to"| node_complaints
node_app -->|"routes to"| node_documents
node_app -->|"routes to"| node_reports
node_app -->|"routes to"| node_notifications
node_app -->|"routes to"| node_settings
node_layout -->|"renders profile"| node_profile
node_dashboard -->|"uses rules"| node_workforce
node_attendance -->|"uses rules"| node_workforce
node_employment -->|"uses rules"| node_workforce
node_payroll -->|"uses rules"| node_workforce
node_reports -->|"uses rules"| node_workforce
node_login -->|"authenticates through"| node_supabase_client
node_app -->|"checks session"| node_supabase_client
node_profile -->|"loads profile"| node_supabase_client
node_dashboard -->|"reads data"| node_supabase_client
node_employment -->|"reads and writes"| node_supabase_client
node_onboarding -->|"uses data"| node_supabase_client
node_attendance -->|"uses data"| node_supabase_client
node_payroll -->|"uses data"| node_supabase_client
node_salary_processing -->|"uses data"| node_supabase_client
node_salary_structure -->|"uses data"| node_supabase_client
node_payslips -->|"uses data"| node_supabase_client
node_payroll_modules -->|"queries and saves"| node_supabase_client
node_approvals -->|"uses data"| node_supabase_client
node_complaints -->|"uses data"| node_supabase_client
node_documents -->|"uses data"| node_supabase_client
node_reports -->|"uses data"| node_supabase_client
node_notifications -->|"uses data"| node_supabase_client
node_settings -->|"uses data"| node_supabase_client
node_supabase_client -->|"connects to"| node_supabase
node_documents -->|"uploads files"| node_document_storage

click node_app "https://github.com/codeacc384-coder/hr_hrms/blob/main/src/App.jsx"
click node_login "https://github.com/codeacc384-coder/hr_hrms/blob/main/src/pages/login/Login.jsx"
click node_layout "https://github.com/codeacc384-coder/hr_hrms/blob/main/src/components/layout/AppLayout.jsx"
click node_profile "https://github.com/codeacc384-coder/hr_hrms/blob/main/src/hooks/useCurrentProfile.js"
click node_dashboard "https://github.com/codeacc384-coder/hr_hrms/blob/main/src/pages/dashboard/Dashboard.jsx"
click node_employment "https://github.com/codeacc384-coder/hr_hrms/blob/main/src/pages/employment/Employment.jsx"
click node_onboarding "https://github.com/codeacc384-coder/hr_hrms/blob/main/src/pages/onboarding/Onboarding.jsx"
click node_attendance "https://github.com/codeacc384-coder/hr_hrms/blob/main/src/pages/attendance/Attendance.jsx"
click node_workforce "https://github.com/codeacc384-coder/hr_hrms/blob/main/src/utils/workforce.js"
click node_payroll "https://github.com/codeacc384-coder/hr_hrms/blob/main/src/pages/payroll/Payroll.jsx"
click node_salary_processing "https://github.com/codeacc384-coder/hr_hrms/blob/main/src/pages/SalaryProcessing/SalaryProcessing.jsx"
click node_salary_structure "https://github.com/codeacc384-coder/hr_hrms/blob/main/src/pages/SalaryStructure/SalaryStructure.jsx"
click node_payslips "https://github.com/codeacc384-coder/hr_hrms/blob/main/src/pages/payslips/PaySlips.jsx"
click node_payroll_modules "https://github.com/codeacc384-coder/hr_hrms/blob/main/src/pages/payroll/PayrollModule.jsx"
click node_approvals "https://github.com/codeacc384-coder/hr_hrms/blob/main/src/pages/approvals/Approvals.jsx"
click node_complaints "https://github.com/codeacc384-coder/hr_hrms/blob/main/src/pages/complaints/Complaints.jsx"
click node_documents "https://github.com/codeacc384-coder/hr_hrms/blob/main/src/pages/Documents/Documents.jsx"
click node_reports "https://github.com/codeacc384-coder/hr_hrms/blob/main/src/pages/reports/Reports.jsx"
click node_notifications "https://github.com/codeacc384-coder/hr_hrms/blob/main/src/pages/notifications/Notifications.jsx"
click node_settings "https://github.com/codeacc384-coder/hr_hrms/blob/main/src/pages/settings/Settings.jsx"
click node_supabase_client "https://github.com/codeacc384-coder/hr_hrms/blob/main/src/lib/supabase.js"

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_app,node_login,node_layout,node_settings,node_hr toneBlue
class node_dashboard,node_employment,node_onboarding,node_attendance toneAmber
class node_payroll,node_salary_processing,node_salary_structure,node_payslips,node_payroll_modules toneMint
class node_approvals,node_complaints,node_documents,node_reports,node_notifications toneRose
class node_profile,node_workforce,node_supabase_client,node_supabase,node_document_storage toneIndigo
```

## Components

### Access and shell

- [Routes and access](https://github.com/codeacc384-coder/hr_hrms/blob/main/src/App.jsx): `src/App.jsx`
- [Sign in](https://github.com/codeacc384-coder/hr_hrms/blob/main/src/pages/login/Login.jsx): `src/pages/login/Login.jsx`
- [Workspace shell](https://github.com/codeacc384-coder/hr_hrms/blob/main/src/components/layout/AppLayout.jsx): `src/components/layout/AppLayout.jsx`
- [Settings](https://github.com/codeacc384-coder/hr_hrms/blob/main/src/pages/settings/Settings.jsx): `src/pages/settings/Settings.jsx`

### Workforce operations

- [Dashboard](https://github.com/codeacc384-coder/hr_hrms/blob/main/src/pages/dashboard/Dashboard.jsx): `src/pages/dashboard/Dashboard.jsx`
- [Employment and teams](https://github.com/codeacc384-coder/hr_hrms/blob/main/src/pages/employment/Employment.jsx): `src/pages/employment/Employment.jsx`
- [Onboarding](https://github.com/codeacc384-coder/hr_hrms/blob/main/src/pages/onboarding/Onboarding.jsx): `src/pages/onboarding/Onboarding.jsx`
- [Attendance](https://github.com/codeacc384-coder/hr_hrms/blob/main/src/pages/attendance/Attendance.jsx): `src/pages/attendance/Attendance.jsx`

### Compensation

- [Payroll](https://github.com/codeacc384-coder/hr_hrms/blob/main/src/pages/payroll/Payroll.jsx): `src/pages/payroll/Payroll.jsx`
- [Salary processing](https://github.com/codeacc384-coder/hr_hrms/blob/main/src/pages/SalaryProcessing/SalaryProcessing.jsx): `src/pages/SalaryProcessing/SalaryProcessing.jsx`
- [Salary structure](https://github.com/codeacc384-coder/hr_hrms/blob/main/src/pages/SalaryStructure/SalaryStructure.jsx): `src/pages/SalaryStructure/SalaryStructure.jsx`
- [Payslips](https://github.com/codeacc384-coder/hr_hrms/blob/main/src/pages/payslips/PaySlips.jsx): `src/pages/payslips/PaySlips.jsx`
- [Payroll modules](https://github.com/codeacc384-coder/hr_hrms/blob/main/src/pages/payroll/PayrollModule.jsx): `src/pages/payroll/PayrollModule.jsx`

### Resources and oversight

- [Approvals](https://github.com/codeacc384-coder/hr_hrms/blob/main/src/pages/approvals/Approvals.jsx): `src/pages/approvals/Approvals.jsx`
- [Complaints](https://github.com/codeacc384-coder/hr_hrms/blob/main/src/pages/complaints/Complaints.jsx): `src/pages/complaints/Complaints.jsx`
- [Documents](https://github.com/codeacc384-coder/hr_hrms/blob/main/src/pages/Documents/Documents.jsx): `src/pages/Documents/Documents.jsx`
- [Reports](https://github.com/codeacc384-coder/hr_hrms/blob/main/src/pages/reports/Reports.jsx): `src/pages/reports/Reports.jsx`
- [Notifications](https://github.com/codeacc384-coder/hr_hrms/blob/main/src/pages/notifications/Notifications.jsx): `src/pages/notifications/Notifications.jsx`

### Shared services

- [Current profile](https://github.com/codeacc384-coder/hr_hrms/blob/main/src/hooks/useCurrentProfile.js): `src/hooks/useCurrentProfile.js`
- [Workforce rules](https://github.com/codeacc384-coder/hr_hrms/blob/main/src/utils/workforce.js): `src/utils/workforce.js`
- [Supabase client](https://github.com/codeacc384-coder/hr_hrms/blob/main/src/lib/supabase.js): `src/lib/supabase.js`
- **Supabase services**
- **Document storage**

### Other components

- **HR user**

## Connections

- HR user → Routes and access: opens portal (evidence: `src/App.jsx`)
- Routes and access → Sign in: routes to (evidence: `src/App.jsx`)
- Routes and access → Workspace shell: protects workspace (evidence: `src/App.jsx`)
- Routes and access → Dashboard: routes to (evidence: `src/App.jsx`)
- Routes and access → Employment and teams: routes to (evidence: `src/App.jsx`)
- Routes and access → Onboarding: routes to (evidence: `src/App.jsx`)
- Routes and access → Attendance: routes to (evidence: `src/App.jsx`)
- Routes and access → Payroll: routes to (evidence: `src/App.jsx`)
- Routes and access → Salary processing: routes to (evidence: `src/App.jsx`)
- Routes and access → Salary structure: routes to (evidence: `src/App.jsx`)
- Routes and access → Payslips: routes to (evidence: `src/App.jsx`)
- Routes and access → Approvals: routes to (evidence: `src/App.jsx`)
- Routes and access → Complaints: routes to (evidence: `src/App.jsx`)
- Routes and access → Documents: routes to (evidence: `src/App.jsx`)
- Routes and access → Reports: routes to (evidence: `src/App.jsx`)
- Routes and access → Notifications: routes to (evidence: `src/App.jsx`)
- Routes and access → Settings: routes to (evidence: `src/App.jsx`)
- Workspace shell → Current profile: renders profile
- Dashboard → Workforce rules: uses rules (evidence: `src/pages/dashboard/Dashboard.jsx`)
- Attendance → Workforce rules: uses rules (evidence: `src/pages/attendance/Attendance.jsx`)
- Employment and teams → Workforce rules: uses rules (evidence: `src/pages/employment/Employment.jsx`)
- Payroll → Workforce rules: uses rules (evidence: `src/pages/payroll/Payroll.jsx`)
- Reports → Workforce rules: uses rules (evidence: `src/pages/reports/Reports.jsx`)
- Sign in → Supabase client: authenticates through (evidence: `src/pages/login/Login.jsx`)
- Routes and access → Supabase client: checks session (evidence: `src/App.jsx`)
- Current profile → Supabase client: loads profile (evidence: `src/hooks/useCurrentProfile.js`)
- Dashboard → Supabase client: reads data (evidence: `src/pages/dashboard/Dashboard.jsx`)
- Employment and teams → Supabase client: reads and writes (evidence: `src/pages/employment/Employment.jsx`)
- Onboarding → Supabase client: uses data (evidence: `src/pages/onboarding/Onboarding.jsx`)
- Attendance → Supabase client: uses data (evidence: `src/pages/attendance/Attendance.jsx`)
- Payroll → Supabase client: uses data (evidence: `src/pages/payroll/Payroll.jsx`)
- Salary processing → Supabase client: uses data (evidence: `src/pages/SalaryProcessing/SalaryProcessing.jsx`)
- Salary structure → Supabase client: uses data (evidence: `src/pages/SalaryStructure/SalaryStructure.jsx`)
- Payslips → Supabase client: uses data (evidence: `src/pages/payslips/PaySlips.jsx`)
- Payroll modules → Supabase client: queries and saves (evidence: `src/pages/payroll/PayrollModule.jsx`)
- Approvals → Supabase client: uses data (evidence: `src/pages/approvals/Approvals.jsx`)
- Complaints → Supabase client: uses data (evidence: `src/pages/complaints/Complaints.jsx`)
- Documents → Supabase client: uses data (evidence: `src/pages/Documents/Documents.jsx`)
- Reports → Supabase client: uses data (evidence: `src/pages/reports/Reports.jsx`)
- Notifications → Supabase client: uses data (evidence: `src/pages/notifications/Notifications.jsx`)
- Settings → Supabase client: uses data (evidence: `src/pages/settings/Settings.jsx`)
- Supabase client → Supabase services: connects to (evidence: `src/lib/supabase.js`)
- Documents → Document storage: uploads files (evidence: `src/pages/Documents/Documents.jsx`)
