# juniormichieletto/khrona architecture

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

- Interactive diagram: https://gitdiagram.com/juniormichieletto/khrona
- Repository: https://github.com/juniormichieletto/khrona

## Overview

Khrona is a coroutine-native Kotlin job scheduler, optionally integrated with Ktor and backed by in-memory, JDBC, or Redis storage. The main flow defines jobs and triggers, seeds scheduled executions, polls and claims eligible work, runs registered handlers with leases and retries, and persists status and recurring executions. The graph includes core execution and storage layers plus the documented integrations. JDBC and Redis implementation details are only partially sampled, so optional backend-to-service links are marked unverified.

Main entry points: [`khrona-core/src/main/kotlin/io/khrona/core/Scheduler.kt`](https://github.com/juniormichieletto/khrona/blob/main/khrona-core/src/main/kotlin/io/khrona/core/Scheduler.kt) (Scheduler), [`khrona-core/src/main/kotlin/io/khrona/core/JobStore.kt`](https://github.com/juniormichieletto/khrona/blob/main/khrona-core/src/main/kotlin/io/khrona/core/JobStore.kt) (Store contract), [`khrona-store-jdbc/src/main/kotlin/io/khrona/store/jdbc/JdbcJobStore.kt`](https://github.com/juniormichieletto/khrona/blob/main/khrona-store-jdbc/src/main/kotlin/io/khrona/store/jdbc/JdbcJobStore.kt) (JDBC store), [`khrona-core/src/main/kotlin/io/khrona/core/Dsl.kt`](https://github.com/juniormichieletto/khrona/blob/main/khrona-core/src/main/kotlin/io/khrona/core/Dsl.kt) (Job DSL)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_integration["Application integration"]
  node_ktor["Ktor plugin<br/>[KhronaPlugin.kt]"]
  node_extensions["Ktor extensions<br/>[Extensions.kt]"]
end

subgraph group_core["Scheduling core"]
  node_dsl["Job DSL<br/>[Dsl.kt]"]
  node_definition["Job definitions<br/>[JobDefinition.kt]"]
  node_triggers["Trigger types"]
  node_execution["Execution records<br/>[JobExecution.kt]"]
  node_status["Execution states<br/>[ExecutionStatus.kt]"]
  node_scheduler["Scheduler<br/>[Scheduler.kt]"]
  node_handlers["Handler registry<br/>[HandlerRegistry.kt]"]
  node_storecontract["Store contract<br/>[JobStore.kt]"]
end

subgraph group_storage["Storage backends"]
  node_memory[("Memory store<br/>[MemoryJobStore.kt]")]
  node_jdbc[("JDBC store<br/>[JdbcJobStore.kt]")]
  node_dialect["JDBC dialects<br/>[JdbcDialect.kt]"]
  node_redis[("Redis store<br/>[RedisJobStore.kt]")]
end

subgraph group_services["Storage services"]
  node_sql[("SQL database")]
  node_redisservice[("Redis server")]
end

node_app(("Ktor application"))

node_app -->|"installs"| node_ktor
node_app -->|"defines jobs"| node_dsl
node_ktor -->|"creates"| node_scheduler
node_extensions -->|"configures"| node_ktor
node_dsl -->|"builds"| node_definition
node_dsl -->|"selects"| node_triggers
node_scheduler -->|"registers"| node_handlers
node_scheduler -->|"polls and claims"| node_storecontract
node_scheduler -->|"loads"| node_definition
node_scheduler -->|"schedules"| node_triggers
node_scheduler -->|"updates"| node_execution
node_storecontract -->|"stores"| node_execution
node_storecontract -->|"stores"| node_definition
node_execution -->|"tracks"| node_status
node_memory -->|"implements"| node_storecontract
node_jdbc -->|"implements"| node_storecontract
node_jdbc -->|"uses"| node_dialect
node_redis -->|"implements"| node_storecontract
node_scheduler -.->|"selects backend"| node_memory
node_scheduler -.->|"selects backend"| node_jdbc
node_scheduler -.->|"selects backend"| node_redis
node_jdbc -.->|"queries"| node_sql
node_redis -.->|"coordinates"| node_redisservice

click node_ktor "https://github.com/juniormichieletto/khrona/blob/main/khrona-ktor/src/main/kotlin/io/khrona/ktor/KhronaPlugin.kt"
click node_extensions "https://github.com/juniormichieletto/khrona/blob/main/khrona-ktor/src/main/kotlin/io/khrona/ktor/Extensions.kt"
click node_dsl "https://github.com/juniormichieletto/khrona/blob/main/khrona-core/src/main/kotlin/io/khrona/core/Dsl.kt"
click node_definition "https://github.com/juniormichieletto/khrona/blob/main/khrona-core/src/main/kotlin/io/khrona/core/JobDefinition.kt"
click node_triggers "https://github.com/juniormichieletto/khrona/tree/main/khrona-core/src/main/kotlin/io/khrona/core"
click node_execution "https://github.com/juniormichieletto/khrona/blob/main/khrona-core/src/main/kotlin/io/khrona/core/JobExecution.kt"
click node_status "https://github.com/juniormichieletto/khrona/blob/main/khrona-core/src/main/kotlin/io/khrona/core/ExecutionStatus.kt"
click node_scheduler "https://github.com/juniormichieletto/khrona/blob/main/khrona-core/src/main/kotlin/io/khrona/core/Scheduler.kt"
click node_handlers "https://github.com/juniormichieletto/khrona/blob/main/khrona-core/src/main/kotlin/io/khrona/core/HandlerRegistry.kt"
click node_storecontract "https://github.com/juniormichieletto/khrona/blob/main/khrona-core/src/main/kotlin/io/khrona/core/JobStore.kt"
click node_memory "https://github.com/juniormichieletto/khrona/blob/main/khrona-store-memory/src/main/kotlin/io/khrona/store/memory/MemoryJobStore.kt"
click node_jdbc "https://github.com/juniormichieletto/khrona/blob/main/khrona-store-jdbc/src/main/kotlin/io/khrona/store/jdbc/JdbcJobStore.kt"
click node_dialect "https://github.com/juniormichieletto/khrona/blob/main/khrona-store-jdbc/src/main/kotlin/io/khrona/store/jdbc/JdbcDialect.kt"
click node_redis "https://github.com/juniormichieletto/khrona/blob/main/khrona-store-redis/src/main/kotlin/io/khrona/store/redis/RedisJobStore.kt"

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_ktor,node_extensions toneBlue
class node_dsl,node_definition,node_triggers,node_execution,node_status,node_scheduler,node_handlers,node_storecontract toneAmber
class node_memory,node_jdbc,node_dialect,node_redis toneMint
class node_sql,node_redisservice toneRose
class node_app toneIndigo
```

## Components

### Application integration

- [Ktor plugin](https://github.com/juniormichieletto/khrona/blob/main/khrona-ktor/src/main/kotlin/io/khrona/ktor/KhronaPlugin.kt): `khrona-ktor/src/main/kotlin/io/khrona/ktor/KhronaPlugin.kt`
- [Ktor extensions](https://github.com/juniormichieletto/khrona/blob/main/khrona-ktor/src/main/kotlin/io/khrona/ktor/Extensions.kt): `khrona-ktor/src/main/kotlin/io/khrona/ktor/Extensions.kt`

### Scheduling core

- [Job DSL](https://github.com/juniormichieletto/khrona/blob/main/khrona-core/src/main/kotlin/io/khrona/core/Dsl.kt): `khrona-core/src/main/kotlin/io/khrona/core/Dsl.kt`
- [Job definitions](https://github.com/juniormichieletto/khrona/blob/main/khrona-core/src/main/kotlin/io/khrona/core/JobDefinition.kt): `khrona-core/src/main/kotlin/io/khrona/core/JobDefinition.kt`
- [Trigger types](https://github.com/juniormichieletto/khrona/tree/main/khrona-core/src/main/kotlin/io/khrona/core): `khrona-core/src/main/kotlin/io/khrona/core`
- [Execution records](https://github.com/juniormichieletto/khrona/blob/main/khrona-core/src/main/kotlin/io/khrona/core/JobExecution.kt): `khrona-core/src/main/kotlin/io/khrona/core/JobExecution.kt`
- [Execution states](https://github.com/juniormichieletto/khrona/blob/main/khrona-core/src/main/kotlin/io/khrona/core/ExecutionStatus.kt): `khrona-core/src/main/kotlin/io/khrona/core/ExecutionStatus.kt`
- [Scheduler](https://github.com/juniormichieletto/khrona/blob/main/khrona-core/src/main/kotlin/io/khrona/core/Scheduler.kt): `khrona-core/src/main/kotlin/io/khrona/core/Scheduler.kt`
- [Handler registry](https://github.com/juniormichieletto/khrona/blob/main/khrona-core/src/main/kotlin/io/khrona/core/HandlerRegistry.kt): `khrona-core/src/main/kotlin/io/khrona/core/HandlerRegistry.kt`
- [Store contract](https://github.com/juniormichieletto/khrona/blob/main/khrona-core/src/main/kotlin/io/khrona/core/JobStore.kt): `khrona-core/src/main/kotlin/io/khrona/core/JobStore.kt`

### Storage backends

- [Memory store](https://github.com/juniormichieletto/khrona/blob/main/khrona-store-memory/src/main/kotlin/io/khrona/store/memory/MemoryJobStore.kt): `khrona-store-memory/src/main/kotlin/io/khrona/store/memory/MemoryJobStore.kt`
- [JDBC store](https://github.com/juniormichieletto/khrona/blob/main/khrona-store-jdbc/src/main/kotlin/io/khrona/store/jdbc/JdbcJobStore.kt): `khrona-store-jdbc/src/main/kotlin/io/khrona/store/jdbc/JdbcJobStore.kt`
- [JDBC dialects](https://github.com/juniormichieletto/khrona/blob/main/khrona-store-jdbc/src/main/kotlin/io/khrona/store/jdbc/JdbcDialect.kt): `khrona-store-jdbc/src/main/kotlin/io/khrona/store/jdbc/JdbcDialect.kt`
- [Redis store](https://github.com/juniormichieletto/khrona/blob/main/khrona-store-redis/src/main/kotlin/io/khrona/store/redis/RedisJobStore.kt): `khrona-store-redis/src/main/kotlin/io/khrona/store/redis/RedisJobStore.kt`

### Storage services

- **SQL database**
- **Redis server**

### Other components

- **Ktor application**

## Connections

- Ktor application → Ktor plugin: installs (evidence: `README.md`)
- Ktor application → Job DSL: defines jobs (evidence: `README.md`)
- Ktor plugin → Scheduler: creates (evidence: `khrona-ktor/src/main/kotlin/io/khrona/ktor/KhronaPlugin.kt`)
- Ktor extensions → Ktor plugin: configures (evidence: `khrona-ktor/src/main/kotlin/io/khrona/ktor/Extensions.kt`)
- Job DSL → Job definitions: builds (evidence: `khrona-core/src/main/kotlin/io/khrona/core/Dsl.kt`)
- Job DSL → Trigger types: selects (evidence: `khrona-core/src/main/kotlin/io/khrona/core/Dsl.kt`)
- Scheduler → Handler registry: registers (evidence: `khrona-core/src/main/kotlin/io/khrona/core/Scheduler.kt`)
- Scheduler → Store contract: polls and claims (evidence: `khrona-core/src/main/kotlin/io/khrona/core/Scheduler.kt`)
- Scheduler → Job definitions: loads (evidence: `khrona-core/src/main/kotlin/io/khrona/core/Scheduler.kt`)
- Scheduler → Trigger types: schedules (evidence: `khrona-core/src/main/kotlin/io/khrona/core/Scheduler.kt`)
- Scheduler → Execution records: updates (evidence: `khrona-core/src/main/kotlin/io/khrona/core/Scheduler.kt`)
- Store contract → Execution records: stores (evidence: `khrona-core/src/main/kotlin/io/khrona/core/JobStore.kt`)
- Store contract → Job definitions: stores (evidence: `khrona-core/src/main/kotlin/io/khrona/core/JobStore.kt`)
- Execution records → Execution states: tracks (evidence: `khrona-core/src/main/kotlin/io/khrona/core/JobExecution.kt`)
- Memory store → Store contract: implements (evidence: `khrona-store-memory/src/main/kotlin/io/khrona/store/memory/MemoryJobStore.kt`)
- JDBC store → Store contract: implements (evidence: `khrona-store-jdbc/src/main/kotlin/io/khrona/store/jdbc/JdbcJobStore.kt`)
- JDBC store → JDBC dialects: uses (evidence: `khrona-store-jdbc/src/main/kotlin/io/khrona/store/jdbc/JdbcJobStore.kt`)
- Redis store → Store contract: implements (evidence: `khrona-store-redis/src/main/kotlin/io/khrona/store/redis/RedisJobStore.kt`)
- Scheduler → Memory store: selects backend (evidence: `README.md`)
- Scheduler → JDBC store: selects backend (evidence: `README.md`)
- Scheduler → Redis store: selects backend (evidence: `README.md`)
- JDBC store → SQL database: queries
- Redis store → Redis server: coordinates
