initial version

kb/diagram/reference-layouts/database-ha-dr.yaml

@@ -0,0 +1,55 @@
+---
+last_verified: 2026-03-14
+description: Reference layout for database HA/DR architecture diagram
+---
+
+layout:
+  name: "Database HA/DR — Dual Region"
+  page_size: "A3 landscape"
+
+  structure:
+    # Primary region takes 60% of width
+    primary_region:
+      position: { x: 20, y: 40 }
+      size: { width: 680, height: 720 }
+      contains:
+        vcn:
+          position: { x: 20, y: 40 }
+          size: { width: 640, height: 660 }
+          subnets:
+            data_tier:
+              position: { x: 20, y: 30 }
+              size: { width: 300, height: 400 }
+              label_position: "top-left"
+            app_tier:
+              position: { x: 340, y: 30 }
+              size: { width: 280, height: 200 }
+            dmz:
+              position: { x: 340, y: 250 }
+              size: { width: 280, height: 100 }
+
+    # DR region takes 35% of width
+    dr_region:
+      position: { x: 720, y: 40 }
+      size: { width: 460, height: 720 }
+      contains:
+        vcn:
+          position: { x: 20, y: 40 }
+          size: { width: 420, height: 400 }
+          subnets:
+            dr_data_tier:
+              position: { x: 20, y: 30 }
+              size: { width: 380, height: 350 }
+
+    # Connection between regions (horizontal)
+    inter_region_connection:
+      from: "data_tier"
+      to: "dr_data_tier"
+      style: "adg"
+      label_position: "center"
+
+  notes:
+    - "Primary region on left, DR region on right"
+    - "Data Guard arrow flows left → right"
+    - "FastConnect shown at bottom connecting to on-premises"
+    - "Security services (Vault, Data Safe) placed near data tier"

kb/diagram/reference-layouts/single-region-ha.yaml

@@ -0,0 +1,70 @@
+---
+last_verified: 2026-03-14
+layout: Single Region with HA
+description: |
+  Reference layout for a single-region deployment with high availability.
+  Suitable for most production workloads not requiring cross-region DR.
+---
+
+canvas:
+  width: 1200
+  height: 800
+
+structure:
+  tenancy:
+    x: 0
+    y: 0
+    width: 1200
+    height: 800
+
+  region:
+    x: 20
+    y: 40
+    width: 1160
+    height: 740
+
+  vcn:
+    x: 20
+    y: 40
+    width: 1100
+    height: 680
+
+  subnets:
+    public_web:
+      position: top
+      x: 20
+      y: 30
+      width: 520
+      height: 180
+      purpose: "Load balancers, WAF"
+
+    private_app:
+      position: middle
+      x: 20
+      y: 230
+      width: 520
+      height: 200
+      purpose: "Application servers, OKE workers"
+
+    private_db:
+      position: bottom
+      x: 20
+      y: 450
+      width: 1060
+      height: 200
+      purpose: "Database instances, Data Safe, Vault"
+
+    private_mgmt:
+      position: right
+      x: 560
+      y: 30
+      width: 500
+      height: 400
+      purpose: "Bastion, monitoring, management"
+
+notes: |
+  - Place load balancers in public subnet at top
+  - App tier in private subnet in middle
+  - Database tier in private subnet at bottom (widest)
+  - Management/security services in right column
+  - Services flow top-to-bottom: LB → App → DB