Queues And Jobs

Use queues for work that can happen outside the request cycle: notifications, imports, exports, media processing, integration callbacks, long-running calculations, and retryable external operations.

Job Design

Queued jobs should be safe to retry.

Prefer:

• passing IDs or small scalar payloads;
• reloading models in handle();
• explicit tries, backoff, timeout, and failure behavior when the job is important;
• idempotency keys or state checks for external side effects;
• after-commit dispatch when jobs depend on committed records.