How abhasbali/distributed-job-scheduler works
Orbital is a distributed job-scheduling platform: users manage organizations, projects, queues and jobs through a dashboard and API; worker processes claim and execute jobs, while scheduling, retries, heartbeats and dead-letter handling support recurring and crash-recoverable execution. The graph separates API, domain services, execution, persistence and dashboard concerns. Several controllers and the scheduler are represented at their exact enclosing directories because their source was not excerpted; their detailed internal calls are therefore omitted.
Main entry points: prisma.ts Prisma client · WorkerRuntime.ts Worker runtime · controllers API controllers · repositories Repositories
Components 23
API and identity
- HTTP server
backend/src/server.ts - Express app
backend/src/app.ts - API routes
backend/src/api/routes/index.ts - API controllers
backend/src/api/controllers - Authentication
backend/src/services/AuthService.ts - Token middleware
backend/src/api/middleware/authMiddleware.ts
Scheduling domain
- Job service
backend/src/services/JobService.ts - Queue service
backend/src/services/QueueService.ts - Domain services
backend/src/services - Recurring scheduler
backend/src/scheduler
Job execution
- Worker runtime
backend/src/workers/WorkerRuntime.ts - Atomic job claims
backend/src/queues/JobClaimService.ts - Retry strategy
backend/src/retry/RetryStrategy.ts - Dead-letter handling
backend/src/queues/DeadLetterService.ts - Worker heartbeats
backend/src/heartbeat/HeartbeatEmitter.ts
Persistence and infrastructure
- Repositories
backend/src/repositories - Prisma client
backend/src/config/prisma.ts - PostgreSQL
- Redis
Dashboard
- Dashboard views
frontend/src/app/(dashboard) - Login view
frontend/src/app/login/page.tsx - API client
frontend/src/lib/api.ts
Other components
- Platform user
Connections 30
- Platform user → Dashboard views: uses
README.md - Platform user → Login view: signs in
README.md - Dashboard views → API client: requests data
- Login view → API client: requests tokens
- API client → HTTP server: calls API
- HTTP server → Express app: creates
backend/src/server.ts - Express app → API routes: mounts
backend/src/app.ts - API routes → API controllers: routes to
backend/src/api/routes/index.ts - API controllers → Authentication: invokes
backend/src/api/controllers/authController.ts - API controllers → Job service: invokes
backend/src/api/controllers/jobController.ts - API controllers → Queue service: invokes
backend/src/api/controllers/queueController.ts - API routes → Token middleware: applies
backend/src/api/routes/index.ts - Token middleware → Authentication: verifies access token
backend/src/api/middleware/authMiddleware.ts - Job service → Repositories: uses job repository
backend/src/services/JobService.ts - Queue service → Repositories: uses queue repository
backend/src/services/QueueService.ts - Authentication → Repositories: uses user repository
backend/src/services/AuthService.ts - Job service → Prisma client: accesses database
backend/src/services/JobService.ts - Worker runtime → Atomic job claims: claims jobs
backend/src/workers/WorkerRuntime.ts - Worker runtime → Retry strategy: computes retry delay
backend/src/workers/WorkerRuntime.ts - Worker runtime → Dead-letter handling: moves exhausted jobs
backend/src/workers/WorkerRuntime.ts - Worker runtime → Worker heartbeats: starts heartbeat
backend/src/workers/WorkerRuntime.ts - Worker runtime → Prisma client: records execution
backend/src/workers/WorkerRuntime.ts - Atomic job claims → Prisma client: claims in database
backend/src/queues/JobClaimService.ts - Dead-letter handling → Prisma client: updates job records
backend/src/queues/DeadLetterService.ts - Worker heartbeats → Prisma client: updates worker state
backend/src/heartbeat/HeartbeatEmitter.ts - Repositories → Prisma client: uses client
backend/src/repositories/JobRepository.ts - Prisma client → PostgreSQL: persists data
README.md - Express app → Redis: rate limiting
backend/src/app.ts - Recurring scheduler → Prisma client: scheduling state
README.md - Domain services → Prisma client: domain persistence
README.md