init rig

rig/docs/graphs/03-architecture.dot

@@ -0,0 +1,56 @@
+// TODO: PLACEHOLDER — replace with the real estate topology.
+//
+// This is where the extracted platform diagrams land. The shape below is
+// illustrative only: it shows how a mocked dependency, a real service and a
+// remote system are meant to sit together, not what the system actually is.
+//
+// The intended end state is that this file stops being hand-written and is
+// generated from the running cluster, so the diagram becomes a report of what
+// exists rather than a drawing of what was once intended.
+digraph estate {
+    rankdir=LR
+    bgcolor="#0a0e17"
+    fontname="Helvetica"
+    node [fontname="Helvetica" fontsize=11 style=filled color="#1e2a4a" fontcolor="#e8eaf0" shape=box]
+    edge [fontname="Helvetica" fontsize=9 fontcolor="#8892a8" color="#4a5568"]
+
+    label="Estate topology — PLACEHOLDER"
+    labelloc=t
+    fontsize=16
+    fontcolor="#ffc107"
+
+    subgraph cluster_new {
+        label="New"
+        style=dashed
+        color="#1e2a4a"
+        fontcolor="#8892a8"
+
+        api     [label="service under work\n(real: built and hot-reloaded)" fillcolor="#1a3a1a" fontcolor="#00c853"]
+    }
+
+    subgraph cluster_core {
+        label="Core (mocked)"
+        style=dashed
+        color="#1e2a4a"
+        fontcolor="#8892a8"
+
+        svc_a   [label="upstream service\n(mock: canned responses)" fillcolor="#121829"]
+        db      [label="datastore\n(mock)" fillcolor="#121829" shape=cylinder]
+    }
+
+    subgraph cluster_legacy {
+        label="Legacy estate (mocked)"
+        style=dashed
+        color="#1e2a4a"
+        fontcolor="#8892a8"
+
+        batch   [label="batch drop\n(mock: writes files on a timer)" fillcolor="#121829"]
+    }
+
+    remote  [label="external system\n(remote: ExternalName,\nreachable only from a VDI)" fillcolor="#3a1a1a" fontcolor="#ffc107" shape=octagon]
+
+    api -> svc_a  [label="HTTP"]
+    api -> db     [label="query"]
+    api -> batch  [label="file handoff" style=dashed]
+    api -> remote [label="only when reachable" style=dashed color="#ffc107"]
+}