Actor: HR Administrator

حسب المصدر الأساسي HRM V1.0c — As an HR Administrator, I want to define threshold bands for each Performance Indicator (e.g. Below 70% = Needs Improvement, 70-90% = Meets, Above 90% = Exceeds), so that raw scores translate to a consistent qualitative rating.

As an HR Administrator, I want to define threshold bands for each Performance Indicator (e.g. Below 70% = Needs Improvement, 70-90% = Meets, Above 90% = Exceeds), so that raw scores translate to a consistent qualitative rating.

Actor: HR Administrator

حسب المصدر الأساسي HRM V1.0c — As an HR Administrator, I want every salary change to be logged with old value, new value, effective date, and reason, so that compensation history is fully auditable.

As an HR Administrator, I want every salary change to be logged with old value, new value, effective date, and reason, so that compensation history is fully auditable.

Actor: Authorized HR User

حسب المصدر الأساسي HRM V1.0c — As the System, I want Net Salary to be computed automatically from the active Salary Structure rather than manually entered, so that it can never drift from what payroll actually calculates.

As the System, I want Net Salary to be computed automatically from the active Salary Structure rather than manually entered, so that it can never drift from what payroll actually calculates.

Actor: HR Administrator

حسب المصدر الأساسي HRM V1.0c — As an HR Administrator, I want approved payslips automatically made available to each employee, so that they don't need to request them manually.

As an HR Administrator, I want approved payslips automatically made available to each employee, so that they don't need to request them manually.

Actor: Payroll Administrator

حسب المصدر الأساسي HRM V1.0c — As a Payroll Administrator, I want to define salary rules (Basic, Allowances, Deductions, Tax) with an explicit computation sequence and formula referencing other rules' outputs, so that dependent calculations (e.g. Tax based on Gross) always compute in the correct order.

As a Payroll Administrator, I want to define salary rules (Basic, Allowances, Deductions, Tax) with an explicit computation sequence and formula referencing other rules' outputs, so that dependent calculations (e.g. Tax based on Gross) always compute in the correct order.

Actor: Payroll Administrator

حسب المصدر الأساسي HRM V1.0c — As a Payroll Administrator, I want to bundle salary rules into named Salary Structures assignable to contracts, so that different employee categories (e.g. hourly vs. monthly, local vs. expat) can have different rule sets.

As a Payroll Administrator, I want to bundle salary rules into named Salary Structures assignable to contracts, so that different employee categories (e.g. hourly vs. monthly, local vs. expat) can have different rule sets.

Actor: Payroll Administrator

حسب المصدر الأساسي HRM V1.0c — As a Payroll Administrator, I want a contract's Salary Structure assignment to automatically sync into payroll runs, so that a contract amendment (Epic 6, US-009) is immediately reflected without a separate manual payroll-side update.

As a Payroll Administrator, I want a contract's Salary Structure assignment to automatically sync into payroll runs, so that a contract amendment (Epic 6, US-009) is immediately reflected without a separate manual payroll-side update.

Actor: Payroll Administrator

حسب المصدر الأساسي HRM V1.0c — As a Payroll Administrator, I want to configure Commission Types (e.g. Sales Target Commission, Referral Commission) with a calculation basis tied to achievement data, so that variable, performance-linked pay is computed consistently rather than entered manually each cycle.

As a Payroll Administrator, I want to configure Commission Types (e.g. Sales Target Commission, Referral Commission) with a calculation basis tied to achievement data, so that variable, performance-linked pay is computed consistently rather than entered manually each cycle.

Actor: Payroll Administrator

حسب المصدر الأساسي HRM V1.0c — As a Payroll Administrator, I want to configure Incentive Types for discretionary, manager-approved bonus payments, so that one-off recognition payments are tracked and taxed correctly rather than handled as an off-system cash payment.

As a Payroll Administrator, I want to configure Incentive Types for discretionary, manager-approved bonus payments, so that one-off recognition payments are tracked and taxed correctly rather than handled as an off-system cash payment.

Actor: Payroll Administrator

حسب المصدر الأساسي HRM V1.0c — As a Payroll Administrator, I want to configure which Social/Medical Insurance provider and scheme applies per company or employee group, so that the correct provider-specific rules feed the statutory SI calculation (Epic 19, US-002).

