# nyikomnisii/civicalert-app architecture

> Architecture diagram of the GitHub repository nyikomnisii/civicalert-app, 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/nyikomnisii/civicalert-app
- Repository: https://github.com/nyikomnisii/civicalert-app

## Overview

Civic Alert is a community incident-reporting system. Residents register or sign in, submit incidents with descriptions, locations and optional images, then track statuses; administrators and service providers manage incidents through a separate web application. This repository contains the Android app, not the web application. The README documents Firebase Firestore and the product capabilities, but no app source was sampled, so edges describe only documented relationships rather than inferred screen routing or implementation details.

Main entry points: [`app/src/main/java/com/example/civicalertoriginal/Screens/MakeReports.kt`](https://github.com/nyikomnisii/civicalert-app/blob/newImage/app/src/main/java/com/example/civicalertoriginal/Screens/MakeReports.kt) (Incident report), [`app/src/main/java/com/example/civicalertoriginal/MainActivity.kt`](https://github.com/nyikomnisii/civicalert-app/blob/newImage/app/src/main/java/com/example/civicalertoriginal/MainActivity.kt) (Android app), [`app/src/main/java/com/example/civicalertoriginal/Screens/Registration.kt`](https://github.com/nyikomnisii/civicalert-app/blob/newImage/app/src/main/java/com/example/civicalertoriginal/Screens/Registration.kt) (Registration), [`app/src/main/java/com/example/civicalertoriginal/Screens/LogIn.kt`](https://github.com/nyikomnisii/civicalert-app/blob/newImage/app/src/main/java/com/example/civicalertoriginal/Screens/LogIn.kt) (Login)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["App entry and access"]
  node_app["Android app<br/>[MainActivity.kt]"]
  node_navigation["App navigation<br/>[Navigation.kt]"]
  node_registration["Registration<br/>[Registration.kt]"]
  node_login["Login<br/>[LogIn.kt]"]
  node_password["Password reset<br/>[ResetPassword.kt]"]
  node_profile["Profile updates<br/>[UpdateProfile.kt]"]
end

subgraph group_reporting["Incident reporting"]
  node_report["Incident report<br/>[MakeReports.kt]"]
  node_camera["Image capture<br/>[Camera.kt]"]
  node_map["Location map<br/>[Mapbox.kt]"]
  node_reference["Reference details<br/>[RefrencePOP.kt]"]
  node_firestore[("Firebase Firestore")]
end

subgraph group_tracking["Incident tracking and support"]
  node_dashboard["Incident dashboard<br/>[Dashboard.kt]"]
  node_reports["View reports<br/>[ViewReports.kt]"]
  node_fullreport["Report details<br/>[ViewFullReport.kt]"]
  node_support["Help and support<br/>[HelpAndSupport.kt]"]
  node_contact["Contact us<br/>[ContactUs.kt]"]
end

node_resident(("Community member"))
node_municipality["Municipality web app"]
node_admins(("Municipal admins"))
node_providers(("Service providers"))

node_resident -->|"uses"| node_app
node_app -.->|"presents"| node_navigation
node_resident -->|"registers"| node_registration
node_resident -->|"signs in"| node_login
node_resident -.->|"resets password"| node_password
node_resident -.->|"updates profile"| node_profile
node_resident -->|"reports incident"| node_report
node_report -->|"sets location"| node_map
node_report -->|"adds image"| node_camera
node_report -->|"stores incident"| node_firestore
node_registration -.->|"stores user data"| node_firestore
node_login -.->|"checks account"| node_firestore
node_resident -->|"views status"| node_dashboard
node_dashboard -.->|"shows incidents"| node_reports
node_reports -.->|"opens details"| node_fullreport
node_resident -.->|"requests help"| node_support
node_resident -.->|"contacts team"| node_contact
node_admins -->|"manages incidents"| node_municipality
node_providers -->|"updates status"| node_municipality
node_municipality -.->|"manages records"| node_firestore

click node_app "https://github.com/nyikomnisii/civicalert-app/blob/newImage/app/src/main/java/com/example/civicalertoriginal/MainActivity.kt"
click node_navigation "https://github.com/nyikomnisii/civicalert-app/blob/newImage/app/src/main/java/com/example/civicalertoriginal/Components/Navigation.kt"
click node_registration "https://github.com/nyikomnisii/civicalert-app/blob/newImage/app/src/main/java/com/example/civicalertoriginal/Screens/Registration.kt"
click node_login "https://github.com/nyikomnisii/civicalert-app/blob/newImage/app/src/main/java/com/example/civicalertoriginal/Screens/LogIn.kt"
click node_password "https://github.com/nyikomnisii/civicalert-app/blob/newImage/app/src/main/java/com/example/civicalertoriginal/Screens/ResetPassword.kt"
click node_profile "https://github.com/nyikomnisii/civicalert-app/blob/newImage/app/src/main/java/com/example/civicalertoriginal/Screens/UpdateProfile.kt"
click node_report "https://github.com/nyikomnisii/civicalert-app/blob/newImage/app/src/main/java/com/example/civicalertoriginal/Screens/MakeReports.kt"
click node_camera "https://github.com/nyikomnisii/civicalert-app/blob/newImage/app/src/main/java/com/example/civicalertoriginal/Screens/Camera.kt"
click node_map "https://github.com/nyikomnisii/civicalert-app/blob/newImage/app/src/main/java/com/example/civicalertoriginal/Screens/Mapbox.kt"
click node_reference "https://github.com/nyikomnisii/civicalert-app/blob/newImage/app/src/main/java/com/example/civicalertoriginal/Screens/RefrencePOP.kt"
click node_dashboard "https://github.com/nyikomnisii/civicalert-app/blob/newImage/app/src/main/java/com/example/civicalertoriginal/Screens/Dashboard.kt"
click node_reports "https://github.com/nyikomnisii/civicalert-app/blob/newImage/app/src/main/java/com/example/civicalertoriginal/Screens/ViewReports.kt"
click node_fullreport "https://github.com/nyikomnisii/civicalert-app/blob/newImage/app/src/main/java/com/example/civicalertoriginal/Screens/ViewFullReport.kt"
click node_support "https://github.com/nyikomnisii/civicalert-app/blob/newImage/app/src/main/java/com/example/civicalertoriginal/Screens/HelpAndSupport.kt"
click node_contact "https://github.com/nyikomnisii/civicalert-app/blob/newImage/app/src/main/java/com/example/civicalertoriginal/Screens/ContactUs.kt"

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_app,node_navigation,node_registration,node_login,node_password,node_profile toneBlue
class node_report,node_camera,node_map,node_reference,node_firestore toneAmber
class node_dashboard,node_reports,node_fullreport,node_support,node_contact toneMint
class node_resident,node_municipality,node_admins,node_providers toneIndigo
```

## Components

### App entry and access

- [Android app](https://github.com/nyikomnisii/civicalert-app/blob/newImage/app/src/main/java/com/example/civicalertoriginal/MainActivity.kt): `app/src/main/java/com/example/civicalertoriginal/MainActivity.kt`
- [App navigation](https://github.com/nyikomnisii/civicalert-app/blob/newImage/app/src/main/java/com/example/civicalertoriginal/Components/Navigation.kt): `app/src/main/java/com/example/civicalertoriginal/Components/Navigation.kt`
- [Registration](https://github.com/nyikomnisii/civicalert-app/blob/newImage/app/src/main/java/com/example/civicalertoriginal/Screens/Registration.kt): `app/src/main/java/com/example/civicalertoriginal/Screens/Registration.kt`
- [Login](https://github.com/nyikomnisii/civicalert-app/blob/newImage/app/src/main/java/com/example/civicalertoriginal/Screens/LogIn.kt): `app/src/main/java/com/example/civicalertoriginal/Screens/LogIn.kt`
- [Password reset](https://github.com/nyikomnisii/civicalert-app/blob/newImage/app/src/main/java/com/example/civicalertoriginal/Screens/ResetPassword.kt): `app/src/main/java/com/example/civicalertoriginal/Screens/ResetPassword.kt`
- [Profile updates](https://github.com/nyikomnisii/civicalert-app/blob/newImage/app/src/main/java/com/example/civicalertoriginal/Screens/UpdateProfile.kt): `app/src/main/java/com/example/civicalertoriginal/Screens/UpdateProfile.kt`

### Incident reporting

- [Incident report](https://github.com/nyikomnisii/civicalert-app/blob/newImage/app/src/main/java/com/example/civicalertoriginal/Screens/MakeReports.kt): `app/src/main/java/com/example/civicalertoriginal/Screens/MakeReports.kt`
- [Image capture](https://github.com/nyikomnisii/civicalert-app/blob/newImage/app/src/main/java/com/example/civicalertoriginal/Screens/Camera.kt): `app/src/main/java/com/example/civicalertoriginal/Screens/Camera.kt`
- [Location map](https://github.com/nyikomnisii/civicalert-app/blob/newImage/app/src/main/java/com/example/civicalertoriginal/Screens/Mapbox.kt): `app/src/main/java/com/example/civicalertoriginal/Screens/Mapbox.kt`
- [Reference details](https://github.com/nyikomnisii/civicalert-app/blob/newImage/app/src/main/java/com/example/civicalertoriginal/Screens/RefrencePOP.kt): `app/src/main/java/com/example/civicalertoriginal/Screens/RefrencePOP.kt`
- **Firebase Firestore**

### Incident tracking and support

- [Incident dashboard](https://github.com/nyikomnisii/civicalert-app/blob/newImage/app/src/main/java/com/example/civicalertoriginal/Screens/Dashboard.kt): `app/src/main/java/com/example/civicalertoriginal/Screens/Dashboard.kt`
- [View reports](https://github.com/nyikomnisii/civicalert-app/blob/newImage/app/src/main/java/com/example/civicalertoriginal/Screens/ViewReports.kt): `app/src/main/java/com/example/civicalertoriginal/Screens/ViewReports.kt`
- [Report details](https://github.com/nyikomnisii/civicalert-app/blob/newImage/app/src/main/java/com/example/civicalertoriginal/Screens/ViewFullReport.kt): `app/src/main/java/com/example/civicalertoriginal/Screens/ViewFullReport.kt`
- [Help and support](https://github.com/nyikomnisii/civicalert-app/blob/newImage/app/src/main/java/com/example/civicalertoriginal/Screens/HelpAndSupport.kt): `app/src/main/java/com/example/civicalertoriginal/Screens/HelpAndSupport.kt`
- [Contact us](https://github.com/nyikomnisii/civicalert-app/blob/newImage/app/src/main/java/com/example/civicalertoriginal/Screens/ContactUs.kt): `app/src/main/java/com/example/civicalertoriginal/Screens/ContactUs.kt`

### Other components

- **Community member**
- **Municipality web app**
- **Municipal admins**
- **Service providers**

## Connections

- Community member → Android app: uses (evidence: `README.md`)
- Android app → App navigation: presents
- Community member → Registration: registers (evidence: `README.md`)
- Community member → Login: signs in (evidence: `README.md`)
- Community member → Password reset: resets password
- Community member → Profile updates: updates profile
- Community member → Incident report: reports incident (evidence: `README.md`)
- Incident report → Location map: sets location (evidence: `README.md`)
- Incident report → Image capture: adds image (evidence: `README.md`)
- Incident report → Firebase Firestore: stores incident (evidence: `README.md`)
- Registration → Firebase Firestore: stores user data
- Login → Firebase Firestore: checks account
- Community member → Incident dashboard: views status (evidence: `README.md`)
- Incident dashboard → View reports: shows incidents
- View reports → Report details: opens details
- Community member → Help and support: requests help
- Community member → Contact us: contacts team
- Municipal admins → Municipality web app: manages incidents (evidence: `README.md`)
- Service providers → Municipality web app: updates status (evidence: `README.md`)
- Municipality web app → Firebase Firestore: manages records
