╔═══════════════════════════════════════════════════════════════╗
║   ██████╗██╗      ██████╗ ██╗   ██╗██████╗                   ║
║  ██╔════╝██║     ██╔═══██╗██║   ██║██╔══██╗                  ║
║  ██║     ██║     ██║   ██║██║   ██║██║  ██║                  ║
║  ██║     ██║     ██║   ██║██║   ██║██║  ██║                  ║
║  ╚██████╗███████╗╚██████╔╝╚██████╔╝██████╔╝                  ║
║   ╚═════╝╚══════╝ ╚═════╝  ╚═════╝ ╚═════╝  ██████╗  █████╗ ████████╗ █████╗  ║
║                                       ██╔══██╗██╔══██╗╚══██╔══╝██╔══██╗ ║
║  Auto-Generated Infrastructure Data   ██║  ██║███████║   ██║   ███████║ ║
║  Topology · Configs · Dashboard       ██║  ██║██╔══██║   ██║   ██╔══██║ ║
║                                       ██████╔╝██║  ██║   ██║   ██║  ██║ ║
║                                       ╚═════╝ ╚═╝  ╚═╝   ╚═╝   ╚═╝  ╚═╝ ║
╚═══════════════════════════════════════════════════════════════╝

Cloud Data

Auto-generated infrastructure data for the cloud stack. Web dashboard + JSON topology files.

---

Table of Contents

A) Documentation Overview

• A.1 Data Files
• A.2 Web Dashboard
• A.3 How Data Is Generated

B) Architectural Design

• B.1 Repository Structure
• B.2 Data Schemas
• B.3 Generation Pipeline

---

A) Documentation Overview

A.1 Data Files

File	Size	Content
cloud-topology.json	~43 KB	VMs, services, WireGuard mesh, SSH config, DNS
cloud-configs.json	~33 KB	Caddy routes, Authelia clients, DNS zones, per-service config

A.2 Web Dashboard

index.html — static web dashboard that renders the JSON data into a visual infrastructure overview. No server required — open directly in a browser.

A.3 How Data Is Generated

These files are auto-generated by the C3 engine in the cloud repo:

cloud/a_solutions/bc-obs_c3-infra-mcp-api/src/engines/
├── gen-topology.ts    → cloud-topology.json
└── gen-configs.ts     → cloud-configs.json

Regeneration happens automatically on every git push to the cloud repo via git.yaml pre-push hook.

---

B) Architectural Design

B.1 Repository Structure

cloud-data/
├── cloud-topology.json    Infrastructure topology (source of truth)
├── cloud-configs.json     Generated service configurations
├── index.html             Web dashboard
├── style.css              Dashboard styles
└── manifest.json          PWA manifest

B.2 Data Schemas

cloud-topology.json: Top-level keys are ssh_key, remote_base, engine_folder, vms (VM definitions with IP/WG/user/arch), and services (service definitions with category/VM/domain/containers).

cloud-configs.json: Contains _meta (generation info), services (per-service config extracted from flake.nix), and infrastructure sections (Caddy routes, Authelia OIDC clients, DNS zones).

B.3 Generation Pipeline

1. C3 engine reads all a_solutions/*/build.json + src/flake.nix
2. Extracts config attrset from each flake
3. Merges with SSH config and VM definitions
4. Writes JSON to cloud-data/ in the cloud repo
5. Committed and pushed to this submodule repo

---

Last Updated: 2026-03-18