Payroll Sync And Exceptions

Summary

Payroll sync and exception handling protect the boundary between reviewed internal time state and external payroll side effects.

Problem

Sync failures may be business blockers, provider errors, or validation gaps. Operators need to see and repair them without losing the history of attempted syncs.

Principle

Classify blockers, record operations, and expose exceptions as repairable workflow state.

Platform Shape

Time-review sync dispatch, failure blockers, and operations modules model the sync path. The payroll exceptions route exposes operational follow-up for records that cannot safely proceed.

Source Evidence

• services/payroll/time_review/sync_dispatch.py
• services/payroll/time_review/sync_failure_blockers.py
• services/payroll/time_review/operations.py
• app/web/app/payroll/exceptions

Related Reading

• docs/engineering/concepts/external-command-outbox.md
• docs/engineering/concepts/idempotency-in-operational-jobs.md