Deep dives¶
Subsystem walkthroughs with pointers to source files. When a deep dive disagrees with the code, trust src/.
| Document | Topic | Key source files |
|---|---|---|
| Write path | HTTP → WAL → flush → chDB MergeTree | adapters/http/write.rs, application/flush_service.rs, adapters/chdb/native_adapter.rs |
| Read path | TimeseriesQL → ClickHouse SQL → chDB | timeseriesql/, application/query_service.rs, adapters/chdb/ |
| Clustering | Replication, Raft, sync, hinted handoff | domain/cluster/, application/cluster/, adapters/cluster/ |
| Compaction | MergeTree background merges | chDB / ClickHouse engine |
| Self-repair | Peer convergence via replication and sync | adapters/cluster/sync_client.rs, replication_log.rs |
Replication peer sends use exponential backoff starting at 1s, capped at 30s, up to replication_max_retries attempts.