Platform

Five engines carry the hard parts of HR

The domain complexity lives in dedicated engines rather than scattered scripts, so behaviour is predictable and rules stay configurable.

Payroll engine

  • Annualised progressive tax from a configurable bracket table
  • Mid-month proration on actual vs expected hours
  • Overtime valued on prorated basic or full salary
  • Deductions capped at a configurable percent of gross (default 70%)
  • Future-month and duplicate-run locks, plus full reversal

Leave engine

  • Three-level approval: Manager → HR → CEO
  • Configurable rule for when CEO sign-off is required
  • Probation-aware eligibility and accrual
  • Duplicate-request prevention and advance-notice rules

Attendance engine

  • Auto-checkout and grace-period auto-absent marking
  • Separate handling for part-time and exempt full-time staff
  • Correction workflow with an auditable ledger
  • Biometric device records feed in automatically

Claims, advances & commission

  • Claims flow Employee → Manager → Accounts
  • Loans disburse then repay by monthly instalment
  • Auto-completion at zero balance
  • Approved deals aggregate into the payroll run

Technology stack

Built on a mature open-source framework that already powers ERPNext — a large developer and hosting ecosystem, not a bespoke unsupported stack.

Application framework

Frappe v15 (Python 3.12)

Database

MariaDB (MySQL-compatible)

Hosting

Single bench-deployed Frappe site

Authentication

Frappe sessions with CSRF enforced

Scheduling

Native Frappe scheduler via hooks.py

File storage

Built-in file manager for payslips & docs

A modular backend, on purpose

The original monolith was decomposed into 15+ focused modules, so extending or re-skinning one feature touches one file — not the whole codebase.

attendance_api.pyCheck-in/out, corrections, attendance scheduler
leave_api.pySubmission, approval, accrual, probation checks
payroll_api.pySingle/bulk runs, breakdowns, overtime, deductions
employee_crud.pyEmployee create / update / delete / list
organisation_api.pyOrg tree, departments, designations
auth_api.pyLogin, password reset, CSRF token issuance
reports_api.pyAttendance, leave and payroll summary reports
asset_api.pyAsset CRUD, depreciation, assignment
accounts_api.pyBank advice export, compliance, asset disposal
Explore compliance