docs(docs): add strategy, coding, and system design documentation hierarchy

2026-11-03 05:27:36 +00:00 · 2026-08-14 18:37:13 -04:00
1 parent 87581c4f4b
commit 91c45ea5de
@@ -0,0 +1,12 @@
+---
+title: 'B-Tree Indexes'
+description: 'The BST ordering invariant as a database index.'
+sidebar:
+  order: 8
+---
+
+:::warning[Under construction]
+This page is a scaffold. Notes, canonical problems, and template code are not written yet.
+:::
+
+**Coding family:** Hierarchical.
@@ -0,0 +1,12 @@
+---
+title: 'Cache Eviction'
+description: 'LRU cache as a hashmap plus a doubly-linked eviction index.'
+sidebar:
+  order: 4
+---
+
+:::warning[Under construction]
+This page is a scaffold. Notes, canonical problems, and template code are not written yet.
+:::
+
+**Coding family:** Nodal Linear.
@@ -0,0 +1,12 @@
+---
+title: 'Dependency Resolution'
+description: 'Topological sort as build-graph and package resolution.'
+sidebar:
+  order: 9
+---
+
+:::warning[Under construction]
+This page is a scaffold. Notes, canonical problems, and template code are not written yet.
+:::
+
+**Coding family:** Relational.
@@ -0,0 +1,12 @@
+---
+title: 'Eventual Consistency'
+description: 'Greedy local decisions that provably converge.'
+sidebar:
+  order: 14
+---
+
+:::warning[Under construction]
+This page is a scaffold. Notes, canonical problems, and template code are not written yet.
+:::
+
+**Coding family:** Decision-Space.
@@ -0,0 +1,12 @@
+---
+title: 'Gossip Propagation'
+description: 'BFS frontier expansion as epidemic broadcast.'
+sidebar:
+  order: 11
+---
+
+:::warning[Under construction]
+This page is a scaffold. Notes, canonical problems, and template code are not written yet.
+:::
+
+**Coding family:** Relational.
@@ -0,0 +1,12 @@
+---
+title: 'Idempotency Caches'
+description: 'A DP memo as an idempotency cache over a deterministic state machine.'
+sidebar:
+  order: 12
+---
+
+:::warning[Under construction]
+This page is a scaffold. Notes, canonical problems, and template code are not written yet.
+:::
+
+**Coding family:** Decision-Space.
@@ -0,0 +1,27 @@
+---
+title: 'System Design'
+description: 'The systems anchor behind each coding family: the same structure, at production scale.'
+sidebar:
+  order: 1
+  label: Overview
+---
+
+:::warning[Under construction]
+This page is a scaffold. Notes, canonical problems, and template code are not written yet.
+:::
+
+## Systems anchors
+
+- [Materialized Views](/guides/system-design/materialized-views) — Prefix sum as a precomputed, read-optimized projection. *(Contiguous Linear)*
+- [Stream Processing](/guides/system-design/stream-processing) — Sliding window as a bounded stream with an eviction policy. *(Contiguous Linear)*
+- [Cache Eviction](/guides/system-design/cache-eviction) — LRU cache as a hashmap plus a doubly-linked eviction index. *(Nodal Linear)*
+- [Log Compaction](/guides/system-design/log-compaction) — Monotonic stack as dropping entries superseded by newer state. *(Auxiliary Ordering)*
+- [Priority Scheduling](/guides/system-design/priority-scheduling) — Heaps behind schedulers, Dijkstra's frontier, and timer wheels. *(Auxiliary Ordering)*
+- [Radix Routing Tables](/guides/system-design/radix-routing-tables) — Tries behind routing tables and IPLD path resolution. *(Hierarchical)*
+- [B-Tree Indexes](/guides/system-design/btree-indexes) — The BST ordering invariant as a database index. *(Hierarchical)*
+- [Dependency Resolution](/guides/system-design/dependency-resolution) — Topological sort as build-graph and package resolution. *(Relational)*
+- [Partition Detection](/guides/system-design/partition-detection) — Union-find as dynamic connectivity across a cluster. *(Relational)*
+- [Gossip Propagation](/guides/system-design/gossip-propagation) — BFS frontier expansion as epidemic broadcast. *(Relational)*
+- [Idempotency Caches](/guides/system-design/idempotency-caches) — A DP memo as an idempotency cache over a deterministic state machine. *(Decision-Space)*
+- [Sagas and Compensation](/guides/system-design/sagas-and-compensation) — Backtracking as a saga with compensating undo. *(Decision-Space)*
+- [Eventual Consistency](/guides/system-design/eventual-consistency) — Greedy local decisions that provably converge. *(Decision-Space)*
@@ -0,0 +1,12 @@
+---
+title: 'Log Compaction'
+description: 'Monotonic stack as dropping entries superseded by newer state.'
+sidebar:
+  order: 5
+---
+
+:::warning[Under construction]
+This page is a scaffold. Notes, canonical problems, and template code are not written yet.
+:::
+
+**Coding family:** Auxiliary Ordering.
@@ -0,0 +1,12 @@
+---
+title: 'Materialized Views'
+description: 'Prefix sum as a precomputed, read-optimized projection.'
+sidebar:
+  order: 2
+---
+
+:::warning[Under construction]
+This page is a scaffold. Notes, canonical problems, and template code are not written yet.
+:::
+
+**Coding family:** Contiguous Linear.
@@ -0,0 +1,9 @@
+import { defineMeta } from "blume";
+
+export default defineMeta({
+  title: "System Design",
+  order: 2,
+  collapsed: true,
+  icon: "monitor-cog",
+  display: "page",
+});
@@ -0,0 +1,12 @@
+---
+title: 'Partition Detection'
+description: 'Union-find as dynamic connectivity across a cluster.'
+sidebar:
+  order: 10
+---
+
+:::warning[Under construction]
+This page is a scaffold. Notes, canonical problems, and template code are not written yet.
+:::
+
+**Coding family:** Relational.
@@ -0,0 +1,12 @@
+---
+title: 'Priority Scheduling'
+description: "Heaps behind schedulers, Dijkstra's frontier, and timer wheels."
+sidebar:
+  order: 6
+---
+
+:::warning[Under construction]
+This page is a scaffold. Notes, canonical problems, and template code are not written yet.
+:::
+
+**Coding family:** Auxiliary Ordering.
@@ -0,0 +1,12 @@
+---
+title: 'Radix Routing Tables'
+description: 'Tries behind routing tables and IPLD path resolution.'
+sidebar:
+  order: 7
+---
+
+:::warning[Under construction]
+This page is a scaffold. Notes, canonical problems, and template code are not written yet.
+:::
+
+**Coding family:** Hierarchical.
@@ -0,0 +1,12 @@
+---
+title: 'Sagas and Compensation'
+description: 'Backtracking as a saga with compensating undo.'
+sidebar:
+  order: 13
+---
+
+:::warning[Under construction]
+This page is a scaffold. Notes, canonical problems, and template code are not written yet.
+:::
+
+**Coding family:** Decision-Space.
@@ -0,0 +1,12 @@
+---
+title: 'Stream Processing'
+description: 'Sliding window as a bounded stream with an eviction policy.'
+sidebar:
+  order: 3
+---
+
+:::warning[Under construction]
+This page is a scaffold. Notes, canonical problems, and template code are not written yet.
+:::
+
+**Coding family:** Contiguous Linear.