init

overview.md

@@ -0,0 +1,55 @@
+# Project Codex: Distributed SDR Intelligence Network
+
+## 1. Executive Summary
+
+Project Codex is a distributed radio monitoring system that evolves traditional scanning into Real-Time Intelligence. Instead of just listening to audio streams, Codex uses AI to transcribe, analyze, and map public safety radio traffic. It turns a chaotic stream of "Police Radio" into a clean, map-based view of Active Incidents (Fires, Accidents, Chases).
+
+## 2. The Core Workflow
+
+- **Listen:** Distributed Edge Nodes (Raspberry Pis) monitor local frequencies using Software Defined Radios (SDR).
+
+- **Stream:** Audio is sent to a central server; Metadata is sent via MQTT.
+
+- **Analyze:** A central Intelligence Engine transcribes the audio and uses LLMs to understand the context.
+
+- **Correlate:** The system groups related radio calls (even from different departments) into unified Incidents.
+
+- **Visualize:** Users view a Live Map showing active incidents, not just radio towers.
+
+## 3. Key Components
+
+### A. The "Reverse-C2" Control Plane
+
+Edge nodes sit behind firewalls and "phone home" to a central C2 server via MQTT. This allows for centralized management, configuration updates, and health monitoring without complex VPNs.
+
+### B. The Intelligence Layer (Global Knowledge)
+
+This is the brain of the operation. It possesses Global Knowledge of all connected nodes.
+
+- **Incident Tracking:** It detects when a new incident starts and tracks it until units clear the scene.
+
+- **Multi-System Fusion:** If the Police radio and Fire radio both mention the same address, the system recognizes it as one single event.
+
+- **Entity Extraction:** Automatically pulls unit numbers, street addresses, and incident types from the voice audio.
+
+### C. The Web Interface
+
+A Next.js application that provides:
+
+- **Live Map:** A tactical view of what is happening now. Icons appear for active calls and vanish/dim when cleared.
+
+- **Incident Archives:** Detailed pages for every event, showing a timeline of the radio traffic, unit movements, and AI-generated summaries.
+
+- **Fleet Management:** Admin tools to tune radios and manage the edge nodes.
+
+## 4. Development Roadmap Summary
+
+- **Phase 1:** Core Connectivity & Node Health.
+
+- **Phase 2:** Metadata Extraction (getting data out of the radio).
+
+- **Phase 3:** The Web Dashboard & Map.
+
+- **Phase 4:** Audio Routing (Discord/Web).
+
+- **Phase 5:** The Intelligence Engine (AI & Incident Aggregation).