blackroad-os-archive/templates/TEMPLATE-003-DOMAIN-DNS-ROUTING.md

╭━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━╮ │ 🌐🛣 DOMAIN CARD · <DOMAIN_NAME> │ ╰━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━╯

🧭 Overview ────────────────────────────────────────────────────────────

• Domain: <DOMAIN_NAME>
• Purpose:
• Owners (👥): <team / person>
• Environment(s): <env_prod / env_staging / etc.>

📡 Routing & Services ────────────────────────────────────────────────────────────

Primary Entry

• 🌐 Hostname: <host or wildcard> (e.g. *.blackroad.io)
• ⛅️ Edge: <Cloudflare zone / worker> (e.g. blackroad-edge-router)

Services Behind This Domain

• 🛰 <service_name_1> –
  • Path(s): /api/..., /auth/...
  • Env:
• 🛰 <service_name_2> –
  • Path(s): /, /dashboard

Traffic Rules (🔀)

• Rule 1: <condition> → <target>
• Rule 2: <condition> → <target>

🧱 DNS Records ────────────────────────────────────────────────────────────

Code-ish view:

TYPE NAME VALUE / TARGET TTL NOTES A auto AAAA auto CNAME <target.domain.com> auto TXT auto <SPF/verification/etc.>

Human view:

• 🌐 Root (<DOMAIN_NAME>) → (e.g. Cloudflare worker/pages)
• 🌐 *.subdomain →
• 🔏 TLS: <Full/Strict/Flexible>

🧪 Verification & Health ────────────────────────────────────────────────────────────

Status

• DNS Resolution (🌐): ✅ / ⚠️ / ❌
• HTTPS (🔐): ✅ / ⚠️ / ❌
• Latency (⏱): ~ global

How to Verify (🔍)

• DNS: dig / nslookup
• HTTPS: visit https:// and check cert
• Worker: wrangler tail or health endpoint

Common Issues (🚨)

• Symptom: → Likely: → Fix:

📚 Links ────────────────────────────────────────────────────────────

• Cloudflare zone:
• Worker / Pages config:
• Related project: projects/<proj_name>/project.md
• Runbook: projects/<proj_name>/runbook.md

🎯 Next Steps

• <Step 1: e.g. "Enable HTTPS on staging subdomain">
• <Step 2: e.g. "Migrate root domain to new router">

💡 Tips

• <keep this domain's use narrow / don't mix X with Y>