paulDB/docs/architecture.md

paulDB – Architektur

Internes Design-Dokument. Das „Warum" hinter der Ordnerstruktur.

Big Picture

paulDB ist eine In-Memory HTAP-Engine: Row- und Column-Storage in einem System, verbunden durch einen Delta-Merge nach SAP-HANA-Vorbild.

SQL-Frontend ──> Query-Router ──┬─> Row-Pfad (Delta)   ─┐
   (sql)           (query)      │                        ├─> Ergebnis
                                └─> Column-Pfad (Main)  ─┘
                       Delta ──(Delta-Merge)──> Main

Module ↔ Roadmap

Modul (src/)	Etappe	Aufgabe
storage/delta	E1	schreib-optimierter Row-Store (OLTP)
sql/	E2/E6	Tokenizer → AST → Plan
storage/main	E3	lese-optimierter Column-Store (OLAP)
compression/	E3	Dictionary + Prefix/RLE/Cluster/Sparse/Indirect
merge/	E4	Delta → Main (das Herzstück)
query/	E5	Router: OLTP- vs OLAP-Pfad (der HTAP-Beweis)
txn/	E7	MVCC / konsistente Lesersicht

Prinzipien

• Verstehen vor Benutzen – jedes Modul kommentiert das Warum.
• Klein, aber echt – lieber wenig, das wirklich läuft.
• Schlanke Public API – Re-Exports in lib.rs, Details bleiben privat.