Accounting Job Scheduler
Component Detail
Description
Background job runner that triggers the Accounting API Adapter via queue events or cron schedule to process approved expenses awaiting accounting sync. Runs asynchronously to avoid blocking expense approval responses, enforces concurrency limits to prevent duplicate submissions, and routes permanently failed records to a dead-letter queue for admin alerting.
accounting-job-scheduler
Sources & reasoning
The implementation notes specify the adapter must run as a background job triggered by queue or cron to avoid blocking approval responses. This infrastructure component encapsulates scheduling, concurrency control, and dead-letter routing separately from business logic.
No source references — this artifact was included based on reasoning alone (see above).
Responsibilities
- Trigger accounting sync jobs from queue events or scheduled cron invocations
- Enforce concurrency limits to prevent duplicate submissions for the same expense
- Schedule exponential backoff retries by enqueuing delayed retry jobs
- Route permanently failed records to dead-letter handling for admin notification
Interfaces
enqueue(expenseId: string): Promise<void>
processQueue(): Promise<void>
scheduleRetry(logId: string, delayMs: number): Promise<void>
handleDeadLetter(logId: string): Promise<void>
Relationships
Dependencies (2)
Components this component depends on
Related Data Entities (1)
Data entities managed by this component