The Institutional
Workforce
The HR module manages the hospital's people—employees, their departments, designations, credentials, and professional lifecycle. It is the system of record for every staff member in the institution.
What is HR Management?
HR Management maintains the complete employee lifecycle: recruitment (onboarding new staff), employee records (personal info, qualifications, contracts), department/designation mapping, credential tracking (licenses, certifications, expiry dates), shift/roster management, and performance workflows.
Every doctor, nurse, technician, administrator, and support staff member has a digital record here that links to their system login, clinical responsibilities, and payroll.
Why Does It Exist?
- → Expired licenses — A doctor with an expired license shouldn't be practicing
- → Coverage gaps — Without roster management, shifts can go unfilled
- → Paper records — Paper-based employee files are hard to search, insecure, and get lost
- → Payroll errors — HR data feeds payroll; errors here multiply downstream
Every Feature Explained
Employee Records
Digital personnel files for every staff member.
Centralizes all employee information in one secure, searchable place.
Records include name, contact, photo, department, designation, qualifications, certifications, emergency contacts, and employment history.
Organizations, Projects & Departments
HR org tree, projects, departments, and designations.
Separates staffing structure from clinical campus geography and enables org-scoped policies.
UI: Organizations (/dashboard/hr/org-units, org:units:*), Projects (/dashboard/hr/projects, hr:projects:*), Departments. Hierarchy: OrgUnit → Project → Department → Designation via employee. Employee.branchId is the clinical work campus (Working-in), never OrgUnit. Optional scope:org:assigned ANDs session orgUnitIds on HR lists.
Credential Tracking
Track professional licenses, certifications, and their expiry dates.
Prevents unlicensed practice. Regulatory compliance.
Certificates are uploaded with issue/expiry dates. Near-expiry credentials trigger alerts. Expired credentials lock the staff member from related clinical functions.
Organizational Structure
View the hospital's reporting hierarchy.
Understand who reports to whom. Essential for approvals and escalations.
Org chart shows managers, their teams, and department structures. Can be used for permission scoping (org scope).
Enhanced Employee Profile
Comprehensive digital personnel profiles with demographic and employment history fields.
Captures the full employee picture for regulatory compliance, emergency contacts, and payroll accuracy.
Profiles include father name, marital status, blood group, religion, nationality, residential address, emergency relation, probation end date, and salary history (hiring, joining, current).
Employment Types
Classify employees by employment category.
Different employment categories have different rights, benefits, and payroll rules.
Canonical types: Probation, Permanent, Contract, Intern, Consultant, Temporary. Each type governs entitlement calculations; older imported records may still show a legacy label but new/edited records must use a canonical type.
HR Policy Templates
Configurable policy engine for leave, late coming, overtime, payroll, and employment lifecycle.
Institutional rules change; policies should be versioned and activatable without code deploys.
HR Policies tab (hr:policy:*). Categories store JSON config. employment_lifecycle policies can auto-confirm probation as permanent and notify HR before probation ends. See /handbook/people/hr-policies.
Employee Documents
Digital document locker for each employee.
Eliminates paper files. Critical documents are always accessible and never lost.
Document types include CNIC (front/back), appointment letter, resume, certificates, bank documents, and others. Files are stored securely with S3 keys. Each document is tagged by type for easy retrieval.
Security Deposit Management
Track employee security deposits and installment recovery.
Some roles require financial bonds. The system tracks collection and return.
Configure deposit amount, installment count, and monthly recovery. Auto-deduct installments from payroll each month. Ledger tracks every installment with month/year. Remaining balance is always visible.
Enhanced Bank Details
Store full banking information for salary disbursement.
Accurate bank details prevent payment failures and delays.
Fields include bank name, branch name, branch code, IBAN, account title, and payment mode (bank transfer, cheque, cash). IBAN validation is built-in.
Late Exemption
Exempt specific employees from late-coming penalties.
Certain roles (e.g., consultants, on-call staff) may have flexible attendance requirements.
Configure late exempt flag with optional date range (from/until) and free late allowances per month. Exempted employees are not penalized for late arrivals within their allowance.
Related Modules
The HR module feeds directly into these adjacent systems. Visit their dedicated pages for complete documentation.
Employee Appraisals
Performance review cycles, goals, KPIs, manager and HR dual reviews, ratings, promotion and increment recommendations.
IT Onboarding & Notifications
Account provisioning for new employees, temporary password generation, role assignment, and IT setup tracking.
HR Policy Templates
Leave eligibility, HOD→HR approval, probation auto-confirm, and category-based policy config.
Technical Architecture
| Field | Type | Institutional Role |
|---|---|---|
| worker_id | UUID | Unique institutional professional ID. |
| modality | Enum | Clinical, Nursing, Admin, Support. |
| credential_hash | Varchar | Verification mark for professional license. |
| duty_status | Boolean | Active on-roster state. |
Note: Sensitive fields use AES-256 field-level encryption where applicable.
Governance & Power
hr:roster:managehr:audit:viewhr:edithr:viewCredential Lock
Clinical staff with expired licenses are automatically restricted from signing diagnostic reports or surgical logs.
Roster Sync
Attendance logs sync with departmental duty rosters to identify gaps in clinical coverage.
IBAN Validation
Bank account IBAN numbers are validated before payroll disbursement to prevent rejected transactions.
Security Deposit Recovery
Monthly security deposit installments are automatically deducted from payroll until the full amount is recovered.