Payroll Outbox Operations
Summary
This page records confirmed payroll outbox operations behavior and marks incomplete boundaries explicitly.
Audience
Payroll users, developers, QA and support engineers, architects, and implementation reviewers.
Monitorable state
Payroll stores Pending, Failed, and Processed outbox state, retry count, processing time, and bounded failure detail. The store selects Pending and Failed records in occurrence order.
| State | Confirmed meaning | Safe interpretation |
|---|---|---|
| Pending | Event intent is eligible for processing | The business commit succeeded; publication is not proved |
| Failed | A processing attempt recorded bounded failure information | Delivery is not proved; retry policy Requires confirmation |
| Processed | The shared processor recorded completion time | Confirm downstream evidence separately when the workflow requires it |
Delivery boundary
Business commits do not wait for broker publication. A shared processor can publish and update status, but Payroll does not register a hosted relay in reviewed source.
Safe operations
Monitor backlog trend, oldest eligible age, failure growth, and contract type without exposing payloads. Do not mutate status or replay records directly through the database.
For an apparently delayed event, first prove the originating business state, then locate its sanitized outbox metadata, then seek producer publication and supported consumer evidence. A growing Pending/Failed set is actionable even while the shallow health endpoint remains healthy. Escalate before replay because idempotency at every downstream consumer is not established by the Payroll producer.
Requires confirmation
Relay scheduling, retry ceiling, alert thresholds, replay workflow, dead-letter handling, retention, and on-call ownership.
Source References
microservices/src/payroll-service/Infrastructure/Persistence.csmicroservices/src/payroll-service/Program.csmicroservices/src/contracts/Events/PayrollCalculatedEvent.csmicroservices/src/contracts/Events/PayslipGeneratedEvent.cs
Related Articles
See Also
Keywords
- Payroll operations
- Payroll Outbox Operations
Revision Information
- Status: Draft
- Last reviewed: 2026-07-15
- Review cycle: Quarterly