# villavito/my-app-hazard architecture

> Architecture diagram of the GitHub repository villavito/my-app-hazard, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-21). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/villavito/my-app-hazard
- Repository: https://github.com/villavito/my-app-hazard

## Overview

Hazard is an incident-reporting and response app: users authenticate, submit incident details (including location and video), and review their reports; administrators triage incidents, manage agencies/users, and inspect reports and trends. Firebase Auth and Firestore provide identity and incident data, while a companion backend handles video uploads and agency email notifications. The graph preserves the documented app areas, but several routes and service connections are unsampled; only evidenced calls or README-described relationships are drawn.

Main entry points: [`services/firestoreService.ts`](https://github.com/villavito/my-app-hazard/blob/main/services/firestoreService.ts) (Incident records), [`contexts/AuthContext.tsx`](https://github.com/villavito/my-app-hazard/blob/main/contexts/AuthContext.tsx) (Session and roles), [`app/capture-incident.tsx`](https://github.com/villavito/my-app-hazard/blob/main/app/capture-incident.tsx) (Capture incident), [`backend/server.js`](https://github.com/villavito/my-app-hazard/blob/main/backend/server.js) (App backend)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_identity["Identity and access"]
  node_authscreens["Sign-in and signup<br/>[signup.tsx]"]
  node_authcontext["Session and roles<br/>[AuthContext.tsx]"]
  node_authservice["Authentication service<br/>[authService.ts]"]
  node_adminaccess["Admin access<br/>[_layout.tsx]"]
end

subgraph group_reporting["Incident reporting"]
  node_home["User home<br/>[index.tsx]"]
  node_capture["Capture incident"]
  node_myreports["My reports<br/>[my-reports.tsx]"]
  node_agencyconfig["Agency and categories<br/>[agencies.ts]"]
end

subgraph group_response["Response operations"]
  node_notifications["Notifications<br/>[notifications.tsx]"]
  node_adminincidents["Incident triage<br/>[incidents.tsx]"]
  node_incidentdetail["Incident detail"]
  node_superadmin["Super-admin dashboard<br/>[super-admin.tsx]"]
  node_charts["Incident charts"]
  node_adminreports["Admin reports<br/>[reports.tsx]"]
end

subgraph group_platform["Data and integrations"]
  node_incidentdata[("Incident records")]
  node_firebase["Firebase client<br/>[firebase.ts]"]
  node_backendapi["Backend API client<br/>[api.ts]"]
  node_backend["App backend<br/>[server.js]"]
  node_firebaseadmin["Backend Firebase<br/>[firebase.js]"]
  node_sms["SMS integration<br/>[sms.js]"]
  node_video["Video upload and playback<br/>[incidentVideo.ts]"]
end

node_user(("App user"))
node_agencyrecipient(("Agency email recipient"))
node_emailservice["Email transport"]

node_user -->|"signs in"| node_authscreens
node_authscreens -->|"authenticates"| node_authservice
node_authcontext -->|"loads roles"| node_authservice
node_authservice -->|"uses auth"| node_firebase
node_authservice -->|"writes user data"| node_incidentdata
node_user -.->|"views status"| node_home
node_home -->|"reads session"| node_authcontext
node_home -->|"loads incidents"| node_incidentdata
node_user -.->|"reports incident"| node_capture
node_capture -->|"reads session"| node_authcontext
node_capture -->|"creates report"| node_incidentdata
node_capture -->|"posts requests"| node_backendapi
node_backendapi -.->|"sends HTTP"| node_backend
node_capture -->|"uses categories"| node_agencyconfig
node_user -.->|"reviews reports"| node_myreports
node_adminaccess -.->|"checks roles"| node_authcontext
node_adminincidents -->|"reads session"| node_authcontext
node_adminincidents -->|"loads incidents"| node_incidentdata
node_adminincidents -->|"uses agency data"| node_agencyconfig
node_incidentdetail -->|"loads incident"| node_incidentdata
node_incidentdetail -->|"renders video"| node_video
node_superadmin -->|"reads session"| node_authcontext
node_superadmin -->|"loads users and incidents"| node_incidentdata
node_superadmin -->|"renders metrics"| node_charts
node_adminreports -.->|"reads reports"| node_incidentdata
node_notifications -->|"loads notifications"| node_incidentdata
node_incidentdata -->|"uses Firestore"| node_firebase
node_backend -->|"uses Firebase"| node_firebaseadmin
node_backend -->|"uses SMS"| node_sms
node_backend -->|"emails alerts"| node_agencyrecipient
node_backend -.->|"sends email"| node_emailservice

click node_authscreens "https://github.com/villavito/my-app-hazard/blob/main/app/signup.tsx"
click node_authcontext "https://github.com/villavito/my-app-hazard/blob/main/contexts/AuthContext.tsx"
click node_authservice "https://github.com/villavito/my-app-hazard/blob/main/services/authService.ts"
click node_adminaccess "https://github.com/villavito/my-app-hazard/blob/main/app/admin/_layout.tsx"
click node_home "https://github.com/villavito/my-app-hazard/blob/main/app/(tabs)/index.tsx"
click node_capture "https://github.com/villavito/my-app-hazard/blob/main/app/capture-incident.tsx"
click node_myreports "https://github.com/villavito/my-app-hazard/blob/main/app/my-reports.tsx"
click node_incidentdata "https://github.com/villavito/my-app-hazard/blob/main/services/firestoreService.ts"
click node_firebase "https://github.com/villavito/my-app-hazard/blob/main/config/firebase.ts"
click node_backendapi "https://github.com/villavito/my-app-hazard/blob/main/config/api.ts"
click node_backend "https://github.com/villavito/my-app-hazard/blob/main/backend/server.js"
click node_firebaseadmin "https://github.com/villavito/my-app-hazard/blob/main/backend/config/firebase.js"
click node_sms "https://github.com/villavito/my-app-hazard/blob/main/backend/config/sms.js"
click node_video "https://github.com/villavito/my-app-hazard/blob/main/utils/incidentVideo.ts"
click node_notifications "https://github.com/villavito/my-app-hazard/blob/main/app/(tabs)/notifications.tsx"
click node_adminincidents "https://github.com/villavito/my-app-hazard/blob/main/app/admin/incidents.tsx"
click node_incidentdetail "https://github.com/villavito/my-app-hazard/blob/main/app/admin/incident-detail.tsx"
click node_superadmin "https://github.com/villavito/my-app-hazard/blob/main/app/admin/super-admin.tsx"
click node_charts "https://github.com/villavito/my-app-hazard/blob/main/components/IncidentStatusChart.tsx"
click node_adminreports "https://github.com/villavito/my-app-hazard/blob/main/app/admin/reports.tsx"
click node_agencyconfig "https://github.com/villavito/my-app-hazard/blob/main/constants/agencies.ts"

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_authscreens,node_authcontext,node_authservice,node_adminaccess,node_user toneBlue
class node_home,node_capture,node_myreports,node_agencyconfig toneAmber
class node_notifications,node_adminincidents,node_incidentdetail,node_superadmin,node_charts,node_adminreports toneMint
class node_incidentdata,node_firebase,node_backendapi,node_backend,node_firebaseadmin,node_sms,node_video toneRose
class node_agencyrecipient,node_emailservice toneIndigo
```

## Components

### Identity and access

- [Sign-in and signup](https://github.com/villavito/my-app-hazard/blob/main/app/signup.tsx): `app/signup.tsx`
- [Session and roles](https://github.com/villavito/my-app-hazard/blob/main/contexts/AuthContext.tsx): `contexts/AuthContext.tsx`
- [Authentication service](https://github.com/villavito/my-app-hazard/blob/main/services/authService.ts): `services/authService.ts`
- [Admin access](https://github.com/villavito/my-app-hazard/blob/main/app/admin/_layout.tsx): `app/admin/_layout.tsx`

### Incident reporting

- [User home](https://github.com/villavito/my-app-hazard/blob/main/app/(tabs)/index.tsx): `app/(tabs)/index.tsx`
- [Capture incident](https://github.com/villavito/my-app-hazard/blob/main/app/capture-incident.tsx): `app/capture-incident.tsx`
- [My reports](https://github.com/villavito/my-app-hazard/blob/main/app/my-reports.tsx): `app/my-reports.tsx`
- [Agency and categories](https://github.com/villavito/my-app-hazard/blob/main/constants/agencies.ts): `constants/agencies.ts`

### Response operations

- [Notifications](https://github.com/villavito/my-app-hazard/blob/main/app/(tabs)/notifications.tsx): `app/(tabs)/notifications.tsx`
- [Incident triage](https://github.com/villavito/my-app-hazard/blob/main/app/admin/incidents.tsx): `app/admin/incidents.tsx`
- [Incident detail](https://github.com/villavito/my-app-hazard/blob/main/app/admin/incident-detail.tsx): `app/admin/incident-detail.tsx`
- [Super-admin dashboard](https://github.com/villavito/my-app-hazard/blob/main/app/admin/super-admin.tsx): `app/admin/super-admin.tsx`
- [Incident charts](https://github.com/villavito/my-app-hazard/blob/main/components/IncidentStatusChart.tsx): `components/IncidentStatusChart.tsx`
- [Admin reports](https://github.com/villavito/my-app-hazard/blob/main/app/admin/reports.tsx): `app/admin/reports.tsx`

### Data and integrations

- [Incident records](https://github.com/villavito/my-app-hazard/blob/main/services/firestoreService.ts): `services/firestoreService.ts`
- [Firebase client](https://github.com/villavito/my-app-hazard/blob/main/config/firebase.ts): `config/firebase.ts`
- [Backend API client](https://github.com/villavito/my-app-hazard/blob/main/config/api.ts): `config/api.ts`
- [App backend](https://github.com/villavito/my-app-hazard/blob/main/backend/server.js): `backend/server.js`
- [Backend Firebase](https://github.com/villavito/my-app-hazard/blob/main/backend/config/firebase.js): `backend/config/firebase.js`
- [SMS integration](https://github.com/villavito/my-app-hazard/blob/main/backend/config/sms.js): `backend/config/sms.js`
- [Video upload and playback](https://github.com/villavito/my-app-hazard/blob/main/utils/incidentVideo.ts): `utils/incidentVideo.ts`

### Other components

- **App user**
- **Agency email recipient**
- **Email transport**

## Connections

- App user → Sign-in and signup: signs in (evidence: `app/signup.tsx`)
- Sign-in and signup → Authentication service: authenticates (evidence: `services/authService.ts`)
- Session and roles → Authentication service: loads roles (evidence: `contexts/AuthContext.tsx`)
- Authentication service → Firebase client: uses auth (evidence: `services/authService.ts`)
- Authentication service → Incident records: writes user data (evidence: `services/authService.ts`)
- App user → User home: views status
- User home → Session and roles: reads session (evidence: `app/(tabs)/index.tsx`)
- User home → Incident records: loads incidents (evidence: `app/(tabs)/index.tsx`)
- App user → Capture incident: reports incident
- Capture incident → Session and roles: reads session (evidence: `app/capture-incident.tsx`)
- Capture incident → Incident records: creates report (evidence: `app/capture-incident.tsx`)
- Capture incident → Backend API client: posts requests (evidence: `app/capture-incident.tsx`)
- Backend API client → App backend: sends HTTP
- Capture incident → Agency and categories: uses categories (evidence: `app/capture-incident.tsx`)
- App user → My reports: reviews reports
- Admin access → Session and roles: checks roles
- Incident triage → Session and roles: reads session (evidence: `app/admin/incidents.tsx`)
- Incident triage → Incident records: loads incidents (evidence: `app/admin/incidents.tsx`)
- Incident triage → Agency and categories: uses agency data (evidence: `app/admin/incidents.tsx`)
- Incident detail → Incident records: loads incident (evidence: `app/admin/incident-detail.tsx`)
- Incident detail → Video upload and playback: renders video (evidence: `app/admin/incident-detail.tsx`)
- Super-admin dashboard → Session and roles: reads session (evidence: `app/admin/super-admin.tsx`)
- Super-admin dashboard → Incident records: loads users and incidents (evidence: `app/admin/super-admin.tsx`)
- Super-admin dashboard → Incident charts: renders metrics (evidence: `app/admin/super-admin.tsx`)
- Admin reports → Incident records: reads reports
- Notifications → Incident records: loads notifications (evidence: `app/(tabs)/notifications.tsx`)
- Incident records → Firebase client: uses Firestore (evidence: `services/firestoreService.ts`)
- App backend → Backend Firebase: uses Firebase (evidence: `backend/server.js`)
- App backend → SMS integration: uses SMS (evidence: `backend/server.js`)
- App backend → Agency email recipient: emails alerts (evidence: `backend/server.js`)
- App backend → Email transport: sends email
