# gs-citizentech-drenaai/drenaai-mobile architecture

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

- Interactive diagram: https://gitdiagram.com/gs-citizentech-drenaai/drenaai-mobile
- Repository: https://github.com/gs-citizentech-drenaai/drenaai-mobile

## Overview

DrenaAi Mobile is the citizen-facing app for reporting dumped waste and monitoring neighborhood flood risk. Residents sign in, submit a photo and location, view the returned severity and queue priority, then follow the report; they can also check rain alerts, the map, and drain sensors. The app screens use a repository contract that selects an API or demo implementation. The README documents backend processing and storage; source excerpts do not show all screen-to-repository calls, so those links rely on README statements rather than inspected implementations.

Main entry points: [`src/dados/repo.ts`](https://github.com/gs-citizentech-drenaai/drenaai-mobile/blob/main/src/dados/repo.ts) (Repository selector), [`src/app/(abas)/index.tsx`](https://github.com/gs-citizentech-drenaai/drenaai-mobile/blob/main/src/app/(abas)/index.tsx) (Neighborhood alerts), [`src/app/perfil.tsx`](https://github.com/gs-citizentech-drenaai/drenaai-mobile/blob/main/src/app/perfil.tsx) (Profile preferences), [`src/dados/ApiRepo.ts`](https://github.com/gs-citizentech-drenaai/drenaai-mobile/blob/main/src/dados/ApiRepo.ts) (API adapter)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_citizen["Citizen journeys"]
  node_auth["Login and signup<br/>[login.tsx]"]
  node_neighborhood["Neighborhood alerts<br/>[index.tsx]"]
  node_report["Report waste<br/>[denunciar.tsx]"]
  node_received["Report result<br/>[&#91;id&#93;.tsx]"]
  node_tracking["Report tracking<br/>[&#91;id&#93;.tsx]"]
  node_map["Queue and sensors map<br/>[mapa.tsx]"]
  node_profile["Profile preferences<br/>[perfil.tsx]"]
end

subgraph group_data["Data access"]
  node_repo["Repository selector<br/>[repo.ts]"]
  node_contract["Repository contract<br/>[DrenaRepo.ts]"]
  node_api["API adapter<br/>[ApiRepo.ts]"]
  node_mock["Demo adapter<br/>[MockRepo.ts]"]
  node_types["Domain data types<br/>[tipos.ts]"]
  node_geo["Distance calculations<br/>[geo.ts]"]
end

subgraph group_state["App state"]
  node_session["Session context<br/>[SessaoContext.tsx]"]
  node_preferences["Preferences context"]
end

subgraph group_shared["Shared presentation"]
  node_ui["Shared UI components"]
end

node_resident(("Resident"))
node_backend["DrenaAi API"]
node_oracle[("Oracle database")]
node_ai["Photo assessment"]
node_sensors["ESP32 sensors"]

node_resident -->|"signs in"| node_auth
node_resident -->|"checks alerts"| node_neighborhood
node_resident -->|"submits report"| node_report
node_resident -->|"views queue"| node_map
node_resident -->|"sets preferences"| node_profile
node_auth -->|"uses session"| node_session
node_session -->|"calls auth methods"| node_repo
node_neighborhood -->|"loads forecast and reports"| node_repo
node_neighborhood -->|"calculates nearby distance"| node_geo
node_report -->|"creates report"| node_repo
node_received -->|"loads report result"| node_repo
node_tracking -->|"loads report history"| node_repo
node_map -->|"loads queue and telemetry"| node_repo
node_profile -->|"updates settings"| node_preferences
node_repo -->|"selects API mode"| node_api
node_repo -->|"selects demo mode"| node_mock
node_api -->|"sends API requests"| node_backend
node_mock -.->|"supplies demo data"| node_neighborhood
node_backend -->|"reads and writes"| node_oracle
node_backend -->|"assesses photo severity"| node_ai
node_sensors -->|"sends readings"| node_backend
node_repo -->|"implements contract"| node_contract
node_api -.->|"implements contract"| node_contract
node_mock -.->|"implements contract"| node_contract
node_neighborhood -->|"renders components"| node_ui
node_profile -->|"renders components"| node_ui

click node_auth "https://github.com/gs-citizentech-drenaai/drenaai-mobile/blob/main/src/app/login.tsx"
click node_neighborhood "https://github.com/gs-citizentech-drenaai/drenaai-mobile/blob/main/src/app/(abas)/index.tsx"
click node_report "https://github.com/gs-citizentech-drenaai/drenaai-mobile/blob/main/src/app/(abas)/denunciar.tsx"
click node_received "https://github.com/gs-citizentech-drenaai/drenaai-mobile/blob/main/src/app/recebida/%5Bid%5D.tsx"
click node_tracking "https://github.com/gs-citizentech-drenaai/drenaai-mobile/blob/main/src/app/ocorrencia/%5Bid%5D.tsx"
click node_map "https://github.com/gs-citizentech-drenaai/drenaai-mobile/blob/main/src/app/(abas)/mapa.tsx"
click node_profile "https://github.com/gs-citizentech-drenaai/drenaai-mobile/blob/main/src/app/perfil.tsx"
click node_session "https://github.com/gs-citizentech-drenaai/drenaai-mobile/blob/main/src/estado/SessaoContext.tsx"
click node_preferences "https://github.com/gs-citizentech-drenaai/drenaai-mobile/blob/main/src/estado/PreferenciasContext.tsx"
click node_repo "https://github.com/gs-citizentech-drenaai/drenaai-mobile/blob/main/src/dados/repo.ts"
click node_contract "https://github.com/gs-citizentech-drenaai/drenaai-mobile/blob/main/src/dados/DrenaRepo.ts"
click node_api "https://github.com/gs-citizentech-drenaai/drenaai-mobile/blob/main/src/dados/ApiRepo.ts"
click node_mock "https://github.com/gs-citizentech-drenaai/drenaai-mobile/blob/main/src/dados/mock/MockRepo.ts"
click node_types "https://github.com/gs-citizentech-drenaai/drenaai-mobile/blob/main/src/dados/tipos.ts"
click node_geo "https://github.com/gs-citizentech-drenaai/drenaai-mobile/blob/main/src/dados/geo.ts"
click node_ui "https://github.com/gs-citizentech-drenaai/drenaai-mobile/tree/main/src/ui"

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_auth,node_neighborhood,node_report,node_received,node_tracking,node_map,node_profile toneBlue
class node_repo,node_contract,node_api,node_mock,node_types,node_geo,node_oracle toneAmber
class node_session,node_preferences,node_backend toneMint
class node_ui toneRose
class node_resident,node_ai,node_sensors toneIndigo
```

## Components

### Citizen journeys

- [Login and signup](https://github.com/gs-citizentech-drenaai/drenaai-mobile/blob/main/src/app/login.tsx): `src/app/login.tsx`
- [Neighborhood alerts](https://github.com/gs-citizentech-drenaai/drenaai-mobile/blob/main/src/app/(abas)/index.tsx): `src/app/(abas)/index.tsx`
- [Report waste](https://github.com/gs-citizentech-drenaai/drenaai-mobile/blob/main/src/app/(abas)/denunciar.tsx): `src/app/(abas)/denunciar.tsx`
- [Report result](https://github.com/gs-citizentech-drenaai/drenaai-mobile/blob/main/src/app/recebida/%5Bid%5D.tsx): `src/app/recebida/[id].tsx`
- [Report tracking](https://github.com/gs-citizentech-drenaai/drenaai-mobile/blob/main/src/app/ocorrencia/%5Bid%5D.tsx): `src/app/ocorrencia/[id].tsx`
- [Queue and sensors map](https://github.com/gs-citizentech-drenaai/drenaai-mobile/blob/main/src/app/(abas)/mapa.tsx): `src/app/(abas)/mapa.tsx`
- [Profile preferences](https://github.com/gs-citizentech-drenaai/drenaai-mobile/blob/main/src/app/perfil.tsx): `src/app/perfil.tsx`

### Data access

- [Repository selector](https://github.com/gs-citizentech-drenaai/drenaai-mobile/blob/main/src/dados/repo.ts): `src/dados/repo.ts`
- [Repository contract](https://github.com/gs-citizentech-drenaai/drenaai-mobile/blob/main/src/dados/DrenaRepo.ts): `src/dados/DrenaRepo.ts`
- [API adapter](https://github.com/gs-citizentech-drenaai/drenaai-mobile/blob/main/src/dados/ApiRepo.ts): `src/dados/ApiRepo.ts`
- [Demo adapter](https://github.com/gs-citizentech-drenaai/drenaai-mobile/blob/main/src/dados/mock/MockRepo.ts): `src/dados/mock/MockRepo.ts`
- [Domain data types](https://github.com/gs-citizentech-drenaai/drenaai-mobile/blob/main/src/dados/tipos.ts): `src/dados/tipos.ts`
- [Distance calculations](https://github.com/gs-citizentech-drenaai/drenaai-mobile/blob/main/src/dados/geo.ts): `src/dados/geo.ts`

### App state

- [Session context](https://github.com/gs-citizentech-drenaai/drenaai-mobile/blob/main/src/estado/SessaoContext.tsx): `src/estado/SessaoContext.tsx`
- [Preferences context](https://github.com/gs-citizentech-drenaai/drenaai-mobile/blob/main/src/estado/PreferenciasContext.tsx): `src/estado/PreferenciasContext.tsx`

### Shared presentation

- [Shared UI components](https://github.com/gs-citizentech-drenaai/drenaai-mobile/tree/main/src/ui): `src/ui`

### Other components

- **Resident**
- **DrenaAi API**
- **Oracle database**
- **Photo assessment**
- **ESP32 sensors**

## Connections

- Resident → Login and signup: signs in (evidence: `README.md`)
- Resident → Neighborhood alerts: checks alerts (evidence: `README.md`)
- Resident → Report waste: submits report (evidence: `README.md`)
- Resident → Queue and sensors map: views queue (evidence: `README.md`)
- Resident → Profile preferences: sets preferences (evidence: `README.md`)
- Login and signup → Session context: uses session (evidence: `src/app/login.tsx`)
- Session context → Repository selector: calls auth methods (evidence: `src/estado/SessaoContext.tsx`)
- Neighborhood alerts → Repository selector: loads forecast and reports (evidence: `src/app/(abas)/index.tsx`)
- Neighborhood alerts → Distance calculations: calculates nearby distance (evidence: `src/app/(abas)/index.tsx`)
- Report waste → Repository selector: creates report (evidence: `README.md`)
- Report result → Repository selector: loads report result (evidence: `README.md`)
- Report tracking → Repository selector: loads report history (evidence: `README.md`)
- Queue and sensors map → Repository selector: loads queue and telemetry (evidence: `README.md`)
- Profile preferences → Preferences context: updates settings (evidence: `src/app/perfil.tsx`)
- Repository selector → API adapter: selects API mode (evidence: `src/dados/repo.ts`)
- Repository selector → Demo adapter: selects demo mode (evidence: `src/dados/repo.ts`)
- API adapter → DrenaAi API: sends API requests (evidence: `README.md`)
- Demo adapter → Neighborhood alerts: supplies demo data (evidence: `README.md`)
- DrenaAi API → Oracle database: reads and writes (evidence: `README.md`)
- DrenaAi API → Photo assessment: assesses photo severity (evidence: `README.md`)
- ESP32 sensors → DrenaAi API: sends readings (evidence: `README.md`)
- Repository selector → Repository contract: implements contract (evidence: `src/dados/repo.ts`)
- API adapter → Repository contract: implements contract (evidence: `src/dados/ApiRepo.ts`)
- Demo adapter → Repository contract: implements contract
- Neighborhood alerts → Shared UI components: renders components (evidence: `src/app/(abas)/index.tsx`)
- Profile preferences → Shared UI components: renders components (evidence: `src/app/perfil.tsx`)
