What problem does it solve?
It prevents brittle background job handling by defining reliable BullMQ queue names, worker entry expectations, and scheduling/job configuration patterns for SpotiArr’s asynchronous processing.
Core Features & Use Cases
- Real queue orchestration: Uses a single source of truth for queue singletons and consistent real queue names for track downloading, searching, and sync workflows.
- Production worker contracts: Enforces worker placement and validates
job.data at the worker entry via parsing.
- Deterministic job behavior: Applies job-type-specific retry/backoff decisions, job ID dedup patterns, and event handling requirements to keep UI/SSE and entity status aligned.
Quick Start
Configure the queues singleton initialization, register workers using the specified factories under infrastructure/workers, and enqueue jobs from the application layer using the defined queue names and job ID rules.