Infrastructure Directory & Disaster Recovery Runbook

graph TD
    subgraph EDGE["🚲 IoT Edge Layer (ESP32-WROOM-32E)"]
        ESP["ESP32 Cellular Tracker
Monotonic 64-bit Sequence Counter
RTC + NVS Watermark"]
    end

    subgraph ROUTE_A["🟢 Route A: Primary Compute (Always Free $0/mo)"]
        GCP["GCP e2-micro VM (34.134.11.181)
Docker Compose Stack (Iowa)"]
        APP["ebike-tracker (Node 22)
Aedes Broker (:1883) + Express (:3000)"]
        LOCAL_DB["ebike-db (postgres:16-alpine)
Credentials & Command Queue"]
        GCP --> APP
        APP --> LOCAL_DB
    end

    subgraph ROUTE_B["🟡 Route B: Secondary Cloud Failover ($0/mo)"]
        EMQX["EMQX Cloud Serverless
ne9190a6.ala.eu-central-1.emqxsl.com:8883 (TLS 1.3)
REST Downlink Dispatcher (:8443)"]
        SUPA["Supabase PostgreSQL
Project: zseccsirfivtsehriixm (Ireland)
Idempotent Deduplication (UNIQUE seq_num)"]
        CRON["GitHub Actions Keep-Alive Cron
Runs every 3 days (0 0 */3 * *)"]
        EMQX --> SUPA
        CRON --> SUPA
    end

    subgraph OBS["📊 Centralized Observability ($0/mo)"]
        GRAFANA["Grafana Cloud (calmlattice2831)
Prometheus Remote Write + Loki Log Ingestion"]
    end

    ESP -->|Default Primary Route: TCP 1883| GCP
    ESP -.->|Failover on Drop: TLS 8883| EMQX
    APP -->|Dual Downlink Dispatch| EMQX
    APP -->|Push Metrics & Logs| GRAFANA

    classDef primary fill:#ffffff,stroke:#1e1e1e,stroke-width:3px,color:#1e1e1e;
    classDef secondary fill:#ffffff,stroke:#1e1e1e,stroke-width:3px,color:#1e1e1e;
    classDef obs fill:#ffffff,stroke:#1e1e1e,stroke-width:3px,color:#1e1e1e;
    classDef edge fill:#ffffff,stroke:#1e1e1e,stroke-width:3px,color:#1e1e1e;

    class GCP,APP,LOCAL_DB primary;
    class EMQX,SUPA,CRON secondary;
    class GRAFANA obs;
    class ESP edge;