Files
blackroad-domains/ALL_DOMAINS_REFERENCE.md
Alexa Louise e7a228870b Add complete BlackRoad infrastructure documentation
This commit adds comprehensive canonical documentation for all BlackRoad
infrastructure, domains, and services.

Documentation includes:
- BLACKROAD_CANONICAL_TRUTH.md - Master source of truth
  - 19 GoDaddy registered domains
  - 58 Cloudflare Pages projects
  - 15 GitHub organizations
  - 40+ repositories
  - 7 physical devices (Raspberry Pis + VPS)
  - 4 AI platform integrations
  - Complete network plane taxonomy
  - IP addressing schema
  - Secrets management locations

- COMPLETE_DOMAIN_MASTER_LIST.md - All domains & projects
  - Complete Cloudflare Pages inventory
  - Domain-to-project mapping
  - Deployment instructions
  - DNS configurations

- LUCIDIA_EARTH_INFRASTRUCTURE.md - Infrastructure guide
  - Cloudflare Pages, Workers, Tunnels
  - Raspberry Pi deployment
  - Docker configurations
  - Claude Code integration

- QUICK_DEPLOY.md - Fast deployment reference
- ALL_DOMAINS_REFERENCE.md - Domain routing details

Automation scripts:
- blackroad-deploy-all.sh - Master deployment orchestrator
- blackroad-netdump.sh - Network inventory collector

All 19 domains:
- lucidia.earth (metaverse)
- blackroad.io (corporate)
- blackroadqi.com (quantum intelligence)
- blackroadquantum.{com,info,net,shop,store}
- roadchain.io, roadcoin.io
- And 10 more domains

Infrastructure as scripture. Complete canonical truth.

🤖 Generated with Claude Code (Cece)

Co-Authored-By: Claude <noreply@anthropic.com>
2025-12-22 18:52:18 -06:00

14 KiB

Complete Domain Reference for All BlackRoad & Lucidia Infrastructure

Owner: Alexa Louise Amundson Organization: BlackRoad Inc. Last Updated: 2025-12-22


Domain Summary

Total Domains: 16+ zones Total Cloudflare Pages Projects: 50+ Raspberry Pi Devices: 4 Cloud VPS: 1 (DigitalOcean)


Primary Domains

Lucidia Ecosystem

Domain Zone ID Pages Project Purpose Status
lucidia.earth 848cf0b18d51e0170e0d1537aec3505a lucidia-earth Metaverse platform Active

Subdomains:

  • api.lucidia.earth → Raspberry Pi 192.168.4.38:3000
  • ws.lucidia.earth → Raspberry Pi 192.168.4.38:8080 (WebSocket)
  • admin.lucidia.earth → lucidia-admin.pages.dev
  • docs.lucidia.earth → lucidia-docs.pages.dev
  • dev.lucidia.earth → lucidia-dev.pages.dev

Related Pages Projects:

  • lucidia-earth.pages.dev (main metaverse)
  • lucidia-platform.pages.dev
  • lucidia-core.pages.dev
  • lucidia-math.pages.dev

BlackRoad Primary

Domain Zone ID Pages Project Purpose Status
blackroad.io TBD blackroad-io Corporate site Active

Subdomains:

  • earth.blackroad.io → earth-blackroad-io.pages.dev
  • demo.blackroad.io → blackroad-os-demo.pages.dev
  • home.blackroad.io → blackroad-os-home.pages.dev
  • api.blackroad.io → DigitalOcean 159.65.43.12:3000
  • creator-studio.blackroad.io → blackroad-hello.pages.dev
  • creator.blackroad.io → blackroad-hello.pages.dev
  • devops.blackroad.io → blackroad-hello.pages.dev
  • education.blackroad.io → blackroad-hello.pages.dev
  • finance.blackroad.io → blackroad-hello.pages.dev
  • ideas.blackroad.io → blackroad-hello.pages.dev
  • legal.blackroad.io → blackroad-hello.pages.dev
  • research-lab.blackroad.io → blackroad-hello.pages.dev
  • studio.blackroad.io → blackroad-hello.pages.dev

BlackRoad Quantum Suite

Domain Pages Project Purpose
blackroadquantum.info blackroad-os-web Quantum information
blackroadquantum.net blackroad-os-web Quantum network
blackroadquantum.shop blackroad-os-web Quantum shop
blackroadquantum.store blackroad-os-web Quantum store
blackroadqi.com blackroad-os-web Quantum intelligence

Other BlackRoad Domains

