📚 SegmentIndex Architecture

This section describes the top-level index orchestration layer: how operations are routed, cached, and executed across segments.

Segment internals are intentionally centralized in Segment Architecture to avoid duplication.

Topics

• Read Path — request routing and lookup flow.
• Write Path — buffering, flush, compaction, and split orchestration.
• Caching Strategy — index-level cache roles and sizing.
• Cache LRU — bounded LRU behavior and trade-offs.
• Performance Model & Sizing — throughput/latency model and tuning knobs.
• Segment Index Concurrency — index thread-safety and lifecycle behavior.