How juniormichieletto/khrona works
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: Scheduler.kt Scheduler · JobStore.kt Store contract · JdbcJobStore.kt JDBC store · Dsl.kt Job DSL
Components 17
Application integration
- Ktor plugin
khrona-ktor/src/main/kotlin/io/khrona/ktor/KhronaPlugin.kt - Ktor extensions
khrona-ktor/src/main/kotlin/io/khrona/ktor/Extensions.kt
Scheduling core
- Job DSL
khrona-core/src/main/kotlin/io/khrona/core/Dsl.kt - Job definitions
khrona-core/src/main/kotlin/io/khrona/core/JobDefinition.kt - Trigger types
khrona-core/src/main/kotlin/io/khrona/core - Execution records
khrona-core/src/main/kotlin/io/khrona/core/JobExecution.kt - Execution states
khrona-core/src/main/kotlin/io/khrona/core/ExecutionStatus.kt - Scheduler
khrona-core/src/main/kotlin/io/khrona/core/Scheduler.kt - Handler registry
khrona-core/src/main/kotlin/io/khrona/core/HandlerRegistry.kt - Store contract
khrona-core/src/main/kotlin/io/khrona/core/JobStore.kt
Storage backends
- Memory store
khrona-store-memory/src/main/kotlin/io/khrona/store/memory/MemoryJobStore.kt - JDBC store
khrona-store-jdbc/src/main/kotlin/io/khrona/store/jdbc/JdbcJobStore.kt - JDBC dialects
khrona-store-jdbc/src/main/kotlin/io/khrona/store/jdbc/JdbcDialect.kt - Redis store
khrona-store-redis/src/main/kotlin/io/khrona/store/redis/RedisJobStore.kt
Storage services
- SQL database
- Redis server
Other components
- Ktor application
Connections 23
- Ktor application → Ktor plugin: installs
README.md - Ktor application → Job DSL: defines jobs
README.md - Ktor plugin → Scheduler: creates
khrona-ktor/src/main/kotlin/io/khrona/ktor/KhronaPlugin.kt - Ktor extensions → Ktor plugin: configures
khrona-ktor/src/main/kotlin/io/khrona/ktor/Extensions.kt - Job DSL → Job definitions: builds
khrona-core/src/main/kotlin/io/khrona/core/Dsl.kt - Job DSL → Trigger types: selects
khrona-core/src/main/kotlin/io/khrona/core/Dsl.kt - Scheduler → Handler registry: registers
khrona-core/src/main/kotlin/io/khrona/core/Scheduler.kt - Scheduler → Store contract: polls and claims
khrona-core/src/main/kotlin/io/khrona/core/Scheduler.kt - Scheduler → Job definitions: loads
khrona-core/src/main/kotlin/io/khrona/core/Scheduler.kt - Scheduler → Trigger types: schedules
khrona-core/src/main/kotlin/io/khrona/core/Scheduler.kt - Scheduler → Execution records: updates
khrona-core/src/main/kotlin/io/khrona/core/Scheduler.kt - Store contract → Execution records: stores
khrona-core/src/main/kotlin/io/khrona/core/JobStore.kt - Store contract → Job definitions: stores
khrona-core/src/main/kotlin/io/khrona/core/JobStore.kt - Execution records → Execution states: tracks
khrona-core/src/main/kotlin/io/khrona/core/JobExecution.kt - Memory store → Store contract: implements
khrona-store-memory/src/main/kotlin/io/khrona/store/memory/MemoryJobStore.kt - JDBC store → Store contract: implements
khrona-store-jdbc/src/main/kotlin/io/khrona/store/jdbc/JdbcJobStore.kt - JDBC store → JDBC dialects: uses
khrona-store-jdbc/src/main/kotlin/io/khrona/store/jdbc/JdbcJobStore.kt - Redis store → Store contract: implements
khrona-store-redis/src/main/kotlin/io/khrona/store/redis/RedisJobStore.kt - Scheduler → Memory store: selects backend
README.md - Scheduler → JDBC store: selects backend
README.md - Scheduler → Redis store: selects backend
README.md - JDBC store → SQL database: queries
- Redis store → Redis server: coordinates