updated docs

docs/graphs/cfg_gen_flow.dot

@@ -0,0 +1,49 @@
+digraph cfg_gen_flow {
+    bgcolor="#0a0a0a"
+    rankdir=LR
+    fontname="Helvetica"
+    node [fontname="Helvetica" fontsize=11 style=filled color="#333" fontcolor="#e5e5e5" shape=box]
+    edge [fontname="Helvetica" fontsize=9 fontcolor="#a3a3a3" color="#d4a574"]
+
+    label="Build Flow — cfg/ to gen/"
+    labelloc=t
+    fontsize=14
+    fontcolor="#d4a574"
+
+    // Source
+    subgraph cluster_source {
+        label="Source (committed)"
+        style=dashed
+        color="#333"
+        fontcolor="#666"
+
+        core [label="soleprint/\ncore framework" fillcolor="#1a1a1a"]
+        cfg [label="cfg/<room>/\nroom config" fillcolor="#1a1a1a"]
+    }
+
+    // Build
+    build [label="build.py\n--cfg <room>" fillcolor="#1a1a1a" color="#d4a574" shape=component]
+
+    // Output
+    subgraph cluster_output {
+        label="Output (generated, gitignored)"
+        style=dashed
+        color="#333"
+        fontcolor="#666"
+
+        gen_spr [label="gen/<room>/soleprint/\ncore + room merged" fillcolor="#1a1a1a"]
+        gen_app [label="gen/<room>/<app>/\ncloned repos" fillcolor="#1a1a1a"]
+        gen_link [label="gen/<room>/link/\nDB bridge" fillcolor="#1a1a1a"]
+    }
+
+    // Run
+    docker [label="docker compose up" fillcolor="#1a1a1a" shape=component]
+
+    // Flow
+    core -> build
+    cfg -> build
+    build -> gen_spr
+    build -> gen_app [style=dashed label="if managed"]
+    build -> gen_link [style=dashed label="if managed"]
+    gen_spr -> docker
+}