ERAMS (Emergency Response and Ambulance Management System) is a web and mobile-based platform designed to improve emergency medical response and ambulance management in Uganda.
# ERAMS — Emergency Response and Ambulance Management System
> **Final Year Project — Bachelor of Information Technology and Computing**
> Kyambogo University | Uganda | Academic Year 2025–2026
---
## Project Description
ERAMS (Emergency Response and Ambulance Management System) is a web and mobile-based platform engineered to digitise and accelerate emergency medical response across selected hospitals in Uganda — one public (government) facility and one private facility. The system tackles well-documented real-world problems — manual phone-based dispatch, absent real-time GPS tracking, poor inter-agency coordination, and paper-based incident records — by delivering role-based access control (RBAC), an automated nearest-ambulance dispatch algorithm, live GPS tracking, digitalised incident logging, hospital arrival notifications, analytics dashboards with DHIS2 export capability, and a full digital audit trail; all through a responsive web frontend for Dispatchers, Hospital Staff, and Administrators, and an offline-tolerant Android application for Ambulance Drivers.
---
## System Architecture
ERAMS follows a **three-tier client-server architecture**:
| Tier | Layer | Technology |
|------|-------|------------|
| **Tier 1** | **Presentation Layer** — Responsive web frontend for Dispatchers, Hospital Staff, and Administrators; Android mobile application for Ambulance Drivers. | HTML5 / CSS3 / JavaScript · Android (Java) |
| **Tier 2** | **Application Layer** — PHP 8.2 RESTful API backend built with Laravel 11, handling business logic, dispatch algorithm, GPS ingestion, RBAC enforcement, and optional DHIS2 export. | Laravel 11 · PHP 8.2 · Sanctum |
| **Tier 3** | **Data Layer** — MySQL 8 relational database storing incidents, users, ambulances, GPS pings, and audit logs. | MySQL 8 · Laravel Eloquent ORM |
---
## Prerequisites
Ensure the following are installed on your development machine before proceeding:
| Requirement | Minimum Version | Download |
| …