spidertabs/ambulink-web

AmbuLink is a digital emergency response platform that connects patients, institutions, highway users, and remote communities across Uganda with the nearest available registered ambulance driver — in real time. AmbuLink Smart Ambulance Booking System — Reducing Emergency Response Time Across Uganda --- ## 📌 Overview AmbuLink is a digital emergency response platform that connects patients, institutions, highway users, and remote communities across Uganda with the nearest available registered ambulance driver — in real time. Developed by students at **Kampala International University**, AmbuLink addresses a critical national public health gap: the complete absence of a coordinated, digital ambulance dispatch system in Uganda. Every year, hundreds of preventable deaths occur because no one could find an ambulance in time. AmbuLink exists to change that. > *"This is not just a software project — it is a response to a national health emergency challenge, designed by Ugandan students for the benefit of Ugandan communities."* ## 🧠 What Makes AmbuLink "Smart"? AmbuLink replaces the delays of human decision-making with the speed of mathematical algorithms. 1. **Autonomous Dispatcher**: Uses the Haversine formula and OSRM routing to instantly match emergencies with the nearest active driver in ` ⚠️ For evaluation and demonstration only. Change all passwords before any production deployment. | Role | Email | Password | |---|---|---| | Admin | admin@ambulink.ug | ambulink@2026 | | Driver | driver.ssali@ambulink.ug | ambulink@2026 | | Patient / User | patient.mukisa@ambulink.ug | ambulink@2026 | --- ## ⚙️ Backend Logic ### Scheduled Dispatch Engine Scheduled bookings remain in a `requested` status until 30 minutes before the pickup time. A PostgreSQL background process (compatible with `pg_cron`) calls `fn_process_scheduled_bookings()`, which: 1. Identifies bookings due within 30 minutes. 2. Runs the **Nearest Driver Algorithm** to find available units. 3. Auto-assigns the driver and triggers a patient notification. ### Admin Appraisal Workflow (Negotiation) To ensure fair pricing for complex scheduled trips, AmbuLink uses an "Appraisal First" model: 1. **Request**: …