As a Payroll Administrator, I want to configure which Social/Medical Insurance provider and scheme applies per company or employee group, so that the correct provider-specific rules feed the statutory SI calculation (Epic 19, US-002).

Actor: Payroll Administrator

حسب المصدر الأساسي HRM V1.0c — As a Payroll Administrator, I want a Loan Account to be created automatically upon an approved Loan Request (Epic 13, US-010), so that loans are traceable to their originating employee-initiated request rather than appearing as unexplained payroll deductions.

As a Payroll Administrator, I want a Loan Account to be created automatically upon an approved Loan Request (Epic 13, US-010), so that loans are traceable to their originating employee-initiated request rather than appearing as unexplained payroll deductions.

Actor: Payroll Administrator

حسب المصدر الأساسي HRM V1.0c — As a Payroll Administrator, I want monthly installments to automatically deduct via the Payroll Engine (Epic 19), so that repayment tracking doesn't require a manual monthly step.

As a Payroll Administrator, I want monthly installments to automatically deduct via the Payroll Engine (Epic 19), so that repayment tracking doesn't require a manual monthly step.

Actor: Payroll Administrator

حسب المصدر الأساسي HRM V1.0c — As a Payroll Administrator, I want to record a Bounced Cheque or returned repayment against a Loan Account, classified by Bounce Type and Bounce Reason, so that failed collateral cheques or returned bank transfers are tracked as a distinct event rather than silently appearing as a missed installment.

As a Payroll Administrator, I want to record a Bounced Cheque or returned repayment against a Loan Account, classified by Bounce Type and Bounce Reason, so that failed collateral cheques or returned bank transfers are tracked as a distinct event rather than silently appearing as a missed installment.

Actor: Payroll Administrator

حسب المصدر الأساسي HRM V1.0c — As a Payroll Administrator, I want to run the monthly payroll pipeline for a defined employee population, with each employee processed independently so that one employee's data issue doesn't block the entire batch, so that payroll for the other 499 employees isn't held hostage by one bad record.

As a Payroll Administrator, I want to run the monthly payroll pipeline for a defined employee population, with each employee processed independently so that one employee's data issue doesn't block the entire batch, so that payroll for the other 499 employees isn't held hostage by one bad record.

Actor: Payroll Administrator

حسب المصدر الأساسي HRM V1.0c — As a Payroll Administrator, I want the payroll engine to compute Social Insurance, Income Tax, and the Martyrs' Fund deduction using the exact Egyptian statutory formulas, so that net pay is legally correct without manual spreadsheet workarounds.

As a Payroll Administrator, I want the payroll engine to compute Social Insurance, Income Tax, and the Martyrs' Fund deduction using the exact Egyptian statutory formulas, so that net pay is legally correct without manual spreadsheet workarounds.

Actor: Payroll Administrator

حسب المصدر الأساسي HRM V1.0c — As a Payroll Administrator, I want to export a finalized (closed) payroll run to Excel, so that I can review, audit, or archive payroll data outside the system.

As a Payroll Administrator, I want to export a finalized (closed) payroll run to Excel, so that I can review, audit, or archive payroll data outside the system.

Actor: Payroll Administrator

حسب المصدر الأساسي HRM V1.0c — As a Payroll Administrator, I want approved Overtime (Epic 10) to automatically feed into the payroll calculation as a salary rule component, so that overtime pay doesn't require manual entry into payroll.

As a Payroll Administrator, I want approved Overtime (Epic 10) to automatically feed into the payroll calculation as a salary rule component, so that overtime pay doesn't require manual entry into payroll.

Actor: Payroll Administrator

حسب المصدر الأساسي HRM V1.0c — As a Payroll Administrator, I want payslip batches to move through Draft -> Computed -> Validated -> Closed states, with Closed being permanently immutable, so that once payroll is paid and closed, historical figures can never be silently altered.

As a Payroll Administrator, I want payslip batches to move through Draft -> Computed -> Validated -> Closed states, with Closed being permanently immutable, so that once payroll is paid and closed, historical figures can never be silently altered.