Real Time Tactical Disaster Telemetry Hub

README excerpt

# 🛰️ BEACON: Real-Time Tactical Disaster Telemetry Hub

**Beacon** is a real-time, cyberpunk-aesthetic disaster response operations center dashboard designed for incident command teams. Formulated for scenario coordination during **Hurricane Elena (24h Post-Landfall)** in Houston, TX, it integrates live geographic telemetry, autonomous alert feeds, and an AI-driven disaster coordination copilot.

---

## 🏗️ Technical Architecture Map

The project is structured as a clean multi-service monorepo using `pnpm` workspaces:

```mermaid
graph TD
    A["Root Workspace"]

    A --> B["frontend/ - React + Vite App"]
    A --> C["backend/ - Express + WebSocket Server"]
    A --> D["shared/ - Common TypeScript Schemas"]
    A --> E["cloud-functions/ - Google Cloud Functions"]
    A --> F["infrastructure/ - Docker Compose & Supabase Migrations"]

    subgraph Shared
        D --> D1["Alert, Shelter, RoadSegment, AssetCache, Message"]
    end

    subgraph Frontend
        B --> G["index.html - View Shell"]
        B --> H["src/ - Source Code"]
        H --> H1["store/ - Zustand Atomic States"]
        H --> H2["features/ - Landing Gate, SOP Manual, Google Satellite Map"]
    end

    subgraph Backend
        C --> I["src/index.ts - Express HTTP and WebSocket Server"]
        C --> J["supabase-js Database Sync Client"]
    end

    subgraph Cloud_Functions
        E --> K["incoming-alert - Gemini Pro NLP Geocoder"]
        E --> L["shelter-check - Automated Overload Auditor"]
    end
```