Export Job Queue Infrastructure
Component Detail
Infrastructure
medium complexity
backend
1
Dependencies
0
Dependents
1
Entities
0
Integrations
Description
Manages the async job lifecycle for report generation to handle large organizations where generation may take several seconds. Enqueues export requests, tracks job state (pending, processing, complete, failed), and provides a polling endpoint. Ensures the admin panel remains responsive while heavy SQL aggregations and file generation run in the background.
export-job-queue
Responsibilities
- Enqueue export job requests with parameters and org context
- Track job state transitions (pending → processing → complete/failed)
- Expose job status polling interface for the frontend
- Clean up temporary files after successful download
Interfaces
enqueueExportJob(params)
getJobStatus(jobId)
markJobComplete(jobId, fileUrl)
markJobFailed(jobId, error)
cleanupExpiredJobs()