Documentation Index

This directory contains reference material for the storage engine prototype.

• architecture_overview.md — end-to-end blueprint covering data model, metadata catalog, cache hierarchy, IO format, and read/write flows.

Component Deep Dives

• main.md — runtime wiring and dependencies.
• entry.md — logical value wrapper.
• page.md — page structure and lifecycle.
• page_cache.md — LRU caches for compressed/uncompressed pages.
• compressor.md — bincode + LZ4 compression pipeline.
• page_io.md — disk layout and IO semantics.
• page_handler.md — cache orchestration and batch retrieval.
• metadata_store.md — MVCC-aware catalog and range lookups.
• ops_handler.md — external API contracts for upsert/update/scan.
• scheduler.md — thread pool skeleton and future scheduling role.

Extend this directory as new subsystems (WAL, compaction, etc.) take shape.