Skip to content

midyh/Incident-Tracker-359

Repository files navigation

E-199 Emergency Response Management System

A full-stack web application for coordinating emergency incident response between fire services, volunteers, and citizens in real-time.

Key Features

Multi-Role User System - The platform serves four distinct user types with tailored interfaces and permissions: fire service administrators who coordinate all emergency operations, registered citizens who report incidents and receive proximity alerts, volunteer firefighters who participate in active responses, and guest users who access public safety information.

Real-Time Emergency Management - Administrators oversee the complete incident lifecycle from initial report through resolution, including verification of submitted incidents, danger level assessment, resource allocation, and continuous status updates visible to all stakeholders.

Proximity-Based Alert System - Registered users receive automatic notifications when emergencies occur within 30 kilometers of their residence, calculated using the TrueWay Matrix API for precise distance measurements between incident locations and user addresses.

Volunteer Coordination - Fire service administrators post volunteer position openings for specific incidents, review participation requests, and maintain communication channels with active volunteers throughout emergency operations.

Geographic Incident Visualization - Interactive mapping displays all active emergencies across the region, enabling users to view incident locations, assess affected areas, and make informed safety decisions.

Integrated Messaging System - Role-based communication channels allow administrators to broadcast public updates, send targeted messages to volunteer groups, and maintain private conversations with individual participants during active operations.

Screenshots

home page report incident admin dashboard report of an incident volunteers application volunteers application, from admin view admin accepts volunteer

The following images showcase the key interfaces and functionality of the E-199 system.

Getting Started

Prerequisites

Ensure Docker and Docker Compose are installed on your system.

Installation and Setup

Clone the repository and navigate to the project directory. Start the application using Docker Compose, which will automatically build the containers and initialize the database with sample data.

docker-compose up --build

The application will be accessible at http://localhost:3000 once all services have started successfully.

Administrator Access

To explore the full administrative capabilities of the system, log in as admin using the following credentials:

Username: admin
Password: admiN12@*69

The administrator interface provides access to incident coordination, volunteer management, statistical dashboards, and system-wide messaging capabilities.

Testing Other User Roles

The system includes pre-populated sample accounts for registered users and volunteer firefighters, allowing you to explore different permission levels and interface variations. Guest functionality is available without authentication by accessing the public incident viewing pages.

Educational Context

Developed as a comprehensive web programming project at the University of Crete, demonstrating full-stack development capabilities, API integration, and real-world application design for emergency management systems.

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages