# asad-rana306/intelligence-emergency-response-system architecture

> Architecture diagram of the GitHub repository asad-rana306/intelligence-emergency-response-system, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-16). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/asad-rana306/intelligence-emergency-response-system
- Repository: https://github.com/asad-rana306/intelligence-emergency-response-system

## Overview

This repository implements an emergency-response platform: users and responders are managed in Auth; crash signals enter IoT, are assessed and published, then Dispatch coordinates responder offers and incident handling; Realtime distributes live updates and call messages. The graph also preserves medical/contact profiles, bystander media, chat, and ML prediction as distinct capabilities. Source excerpts support only selected internal calls; unsampled cross-service wiring is shown only as unverified dashed links or omitted.

Main entry points: [`iers-iot-service/src/main/java/com/iers/iot/service/CrashIngestionService.java`](https://github.com/asad-rana306/intelligence-emergency-response-system/blob/main/iers-iot-service/src/main/java/com/iers/iot/service/CrashIngestionService.java) (Crash ingestion), [`iers-dispatch-service/src/main/java/com/iers/dispatch/service/DispatchOrchestrator.java`](https://github.com/asad-rana306/intelligence-emergency-response-system/blob/main/iers-dispatch-service/src/main/java/com/iers/dispatch/service/DispatchOrchestrator.java) (Dispatch workflow), [`iers-auth-service/src/main/java/com/iers/auth/service/AuthService.java`](https://github.com/asad-rana306/intelligence-emergency-response-system/blob/main/iers-auth-service/src/main/java/com/iers/auth/service/AuthService.java) (Auth and accounts), [`iers-realtime-service/src/main/java/com/iers/realtime/service/FanOutService.java`](https://github.com/asad-rana306/intelligence-emergency-response-system/blob/main/iers-realtime-service/src/main/java/com/iers/realtime/service/FanOutService.java) (Event fan-out)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_edge["Gateway"]
  node_gateway["API gateway"]
end

subgraph group_identity["Identity and Profiles"]
  node_auth["Auth and accounts<br/>[AuthService.java]"]
  node_responder["Responder profiles"]
  node_medical["Medical profiles"]
  node_contacts["Emergency contacts"]
  node_userdata[("User records<br/>[User.java]")]
  node_responderdata[("Responder records")]
end

subgraph group_ingest["Crash Intake"]
  node_crashapi["Crash intake API"]
  node_ingestion["Crash ingestion"]
  node_crashdata[("Crash records<br/>[CrashEvent.java]")]
  node_media["Bystander media"]
  node_mlclient["ML client"]
end

subgraph group_dispatch["Dispatch Operations"]
  node_dispatch["Dispatch workflow"]
  node_spatial["Responder matching"]
  node_incident[("Incident records<br/>[Incident.java]")]
  node_chat["Incident chat<br/>[ChatService.java]"]
end

subgraph group_live["Realtime Delivery"]
  node_realtime["Event fan-out<br/>[FanOutService.java]"]
  node_livestate[("Live state")]
  node_publisher["Live publisher<br/>[LivePublisher.java]"]
  node_calls["Call relay"]
end

subgraph group_ml["Prediction"]
  node_mlapi["Crash predictor API<br/>[main.py]"]
end

node_client(("Drivers and responders"))
node_kafka["Event broker"]
node_phones(("Connected clients"))

node_client -.->|"sends requests"| node_gateway
node_gateway -.->|"routes requests"| node_auth
node_client -->|"submits crash"| node_crashapi
node_crashapi -->|"invokes ingestion"| node_ingestion
node_ingestion -->|"persists events"| node_crashdata
node_ingestion -->|"publishes events"| node_kafka
node_ingestion -.->|"requests prediction"| node_mlclient
node_mlclient -.->|"calls prediction"| node_mlapi
node_kafka -.->|"delivers crash event"| node_dispatch
node_dispatch -.->|"selects responders"| node_spatial
node_spatial -->|"fetches availability"| node_auth
node_dispatch -.->|"updates incidents"| node_incident
node_dispatch -.->|"publishes incident events"| node_kafka
node_client -.->|"sends chat"| node_chat
node_chat -->|"announces messages"| node_kafka
node_kafka -.->|"delivers events"| node_realtime
node_realtime -->|"updates snapshots"| node_livestate
node_realtime -.->|"pushes updates"| node_publisher
node_client -.->|"sends call signal"| node_calls
node_calls -->|"checks incident link"| node_livestate
node_calls -->|"relays call"| node_publisher
node_publisher -.->|"pushes live data"| node_phones
node_auth -->|"stores accounts"| node_userdata
node_auth -->|"creates responder profile"| node_responderdata
node_responder -->|"updates responder"| node_responderdata

click node_gateway "https://github.com/asad-rana306/intelligence-emergency-response-system/tree/main/iers-api-gateway/src/main/java/com/iers/gateway"
click node_auth "https://github.com/asad-rana306/intelligence-emergency-response-system/blob/main/iers-auth-service/src/main/java/com/iers/auth/service/AuthService.java"
click node_responder "https://github.com/asad-rana306/intelligence-emergency-response-system/blob/main/iers-auth-service/src/main/java/com/iers/auth/service/ResponderService.java"
click node_medical "https://github.com/asad-rana306/intelligence-emergency-response-system/blob/main/iers-auth-service/src/main/java/com/iers/auth/service/MedicalProfileService.java"
click node_contacts "https://github.com/asad-rana306/intelligence-emergency-response-system/blob/main/iers-auth-service/src/main/java/com/iers/auth/service/EmergencyContactService.java"
click node_userdata "https://github.com/asad-rana306/intelligence-emergency-response-system/blob/main/iers-auth-service/src/main/java/com/iers/auth/entity/User.java"
click node_responderdata "https://github.com/asad-rana306/intelligence-emergency-response-system/blob/main/iers-auth-service/src/main/java/com/iers/auth/entity/ResponderProfile.java"
click node_crashapi "https://github.com/asad-rana306/intelligence-emergency-response-system/blob/main/iers-iot-service/src/main/java/com/iers/iot/controller/CrashController.java"
click node_ingestion "https://github.com/asad-rana306/intelligence-emergency-response-system/blob/main/iers-iot-service/src/main/java/com/iers/iot/service/CrashIngestionService.java"
click node_crashdata "https://github.com/asad-rana306/intelligence-emergency-response-system/blob/main/iers-iot-service/src/main/java/com/iers/iot/entity/CrashEvent.java"
click node_media "https://github.com/asad-rana306/intelligence-emergency-response-system/blob/main/iers-iot-service/src/main/java/com/iers/iot/service/BystanderMediaService.java"
click node_mlclient "https://github.com/asad-rana306/intelligence-emergency-response-system/blob/main/iers-iot-service/src/main/java/com/iers/iot/service/MlServiceClient.java"
click node_mlapi "https://github.com/asad-rana306/intelligence-emergency-response-system/blob/main/iers-ml-service/app/main.py"
click node_dispatch "https://github.com/asad-rana306/intelligence-emergency-response-system/blob/main/iers-dispatch-service/src/main/java/com/iers/dispatch/service/DispatchOrchestrator.java"
click node_spatial "https://github.com/asad-rana306/intelligence-emergency-response-system/blob/main/iers-dispatch-service/src/main/java/com/iers/dispatch/service/SpatialQueryService.java"
click node_incident "https://github.com/asad-rana306/intelligence-emergency-response-system/blob/main/iers-dispatch-service/src/main/java/com/iers/dispatch/entity/Incident.java"
click node_chat "https://github.com/asad-rana306/intelligence-emergency-response-system/blob/main/iers-dispatch-service/src/main/java/com/iers/dispatch/service/ChatService.java"
click node_realtime "https://github.com/asad-rana306/intelligence-emergency-response-system/blob/main/iers-realtime-service/src/main/java/com/iers/realtime/service/FanOutService.java"
click node_livestate "https://github.com/asad-rana306/intelligence-emergency-response-system/blob/main/iers-realtime-service/src/main/java/com/iers/realtime/store/LiveStateStore.java"
click node_publisher "https://github.com/asad-rana306/intelligence-emergency-response-system/blob/main/iers-realtime-service/src/main/java/com/iers/realtime/service/LivePublisher.java"
click node_calls "https://github.com/asad-rana306/intelligence-emergency-response-system/blob/main/iers-realtime-service/src/main/java/com/iers/realtime/service/CallRelayService.java"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_gateway,node_phones toneBlue
class node_auth,node_responder,node_medical,node_contacts,node_userdata,node_responderdata toneAmber
class node_crashapi,node_ingestion,node_crashdata,node_media,node_mlclient toneMint
class node_dispatch,node_spatial,node_incident,node_chat toneRose
class node_realtime,node_livestate,node_publisher,node_calls,node_client,node_kafka toneIndigo
class node_mlapi toneTeal
```

## Components

### Gateway

- [API gateway](https://github.com/asad-rana306/intelligence-emergency-response-system/tree/main/iers-api-gateway/src/main/java/com/iers/gateway): `iers-api-gateway/src/main/java/com/iers/gateway`

### Identity and Profiles

- [Auth and accounts](https://github.com/asad-rana306/intelligence-emergency-response-system/blob/main/iers-auth-service/src/main/java/com/iers/auth/service/AuthService.java): `iers-auth-service/src/main/java/com/iers/auth/service/AuthService.java`
- [Responder profiles](https://github.com/asad-rana306/intelligence-emergency-response-system/blob/main/iers-auth-service/src/main/java/com/iers/auth/service/ResponderService.java): `iers-auth-service/src/main/java/com/iers/auth/service/ResponderService.java`
- [Medical profiles](https://github.com/asad-rana306/intelligence-emergency-response-system/blob/main/iers-auth-service/src/main/java/com/iers/auth/service/MedicalProfileService.java): `iers-auth-service/src/main/java/com/iers/auth/service/MedicalProfileService.java`
- [Emergency contacts](https://github.com/asad-rana306/intelligence-emergency-response-system/blob/main/iers-auth-service/src/main/java/com/iers/auth/service/EmergencyContactService.java): `iers-auth-service/src/main/java/com/iers/auth/service/EmergencyContactService.java`
- [User records](https://github.com/asad-rana306/intelligence-emergency-response-system/blob/main/iers-auth-service/src/main/java/com/iers/auth/entity/User.java): `iers-auth-service/src/main/java/com/iers/auth/entity/User.java`
- [Responder records](https://github.com/asad-rana306/intelligence-emergency-response-system/blob/main/iers-auth-service/src/main/java/com/iers/auth/entity/ResponderProfile.java): `iers-auth-service/src/main/java/com/iers/auth/entity/ResponderProfile.java`

### Crash Intake

- [Crash intake API](https://github.com/asad-rana306/intelligence-emergency-response-system/blob/main/iers-iot-service/src/main/java/com/iers/iot/controller/CrashController.java): `iers-iot-service/src/main/java/com/iers/iot/controller/CrashController.java`
- [Crash ingestion](https://github.com/asad-rana306/intelligence-emergency-response-system/blob/main/iers-iot-service/src/main/java/com/iers/iot/service/CrashIngestionService.java): `iers-iot-service/src/main/java/com/iers/iot/service/CrashIngestionService.java`
- [Crash records](https://github.com/asad-rana306/intelligence-emergency-response-system/blob/main/iers-iot-service/src/main/java/com/iers/iot/entity/CrashEvent.java): `iers-iot-service/src/main/java/com/iers/iot/entity/CrashEvent.java`
- [Bystander media](https://github.com/asad-rana306/intelligence-emergency-response-system/blob/main/iers-iot-service/src/main/java/com/iers/iot/service/BystanderMediaService.java): `iers-iot-service/src/main/java/com/iers/iot/service/BystanderMediaService.java`
- [ML client](https://github.com/asad-rana306/intelligence-emergency-response-system/blob/main/iers-iot-service/src/main/java/com/iers/iot/service/MlServiceClient.java): `iers-iot-service/src/main/java/com/iers/iot/service/MlServiceClient.java`

### Dispatch Operations

- [Dispatch workflow](https://github.com/asad-rana306/intelligence-emergency-response-system/blob/main/iers-dispatch-service/src/main/java/com/iers/dispatch/service/DispatchOrchestrator.java): `iers-dispatch-service/src/main/java/com/iers/dispatch/service/DispatchOrchestrator.java`
- [Responder matching](https://github.com/asad-rana306/intelligence-emergency-response-system/blob/main/iers-dispatch-service/src/main/java/com/iers/dispatch/service/SpatialQueryService.java): `iers-dispatch-service/src/main/java/com/iers/dispatch/service/SpatialQueryService.java`
- [Incident records](https://github.com/asad-rana306/intelligence-emergency-response-system/blob/main/iers-dispatch-service/src/main/java/com/iers/dispatch/entity/Incident.java): `iers-dispatch-service/src/main/java/com/iers/dispatch/entity/Incident.java`
- [Incident chat](https://github.com/asad-rana306/intelligence-emergency-response-system/blob/main/iers-dispatch-service/src/main/java/com/iers/dispatch/service/ChatService.java): `iers-dispatch-service/src/main/java/com/iers/dispatch/service/ChatService.java`

### Realtime Delivery

- [Event fan-out](https://github.com/asad-rana306/intelligence-emergency-response-system/blob/main/iers-realtime-service/src/main/java/com/iers/realtime/service/FanOutService.java): `iers-realtime-service/src/main/java/com/iers/realtime/service/FanOutService.java`
- [Live state](https://github.com/asad-rana306/intelligence-emergency-response-system/blob/main/iers-realtime-service/src/main/java/com/iers/realtime/store/LiveStateStore.java): `iers-realtime-service/src/main/java/com/iers/realtime/store/LiveStateStore.java`
- [Live publisher](https://github.com/asad-rana306/intelligence-emergency-response-system/blob/main/iers-realtime-service/src/main/java/com/iers/realtime/service/LivePublisher.java): `iers-realtime-service/src/main/java/com/iers/realtime/service/LivePublisher.java`
- [Call relay](https://github.com/asad-rana306/intelligence-emergency-response-system/blob/main/iers-realtime-service/src/main/java/com/iers/realtime/service/CallRelayService.java): `iers-realtime-service/src/main/java/com/iers/realtime/service/CallRelayService.java`

### Prediction

- [Crash predictor API](https://github.com/asad-rana306/intelligence-emergency-response-system/blob/main/iers-ml-service/app/main.py): `iers-ml-service/app/main.py`

### Other components

- **Drivers and responders**
- **Event broker**
- **Connected clients**

## Connections

- Drivers and responders → API gateway: sends requests
- API gateway → Auth and accounts: routes requests
- Drivers and responders → Crash intake API: submits crash (evidence: `iers-iot-service/src/main/java/com/iers/iot/controller/CrashController.java`)
- Crash intake API → Crash ingestion: invokes ingestion (evidence: `iers-iot-service/src/main/java/com/iers/iot/controller/CrashController.java`)
- Crash ingestion → Crash records: persists events (evidence: `iers-iot-service/src/main/java/com/iers/iot/service/CrashIngestionService.java`)
- Crash ingestion → Event broker: publishes events (evidence: `iers-iot-service/src/main/java/com/iers/iot/service/CrashIngestionService.java`)
- Crash ingestion → ML client: requests prediction (evidence: `iers-iot-service/src/main/java/com/iers/iot/service/CrashIngestionService.java`)
- ML client → Crash predictor API: calls prediction
- Event broker → Dispatch workflow: delivers crash event
- Dispatch workflow → Responder matching: selects responders
- Responder matching → Auth and accounts: fetches availability (evidence: `iers-dispatch-service/src/main/java/com/iers/dispatch/service/SpatialQueryService.java`)
- Dispatch workflow → Incident records: updates incidents
- Dispatch workflow → Event broker: publishes incident events
- Drivers and responders → Incident chat: sends chat
- Incident chat → Event broker: announces messages (evidence: `iers-dispatch-service/src/main/java/com/iers/dispatch/service/ChatService.java`)
- Event broker → Event fan-out: delivers events
- Event fan-out → Live state: updates snapshots (evidence: `iers-realtime-service/src/main/java/com/iers/realtime/service/FanOutService.java`)
- Event fan-out → Live publisher: pushes updates (evidence: `iers-realtime-service/src/main/java/com/iers/realtime/service/FanOutService.java`)
- Drivers and responders → Call relay: sends call signal
- Call relay → Live state: checks incident link (evidence: `iers-realtime-service/src/main/java/com/iers/realtime/service/CallRelayService.java`)
- Call relay → Live publisher: relays call (evidence: `iers-realtime-service/src/main/java/com/iers/realtime/service/CallRelayService.java`)
- Live publisher → Connected clients: pushes live data
- Auth and accounts → User records: stores accounts (evidence: `iers-auth-service/src/main/java/com/iers/auth/service/AuthService.java`)
- Auth and accounts → Responder records: creates responder profile (evidence: `iers-auth-service/src/main/java/com/iers/auth/service/AuthService.java`)
- Responder profiles → Responder records: updates responder (evidence: `iers-auth-service/src/main/java/com/iers/auth/service/ResponderService.java`)