Domain Pages Project Purpose
blackroad.me blackroad-me Personal site
blackroad.systems blackroad-systems Systems dashboard
roadchain.io roadchain-io Blockchain platform
roadcoin.io roadcoin-io Cryptocurrency

All Cloudflare Pages Projects

Active Deployments (Most Recent First)

  1. roadworld → roadworld.pages.dev
  2. lucidia-earth → lucidia-earth.pages.dev MAIN METAVERSE
  3. earth-blackroad-io → earth-blackroad-io.pages.dev, earth.blackroad.io
  4. blackroad-io → blackroad-io.pages.dev, blackroad.io
  5. blackroad-os-web → blackroad-os-web.pages.dev + 6 quantum domains
  6. blackroad-hello → blackroad-hello.pages.dev + 10 subdomains
  7. blackroad-os-demo → blackroad-os-demo.pages.dev, demo.blackroad.io
  8. blackroad-os-home → blackroad-os-home.pages.dev, home.blackroad.io
  9. blackroad-pitstop → blackroad-pitstop.pages.dev
  10. blackroad-metaverse → blackroad-metaverse.pages.dev
  11. blackroad-prism-console → blackroad-prism-console.pages.dev
  12. blackroad-console → blackroad-console.pages.dev
  13. applier-blackroad → applier-blackroad.pages.dev
  14. blackroad-gateway-web → blackroad-gateway-web.pages.dev
  15. blackroad-assets → blackroad-assets.pages.dev
  16. blackroad-portals → blackroad-portals.pages.dev
  17. blackroad-blackroadquantum → blackroad-blackroadquantum.pages.dev
  18. blackroad-blackroad-io → blackroad-blackroad-io.pages.dev
  19. blackroad-cece → blackroad-cece.pages.dev
  20. blackroad-blackroadai → blackroad-blackroadai.pages.dev
  21. blackroad-blackroad-me → blackroad-blackroad-me.pages.dev
  22. blackroad-portals-unified → blackroad-portals-unified.pages.dev
  23. blackroad-unified → blackroad-unified.pages.dev
  24. blackroad-status → blackroad-status.pages.dev
  25. blackroad-os-prism → blackroad-os-prism.pages.dev
  26. blackroad-hello-test → blackroad-hello-test.pages.dev
  27. lucidia-platform → lucidia-platform.pages.dev
  28. lucidia-math → lucidia-math.pages.dev
  29. lucidia-core → lucidia-core.pages.dev
  30. blackroad-tools → blackroad-tools.pages.dev
  31. blackroad-agents → blackroad-agents.pages.dev
  32. blackroad-chat → blackroad-chat.pages.dev
  33. blackroad-status-new → blackroad-status-new.pages.dev
  34. blackroad-admin → blackroad-admin.pages.dev
  35. blackroad-analytics → blackroad-analytics.pages.dev
  36. blackroad-builder → blackroad-builder.pages.dev
  37. blackroad-store → blackroad-store.pages.dev
  38. blackroad-workflows → blackroad-workflows.pages.dev
  39. blackroad-docs-hub → blackroad-docs-hub.pages.dev
  40. blackroad-payment-page → blackroad-payment-page.pages.dev
  41. blackroad-buy-now → blackroad-buy-now.pages.dev
  42. blackroad-company → blackroad-company.pages.dev
  43. roadcoin-io → roadcoin-io.pages.dev
  44. blackroad-systems → blackroad-systems.pages.dev
  45. blackroad-me → blackroad-me.pages.dev
  46. roadchain-io → roadchain-io.pages.dev
  47. blackroad-api → blackroad-api.pages.dev
  48. roadwork-production → roadwork-production.pages.dev
  49. remotejobs-platform → remotejobs-platform.pages.dev
  50. openai-structured-output → openai-structured-output.pages.dev

Cloudflare Workers

