wisdomdzontoh/ebads-documentation

EBADS is an algorithm-driven emergency bed allocation and dispatch system built specifically for Ghana's hospital referral network. # EBADS — Emergency Bed Allocation and Dispatch System > **Status:** Prototype — under active development > **Last updated:** 2026 --- ## What Is EBADS? EBADS is an algorithm-driven emergency bed allocation and dispatch system built specifically for Ghana's hospital referral network. It solves the **No Bed Syndrome** — the systemic failure in which ambulance crews transport patients to hospitals that cannot admit them due to unavailable beds, causing repeated redirections and, in documented cases, patient deaths. The system has two components: | Component | Technology | Purpose | |---|---|---| | **Allocation Engine** | FastAPI + PostgreSQL | Stateful REST API that holds hospital registry and bed availability state; runs matching algorithms; serves recommendations | | **Mobile Application** | React Native + Expo | Dispatcher interface, offline algorithm execution engine, and simulation environment | The engine is designed to be called by any authorised client — NAS dispatcher apps, GHS dashboards, third-party health platforms. The mobile app is the reference client and the primary evaluation tool. --- ## The Core Problem This Solves Ghana's NAS dispatchers currently phone hospitals one by one to find an available bed. No system aggregates bed availability. No algorithm guides facility selection. Patients are frequently turned away by multiple hospitals before placement. EBADS replaces that telephone process with: 1. A real-time facility registry hospitals push bed updates to 2. Three matching algorithms that select the best facility based on travel time, bed availability, and clinical capability 3. A dynamic selection policy that automatically picks the right algorithm based on connectivity and queue state 4. Full offline capability — dispatchers in rural areas get algorithmic recommendations even with zero network connectivity --- ## Repository Structure ``` ebads/ ├── engine/ # FastAPI allocation engine │ ├── app/ │ │ ├── main.p …