Actor: HR Administrator

حسب المصدر الأساسي HRM V1.0c — As an HR Administrator, I want to review and approve a period's attendance data before it feeds payroll, so that payroll always calculates from a confirmed, not provisional, attendance dataset.

As an HR Administrator, I want to review and approve a period's attendance data before it feeds payroll, so that payroll always calculates from a confirmed, not provisional, attendance dataset.

Actor: HR Administrator

حسب المصدر الأساسي HRM V1.0c — As an HR Administrator, I want to configure grace time and exception rules relative to each employee's effective Working Schedule, so that minor lateness within policy doesn't get flagged, while genuine exceptions are caught.

As an HR Administrator, I want to configure grace time and exception rules relative to each employee's effective Working Schedule, so that minor lateness within policy doesn't get flagged, while genuine exceptions are caught.

Actor: Employee

حسب المصدر الأساسي HRM V1.0c — As an Employee, I want to submit a self-service request disputing or explaining an attendance record (e.g. forgot to check out, device malfunction), so that I have a formal channel to get my attendance corrected rather than relying on an informal conversation with HR.

As an Employee, I want to submit a self-service request disputing or explaining an attendance record (e.g. forgot to check out, device malfunction), so that I have a formal channel to get my attendance corrected rather than relying on an informal conversation with HR.

Actor: Employee or Manager

حسب المصدر الأساسي HRM V1.0c — As an Employee or Manager, I want to receive notifications for attendance-related events (missing check-out, unresolved conflict, correction request status), so that issues are addressed promptly rather than discovered at payroll time.

As an Employee or Manager, I want to receive notifications for attendance-related events (missing check-out, unresolved conflict, correction request status), so that issues are addressed promptly rather than discovered at payroll time.

Actor: IT/Facilities Administrator

حسب المصدر الأساسي HRM V1.0c — As an IT/Facilities Administrator, I want to register physical Gate/access-control devices (turnstiles, door readers) separately from biometric time-attendance devices, so that entry-exit access logs and time-attendance punches can be correctly distinguished even when the same physical hardware vendor provides both.

As an IT/Facilities Administrator, I want to register physical Gate/access-control devices (turnstiles, door readers) separately from biometric time-attendance devices, so that entry-exit access logs and time-attendance punches can be correctly distinguished even when the same physical hardware vendor provides both.

Actor: HR Administrator

حسب المصدر الأساسي HRM V1.0c — As an HR Administrator, I want to configure attendance policy categories — Office Attendance rules, Time Management rules, and General Policies — as distinct configurable groups, so that different work arrangements (on-site vs. remote/hybrid) can follow appropriately different rules without one giant undifferentiated settings screen.

As an HR Administrator, I want to configure attendance policy categories — Office Attendance rules, Time Management rules, and General Policies — as distinct configurable groups, so that different work arrangements (on-site vs. remote/hybrid) can follow appropriately different rules without one giant undifferentiated settings screen.

Actor: Employee

حسب المصدر الأساسي HRM V1.0c — As an Employee, I want to submit an overtime request for hours worked beyond my standard schedule, so that it can be reviewed and correctly compensated per company policy.

As an Employee, I want to submit an overtime request for hours worked beyond my standard schedule, so that it can be reviewed and correctly compensated per company policy.

Actor: Direct Manager

حسب المصدر الأساسي HRM V1.0c — As a Direct Manager, I want to submit an overtime record on behalf of an employee, so that I can log overtime for team members who can't self-submit (e.g. no system access).

As a Direct Manager, I want to submit an overtime record on behalf of an employee, so that I can log overtime for team members who can't self-submit (e.g. no system access).

Actor: Approver

حسب المصدر الأساسي HRM V1.0c — As an Approver, I want to review and approve/reject overtime requests with visibility into the employee's monthly cap status, so that I can make an informed decision rather than approving blind.

As an Approver, I want to review and approve/reject overtime requests with visibility into the employee's monthly cap status, so that I can make an informed decision rather than approving blind.

Actor: Employee or HR Administrator

