Version, Validation, Approval & Rollback
Lifecycle of a material policy change — demo record: hr.eos.gratuity_pack v15 (end-of-service accrual basis update, HR-04). Every state transition keeps evidence; approval binds the immutable content hash; rollback publishes a new version and never rewrites history.
- Definition
- hr.eos.gratuity_pack — End-of-service & gratuity policy pack (HR-04)
- Scope
- Legal entity — Al Manara Properties LLC
- Maker
- VNVikram Nair (Configuration Administrator)
- Reason
- Align accrual wage basis with amended contract templates; freeze pre-2026 cohort accrual
- Content hash
sha256:b7d3f2a9…41fa(immutable — approval binds this hash)- Created
- 14 Jul 2026 15:22 · edited 16 Jul 2026 17:29
- Validation
- Passed 16 Jul 2026 17:30 · schema gratuity-pack-3.1 · 0 errors, 1 notice
- Simulation
- 12 / 12 golden calculations matched · evidence SIM-2216
- Approvals
- Legal ✓ (Mariam Al Suwaidi) · Finance pending (Fatima Rashid)
- Requested activation
- 01 Aug 2026 00:00 GST — payroll change window W-2026-08A
- Prior version
- v14 active since 01 Jan 2026 · remains reproducible after supersession
| State | Meaning | Exit control |
|---|---|---|
| Draft | Maker edits values and rationale | Schema and permission checks |
| Validated | Automated validation and simulations pass | No unresolved error; evidence retained |
| Pending approval | Independent owner reviews diff and impact | Maker-checker / SoD enforced |
| Scheduled | Approved version awaits effective time / change window | Conflict and dependency recheck |
| Active | Runtime resolves this version | Immutable; monitored; version recorded on transactions |
| Superseded | Later version became active | Still readable and reproducible |
| Rejected | Approver rejected with reason | Cannot activate; maker may create a new draft |
| Rolled back | A new activation restores a known-good version | Failed version preserved with incident evidence |
| Step | Role / person | SoD check | Decision | Evidence |
|---|---|---|---|---|
| Maker | VNVikram Nair | Cannot self-approve | Submitted 16 Jul 17:32 | Reason + hash b7d3…41fa |
| Checker 1 — Legal | MSMariam Al Suwaidi | Independent · no benefit | Approved 17 Jul 09:12 | Reviewed diff, simulation SIM-2216, statutory floor check |
| Checker 2 — Finance | FRFatima Rashid | Independent · no benefit | Pending — due 20 Jul | Sees maker, reason, hash, diff, simulation, activation window |
| Excluded approver | RFRashid Al Farsi | Blocked — beneficiary of EOS change | Not eligible | A beneficiary cannot approve a self-benefiting pay exception |
| Version | State | Content hash | Effective | Maker | Approvers | Note |
|---|---|---|---|---|---|---|
| v15 | Pending approval | b7d3…41fa | requested 01 Aug 2026 | Vikram Nair | Legal ✓ · Finance pending | Accrual wage basis + cohort freeze |
| v14 | Active | 2e91…c604 | 01 Jan 2026 → open | Vikram Nair | Legal ✓ · Finance ✓ | FY2026 statutory pack refresh — known-good |
| v13 | Superseded | a1c8…9b02 | 01 Jun 2025 → 31 Dec 2025 | Elena Petrova | Legal ✓ · Finance ✓ | Readable + reproducible for FY2025 settlements |
| v12 | Rolled back | 77aa…d5e3 | 01 May 2025 → 31 May 2025 | Vikram Nair | Legal ✓ · Finance ✓ | Mis-stated cap; incident INC-2025-0912 attached; preserved unrewritten |
| v11 | Rejected | 03fe…8817 | — | Vikram Nair | Finance ✗ Fatima Rashid | Rejection reason: unapproved wage-basis deviation from golden calc set |
| v10 | Superseded | 5cb0…1f9d | 01 Jan 2025 → 30 Apr 2025 | Elena Petrova | Legal ✓ · Finance ✓ | Baseline migration import (DATA-01 evidence) |
- Effective time
- 01 Aug 2026 00:00 GST (Asia/Dubai)
- Change window
- 31 Jul 22:00 → 01 Aug 02:00 · payroll quiet period
- Dependency recheck
- Pass — WPS profile v7 activates in the same window; no ordering conflict
- Conflict recheck
- No overlapping active version for key/scope/period
- Runtime event
ConfigurationActivatedwill publish definition, scope, version, effective time, correlation ID → runtime observability- Fallback
- If activation gate fails, v14 stays effective; no partial state
cfg-7be40- 17 Jul 2026 09:12Legal approval recorded
- 16 Jul 2026 17:32Submitted for approval (APR-2026-0455)
- 16 Jul 2026 17:30Validation + simulation passed
- 16 Jul 2026 16:41Draft edited — prior validation invalidated
- 14 Jul 2026 15:22Draft v15 created from active v14
This publishes new version v16 (content hash of v14: 2e91…c604) effective at the next change window. It does not delete or alter v15. Affected: 0 posted payruns (versions pinned), 1 scheduled payrun PR-2026-08, 2 dependent changes.
Rollback itself is maker-checker: the requester cannot approve, and an independent owner must confirm before the new version is scheduled.
Static render mockup — no live data. Source: ERP Modern Development Specification v2.0 · Covers: CFG-03 (lifecycle states, maker-checker, content-hash binding, scheduled activation, rollback as new version).