Musbi8788/fire_alerts

Real‑time emergency dispatch for The Gambia. One tap sends your GPS to the nearest fire station. Built by one developer, donated to save lives. # 🔥 FireAlert GM > **Real-time emergency reporting and dispatch system for The Gambia** > Built to reduce fire service response times and save lives. --- ## Table of Contents 1. Project Overview 2. The Problem 3. The Solution 4. System Architecture 5. User Roles 6. Full System Flow 7. Project Structure 8. Database Design 9. API Reference 10. Real-time Events 11. MVP Scope 12. Full Product Scope 13. Tech Stack 14. Production Architecture 15. Environment Variables 16. Sprint Plan 17. Setup & Installation 18. Deployment 19. SMS & Voice Integration 20. Security & Data Policy 21. Monitoring & Reliability 22. Handover & Maintenance --- ## 1. Project Overview FireAlert GM is a Progressive Web Application (PWA) built to modernise emergency reporting and dispatch operations for the **Gambia Fire and Rescue Service (GFRS)**. It replaces the current phone-call-only system where dispatchers struggle to identify exact locations, leading to delayed responses and preventable deaths. The system allows any person in The Gambia to submit a fire or rescue emergency with their GPS coordinates, automatically alerts the nearest available fire station in real time, and keeps the citizen informed throughout the entire response lifecycle. | Property | Detail | |---|---| | **Built by** | Musbi (creator of AttendanceGM) | | **Donated to** | Gambia Fire and Rescue Service (GFRS) | | **Platform** | Progressive Web App — works on any phone browser, no install required | | **Backend** | FastAPI (Python 3.11+) | | **Frontend** | React 18 + Vite | | **Database** | PostgreSQL 15 + PostGIS | | **Real-time** | Socket.IO | | **SMS** | Africa's Talking API (Gambia supported) | | **Maps** | Leaflet.js + OpenStreetMap | | **Status** | In development | --- ## 2. The Problem When a fire or emergency occurs in The Gambia today: - The citizen calls the fire service by phone - The dispatcher tries to understand the location verbally - Many areas have no formal addresses — only landmarks - The wron …