How frappe/hrms works
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: main.js Mobile app shell · leave_application.py Leave requests · salary_slip.py Salary slips · index.js App routing
Components 20
Employee app
- Mobile app shell
frontend/src/main.js - App routing
frontend/src/router/index.js - Employee views
frontend/src/views - Push notifications
frontend/src/utils/pushNotifications.js
People lifecycle
- Onboarding
hrms/hr/doctype/employee_onboarding - Employee lifecycle
hrms/hr/doctype - Recruitment
hrms/hr/doctype/job_applicant
Workforce operations
- Leave requests
hrms/hr/doctype/leave_application/leave_application.py - Leave ledger
hrms/hr/doctype/leave_ledger_entry/leave_ledger_entry.py - Holiday scheduling
hrms/utils/holiday_list.py - Attendance and shifts
hrms/hr/doctype/attendance - Roster interface
roster/src/views/MonthView.vue
Expenses and payroll
- Expense claims
hrms/hr/doctype/expense_claim/expense_claim.py - Employee advances
hrms/hr/doctype/employee_advance/employee_advance.py - Payroll processing
hrms/payroll/doctype/payroll_entry/payroll_entry.py - Salary slips
hrms/payroll/doctype/salary_slip/salary_slip.py - Salary structures
hrms/payroll/doctype/salary_structure/salary_structure.py - Taxation
hrms/payroll/report/income_tax_computation/income_tax_computation.py
Performance
- Appraisals and goals
hrms/hr/doctype/appraisal
Other components
- Employee
Connections 18
- Employee → Mobile app shell: uses
README.md - Mobile app shell → App routing: installs
frontend/src/main.js - App routing → Employee views: routes to
frontend/src/router/index.js - Mobile app shell → Push notifications: initializes
frontend/src/main.js - Employee → Onboarding: joins through
README.md - Employee → Employee lifecycle: progresses through
README.md - Employee → Recruitment: is recruited through
README.md - Employee → Leave requests: requests leave
README.md - Leave requests → Leave ledger: updates
hrms/hr/doctype/leave_application/leave_application.py - Leave requests → Holiday scheduling: uses calendar rules
hrms/hr/doctype/leave_application/leave_application.py - Employee → Attendance and shifts: checks in
README.md - Roster interface → Attendance and shifts: supports scheduling
README.md - Employee → Expense claims: submits claims
README.md - Employee → Employee advances: requests advances
README.md - Payroll processing → Salary slips: creates slips
hrms/payroll/doctype/payroll_entry/payroll_entry.py - Salary slips → Salary structures: uses structure
hrms/payroll/doctype/salary_slip/salary_slip.py - Salary slips → Taxation: calculates tax
README.md - Employee → Appraisals and goals: participates in review
README.md