# frappe/hrms architecture

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

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

## Overview

Frappe HR is an HRMS and payroll product built on Frappe, with a Vue employee-facing mobile/PWA frontend and server-side HR workflows. A user enters through the employee app, authenticates and views employee-specific screens, then submits or reviews requests such as leave, attendance, and expenses; HR/payroll processes those records and produces payroll and salary-slip results. The tree and README establish the broader lifecycle, performance, taxation, and accounting capabilities. Some links between frontend screens and backend handlers are not visible in the excerpts, so those are shown as unverified.

Main entry points: [`frontend/src/main.js`](https://github.com/frappe/hrms/blob/develop/frontend/src/main.js) (Mobile app shell), [`hrms/hr/doctype/leave_application/leave_application.py`](https://github.com/frappe/hrms/blob/develop/hrms/hr/doctype/leave_application/leave_application.py) (Leave requests), [`hrms/payroll/doctype/salary_slip/salary_slip.py`](https://github.com/frappe/hrms/blob/develop/hrms/payroll/doctype/salary_slip/salary_slip.py) (Salary slips), [`frontend/src/router/index.js`](https://github.com/frappe/hrms/blob/develop/frontend/src/router/index.js) (App routing)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["Employee app"]
  node_frontend["Mobile app shell<br/>[main.js]"]
  node_routing["App routing<br/>[index.js]"]
  node_app_views["Employee views"]
  node_push["Push notifications"]
end

subgraph group_people["People lifecycle"]
  node_onboarding["Onboarding"]
  node_employee_lifecycle["Employee lifecycle"]
  node_recruitment["Recruitment"]
end

subgraph group_workforce["Workforce operations"]
  node_leave["Leave requests"]
  node_leave_ledger["Leave ledger"]
  node_holiday["Holiday scheduling<br/>[holiday_list.py]"]
  node_attendance["Attendance and shifts"]
  node_roster["Roster interface<br/>[MonthView.vue]"]
end

subgraph group_finance["Expenses and payroll"]
  node_expense_claim["Expense claims<br/>[expense_claim.py]"]
  node_employee_advance["Employee advances"]
  node_payroll_entry["Payroll processing<br/>[payroll_entry.py]"]
  node_salary_slip["Salary slips<br/>[salary_slip.py]"]
  node_salary_structure["Salary structures"]
  node_taxation["Taxation"]
end

subgraph group_performance["Performance"]
  node_performance["Appraisals and goals"]
end

node_employee(("Employee"))

node_employee -->|"uses"| node_frontend
node_frontend -->|"installs"| node_routing
node_routing -->|"routes to"| node_app_views
node_frontend -->|"initializes"| node_push
node_employee -.->|"joins through"| node_onboarding
node_employee -.->|"progresses through"| node_employee_lifecycle
node_employee -.->|"is recruited through"| node_recruitment
node_employee -.->|"requests leave"| node_leave
node_leave -->|"updates"| node_leave_ledger
node_leave -->|"uses calendar rules"| node_holiday
node_employee -.->|"checks in"| node_attendance
node_roster -.->|"supports scheduling"| node_attendance
node_employee -.->|"submits claims"| node_expense_claim
node_employee -.->|"requests advances"| node_employee_advance
node_payroll_entry -->|"creates slips"| node_salary_slip
node_salary_slip -->|"uses structure"| node_salary_structure
node_salary_slip -.->|"calculates tax"| node_taxation
node_employee -.->|"participates in review"| node_performance

click node_frontend "https://github.com/frappe/hrms/blob/develop/frontend/src/main.js"
click node_routing "https://github.com/frappe/hrms/blob/develop/frontend/src/router/index.js"
click node_app_views "https://github.com/frappe/hrms/tree/develop/frontend/src/views"
click node_push "https://github.com/frappe/hrms/blob/develop/frontend/src/utils/pushNotifications.js"
click node_onboarding "https://github.com/frappe/hrms/tree/develop/hrms/hr/doctype/employee_onboarding"
click node_employee_lifecycle "https://github.com/frappe/hrms/tree/develop/hrms/hr/doctype"
click node_recruitment "https://github.com/frappe/hrms/tree/develop/hrms/hr/doctype/job_applicant"
click node_leave "https://github.com/frappe/hrms/blob/develop/hrms/hr/doctype/leave_application/leave_application.py"
click node_leave_ledger "https://github.com/frappe/hrms/blob/develop/hrms/hr/doctype/leave_ledger_entry/leave_ledger_entry.py"
click node_holiday "https://github.com/frappe/hrms/blob/develop/hrms/utils/holiday_list.py"
click node_attendance "https://github.com/frappe/hrms/tree/develop/hrms/hr/doctype/attendance"
click node_roster "https://github.com/frappe/hrms/blob/develop/roster/src/views/MonthView.vue"
click node_expense_claim "https://github.com/frappe/hrms/blob/develop/hrms/hr/doctype/expense_claim/expense_claim.py"
click node_employee_advance "https://github.com/frappe/hrms/blob/develop/hrms/hr/doctype/employee_advance/employee_advance.py"
click node_payroll_entry "https://github.com/frappe/hrms/blob/develop/hrms/payroll/doctype/payroll_entry/payroll_entry.py"
click node_salary_slip "https://github.com/frappe/hrms/blob/develop/hrms/payroll/doctype/salary_slip/salary_slip.py"
click node_salary_structure "https://github.com/frappe/hrms/blob/develop/hrms/payroll/doctype/salary_structure/salary_structure.py"
click node_taxation "https://github.com/frappe/hrms/blob/develop/hrms/payroll/report/income_tax_computation/income_tax_computation.py"
click node_performance "https://github.com/frappe/hrms/tree/develop/hrms/hr/doctype/appraisal"

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_frontend,node_routing,node_app_views,node_push toneBlue
class node_onboarding,node_employee_lifecycle,node_recruitment toneAmber
class node_leave,node_leave_ledger,node_holiday,node_attendance,node_roster toneMint
class node_expense_claim,node_employee_advance,node_payroll_entry,node_salary_slip,node_salary_structure,node_taxation toneRose
class node_performance,node_employee toneIndigo
```

## Components

### Employee app

- [Mobile app shell](https://github.com/frappe/hrms/blob/develop/frontend/src/main.js): `frontend/src/main.js`
- [App routing](https://github.com/frappe/hrms/blob/develop/frontend/src/router/index.js): `frontend/src/router/index.js`
- [Employee views](https://github.com/frappe/hrms/tree/develop/frontend/src/views): `frontend/src/views`
- [Push notifications](https://github.com/frappe/hrms/blob/develop/frontend/src/utils/pushNotifications.js): `frontend/src/utils/pushNotifications.js`

### People lifecycle

- [Onboarding](https://github.com/frappe/hrms/tree/develop/hrms/hr/doctype/employee_onboarding): `hrms/hr/doctype/employee_onboarding`
- [Employee lifecycle](https://github.com/frappe/hrms/tree/develop/hrms/hr/doctype): `hrms/hr/doctype`
- [Recruitment](https://github.com/frappe/hrms/tree/develop/hrms/hr/doctype/job_applicant): `hrms/hr/doctype/job_applicant`

### Workforce operations

- [Leave requests](https://github.com/frappe/hrms/blob/develop/hrms/hr/doctype/leave_application/leave_application.py): `hrms/hr/doctype/leave_application/leave_application.py`
- [Leave ledger](https://github.com/frappe/hrms/blob/develop/hrms/hr/doctype/leave_ledger_entry/leave_ledger_entry.py): `hrms/hr/doctype/leave_ledger_entry/leave_ledger_entry.py`
- [Holiday scheduling](https://github.com/frappe/hrms/blob/develop/hrms/utils/holiday_list.py): `hrms/utils/holiday_list.py`
- [Attendance and shifts](https://github.com/frappe/hrms/tree/develop/hrms/hr/doctype/attendance): `hrms/hr/doctype/attendance`
- [Roster interface](https://github.com/frappe/hrms/blob/develop/roster/src/views/MonthView.vue): `roster/src/views/MonthView.vue`

### Expenses and payroll

- [Expense claims](https://github.com/frappe/hrms/blob/develop/hrms/hr/doctype/expense_claim/expense_claim.py): `hrms/hr/doctype/expense_claim/expense_claim.py`
- [Employee advances](https://github.com/frappe/hrms/blob/develop/hrms/hr/doctype/employee_advance/employee_advance.py): `hrms/hr/doctype/employee_advance/employee_advance.py`
- [Payroll processing](https://github.com/frappe/hrms/blob/develop/hrms/payroll/doctype/payroll_entry/payroll_entry.py): `hrms/payroll/doctype/payroll_entry/payroll_entry.py`
- [Salary slips](https://github.com/frappe/hrms/blob/develop/hrms/payroll/doctype/salary_slip/salary_slip.py): `hrms/payroll/doctype/salary_slip/salary_slip.py`
- [Salary structures](https://github.com/frappe/hrms/blob/develop/hrms/payroll/doctype/salary_structure/salary_structure.py): `hrms/payroll/doctype/salary_structure/salary_structure.py`
- [Taxation](https://github.com/frappe/hrms/blob/develop/hrms/payroll/report/income_tax_computation/income_tax_computation.py): `hrms/payroll/report/income_tax_computation/income_tax_computation.py`

### Performance

- [Appraisals and goals](https://github.com/frappe/hrms/tree/develop/hrms/hr/doctype/appraisal): `hrms/hr/doctype/appraisal`

### Other components

- **Employee**

## Connections

- Employee → Mobile app shell: uses (evidence: `README.md`)
- Mobile app shell → App routing: installs (evidence: `frontend/src/main.js`)
- App routing → Employee views: routes to (evidence: `frontend/src/router/index.js`)
- Mobile app shell → Push notifications: initializes (evidence: `frontend/src/main.js`)
- Employee → Onboarding: joins through (evidence: `README.md`)
- Employee → Employee lifecycle: progresses through (evidence: `README.md`)
- Employee → Recruitment: is recruited through (evidence: `README.md`)
- Employee → Leave requests: requests leave (evidence: `README.md`)
- Leave requests → Leave ledger: updates (evidence: `hrms/hr/doctype/leave_application/leave_application.py`)
- Leave requests → Holiday scheduling: uses calendar rules (evidence: `hrms/hr/doctype/leave_application/leave_application.py`)
- Employee → Attendance and shifts: checks in (evidence: `README.md`)
- Roster interface → Attendance and shifts: supports scheduling (evidence: `README.md`)
- Employee → Expense claims: submits claims (evidence: `README.md`)
- Employee → Employee advances: requests advances (evidence: `README.md`)
- Payroll processing → Salary slips: creates slips (evidence: `hrms/payroll/doctype/payroll_entry/payroll_entry.py`)
- Salary slips → Salary structures: uses structure (evidence: `hrms/payroll/doctype/salary_slip/salary_slip.py`)
- Salary slips → Taxation: calculates tax (evidence: `README.md`)
- Employee → Appraisals and goals: participates in review (evidence: `README.md`)