Active Workers

  1. lucidia-earth-router

    • Routes: lucidia.earth/*
    • Target: lucidia-earth.pages.dev
    • Location: ~/lucidia-earth-router
  2. blackroad-landing-worker

    • Target: blackroad-io.pages.dev
    • Location: ~/blackroad-landing-worker
  3. br-8080-cadillac (Port 8080 Cadillac)

    • Origin agent
    • Created: 7 months ago

Physical Infrastructure

Raspberry Pi Devices

Device IP Address Hostname Services Location
Lucidia Pi 192.168.4.38 lucidia Backend API, WebSocket, Database Home Network
Lucidia Alt 192.168.4.99 lucidia Backup services Home Network
BlackRoad Pi 192.168.4.64 blackroad-pi Secondary services Home Network
iPhone Koder 192.168.4.68:8080 iphone-koder Mobile development Home Network

Cloud VPS

Provider IP Hostname Services
DigitalOcean 159.65.43.12 codex-infinity BlackRoad API, Services

GitHub Organizations & Repositories

Organizations

  1. BlackRoad-OS (primary)
  2. blackboxprogramming (15 orgs total, 66 repos)

Key Repositories

  • lucidia-metaverse
  • lucidia-earth-router
  • lucidia-backend
  • blackroad-os-web
  • blackroad-os-core
  • blackroad-os-prism
  • blackroad-pi-ops
  • blackroad-agents
  • And 58+ more...

Connection Methods

Cloudflare Pages Deploy

Method 1: Direct CLI

wrangler pages deploy dist --project-name=<project-name>

Method 2: Git Integration

git push origin main
# Auto-deploys via Cloudflare Pages Git integration

Method 3: GitHub Actions

- uses: cloudflare/wrangler-action@v3
  with:
    apiToken: ${{ secrets.CF_API_TOKEN }}
    command: pages deploy dist --project-name=<project>

Cloudflare Workers Deploy

cd ~/worker-directory
wrangler deploy

Raspberry Pi Deploy (via SSH)

# Method 1: Direct SSH
ssh pi@192.168.4.38 'cd ~/project && git pull && docker-compose up -d --build'

# Method 2: Cloudflare Tunnel
cloudflared tunnel --url http://localhost:3000

Raspberry Pi Deploy (via Cloudflare Tunnel - Shellfish)

Setup Tunnel:

# On Pi
cloudflared tunnel login
cloudflared tunnel create lucidia-backend
cloudflared tunnel route dns lucidia-backend api.lucidia.earth

# Configure
nano ~/.cloudflared/config.yml

Config:

tunnel: <TUNNEL_ID>
credentials-file: /home/pi/.cloudflared/<TUNNEL_ID>.json

ingress:
  - hostname: api.lucidia.earth
    service: http://localhost:3000
  - hostname: ws.lucidia.earth
    service: http://localhost:8080
  - service: http_status:404

Run:

cloudflared tunnel run lucidia-backend

Docker Deployments

On Raspberry Pi:

ssh pi@192.168.4.38

# Navigate to project
cd ~/lucidia-backend

# Deploy with Docker Compose
docker-compose up -d --build

# View logs
docker-compose logs -f

# Restart specific service
docker-compose restart api

Docker Compose Structure:

services:
  api:
    image: node:18-alpine
    ports: ["3000:3000"]

  websocket:
    image: node:18-alpine
    ports: ["8080:8080"]

  postgres:
    image: postgres:15-alpine
    ports: ["5432:5432"]

  redis:
    image: redis:7-alpine
    ports: ["6379:6379"]

Claude Code Integration

Deploy via Claude:

# Claude can execute deployment scripts
~/lucidia-deploy.sh

# Or individual commands
cd ~/lucidia-metaverse && npm run build && wrangler pages deploy dist --project-name=lucidia-earth

Claude Automation:

# Create deployment script
cat > ~/deploy-all-domains.sh << 'EOF'
#!/bin/bash
# Deploy all infrastructure

# Lucidia
cd ~/lucidia-metaverse && npm run build && wrangler pages deploy dist --project-name=lucidia-earth
cd ~/lucidia-earth-router && wrangler deploy

# BlackRoad
cd ~/blackroad-io && npm run build && wrangler pages deploy dist --project-name=blackroad-io

# Backend
ssh pi@192.168.4.38 'cd ~/lucidia-backend && docker-compose up -d --build'

echo "✅ All deployments complete"
EOF

chmod +x ~/deploy-all-domains.sh

DNS Configuration Reference

Standard Cloudflare Pages Setup

Type: CNAME
Name: @ (or subdomain)
Content: <project-name>.pages.dev
Proxy Status: Proxied (orange cloud)
TTL: Auto

Cloudflare Worker Setup

Type: CNAME
Name: @
Content: <worker-name>.workers.dev
Proxy Status: Proxied
TTL: Auto

# Worker Routes configured in wrangler.toml:
[[routes]]
pattern = "domain.com/*"
zone_name = "domain.com"

Raspberry Pi via Tunnel

Type: CNAME
Name: api (or subdomain)
Content: <tunnel-id>.cfargotunnel.com
Proxy Status: Proxied
TTL: Auto
Type: A
Name: api
Content: 192.168.4.38
Proxy Status: DNS Only (grey cloud)
TTL: Auto

Domain Addition Workflow

Adding New Domain to Cloudflare

Step 1: Add Zone

curl -X POST "https://api.cloudflare.com/client/v4/zones" \
  -H "Authorization: Bearer yP5h0HvsXX0BpHLs01tLmgtTbQurIKPL4YnQfIwy" \
  -H "Content-Type: application/json" \
  --data '{
    "name": "newdomain.com",
    "account": {
      "id": "463024cf9efed5e7b40c5fbe7938e256"
    }
  }'

Step 2: Update Nameservers

Update at domain registrar:
NS1: alexa.ns.cloudflare.com
NS2: tommy.ns.cloudflare.com

Step 3: Create Pages Project

cd ~/new-project
npm run build
wrangler pages deploy dist --project-name=newdomain-com

Step 4: Add Custom Domain

# Via Cloudflare Dashboard:
# Pages → Project → Custom Domains → Add Domain → newdomain.com

Step 5: Create Worker (if routing needed)

mkdir ~/newdomain-router
cd ~/newdomain-router

# Create wrangler.toml
cat > wrangler.toml << 'EOF'
name = "newdomain-router"
main = "src/index.ts"
compatibility_date = "2025-01-01"

[vars]
PAGES_URL = "https://newdomain-com.pages.dev"

[[routes]]
pattern = "newdomain.com/*"
zone_name = "newdomain.com"
EOF

# Create worker code
mkdir -p src
cat > src/index.ts << 'EOF'
interface Env {
  PAGES_URL: string;
}

export default {
  async fetch(request: Request, env: Env): Promise<Response> {
    const url = new URL(request.url);
    const pagesUrl = new URL(url.pathname + url.search, env.PAGES_URL);

    const response = await fetch(pagesUrl.toString(), {
      method: request.method,
      headers: request.headers,
      body: request.body,
    });

    return new Response(response.body, response);
  },
};
EOF

# Deploy
wrangler deploy

Monitoring & Health Checks

Cloudflare Analytics

  • Dashboard → Analytics → Traffic
  • Pages → Project → Analytics
  • Workers → Analytics

Custom Health Check Script

#!/bin/bash
# health-check-all.sh

echo "🔍 Checking all domains..."

DOMAINS=(
  "lucidia.earth"
  "blackroad.io"
  "blackroadquantum.info"
  "blackroadqi.com"
  "roadchain.io"
)

for domain in "${DOMAINS[@]}"; do
  echo -n "Checking https://$domain ... "
  STATUS=$(curl -s -o /dev/null -w "%{http_code}" "https://$domain")

  if [ "$STATUS" -eq 200 ]; then
    echo "✅ OK ($STATUS)"
  else
    echo "❌ FAILED ($STATUS)"
  fi
done

echo ""
echo "🥧 Checking Raspberry Pis..."
ping -c 1 192.168.4.38 > /dev/null && echo "✅ Lucidia Pi (192.168.4.38)" || echo "❌ Lucidia Pi"
ping -c 1 192.168.4.64 > /dev/null && echo "✅ BlackRoad Pi (192.168.4.64)" || echo "❌ BlackRoad Pi"
ping -c 1 192.168.4.68 > /dev/null && echo "✅ iPhone Koder (192.168.4.68)" || echo "❌ iPhone Koder"

echo ""
echo "🐳 Checking Docker containers..."
ssh pi@192.168.4.38 'docker ps --format "table {{.Names}}\t{{.Status}}"'

Railway Projects

12+ projects deployed


Summary Statistics

  • Cloudflare Pages: 50+ projects
  • Cloudflare Workers: 3+ active
  • Domains: 16+ zones
  • Subdomains: 30+
  • Raspberry Pis: 4 devices
  • Cloud VPS: 1 (DigitalOcean)
  • GitHub Orgs: 15
  • GitHub Repos: 66+
  • Railway Projects: 12+

Quick Access Commands

# Deploy everything
~/deploy-all-domains.sh

# Check all health
~/health-check-all.sh

# SSH to Pis
ssh pi@192.168.4.38  # Lucidia
ssh pi@192.168.4.64  # BlackRoad
ssh pi@192.168.4.68  # iPhone

# SSH to Cloud
ssh root@159.65.43.12  # DigitalOcean

# Wrangler commands
wrangler pages project list
wrangler deployments list
wrangler tail

# Docker on Pi
ssh pi@192.168.4.38 'docker ps'
ssh pi@192.168.4.38 'docker-compose logs -f'

Maintained By: Claude Code + Alexa Louise Amundson Support: blackroad.systems@gmail.com Primary: amundsonalexa@gmail.com