🎯 Real-time Emergency Response Management System

AI-powered dispatch platform that transforms emergency calls into actionable intelligence

---

🔗 Explore The Ecosystem

React • TypeScript • Vite ✨ Tactical Dashboard & Live UI

FastAPI • AI/NLP • Python 🔥 AI Engine & Command Center

---

👨‍💻 The Architects

Sanjay Rohith 🚀 Lead Developer

Sanjay E 🧠 AI & Backend

Abishek Raj 🎨 Frontend Architect

---

💡 The Problem We're Solving

⏱️ Every Second Matters Emergency dispatchers are the unsung heroes operating under extreme pressure: Challenge Impact 📝 Manual Data Entry Precious seconds wasted during high-stress calls ❌ Human Error Incorrect resource deployment risks lives 🧠 Cognitive Overload Managing multiple streams simultaneously 🐌 Delayed Response Inefficient incident classification

┌──────────────────┐ │ BEFORE ResQ │ │ │ │ 📞 ──→ 📝 │ │ Call Manual │ │ Entry │ │ │ │ ⏰ +45 seconds │ └──────────────────┘ ┌──────────────────┐ │ WITH ResQ-Desk │ │ │ │ 📞 ──→ 🤖 │ │ Call AI Auto │ │ Fill │ │ │ │ ⚡ <3 seconds │ └──────────────────┘

---

✨ Features That Save Lives

🎙️ Live Call Management	🧠 AI Intelligence	📋 Auto Reports	🗺️ Tactical Maps
Push-to-talk interface	Real-time NLP analysis	Zero-touch form filling	Live unit tracking
Audio visualization	Smart data extraction	Severity classification	Route optimization
Language detection	Keyword detection	AI reasoning display	Multi-unit coordination
Encrypted channels	Confidence scoring	Tactical alerts	ETA calculations

🎙️ Live Call Management

┌─────────────────────────────────────────────────────────────┐
│  🔴 LIVE CALL                                    00:01:23   │
├─────────────────────────────────────────────────────────────┤
│                                                             │
│  ████████████████░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░  │
│  ▁▂▃▅▂▁▂▃▅▇▅▃▂▁▂▃▅▆▅▃▂▁▂▃▄▅▆▇▆▅▄▃▂▁▂▃▄▅▆▇▆▅▄▃▂▁          │
│                                                             │
│  [🎤 PTT ACTIVE]    [🔇 MUTE]    [📍 LOCATE]    [🚨 ALERT]  │
└─────────────────────────────────────────────────────────────┘

🧠 AI-Powered Intelligence

"There's a fire on the second floor..."

⬇️ Instant AI Analysis ⬇️

Field	Extracted Value	Confidence
📍 Location	123 Main Street, 2nd Floor	94%
🔥 Type	FIRE	98%
⚠️ Severity	CRITICAL	91%
🏷️ Keywords	FIRE SMOKE TRAPPED	—

---

🏗️ System Architecture

                    ╔═══════════════════════════════════════╗
                    ║         ResQ-Desk Architecture        ║
                    ╚═══════════════════════════════════════╝

    ┌─────────────────┐         ┌─────────────────┐         ┌─────────────────┐
    │                 │         │                 │         │                 │
    │   🎤 Web Speech │────────▶│  ⚛️ React UI   │────────▶│  🧠 AI Backend  │
    │       API       │         │   (This Repo)   │         │   (FastAPI)     │
    │                 │         │                 │         │                 │
    └─────────────────┘         └─────────────────┘         └─────────────────┘
           │                           │                           │
           │                           │                           │
           ▼                           ▼                           ▼
    ┌─────────────────┐         ┌─────────────────┐         ┌─────────────────┐
    │  Voice → Text   │         │  Tactical UI    │         │  NLP Analysis   │
    │  Recognition    │         │  Live Dashboard │         │  Data Extract   │
    └─────────────────┘         └─────────────────┘         └─────────────────┘

🛠️ Tech Stack

Layer	Technology	Badge
UI Framework	React 18
Language	TypeScript
Build Tool	Vite
Styling	Tailwind CSS
Components	shadcn/ui
State	TanStack Query

---

🚀 Quick Start

📋 Prerequisites

• ✅ Node.js 18+ or Bun
• ✅ Modern browser (Chrome 80+, Firefox 76+, Safari 14+)
• ✅ Microphone access for speech recognition

⚡ Installation

# 1️⃣ Clone the repository
git clone https://github.com/sanjayrohith/ResQ-Desk.git

# 2️⃣ Navigate to project
cd ResQ-Desk

