Expense Event Integration Testing Guide

Summary

Existing scripts provide Expense outbox, workflow-callback, notification-dispatch, Payroll projection, duplicate, stale-event, parity, and cutover evidence. No dedicated automated contract-test project or end-to-end production-broker test suite is confirmed.

Existing evidence

Evidence	Confirmed event coverage	Limitation
Expense smoke	Approval, rejection, and paid transitions create outbox records	Does not by itself prove downstream broker delivery
Expense workflow smoke mode	Workflow approval/rejection callbacks and duplicate callback suppression	Local workflow exercise, not workflow-event consumption
Expense notification smoke mode	Real Expense outbox contracts are passed through Notification resolution, delivery, and duplicate handling	Uses a broker-free test-dispatch boundary
Payroll smoke	Expense event subscription, projection updates, duplicate handling, stale handling, and calculation impact	Synthetic publication rather than the Expense hosted relay
Expense parity automation	Includes outbox evidence in compatibility comparison	Does not validate consumer delivery
Cutover runbook	Includes validation and rollback activities around Expense transition	Does not establish an executed event replay or rollback rehearsal

Not implemented as confirmed automated evidence

• Version-compatibility contract suite
• Expense relay retry-ceiling or dead-letter test
• Broker partition-ordering test
• Expense inbound-consumer test
• Cross-service replay test
• Formal chaos or long-running delivery test

Use approved isolated environments and synthetic data when running existing scripts. This documentation task did not run services, connect to a broker or database, or execute integration scripts.

Requires confirmation

Test environment ownership, broker test strategy, contract fixtures, replay testing, failure-injection policy, and release-gate requirements require confirmation.

Source References

• microservices/scripts/smoke-expense.ps1
• microservices/scripts/smoke-payroll.ps1
• microservices/scripts/compare-expense-parity.ps1
• microservices/docs/expense-cutover-runbook.md

Related Articles

• Expense events documentation
• Expense technical documentation
• Expense database documentation

See Also

• Expense API documentation
• Expense module

Keywords

• Expense events
• Integration Testing Guide
• Integration contracts

Revision Information

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