How kshitij7498/codity.ai_distributed-job-scheduler. works
Distributed Job Scheduler is a multi-tenant platform for submitting immediate, delayed, scheduled, recurring, and batch jobs, then executing them across workers with retries, leases, heartbeats, execution history, and DLQ recovery. Users configure organizations, projects, queues, and retry policies through the REST API and dashboard; workers claim and execute jobs against PostgreSQL, while API endpoints expose fleet and job monitoring. Edges reflect the README, source excerpts, and SOURCE INDEX references; unsampled subsystem connections are omitted where their runtime wiring is not shown.
Main entry points: router.py REST Router · session.py Database Sessions · service.py Worker Lifecycle and Execution · auth.py Authentication API
Components 26
Dashboard and API
- Control Dashboard
frontend/src/main.jsx - REST Router
backend/app/api/router.py
Identity and Tenancy
- Authentication API
backend/app/api/routes/auth.py - JWT Security
backend/app/auth/security.py - User Authentication
backend/app/auth/dependencies.py - Auth Schemas
backend/app/auth/schemas.py - Organizations API
backend/app/api/routes/organizations.py - Projects API
backend/app/api/routes/projects.py
Job Management
- Queues and Retry Policies
backend/app/api/routes/queues.py - Jobs API
backend/app/api/routes/jobs.py - Job Creation and Scheduling
backend/app/jobs/service.py - Job Schemas
backend/app/jobs/schemas.py - DLQ Recovery API
backend/app/api/routes/dlq.py
Worker Runtime
- Worker Fleet API
backend/app/api/routes/workers.py - Monitoring API
backend/app/api/routes/monitoring.py - Worker Process
backend/app/workers/runner.py - Worker Lifecycle and Execution
backend/app/workers/service.py - Atomic Job Claiming
backend/app/workers/claimer.py - Payload Executor
backend/app/workers/executor.py - Schedule Dispatcher
backend/app/workers/scheduler.py
Persistence and State
- Scheduler Data Model
backend/app/models/models.py - Lifecycle and Type Enums
backend/app/models/enums.py - Database Sessions
backend/app/db/session.py - Runtime Configuration
backend/app/core/config.py - PostgreSQL
Other components
- Scheduler User
Connections 35
- Scheduler User → Control Dashboard: uses
README.md - Control Dashboard → REST Router: calls REST API
README.md - REST Router → Authentication API: registers
backend/app/api/router.py - REST Router → Organizations API: registers
backend/app/api/router.py - REST Router → Projects API: registers
backend/app/api/router.py - REST Router → Queues and Retry Policies: registers
backend/app/api/router.py - REST Router → Jobs API: registers
backend/app/api/router.py - REST Router → Worker Fleet API: registers
backend/app/api/router.py - REST Router → Monitoring API: registers
backend/app/api/router.py - REST Router → DLQ Recovery API: registers
backend/app/api/router.py - Authentication API → JWT Security: hashes and signs
backend/app/api/routes/auth.py - Authentication API → Auth Schemas: validates with
backend/app/api/routes/auth.py - User Authentication → JWT Security: decodes token
backend/app/auth/dependencies.py - Authentication API → Database Sessions: uses session
backend/app/api/routes/auth.py - Organizations API → Database Sessions: uses session
backend/app/api/routes/organizations.py - Projects API → Database Sessions: uses session
backend/app/api/routes/projects.py - Queues and Retry Policies → Projects API: checks project access
backend/app/api/routes/queues.py - Queues and Retry Policies → Database Sessions: uses session
backend/app/api/routes/queues.py - Jobs API → Job Creation and Scheduling: creates jobs
backend/app/api/routes/jobs.py - Jobs API → Job Schemas: validates with
backend/app/api/routes/jobs.py - Job Creation and Scheduling → Job Schemas: accepts payloads
backend/app/jobs/service.py - Job Creation and Scheduling → Scheduler Data Model: creates job records
backend/app/jobs/service.py - Worker Process → Worker Lifecycle and Execution: runs worker
backend/app/workers/runner.py - Worker Process → Schedule Dispatcher: starts scheduler
backend/app/workers/runner.py - Worker Lifecycle and Execution → Atomic Job Claiming: claims and marks running
backend/app/workers/service.py - Worker Lifecycle and Execution → Payload Executor: executes payload
backend/app/workers/service.py - Worker Lifecycle and Execution → Database Sessions: opens sessions
backend/app/workers/service.py - Worker Fleet API → Database Sessions: uses session
backend/app/api/routes/workers.py - Monitoring API → Database Sessions: uses session
backend/app/api/routes/monitoring.py - DLQ Recovery API → Database Sessions: uses session
backend/app/api/routes/dlq.py - Database Sessions → Runtime Configuration: configures connection
backend/app/db/session.py - Database Sessions → PostgreSQL: connects
README.md - Scheduler Data Model → Lifecycle and Type Enums: defines state with
backend/app/models/models.py - Atomic Job Claiming → PostgreSQL: claims transactionally
README.md - Worker Lifecycle and Execution → PostgreSQL: persists execution and heartbeats
backend/app/workers/service.py