Skip to main content

Payroll Lock and Snapshots

Summary​

Reopen approval is blocked, Payroll dependency fails, or snapshot results are inconsistent.

Audience​

Employees or administrators affected by the scenario, first-line support, QA, service owners, and operations.

Symptoms​

  • Reopen approval is blocked, Payroll dependency fails, or snapshot results are inconsistent.

Scope​

Payroll lock/freeze check and approved Attendance snapshot capture.

Likely causes​

Locked/frozen period, unavailable Payroll call, partial cross-service operation, or snapshot governance question.

Cause​

The confirmed cause categories are listed under Likely causes above; determine the applicable category from sanitized evidence before taking action.

Safe diagnostic steps​

  1. Confirm period, lock-call outcome category, Attendance state, snapshot presence through supported interfaces, and correlation identifiers across services.
  2. Preserve tenant isolation and redact personal or security-sensitive data.
  3. Do not use direct database changes, authorization bypasses, or ad hoc broker operations.

Safe resolution​

Restore Payroll availability or follow the governed Payroll-period process. Do not bypass locks, replace snapshots, or edit data directly.

Resolution​

Apply only the Safe resolution described above and remain within the documented ownership boundary.

Validation​

Repeat safe reads; verify lock status and snapshot consistency with the approved period.

Evidence to collect​

Period, sanitized employee scope, call/result categories, snapshot reference, cross-service correlation identifiers.

Escalation​

Payroll owner first for locks/snapshots; Attendance owner for source records; DevOps for availability.

Source References​

  • microservices/src/attendance-service/Infrastructure/PayrollLockClient.cs
  • microservices/src/attendance-service/Application/Services/PayrollSnapshotService.cs

See Also​

Keywords​

  • Attendance
  • Troubleshooting
  • Payroll Lock and Snapshots

Revision Information​

  • Status: Draft
  • Last reviewed: 2026-07-15
  • Review cycle: Quarterly