# ankit0514/chronos-job_scheduling architecture

> Architecture diagram of the GitHub repository ankit0514/chronos-job_scheduling, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-20). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/ankit0514/chronos-job_scheduling
- Repository: https://github.com/ankit0514/chronos-job_scheduling

## Overview

Chronos is a C++ workload scheduler prototype. Its main distributed workflow accepts jobs through an authenticated HTTP API, persists job metadata and publishes events, then a scheduler consumes submissions, selects a healthy worker, records state and publishes assignments. Workers report heartbeats and execution events; retries and workflow DAG execution are additional capabilities. The repository also offers an in-memory thread-pool scheduler. The README documents integration boundaries; sampled source confirms key scheduler dispatch behavior, but does not expose every service or worker-agent interaction.

Main entry points: [`src/scheduler_service_main.cpp`](https://github.com/ankit0514/chronos-job_scheduling/blob/main/src/scheduler_service_main.cpp) (Scheduler service), [`src/api_main.cpp`](https://github.com/ankit0514/chronos-job_scheduling/blob/main/src/api_main.cpp) (API service entry), [`src/in_memory_scheduler.cpp`](https://github.com/ankit0514/chronos-job_scheduling/blob/main/src/in_memory_scheduler.cpp) (In-memory scheduler), [`src/job_repository.cpp`](https://github.com/ankit0514/chronos-job_scheduling/blob/main/src/job_repository.cpp) (Job repository)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_api["API ingress"]
  node_gateway["HTTP gateway<br/>[api_gateway.cpp]"]
  node_api_entry["API service entry<br/>[api_main.cpp]"]
end

subgraph group_messaging["Persistence and events"]
  node_repository[("Job repository<br/>[job_repository.cpp]")]
  node_postgres[("PostgreSQL")]
  node_event_bus["Kafka event bus"]
  node_kafka["Kafka"]
end

subgraph group_scheduling["Scheduling"]
  node_job_model["Job model<br/>[job.hpp]"]
  node_job_states["Job states<br/>[job_state.hpp]"]
  node_scheduler_service["Scheduler service"]
  node_selector["Worker selector"]
  node_retry_policy["Retry policy<br/>[retry_policy.cpp]"]
  node_local_scheduler["In-memory scheduler"]
  node_priority_queue["Priority queue"]
end

subgraph group_workers["Worker management"]
  node_worker_manager["Worker manager<br/>[worker_manager.cpp]"]
  node_worker_model["Worker model<br/>[worker.hpp]"]
  node_worker_service["Worker manager service"]
  node_redis_store[("Redis worker store")]
  node_redis[("Redis")]
  node_worker_agent["Worker agent"]
end

subgraph group_workflow["Workflow execution"]
  node_workflow_graph["Workflow graph<br/>[workflow_graph.cpp]"]
  node_workflow_executor["Workflow executor"]
end

node_client(("API client"))

node_client -->|"submits jobs"| node_gateway
node_gateway -.->|"routes requests"| node_api_entry
node_api_entry -->|"persists metadata"| node_repository
node_api_entry -->|"publishes events"| node_event_bus
node_repository -->|"reads and writes"| node_postgres
node_event_bus -->|"publishes events"| node_kafka
node_kafka -->|"delivers submissions"| node_scheduler_service
node_scheduler_service -->|"publishes assignments"| node_event_bus
node_scheduler_service -->|"transitions job state"| node_repository
node_scheduler_service -->|"selects worker"| node_selector
node_scheduler_service -->|"tracks workers"| node_worker_manager
node_scheduler_service -->|"computes retry delay"| node_retry_policy
node_scheduler_service -->|"handles jobs"| node_job_model
node_scheduler_service -->|"transitions states"| node_job_states
node_worker_agent -->|"reports events"| node_kafka
node_worker_service -.->|"stores worker state"| node_redis_store
node_redis_store -->|"stores expiring state"| node_redis
node_local_scheduler -->|"queues jobs"| node_priority_queue
node_local_scheduler -->|"applies retries"| node_retry_policy
node_workflow_executor -->|"executes DAG"| node_workflow_graph
node_workflow_executor -->|"schedules tasks"| node_local_scheduler

click node_gateway "https://github.com/ankit0514/chronos-job_scheduling/blob/main/src/api_gateway.cpp"
click node_api_entry "https://github.com/ankit0514/chronos-job_scheduling/blob/main/src/api_main.cpp"
click node_job_model "https://github.com/ankit0514/chronos-job_scheduling/blob/main/include/chronos/domain/job.hpp"
click node_job_states "https://github.com/ankit0514/chronos-job_scheduling/blob/main/include/chronos/domain/job_state.hpp"
click node_repository "https://github.com/ankit0514/chronos-job_scheduling/blob/main/src/job_repository.cpp"
click node_event_bus "https://github.com/ankit0514/chronos-job_scheduling/blob/main/src/kafka_event_bus.cpp"
click node_scheduler_service "https://github.com/ankit0514/chronos-job_scheduling/blob/main/src/scheduler_service_main.cpp"
click node_selector "https://github.com/ankit0514/chronos-job_scheduling/blob/main/src/worker_selector.cpp"
click node_retry_policy "https://github.com/ankit0514/chronos-job_scheduling/blob/main/src/retry_policy.cpp"
click node_local_scheduler "https://github.com/ankit0514/chronos-job_scheduling/blob/main/src/in_memory_scheduler.cpp"
click node_priority_queue "https://github.com/ankit0514/chronos-job_scheduling/blob/main/src/job_priority_queue.cpp"
click node_worker_manager "https://github.com/ankit0514/chronos-job_scheduling/blob/main/src/worker_manager.cpp"
click node_worker_model "https://github.com/ankit0514/chronos-job_scheduling/blob/main/include/chronos/domain/worker.hpp"
click node_worker_service "https://github.com/ankit0514/chronos-job_scheduling/blob/main/src/worker_manager_service_main.cpp"
click node_redis_store "https://github.com/ankit0514/chronos-job_scheduling/blob/main/src/redis_worker_store.cpp"
click node_worker_agent "https://github.com/ankit0514/chronos-job_scheduling/blob/main/src/worker_agent_main.cpp"
click node_workflow_graph "https://github.com/ankit0514/chronos-job_scheduling/blob/main/src/workflow_graph.cpp"
click node_workflow_executor "https://github.com/ankit0514/chronos-job_scheduling/blob/main/src/workflow_executor.cpp"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_gateway,node_api_entry,node_client toneBlue
class node_repository,node_postgres,node_event_bus,node_kafka toneAmber
class node_job_model,node_job_states,node_scheduler_service,node_selector,node_retry_policy,node_local_scheduler,node_priority_queue toneMint
class node_worker_manager,node_worker_model,node_worker_service,node_redis_store,node_redis,node_worker_agent toneRose
class node_workflow_graph,node_workflow_executor toneIndigo
```

## Components

### API ingress

- [HTTP gateway](https://github.com/ankit0514/chronos-job_scheduling/blob/main/src/api_gateway.cpp): `src/api_gateway.cpp`
- [API service entry](https://github.com/ankit0514/chronos-job_scheduling/blob/main/src/api_main.cpp): `src/api_main.cpp`

### Persistence and events

- [Job repository](https://github.com/ankit0514/chronos-job_scheduling/blob/main/src/job_repository.cpp): `src/job_repository.cpp`
- **PostgreSQL**
- [Kafka event bus](https://github.com/ankit0514/chronos-job_scheduling/blob/main/src/kafka_event_bus.cpp): `src/kafka_event_bus.cpp`
- **Kafka**

### Scheduling

- [Job model](https://github.com/ankit0514/chronos-job_scheduling/blob/main/include/chronos/domain/job.hpp): `include/chronos/domain/job.hpp`
- [Job states](https://github.com/ankit0514/chronos-job_scheduling/blob/main/include/chronos/domain/job_state.hpp): `include/chronos/domain/job_state.hpp`
- [Scheduler service](https://github.com/ankit0514/chronos-job_scheduling/blob/main/src/scheduler_service_main.cpp): `src/scheduler_service_main.cpp`
- [Worker selector](https://github.com/ankit0514/chronos-job_scheduling/blob/main/src/worker_selector.cpp): `src/worker_selector.cpp`
- [Retry policy](https://github.com/ankit0514/chronos-job_scheduling/blob/main/src/retry_policy.cpp): `src/retry_policy.cpp`
- [In-memory scheduler](https://github.com/ankit0514/chronos-job_scheduling/blob/main/src/in_memory_scheduler.cpp): `src/in_memory_scheduler.cpp`
- [Priority queue](https://github.com/ankit0514/chronos-job_scheduling/blob/main/src/job_priority_queue.cpp): `src/job_priority_queue.cpp`

### Worker management

- [Worker manager](https://github.com/ankit0514/chronos-job_scheduling/blob/main/src/worker_manager.cpp): `src/worker_manager.cpp`
- [Worker model](https://github.com/ankit0514/chronos-job_scheduling/blob/main/include/chronos/domain/worker.hpp): `include/chronos/domain/worker.hpp`
- [Worker manager service](https://github.com/ankit0514/chronos-job_scheduling/blob/main/src/worker_manager_service_main.cpp): `src/worker_manager_service_main.cpp`
- [Redis worker store](https://github.com/ankit0514/chronos-job_scheduling/blob/main/src/redis_worker_store.cpp): `src/redis_worker_store.cpp`
- **Redis**
- [Worker agent](https://github.com/ankit0514/chronos-job_scheduling/blob/main/src/worker_agent_main.cpp): `src/worker_agent_main.cpp`

### Workflow execution

- [Workflow graph](https://github.com/ankit0514/chronos-job_scheduling/blob/main/src/workflow_graph.cpp): `src/workflow_graph.cpp`
- [Workflow executor](https://github.com/ankit0514/chronos-job_scheduling/blob/main/src/workflow_executor.cpp): `src/workflow_executor.cpp`

### Other components

- **API client**

## Connections

- API client → HTTP gateway: submits jobs (evidence: `README.md`)
- HTTP gateway → API service entry: routes requests
- API service entry → Job repository: persists metadata (evidence: `README.md`)
- API service entry → Kafka event bus: publishes events (evidence: `README.md`)
- Job repository → PostgreSQL: reads and writes (evidence: `README.md`)
- Kafka event bus → Kafka: publishes events (evidence: `README.md`)
- Kafka → Scheduler service: delivers submissions (evidence: `src/scheduler_service_main.cpp`)
- Scheduler service → Kafka event bus: publishes assignments (evidence: `src/scheduler_service_main.cpp`)
- Scheduler service → Job repository: transitions job state (evidence: `src/scheduler_service_main.cpp`)
- Scheduler service → Worker selector: selects worker (evidence: `src/scheduler_service_main.cpp`)
- Scheduler service → Worker manager: tracks workers (evidence: `src/scheduler_service_main.cpp`)
- Scheduler service → Retry policy: computes retry delay (evidence: `src/scheduler_service_main.cpp`)
- Scheduler service → Job model: handles jobs (evidence: `src/scheduler_service_main.cpp`)
- Scheduler service → Job states: transitions states (evidence: `src/scheduler_service_main.cpp`)
- Worker agent → Kafka: reports events (evidence: `README.md`)
- Worker manager service → Redis worker store: stores worker state
- Redis worker store → Redis: stores expiring state (evidence: `README.md`)
- In-memory scheduler → Priority queue: queues jobs
- In-memory scheduler → Retry policy: applies retries
- Workflow executor → Workflow graph: executes DAG
- Workflow executor → In-memory scheduler: schedules tasks
