axmed-8/Somali_help_app

# Somali Help App Professional emergency help platform for Somalia. Citizens report emergencies with live GPS, track response teams in real time, and reach a Call Center for operator-led multi-service dispatch. **Repository:** github.com --- ## Description Somali Help App connects citizens with hospitals, police, and fire services. Emergencies can be started from a mobile SOS form or by calling the Call Center (phone + silent GPS). An **AI Assistance** engine analyzes incidents and recommends responders — it never dispatches automatically. Final approval always belongs to a human operator (Call Center) or the existing SOS auto-routing rules for life-safety Method 1. --- ## Features - **Two emergency methods** - Method 1: Report Emergency (SOS) with GPS and auto-routing - Method 2: Call Emergency Center (`tel:` + silent location push) - **Role-based dashboards** — Citizen, Hospital, Police, Fire, Call Center, Admin - **Smart hospital routing** — nearest open facility, capacity-aware escalation - **Police & fire dispatch** — type-based assignment to response stations - **Call Center multi-dispatch** — Medical + Police + Fire from one call - **Live GPS tracking & ETA** — map view with Google Maps or Leaflet fallback - **Chat & notifications** — in-app messaging and role-targeted alerts - **AI Emergency Engine** — category, priority, risk, recommended responders, confidence & reason (rule-based by default) - **MySQL or JSON storage** — JSON for local/dev/tests; MySQL for production --- ## Technologies Used | Layer | Stack | |-------|--------| | Backend | Python 3, Flask, Werkzeug | | Frontend | HTML5, CSS3, JavaScript (mobile-first) | | Database | JSON files (default/dev) or MySQL (PyMySQL) | | Maps | Google Maps JavaScript API + OpenStreetMap / Leaflet fallback | | AI | Provider-independent `ai_engine` (default: offline rule-based) | | Tests | pytest | --- ## Installation ### Prerequisites - Python 3.10+ recommended - (Opt …