# leanquality2017/lean-hrm architecture

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

- Interactive diagram: https://gitdiagram.com/leanquality2017/lean-hrm
- Repository: https://github.com/leanquality2017/lean-hrm

## Overview

UniHR is a role- and company-scoped HR management application, with institute operations and payroll available as gated modules. Users enter through the Next.js application and authentication flow; domain pages call API route handlers, which validate and authorize requests before operating on Prisma-backed records. The graph emphasizes documented employee, payroll, attendance, leave, and institute capabilities; most domain handlers and UI pages were not sampled, so their specific call relationships are omitted.

Main entry points: [`src/lib/db.ts`](https://github.com/leanquality2017/lean-hrm/blob/main/src/lib/db.ts) (Prisma database), [`src/lib/api-auth.ts`](https://github.com/leanquality2017/lean-hrm/blob/main/src/lib/api-auth.ts) (API authorization), [`src/app/api/payroll/route.ts`](https://github.com/leanquality2017/lean-hrm/blob/main/src/app/api/payroll/route.ts) (Payroll), [`src/app/api/employees/route.ts`](https://github.com/leanquality2017/lean-hrm/blob/main/src/app/api/employees/route.ts) (Employee management)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["Application entry"]
  node_app["App shell<br/>[app-shell.tsx]"]
  node_pwa["PWA registration<br/>[pwa-register.tsx]"]
end

subgraph group_security["Identity and safeguards"]
  node_login["Credentials login<br/>[auth.ts]"]
  node_session["API authorization<br/>[api-auth.ts]"]
  node_pageguard["Page guards<br/>[page-guard.ts]"]
end

subgraph group_hr["Workforce operations"]
  node_employees["Employee management<br/>[route.ts]"]
  node_attendance["Attendance<br/>[route.ts]"]
  node_leaves["Leave requests<br/>[route.ts]"]
  node_payroll["Payroll<br/>[route.ts]"]
  node_workreports["Work reports<br/>[route.ts]"]
  node_recruitment["Recruitment<br/>[route.ts]"]
  node_companies["Company operations<br/>[route.ts]"]
end

subgraph group_institute["Institute operations"]
  node_institute["Institute modules"]
end

subgraph group_platform["Shared services"]
  node_validation["Request validation<br/>[validation.ts]"]
  node_features["Feature gates<br/>[feature-gates.ts]"]
  node_audit["Audit logging<br/>[audit.ts]"]
  node_pagination["Pagination<br/>[pagination.ts]"]
  node_database[("Prisma database<br/>[db.ts]")]
  node_constants["Domain constants<br/>[constants.ts]"]
end

node_user(("HR user"))

node_user -->|"uses"| node_app
node_app -->|"registers"| node_pwa
node_user -.->|"signs in"| node_login
node_login -->|"checks credentials"| node_database
node_login -.->|"provides session"| node_session
node_session -->|"loads user"| node_database
node_pageguard -->|"checks gates"| node_features
node_user -.->|"manages staff"| node_employees
node_user -.->|"records attendance"| node_attendance
node_user -.->|"requests leave"| node_leaves
node_user -.->|"reviews payroll"| node_payroll
node_user -.->|"submits reports"| node_workreports
node_user -.->|"handles applicants"| node_recruitment
node_user -.->|"administers companies"| node_companies
node_user -.->|"manages institute"| node_institute
node_employees -->|"authorizes"| node_session
node_employees -->|"validates input"| node_validation
node_employees -->|"reads and writes"| node_database
node_attendance -->|"authorizes"| node_session
node_attendance -->|"reads and writes"| node_database
node_leaves -->|"authorizes"| node_session
node_leaves -->|"reads and writes"| node_database
node_payroll -->|"authorizes"| node_session
node_payroll -->|"checks gate"| node_features
node_payroll -->|"validates input"| node_validation
node_payroll -->|"records events"| node_audit
node_payroll -->|"reads and writes"| node_database
node_payroll -->|"parses pages"| node_pagination
node_workreports -->|"authorizes"| node_session
node_workreports -->|"reads and writes"| node_database
node_recruitment -->|"authorizes"| node_session
node_recruitment -->|"validates input"| node_validation
node_recruitment -->|"reads and writes"| node_database
node_companies -->|"authorizes"| node_session
node_companies -->|"reads and writes"| node_database
node_institute -.->|"gated by"| node_features
node_employees -->|"uses roles"| node_constants
node_audit -->|"writes logs"| node_database

click node_app "https://github.com/leanquality2017/lean-hrm/blob/main/src/components/app-shell.tsx"
click node_pwa "https://github.com/leanquality2017/lean-hrm/blob/main/src/components/pwa-register.tsx"
click node_login "https://github.com/leanquality2017/lean-hrm/blob/main/src/lib/auth.ts"
click node_session "https://github.com/leanquality2017/lean-hrm/blob/main/src/lib/api-auth.ts"
click node_pageguard "https://github.com/leanquality2017/lean-hrm/blob/main/src/lib/page-guard.ts"
click node_employees "https://github.com/leanquality2017/lean-hrm/blob/main/src/app/api/employees/route.ts"
click node_attendance "https://github.com/leanquality2017/lean-hrm/blob/main/src/app/api/attendance/route.ts"
click node_leaves "https://github.com/leanquality2017/lean-hrm/blob/main/src/app/api/leaves/route.ts"
click node_payroll "https://github.com/leanquality2017/lean-hrm/blob/main/src/app/api/payroll/route.ts"
click node_workreports "https://github.com/leanquality2017/lean-hrm/blob/main/src/app/api/work-reports/route.ts"
click node_recruitment "https://github.com/leanquality2017/lean-hrm/blob/main/src/app/api/applications/route.ts"
click node_companies "https://github.com/leanquality2017/lean-hrm/blob/main/src/app/api/companies/route.ts"
click node_institute "https://github.com/leanquality2017/lean-hrm/tree/main/src/app/(app)/institute"
click node_validation "https://github.com/leanquality2017/lean-hrm/blob/main/src/lib/validation.ts"
click node_features "https://github.com/leanquality2017/lean-hrm/blob/main/src/lib/feature-gates.ts"
click node_audit "https://github.com/leanquality2017/lean-hrm/blob/main/src/lib/audit.ts"
click node_pagination "https://github.com/leanquality2017/lean-hrm/blob/main/src/lib/pagination.ts"
click node_database "https://github.com/leanquality2017/lean-hrm/blob/main/src/lib/db.ts"
click node_constants "https://github.com/leanquality2017/lean-hrm/blob/main/src/lib/constants.ts"

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_pwa,node_user toneBlue
class node_login,node_session,node_pageguard toneAmber
class node_employees,node_attendance,node_leaves,node_payroll,node_workreports,node_recruitment,node_companies toneMint
class node_institute toneRose
class node_validation,node_features,node_audit,node_pagination,node_database,node_constants toneIndigo
```

## Components

### Application entry

- [App shell](https://github.com/leanquality2017/lean-hrm/blob/main/src/components/app-shell.tsx): `src/components/app-shell.tsx`
- [PWA registration](https://github.com/leanquality2017/lean-hrm/blob/main/src/components/pwa-register.tsx): `src/components/pwa-register.tsx`

### Identity and safeguards

- [Credentials login](https://github.com/leanquality2017/lean-hrm/blob/main/src/lib/auth.ts): `src/lib/auth.ts`
- [API authorization](https://github.com/leanquality2017/lean-hrm/blob/main/src/lib/api-auth.ts): `src/lib/api-auth.ts`
- [Page guards](https://github.com/leanquality2017/lean-hrm/blob/main/src/lib/page-guard.ts): `src/lib/page-guard.ts`

### Workforce operations

- [Employee management](https://github.com/leanquality2017/lean-hrm/blob/main/src/app/api/employees/route.ts): `src/app/api/employees/route.ts`
- [Attendance](https://github.com/leanquality2017/lean-hrm/blob/main/src/app/api/attendance/route.ts): `src/app/api/attendance/route.ts`
- [Leave requests](https://github.com/leanquality2017/lean-hrm/blob/main/src/app/api/leaves/route.ts): `src/app/api/leaves/route.ts`
- [Payroll](https://github.com/leanquality2017/lean-hrm/blob/main/src/app/api/payroll/route.ts): `src/app/api/payroll/route.ts`
- [Work reports](https://github.com/leanquality2017/lean-hrm/blob/main/src/app/api/work-reports/route.ts): `src/app/api/work-reports/route.ts`
- [Recruitment](https://github.com/leanquality2017/lean-hrm/blob/main/src/app/api/applications/route.ts): `src/app/api/applications/route.ts`
- [Company operations](https://github.com/leanquality2017/lean-hrm/blob/main/src/app/api/companies/route.ts): `src/app/api/companies/route.ts`

### Institute operations

- [Institute modules](https://github.com/leanquality2017/lean-hrm/tree/main/src/app/(app)/institute): `src/app/(app)/institute`

### Shared services

- [Request validation](https://github.com/leanquality2017/lean-hrm/blob/main/src/lib/validation.ts): `src/lib/validation.ts`
- [Feature gates](https://github.com/leanquality2017/lean-hrm/blob/main/src/lib/feature-gates.ts): `src/lib/feature-gates.ts`
- [Audit logging](https://github.com/leanquality2017/lean-hrm/blob/main/src/lib/audit.ts): `src/lib/audit.ts`
- [Pagination](https://github.com/leanquality2017/lean-hrm/blob/main/src/lib/pagination.ts): `src/lib/pagination.ts`
- [Prisma database](https://github.com/leanquality2017/lean-hrm/blob/main/src/lib/db.ts): `src/lib/db.ts`
- [Domain constants](https://github.com/leanquality2017/lean-hrm/blob/main/src/lib/constants.ts): `src/lib/constants.ts`

### Other components

- **HR user**

## Connections

- HR user → App shell: uses (evidence: `src/components/app-shell.tsx`)
- App shell → PWA registration: registers (evidence: `src/components/app-shell.tsx`)
- HR user → Credentials login: signs in
- Credentials login → Prisma database: checks credentials (evidence: `src/lib/auth.ts`)
- Credentials login → API authorization: provides session (evidence: `src/lib/api-auth.ts`)
- API authorization → Prisma database: loads user (evidence: `src/lib/api-auth.ts`)
- Page guards → Feature gates: checks gates (evidence: `src/lib/page-guard.ts`)
- HR user → Employee management: manages staff
- HR user → Attendance: records attendance
- HR user → Leave requests: requests leave
- HR user → Payroll: reviews payroll
- HR user → Work reports: submits reports
- HR user → Recruitment: handles applicants
- HR user → Company operations: administers companies
- HR user → Institute modules: manages institute
- Employee management → API authorization: authorizes (evidence: `src/app/api/employees/route.ts`)
- Employee management → Request validation: validates input (evidence: `src/app/api/employees/route.ts`)
- Employee management → Prisma database: reads and writes (evidence: `src/app/api/employees/route.ts`)
- Attendance → API authorization: authorizes (evidence: `src/app/api/attendance/route.ts`)
- Attendance → Prisma database: reads and writes (evidence: `src/app/api/attendance/route.ts`)
- Leave requests → API authorization: authorizes (evidence: `src/app/api/leaves/route.ts`)
- Leave requests → Prisma database: reads and writes (evidence: `src/app/api/leaves/route.ts`)
- Payroll → API authorization: authorizes (evidence: `src/app/api/payroll/route.ts`)
- Payroll → Feature gates: checks gate (evidence: `src/app/api/payroll/route.ts`)
- Payroll → Request validation: validates input (evidence: `src/app/api/payroll/route.ts`)
- Payroll → Audit logging: records events (evidence: `src/app/api/payroll/route.ts`)
- Payroll → Prisma database: reads and writes (evidence: `src/app/api/payroll/route.ts`)
- Payroll → Pagination: parses pages (evidence: `src/app/api/payroll/route.ts`)
- Work reports → API authorization: authorizes (evidence: `src/app/api/work-reports/route.ts`)
- Work reports → Prisma database: reads and writes (evidence: `src/app/api/work-reports/route.ts`)
- Recruitment → API authorization: authorizes (evidence: `src/app/api/applications/route.ts`)
- Recruitment → Request validation: validates input (evidence: `src/app/api/applications/route.ts`)
- Recruitment → Prisma database: reads and writes (evidence: `src/app/api/applications/route.ts`)
- Company operations → API authorization: authorizes (evidence: `src/app/api/companies/route.ts`)
- Company operations → Prisma database: reads and writes (evidence: `src/app/api/companies/route.ts`)
- Institute modules → Feature gates: gated by
- Employee management → Domain constants: uses roles (evidence: `src/app/api/employees/route.ts`)
- Audit logging → Prisma database: writes logs (evidence: `src/lib/audit.ts`)
