# bulsu-kbpulido/alertu-admin architecture

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

- Interactive diagram: https://gitdiagram.com/bulsu-kbpulido/alertu-admin
- Repository: https://github.com/bulsu-kbpulido/alertu-admin

## Overview

AlertU is a React admin and public incident-reporting application. The main workflow is an administrator signing in, reviewing incoming reports, and managing their status, with dashboards and citizen records supporting operations; members of the public can also submit or view reports. Separate real-time SOS, messaging, and emergency-call capabilities complement report management. The README is only a Vite template description, so capability labels come from the source tree and excerpts; several page-level connections are documented by the SOURCE INDEX rather than inspected implementations.

Main entry points: [`src/App.jsx`](https://github.com/bulsu-kbpulido/alertu-admin/blob/main/src/App.jsx) (App routing), [`src/firebase.js`](https://github.com/bulsu-kbpulido/alertu-admin/blob/main/src/firebase.js) (Firebase services), [`src/pages/Report_Management.jsx`](https://github.com/bulsu-kbpulido/alertu-admin/blob/main/src/pages/Report_Management.jsx) (Report management), [`src/sos_emergency/SOSadminModal.jsx`](https://github.com/bulsu-kbpulido/alertu-admin/blob/main/src/sos_emergency/SOSadminModal.jsx) (Live SOS response)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["Application"]
  node_entry["App routing<br/>[App.jsx]"]
  node_login["Admin login<br/>[Login.jsx]"]
  node_nav["Admin navigation<br/>[Navbar.jsx]"]
  node_ui["UI primitives"]
  node_dialog["Alert dialog<br/>[alert-dialog.jsx]"]
end

subgraph group_reports["Incident Reports"]
  node_reportcreate["Report creation<br/>[Create_Reports.jsx]"]
  node_publicreports["Public reporting"]
  node_reportops["Report management"]
  node_reportviews["Report review<br/>[View_Reports.jsx]"]
  node_reportarchive["Archived reports"]
  node_sendreports["Report distribution<br/>[Send_Reports.jsx]"]
end

subgraph group_operations["Admin Operations"]
  node_dashboard["Operations dashboard<br/>[Dashboard.jsx]"]
  node_dashdata["Dashboard analytics"]
  node_citizens["Citizen management"]
  node_alerts["Alert management"]
  node_badges["New-item tracking<br/>[useNewRows.js]"]
  node_audit["Audit logging<br/>[useAuditLog.js]"]
end

subgraph group_realtime["Live Response"]
  node_sos["Live SOS response<br/>[SOSadminModal.jsx]"]
  node_soshistory["SOS history"]
  node_calls["Emergency calls<br/>[AdminCallModal.jsx]"]
  node_messages["Messaging<br/>[MessagesDrawer.jsx]"]
end

subgraph group_infra["Services"]
  node_firebase[("Firebase services<br/>[firebase.js]")]
  node_socket["Socket client<br/>[socket.js]"]
  node_backend["AlertU backend"]
end

node_admin(("Administrator"))
node_public(("Public user"))

node_admin -->|"opens"| node_entry
node_public -->|"opens"| node_entry
node_entry -->|"routes to"| node_login
node_entry -->|"routes to"| node_dashboard
node_entry -->|"routes to"| node_reportcreate
node_entry -->|"routes to"| node_publicreports
node_entry -->|"routes to"| node_reportops
node_entry -->|"routes to"| node_citizens
node_entry -->|"routes to"| node_alerts
node_entry -->|"renders"| node_nav
node_dashboard -.->|"uses"| node_dashdata
node_reportops -.->|"uses"| node_reportviews
node_reportviews -->|"links to"| node_reportarchive
node_reportops -.->|"routes to"| node_sendreports
node_nav -->|"opens"| node_soshistory
node_sos -->|"updates status"| node_firebase
node_sos -->|"handles events"| node_socket
node_calls -->|"signals calls"| node_socket
node_entry -->|"subscribes to messages"| node_messages
node_badges -->|"watches records"| node_firebase
node_audit -->|"posts audit events"| node_backend
node_entry -->|"reads live data"| node_firebase
node_firebase -.->|"connects to"| node_backend
node_entry -.->|"uses controls"| node_ui
node_ui -.->|"includes"| node_dialog

click node_entry "https://github.com/bulsu-kbpulido/alertu-admin/blob/main/src/App.jsx"
click node_login "https://github.com/bulsu-kbpulido/alertu-admin/blob/main/src/pages/Login.jsx"
click node_nav "https://github.com/bulsu-kbpulido/alertu-admin/blob/main/src/components/Navbar.jsx"
click node_dashboard "https://github.com/bulsu-kbpulido/alertu-admin/blob/main/src/pages/Dashboard.jsx"
click node_dashdata "https://github.com/bulsu-kbpulido/alertu-admin/tree/main/src/dashboard_utils"
click node_citizens "https://github.com/bulsu-kbpulido/alertu-admin/blob/main/src/pages/Citizen_Management.jsx"
click node_reportcreate "https://github.com/bulsu-kbpulido/alertu-admin/blob/main/src/pages/Create_Reports.jsx"
click node_publicreports "https://github.com/bulsu-kbpulido/alertu-admin/blob/main/src/pages/PublicReportPage.jsx"
click node_reportops "https://github.com/bulsu-kbpulido/alertu-admin/blob/main/src/pages/Report_Management.jsx"
click node_reportviews "https://github.com/bulsu-kbpulido/alertu-admin/blob/main/src/report_utilities/View_Reports.jsx"
click node_reportarchive "https://github.com/bulsu-kbpulido/alertu-admin/blob/main/src/report_utilities/Archived_Routes.jsx"
click node_sendreports "https://github.com/bulsu-kbpulido/alertu-admin/blob/main/src/pages/Send_Reports.jsx"
click node_alerts "https://github.com/bulsu-kbpulido/alertu-admin/blob/main/src/pages/Alert_Management.jsx"
click node_sos "https://github.com/bulsu-kbpulido/alertu-admin/blob/main/src/sos_emergency/SOSadminModal.jsx"
click node_soshistory "https://github.com/bulsu-kbpulido/alertu-admin/blob/main/src/sos_emergency/SOShistorymodal.jsx"
click node_calls "https://github.com/bulsu-kbpulido/alertu-admin/blob/main/src/admin_call/AdminCallModal.jsx"
click node_messages "https://github.com/bulsu-kbpulido/alertu-admin/blob/main/src/components/MessagesDrawer.jsx"
click node_badges "https://github.com/bulsu-kbpulido/alertu-admin/blob/main/src/hooks/useNewRows.js"
click node_audit "https://github.com/bulsu-kbpulido/alertu-admin/blob/main/src/useAuditLog.js"
click node_firebase "https://github.com/bulsu-kbpulido/alertu-admin/blob/main/src/firebase.js"
click node_socket "https://github.com/bulsu-kbpulido/alertu-admin/blob/main/src/socket.js"
click node_ui "https://github.com/bulsu-kbpulido/alertu-admin/tree/main/src/components/ui"
click node_dialog "https://github.com/bulsu-kbpulido/alertu-admin/blob/main/src/components/ui/alert-dialog.jsx"

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_entry,node_login,node_nav,node_ui,node_dialog,node_public toneBlue
class node_reportcreate,node_publicreports,node_reportops,node_reportviews,node_reportarchive,node_sendreports toneAmber
class node_dashboard,node_dashdata,node_citizens,node_alerts,node_badges,node_audit toneMint
class node_sos,node_soshistory,node_calls,node_messages toneRose
class node_firebase,node_socket,node_backend,node_admin toneIndigo
```

## Components

### Application

- [App routing](https://github.com/bulsu-kbpulido/alertu-admin/blob/main/src/App.jsx): `src/App.jsx`
- [Admin login](https://github.com/bulsu-kbpulido/alertu-admin/blob/main/src/pages/Login.jsx): `src/pages/Login.jsx`
- [Admin navigation](https://github.com/bulsu-kbpulido/alertu-admin/blob/main/src/components/Navbar.jsx): `src/components/Navbar.jsx`
- [UI primitives](https://github.com/bulsu-kbpulido/alertu-admin/tree/main/src/components/ui): `src/components/ui`
- [Alert dialog](https://github.com/bulsu-kbpulido/alertu-admin/blob/main/src/components/ui/alert-dialog.jsx): `src/components/ui/alert-dialog.jsx`

### Incident Reports

- [Report creation](https://github.com/bulsu-kbpulido/alertu-admin/blob/main/src/pages/Create_Reports.jsx): `src/pages/Create_Reports.jsx`
- [Public reporting](https://github.com/bulsu-kbpulido/alertu-admin/blob/main/src/pages/PublicReportPage.jsx): `src/pages/PublicReportPage.jsx`
- [Report management](https://github.com/bulsu-kbpulido/alertu-admin/blob/main/src/pages/Report_Management.jsx): `src/pages/Report_Management.jsx`
- [Report review](https://github.com/bulsu-kbpulido/alertu-admin/blob/main/src/report_utilities/View_Reports.jsx): `src/report_utilities/View_Reports.jsx`
- [Archived reports](https://github.com/bulsu-kbpulido/alertu-admin/blob/main/src/report_utilities/Archived_Routes.jsx): `src/report_utilities/Archived_Routes.jsx`
- [Report distribution](https://github.com/bulsu-kbpulido/alertu-admin/blob/main/src/pages/Send_Reports.jsx): `src/pages/Send_Reports.jsx`

### Admin Operations

- [Operations dashboard](https://github.com/bulsu-kbpulido/alertu-admin/blob/main/src/pages/Dashboard.jsx): `src/pages/Dashboard.jsx`
- [Dashboard analytics](https://github.com/bulsu-kbpulido/alertu-admin/tree/main/src/dashboard_utils): `src/dashboard_utils`
- [Citizen management](https://github.com/bulsu-kbpulido/alertu-admin/blob/main/src/pages/Citizen_Management.jsx): `src/pages/Citizen_Management.jsx`
- [Alert management](https://github.com/bulsu-kbpulido/alertu-admin/blob/main/src/pages/Alert_Management.jsx): `src/pages/Alert_Management.jsx`
- [New-item tracking](https://github.com/bulsu-kbpulido/alertu-admin/blob/main/src/hooks/useNewRows.js): `src/hooks/useNewRows.js`
- [Audit logging](https://github.com/bulsu-kbpulido/alertu-admin/blob/main/src/useAuditLog.js): `src/useAuditLog.js`

### Live Response

- [Live SOS response](https://github.com/bulsu-kbpulido/alertu-admin/blob/main/src/sos_emergency/SOSadminModal.jsx): `src/sos_emergency/SOSadminModal.jsx`
- [SOS history](https://github.com/bulsu-kbpulido/alertu-admin/blob/main/src/sos_emergency/SOShistorymodal.jsx): `src/sos_emergency/SOShistorymodal.jsx`
- [Emergency calls](https://github.com/bulsu-kbpulido/alertu-admin/blob/main/src/admin_call/AdminCallModal.jsx): `src/admin_call/AdminCallModal.jsx`
- [Messaging](https://github.com/bulsu-kbpulido/alertu-admin/blob/main/src/components/MessagesDrawer.jsx): `src/components/MessagesDrawer.jsx`

### Services

- [Firebase services](https://github.com/bulsu-kbpulido/alertu-admin/blob/main/src/firebase.js): `src/firebase.js`
- [Socket client](https://github.com/bulsu-kbpulido/alertu-admin/blob/main/src/socket.js): `src/socket.js`
- **AlertU backend**

### Other components

- **Administrator**
- **Public user**

## Connections

- Administrator → App routing: opens (evidence: `src/App.jsx`)
- Public user → App routing: opens (evidence: `src/App.jsx`)
- App routing → Admin login: routes to (evidence: `src/App.jsx`)
- App routing → Operations dashboard: routes to (evidence: `src/App.jsx`)
- App routing → Report creation: routes to (evidence: `src/App.jsx`)
- App routing → Public reporting: routes to (evidence: `src/App.jsx`)
- App routing → Report management: routes to (evidence: `src/App.jsx`)
- App routing → Citizen management: routes to (evidence: `src/App.jsx`)
- App routing → Alert management: routes to (evidence: `src/App.jsx`)
- App routing → Admin navigation: renders (evidence: `src/App.jsx`)
- Operations dashboard → Dashboard analytics: uses
- Report management → Report review: uses
- Report review → Archived reports: links to (evidence: `src/report_utilities/Archived_Routes.jsx`)
- Report management → Report distribution: routes to
- Admin navigation → SOS history: opens (evidence: `src/components/Navbar.jsx`)
- Live SOS response → Firebase services: updates status (evidence: `src/sos_emergency/SOSadminModal.jsx`)
- Live SOS response → Socket client: handles events (evidence: `src/sos_emergency/SOSadminModal.jsx`)
- Emergency calls → Socket client: signals calls (evidence: `src/admin_call/AdminCallModal.jsx`)
- App routing → Messaging: subscribes to messages (evidence: `src/App.jsx`)
- New-item tracking → Firebase services: watches records (evidence: `src/hooks/useNewRows.js`)
- Audit logging → AlertU backend: posts audit events (evidence: `src/useAuditLog.js`)
- App routing → Firebase services: reads live data (evidence: `src/App.jsx`)
- Firebase services → AlertU backend: connects to
- App routing → UI primitives: uses controls
- UI primitives → Alert dialog: includes (evidence: `src/components/ui/alert-dialog.jsx`)
