Update tech_docs/its_the_new_style_design.md

2025-08-05 12:46:16 -05:00
parent 73cfc346c6
commit 4f75a3dadf
1 changed files with 71 additions and 0 deletions
--- a/tech_docs/its_the_new_style_design.md
+++ b/tech_docs/its_the_new_style_design.md
@@ -1,3 +1,74 @@
+──────────────────────────────────────────────  
+Symphony-in-DNS Cheat Sheet  
+Homelab Edition – v1.0 (fits on one A4, landscape)  
+──────────────────────────────────────────────  
+
+1. The Clock-face /24  
+   192.168.42.0/24  
+   .1 – .12      → static metal (noon-to-midnight hand)  
+   .127           → silent 6 o’clock tick (NEVER used)  
+   .129 – .254   → mirrored DHCP hand (fleet: LXC / VM / K8s)  
+   Primes (.11, .13, .17…) within any range are intentionally empty.  
+
+2. Role Keys (white keys only)  
+   C  Core (router / firewall)  
+   D  Data (DB / storage)  
+   E  Edge (load-balancer)  
+   F  Fleet-host (KVM / LXC metal)  
+   G  GitOps (CI / runners)  
+   A  App server  
+   B  Backup  
+
+3. Zone Palette (Mondrian colours)  
+   infra  (black)  – infrastructure control plane  
+   lan    (red)    – trusted internal LAN  
+   dmz    (blue)   – public / untrusted  
+   guest  (yellow) – lab / throw-away  
+
+4. Hostname Grammar  
+   <role>-<seq>.<zone>.mycorp.net  
+   • role  = 1-letter above  
+   • seq   = 01 – 88 (zero-padded)  
+   • zone  = one of the four colours  
+
+   Example full rectangle: F-05.lan.mycorp.net  
+
+5. Homelab Metal Map (static hand)  
+   .1  F-01.lan   Dell-1  (KVM)  
+   .2  F-02.lan   Dell-2  (K8s CP)  
+   .3  F-03.lan   Dell-3  (Ceph)  
+   .4  F-04.lan   Dell-4  (CI)  
+   .5  F-05.lan   Dell-5  (Unifi)  
+   .6  P-01.lan   Pi-1    (Pi-hole)  
+   .7  P-02.lan   Pi-2    (MQTT)  
+   .8  P-03.lan   Pi-3    (3-D printer)  
+   .9  P-04.lan   Pi-4    (UPS probe)  
+   .11 (silent prime – leave empty)  
+
+6. Fleet & Containers  
+   • Will auto-lease mirrored hand (.129-254).  
+   • Names follow same grammar: A-17.lan, D-31.dmz, etc.  
+
+7. Quick Commands  
+   # set hostname  
+   hostnamectl set-hostname F-03.lan.mycorp.net  
+
+   # Ansible ping  
+   ansible metal -i inventory.yml -m ping  
+
+   # DNS check  
+   dig +short -x 192.168.42.3  
+
+8. Keep It Tidy  
+   • Never exceed 88 hosts per role/zone.  
+   • Always zero-pad sequences.  
+   • Primes are sacred silence—do not assign.  
+
+──────────────────────────────────────────────  
+Print, laminate, stick near the rack.
+
+---
+
 ──────────────────────────────────────────────  
 SYMPHONY-IN-DNS  
 A playful yet practical naming grammar that satisfies all four axioms and the six meta-themes above.