From 38386afea463500744fbf828cd3c30e3252a9bf2 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=E2=80=9CBeeRad=E2=80=9D?= <bradwmorriswork@gmail.com>
Date: Mon, 2 Feb 2026 10:32:35 +1100
Subject: [PATCH] docs: add Mermaid ER diagram to schema docs
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
---
 docs/2_schema.md | 45 +++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 45 insertions(+)

diff --git a/docs/2_schema.md b/docs/2_schema.md
index 2291383..d31b66b 100644
--- a/docs/2_schema.md
+++ b/docs/2_schema.md
@@ -1,5 +1,50 @@
 # Database Schema
 
+## Entity Relationship Diagram
+
+```mermaid
+erDiagram
+    nodes ||--o{ node_dimensions : "has"
+    nodes ||--o{ edges : "from"
+    nodes ||--o{ edges : "to"
+    nodes ||--o{ chunks : "contains"
+    dimensions ||--o{ node_dimensions : "tagged_with"
+
+    nodes {
+        INTEGER id PK
+        TEXT title
+        TEXT content
+        TEXT type
+        BLOB embedding
+    }
+
+    edges {
+        INTEGER id PK
+        INTEGER from_node_id FK
+        INTEGER to_node_id FK
+        TEXT context
+        TEXT explanation
+    }
+
+    dimensions {
+        TEXT name PK
+        INTEGER is_priority
+    }
+
+    node_dimensions {
+        INTEGER node_id FK
+        TEXT dimension FK
+    }
+
+    chunks {
+        INTEGER id PK
+        INTEGER node_id FK
+        TEXT text
+    }
+```
+
+---
+
 ## Why SQLite?
 
 RA-H uses **SQLite** for local-first data ownership. Your knowledge stays on your machine - no cloud dependencies. SQLite provides: