# surenderkm21/evacway architecture

> Architecture diagram of the GitHub repository surenderkm21/evacway, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-04). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/surenderkm21/evacway
- Repository: https://github.com/surenderkm21/evacway

## Overview

EvacWay serves attendees navigating event venues and organizers coordinating crowd safety. Attendees sign in, share location, are geofenced into zones, view density-aware routes, receive targeted alerts, and can signal SOS; admins manage zones, density, alerts, users, and distress signals. The Firebase layer supplies authentication, live Firestore access, and write/error handling. The README documents the routing algorithm and capabilities; some feature-component internals were not sampled, so uncertain links are omitted or marked unverified.

Main entry points: [`src/components/user/user-dashboard.jsx`](https://github.com/surenderkm21/evacway/blob/main/src/components/user/user-dashboard.jsx) (Attendee dashboard), [`src/components/admin/admin-dashboard.jsx`](https://github.com/surenderkm21/evacway/blob/main/src/components/admin/admin-dashboard.jsx) (Operations dashboard), [`src/components/auth/login-form.jsx`](https://github.com/surenderkm21/evacway/blob/main/src/components/auth/login-form.jsx) (Login and roles), [`src/firebase/non-blocking-updates.js`](https://github.com/surenderkm21/evacway/blob/main/src/firebase/non-blocking-updates.js) (Nonblocking writes)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["Access and navigation"]
  node_login["Login and roles<br/>[login-form.jsx]"]
  node_user_page["Attendee page<br/>[page.jsx]"]
  node_admin_page["Admin page<br/>[page.jsx]"]
end

subgraph group_attendee["Attendee safety"]
  node_user_dashboard["Attendee dashboard<br/>[user-dashboard.jsx]"]
  node_location["Location tracking"]
  node_geofencing["Zone detection<br/>[user-dashboard.jsx]"]
  node_routing["Route optimization<br/>[actions.js]"]
  node_route_planner["Route planning<br/>[route-planner.jsx]"]
  node_route_info["Route details<br/>[route-info.jsx]"]
  node_map["Live zone map<br/>[map-view.jsx]"]
  node_sos["SOS signal<br/>[sos-button.jsx]"]
  node_alerts_view["Alert reception<br/>[user-dashboard.jsx]"]
end

subgraph group_operations["Admin command center"]
  node_admin_dashboard["Operations dashboard"]
  node_zones["Zone management<br/>[zone-manager.jsx]"]
  node_density["Density controls"]
  node_alerts_admin["Alert broadcast<br/>[alert-manager.jsx]"]
  node_sos_monitor["SOS monitoring<br/>[sos-monitor.jsx]"]
  node_user_monitor["User activity audit<br/>[user-monitor.jsx]"]
end

subgraph group_cloud["Firebase data services"]
  node_firestore[("Firestore")]
  node_firebase_layer["Firebase client and hooks<br/>[index.js]"]
  node_write_helpers["Nonblocking writes"]
  node_error_events["Permission error events<br/>[error-emitter.js]"]
end

node_attendee_actor(("Attendee"))
node_admin_actor(("Organizer"))
node_auth_service["Firebase Auth"]
node_maps["Google Maps API"]

node_attendee_actor -->|"signs in"| node_login
node_admin_actor -->|"signs in"| node_login
node_login -->|"authenticates"| node_auth_service
node_login -->|"writes profile"| node_firestore
node_login -->|"routes attendee"| node_user_page
node_login -->|"routes admin"| node_admin_page
node_user_page -->|"renders"| node_user_dashboard
node_admin_page -->|"renders"| node_admin_dashboard
node_user_dashboard -->|"reads live data"| node_firebase_layer
node_firebase_layer -.->|"subscribes"| node_firestore
node_user_dashboard -->|"identifies zone"| node_geofencing
node_user_dashboard -->|"updates location"| node_firestore
node_user_dashboard -->|"renders"| node_location
node_user_dashboard -->|"renders"| node_route_planner
node_user_dashboard -->|"requests route"| node_routing
node_routing -.->|"returns route data"| node_route_info
node_user_dashboard -->|"renders"| node_route_info
node_user_dashboard -->|"renders zones and routes"| node_map
node_user_dashboard -->|"renders"| node_sos
node_sos -.->|"broadcasts distress"| node_firestore
node_user_dashboard -->|"shows targeted alerts"| node_alerts_view
node_alerts_view -->|"listens for alerts"| node_firestore
node_admin_dashboard -->|"renders"| node_zones
node_admin_dashboard -->|"renders"| node_density
node_admin_dashboard -->|"renders"| node_alerts_admin
node_admin_dashboard -->|"renders"| node_sos_monitor
node_admin_dashboard -->|"renders"| node_user_monitor
node_zones -.->|"selects boundaries"| node_maps
node_zones -->|"adds zones"| node_write_helpers
node_alerts_admin -->|"adds alerts"| node_write_helpers
node_write_helpers -->|"writes documents"| node_firestore
node_write_helpers -->|"emits failures"| node_error_events
node_alerts_admin -->|"stores broadcast"| node_firestore
node_user_dashboard -->|"uses Dijkstra routing"| node_routing

click node_login "https://github.com/surenderkm21/evacway/blob/main/src/components/auth/login-form.jsx"
click node_user_page "https://github.com/surenderkm21/evacway/blob/main/src/app/user/page.jsx"
click node_admin_page "https://github.com/surenderkm21/evacway/blob/main/src/app/admin/page.jsx"
click node_user_dashboard "https://github.com/surenderkm21/evacway/blob/main/src/components/user/user-dashboard.jsx"
click node_location "https://github.com/surenderkm21/evacway/blob/main/src/components/user/location-tracker.jsx"
click node_geofencing "https://github.com/surenderkm21/evacway/blob/main/src/components/user/user-dashboard.jsx"
click node_routing "https://github.com/surenderkm21/evacway/blob/main/src/lib/actions.js"
click node_route_planner "https://github.com/surenderkm21/evacway/blob/main/src/components/user/route-planner.jsx"
click node_route_info "https://github.com/surenderkm21/evacway/blob/main/src/components/user/route-info.jsx"
click node_map "https://github.com/surenderkm21/evacway/blob/main/src/components/user/map-view.jsx"
click node_sos "https://github.com/surenderkm21/evacway/blob/main/src/components/user/sos-button.jsx"
click node_alerts_view "https://github.com/surenderkm21/evacway/blob/main/src/components/user/user-dashboard.jsx"
click node_admin_dashboard "https://github.com/surenderkm21/evacway/blob/main/src/components/admin/admin-dashboard.jsx"
click node_zones "https://github.com/surenderkm21/evacway/blob/main/src/components/admin/zone-manager.jsx"
click node_density "https://github.com/surenderkm21/evacway/blob/main/src/components/admin/density-control.jsx"
click node_alerts_admin "https://github.com/surenderkm21/evacway/blob/main/src/components/admin/alert-manager.jsx"
click node_sos_monitor "https://github.com/surenderkm21/evacway/blob/main/src/components/admin/sos-monitor.jsx"
click node_user_monitor "https://github.com/surenderkm21/evacway/blob/main/src/components/admin/user-monitor.jsx"
click node_firebase_layer "https://github.com/surenderkm21/evacway/blob/main/src/firebase/index.js"
click node_write_helpers "https://github.com/surenderkm21/evacway/blob/main/src/firebase/non-blocking-updates.js"
click node_error_events "https://github.com/surenderkm21/evacway/blob/main/src/firebase/error-emitter.js"

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_login,node_user_page,node_admin_page toneBlue
class node_user_dashboard,node_location,node_geofencing,node_routing,node_route_planner,node_route_info,node_map,node_sos,node_alerts_view toneAmber
class node_admin_dashboard,node_zones,node_density,node_alerts_admin,node_sos_monitor,node_user_monitor,node_maps toneMint
class node_firestore,node_firebase_layer,node_write_helpers,node_error_events toneRose
class node_attendee_actor,node_admin_actor,node_auth_service toneIndigo
```

## Components

### Access and navigation

- [Login and roles](https://github.com/surenderkm21/evacway/blob/main/src/components/auth/login-form.jsx): `src/components/auth/login-form.jsx`
- [Attendee page](https://github.com/surenderkm21/evacway/blob/main/src/app/user/page.jsx): `src/app/user/page.jsx`
- [Admin page](https://github.com/surenderkm21/evacway/blob/main/src/app/admin/page.jsx): `src/app/admin/page.jsx`

### Attendee safety

- [Attendee dashboard](https://github.com/surenderkm21/evacway/blob/main/src/components/user/user-dashboard.jsx): `src/components/user/user-dashboard.jsx`
- [Location tracking](https://github.com/surenderkm21/evacway/blob/main/src/components/user/location-tracker.jsx): `src/components/user/location-tracker.jsx`
- [Zone detection](https://github.com/surenderkm21/evacway/blob/main/src/components/user/user-dashboard.jsx): `src/components/user/user-dashboard.jsx`
- [Route optimization](https://github.com/surenderkm21/evacway/blob/main/src/lib/actions.js): `src/lib/actions.js`
- [Route planning](https://github.com/surenderkm21/evacway/blob/main/src/components/user/route-planner.jsx): `src/components/user/route-planner.jsx`
- [Route details](https://github.com/surenderkm21/evacway/blob/main/src/components/user/route-info.jsx): `src/components/user/route-info.jsx`
- [Live zone map](https://github.com/surenderkm21/evacway/blob/main/src/components/user/map-view.jsx): `src/components/user/map-view.jsx`
- [SOS signal](https://github.com/surenderkm21/evacway/blob/main/src/components/user/sos-button.jsx): `src/components/user/sos-button.jsx`
- [Alert reception](https://github.com/surenderkm21/evacway/blob/main/src/components/user/user-dashboard.jsx): `src/components/user/user-dashboard.jsx`

### Admin command center

- [Operations dashboard](https://github.com/surenderkm21/evacway/blob/main/src/components/admin/admin-dashboard.jsx): `src/components/admin/admin-dashboard.jsx`
- [Zone management](https://github.com/surenderkm21/evacway/blob/main/src/components/admin/zone-manager.jsx): `src/components/admin/zone-manager.jsx`
- [Density controls](https://github.com/surenderkm21/evacway/blob/main/src/components/admin/density-control.jsx): `src/components/admin/density-control.jsx`
- [Alert broadcast](https://github.com/surenderkm21/evacway/blob/main/src/components/admin/alert-manager.jsx): `src/components/admin/alert-manager.jsx`
- [SOS monitoring](https://github.com/surenderkm21/evacway/blob/main/src/components/admin/sos-monitor.jsx): `src/components/admin/sos-monitor.jsx`
- [User activity audit](https://github.com/surenderkm21/evacway/blob/main/src/components/admin/user-monitor.jsx): `src/components/admin/user-monitor.jsx`

### Firebase data services

- **Firestore**
- [Firebase client and hooks](https://github.com/surenderkm21/evacway/blob/main/src/firebase/index.js): `src/firebase/index.js`
- [Nonblocking writes](https://github.com/surenderkm21/evacway/blob/main/src/firebase/non-blocking-updates.js): `src/firebase/non-blocking-updates.js`
- [Permission error events](https://github.com/surenderkm21/evacway/blob/main/src/firebase/error-emitter.js): `src/firebase/error-emitter.js`

### Other components

- **Attendee**
- **Organizer**
- **Firebase Auth**
- **Google Maps API**

## Connections

- Attendee → Login and roles: signs in
- Organizer → Login and roles: signs in
- Login and roles → Firebase Auth: authenticates (evidence: `src/components/auth/login-form.jsx`)
- Login and roles → Firestore: writes profile (evidence: `src/components/auth/login-form.jsx`)
- Login and roles → Attendee page: routes attendee (evidence: `src/components/auth/login-form.jsx`)
- Login and roles → Admin page: routes admin (evidence: `src/components/auth/login-form.jsx`)
- Attendee page → Attendee dashboard: renders (evidence: `src/app/user/page.jsx`)
- Admin page → Operations dashboard: renders (evidence: `src/app/admin/page.jsx`)
- Attendee dashboard → Firebase client and hooks: reads live data (evidence: `src/components/user/user-dashboard.jsx`)
- Firebase client and hooks → Firestore: subscribes
- Attendee dashboard → Zone detection: identifies zone (evidence: `src/components/user/user-dashboard.jsx`)
- Attendee dashboard → Firestore: updates location (evidence: `src/components/user/user-dashboard.jsx`)
- Attendee dashboard → Location tracking: renders (evidence: `src/components/user/user-dashboard.jsx`)
- Attendee dashboard → Route planning: renders (evidence: `src/components/user/user-dashboard.jsx`)
- Attendee dashboard → Route optimization: requests route (evidence: `src/components/user/user-dashboard.jsx`)
- Route optimization → Route details: returns route data
- Attendee dashboard → Route details: renders (evidence: `src/components/user/user-dashboard.jsx`)
- Attendee dashboard → Live zone map: renders zones and routes (evidence: `src/components/user/user-dashboard.jsx`)
- Attendee dashboard → SOS signal: renders (evidence: `src/components/user/user-dashboard.jsx`)
- SOS signal → Firestore: broadcasts distress
- Attendee dashboard → Alert reception: shows targeted alerts (evidence: `src/components/user/user-dashboard.jsx`)
- Alert reception → Firestore: listens for alerts (evidence: `src/components/user/user-dashboard.jsx`)
- Operations dashboard → Zone management: renders (evidence: `src/components/admin/admin-dashboard.jsx`)
- Operations dashboard → Density controls: renders (evidence: `src/components/admin/admin-dashboard.jsx`)
- Operations dashboard → Alert broadcast: renders (evidence: `src/components/admin/admin-dashboard.jsx`)
- Operations dashboard → SOS monitoring: renders (evidence: `src/components/admin/admin-dashboard.jsx`)
- Operations dashboard → User activity audit: renders (evidence: `src/components/admin/admin-dashboard.jsx`)
- Zone management → Google Maps API: selects boundaries (evidence: `README.md`)
- Zone management → Nonblocking writes: adds zones (evidence: `src/components/admin/zone-manager.jsx`)
- Alert broadcast → Nonblocking writes: adds alerts (evidence: `src/components/admin/alert-manager.jsx`)
- Nonblocking writes → Firestore: writes documents (evidence: `src/firebase/non-blocking-updates.js`)
- Nonblocking writes → Permission error events: emits failures (evidence: `src/firebase/non-blocking-updates.js`)
- Alert broadcast → Firestore: stores broadcast (evidence: `src/components/admin/alert-manager.jsx`)
- Attendee dashboard → Route optimization: uses Dijkstra routing (evidence: `README.md`)