# 3️⃣ Install dependencies
npm install

# 4️⃣ Launch development server
npm run dev

🎉 Open http://localhost:5173 and start saving lives!

---

📁 Project Structure

ResQ-Desk/
│
├── 📂 src/
│   ├── 📂 components/
│   │   ├── 📂 dashboard/
│   │   │   ├── 🎯 Header.tsx           # System status & nav
│   │   │   ├── 📞 LiveCall.tsx         # PTT controls & timer
│   │   │   ├── 📝 LiveTranscription.tsx # Speech-to-text engine
│   │   │   ├── 📋 IncidentDetails.tsx  # AI form automation
│   │   │   ├── 🗺️ MapPanel.tsx         # Tactical deployment
│   │   │   └── 🚨 DispatchPopup.tsx    # Unit assignment
│   │   │
│   │   └── 📂 ui/                      # shadcn/ui components
│   │
│   ├── 📂 pages/
│   │   └── 🏠 Index.tsx                # Main orchestration
│   │
│   ├── 📂 hooks/                       # Custom React hooks
│   └── 📂 lib/                         # Utilities
│
└── ⚙️ Configuration files

---

🔄 How It Works

graph LR
    A[📞 Emergency Call] -->|Voice Input| B[🎤 Live Transcription]
    B -->|Text Stream| C[🧠 AI Analysis]
    C -->|Structured Data| D[📋 Auto-fill Form]
    D -->|Dispatch Ready| E[🗺️ Resource Dispatch]
    E -->|Unit Assigned| F[🚑 Deployment]
    
    style A fill:#FF6B6B,color:#fff
    style B fill:#4ECDC4,color:#fff
    style C fill:#45B7D1,color:#fff
    style D fill:#96CEB4,color:#fff
    style E fill:#FFEAA7,color:#333
    style F fill:#00D26A,color:#fff

Loading

Step	Action	Time
1️⃣	Call Initiated — Operator activates PTT, caller speaks	0s
2️⃣	Real-time Transcription — Speech converted instantly	<1.5s
3️⃣	AI Processing — Backend extracts location, type, severity	~2-3s
4️⃣	Form Auto-fill — Incident details populate automatically	instant
5️⃣	Dispatch Decision — System suggests optimal unit	ready
6️⃣	Unit Deployment — Responders receive coordinates & ETA	🚀

---

🔌 API Integration

📡 Backend Communication

Endpoint

POST http://127.0.0.1:8000/analyze

Request

{
  "text": "There's a fire on the second floor of 123 Main Street"
}

Response

{
  "incident_id": "INC-2024-001",
  "location": "123 Main Street, 2nd Floor",
  "emergency_type": "FIRE",
  "severity": "Critical",
  "keywords": ["FIRE", "SMOKE", "TRAPPED"],
  "reasoning": "Multiple fire indicators detected with potential victims",
  "confidence_score": 0.94,
  "suggested_unit": "F07"
}

---

📊 Performance

Metric	Value	Status
🎤 Transcription Latency	<1.5s	🟢
🧠 AI Analysis Time	~2-3s	🟢
📋 Form Auto-fill	Instant	🟢
🗺️ Map Rendering	60 FPS	🟢

---

🌐 Browser Support

80+ ✅	76+ ✅	14+ ⚠️	80+ ✅
Recommended	Full Support	Limited Speech API	Full Support

---

🔐 Security

🔒	Feature	Description
✅	Encrypted Channels	All communications secured
✅	No Persistent Storage	Sensitive call data not stored
✅	Client-side Processing	Privacy-first voice handling
✅	Secure API	Protected backend communication

---

🚧 Roadmap

    🎯 CURRENT                    🔮 FUTURE
    ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
    
    ✅ Real-time transcription    ⬜ Multi-language support
    ✅ AI incident analysis       ⬜ Analytics dashboard
    ✅ Auto-form filling          ⬜ CAD integration
    ✅ Tactical map               ⬜ Mobile app
    ✅ Unit dispatch              ⬜ Voice biometrics
                                  ⬜ Predictive ML

---

🛠️ Scripts

npm run dev      # 🔥 Development server with HMR
npm run build    # 📦 Production build
npm run preview  # 👀 Preview production build
npm run lint     # 🔍 ESLint analysis

---

🤝 Contributing

We welcome contributions from the community!

---

📄 License

Released under the MIT License

See LICENSE for details

---

💖 Built with passion for first responders

⏱️ Saving seconds to save lives

_{Made with ❤️ by the ResQ Team}