حسب المصدر الأساسي HRM V1.0c — As an Employee or HR Administrator, I want to view overtime requests (mine, or company-wide for HR) with status and totals, so that I can track overtime usage.

As an Employee or HR Administrator, I want to view overtime requests (mine, or company-wide for HR) with status and totals, so that I can track overtime usage.

Actor: HR Administrator

حسب المصدر الأساسي HRM V1.0c — As an HR Administrator, I want an overtime summary report by employee/department/period, so that I can monitor overtime cost trends.

As an HR Administrator, I want an overtime summary report by employee/department/period, so that I can monitor overtime cost trends.

Actor: HR Administrator

حسب المصدر الأساسي HRM V1.0c — As an HR Administrator, I want the system to ship pre-configured with the 17 leave types mandated by Egyptian Labor Law No. 14/2025 (exact duration, wage ratio, and legal article per type), with the ability to add my own custom non-statutory types on top, so that my company is compliant by default without needing a lawyer to configure leave policy.

As an HR Administrator, I want the system to ship pre-configured with the 17 leave types mandated by Egyptian Labor Law No. 14/2025 (exact duration, wage ratio, and legal article per type), with the ability to add my own custom non-statutory types on top, so that my company is compliant by default without needing a lawyer to configure leave policy.

Actor: HR Administrator

حسب المصدر الأساسي HRM V1.0c — As an HR Administrator, I want to allocate leave balances at company level with individual overrides for exceptions, so that standard entitlements don't require per-employee manual setup.

As an HR Administrator, I want to allocate leave balances at company level with individual overrides for exceptions, so that standard entitlements don't require per-employee manual setup.

Actor: HR Administrator

حسب المصدر الأساسي HRM V1.0c — As an HR Administrator, I want to view and search leave allocations at both company and individual level, so that I can audit entitlements.

As an HR Administrator, I want to view and search leave allocations at both company and individual level, so that I can audit entitlements.

Actor: Employee

حسب المصدر الأساسي HRM V1.0c — As an Employee, I want to submit a leave request for a date range, with the system automatically excluding non-working days and public holidays from the balance deduction, so that I'm not charged leave for days I wasn't scheduled to work anyway.

As an Employee, I want to submit a leave request for a date range, with the system automatically excluding non-working days and public holidays from the balance deduction, so that I'm not charged leave for days I wasn't scheduled to work anyway.

Actor: Employee

حسب المصدر الأساسي HRM V1.0c — As an Employee, I want to request cancellation or partial cut of an approved leave, so that my balance and payroll correctly reflect a change in plans.

As an Employee, I want to request cancellation or partial cut of an approved leave, so that my balance and payroll correctly reflect a change in plans.

Actor: Employee

حسب المصدر الأساسي HRM V1.0c — As an Employee, I want to view my leave request history with status, so that I can track my requests.

As an Employee, I want to view my leave request history with status, so that I can track my requests.

Actor: Employee or Approver

حسب المصدر الأساسي HRM V1.0c — As an Employee or Approver, I want to view full leave request details including the working-day calculation breakdown, so that the deducted amount is transparent and auditable.

As an Employee or Approver, I want to view full leave request details including the working-day calculation breakdown, so that the deducted amount is transparent and auditable.

Actor: HR Administrator

حسب المصدر الأساسي HRM V1.0c — As an HR Administrator, I want each Leave Type to follow one of four distinct approval patterns, so that sensitive leave (e.g. medical) is routed appropriately while routine leave isn't bottlenecked by unnecessary layers.

As an HR Administrator, I want each Leave Type to follow one of four distinct approval patterns, so that sensitive leave (e.g. medical) is routed appropriately while routine leave isn't bottlenecked by unnecessary layers.

Actor: system architect

حسب المصدر الأساسي HRM V1.0c — As a system architect, I want the leave request lifecycle to follow a formal state machine, so that status transitions are predictable, auditable, and impossible to corrupt via invalid transitions.

As a system architect, I want the leave request lifecycle to follow a formal state machine, so that status transitions are predictable, auditable, and impossible to corrupt via invalid transitions.