# brunolopaiva/populacaoonline architecture

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

- Interactive diagram: https://gitdiagram.com/brunolopaiva/populacaoonline
- Repository: https://github.com/brunolopaiva/populacaoonline

## Overview

População Online is a Flutter service for residents to submit and track municipal requests and for municipal staff to manage them through a web interface. The resident workflow covers creating a request, attaching evidence and location, then following its status; staff review, prioritize, assign, update, and communicate about requests, with dashboards for effectiveness. The tree identifies the relevant Dart modules, but their source was not excerpted, so links between them rely on README-described capabilities; storage and backend details are not established.

Main entry points: [`lib/mobile/create_step3.dart`](https://github.com/brunolopaiva/populacaoonline/blob/main/lib/mobile/create_step3.dart) (Location and submit), [`lib/widgets/sumary.dart`](https://github.com/brunolopaiva/populacaoonline/blob/main/lib/widgets/sumary.dart) (Effectiveness summary), [`lib/web/web_requests.dart`](https://github.com/brunolopaiva/populacaoonline/blob/main/lib/web/web_requests.dart) (Request management), [`lib/main.dart`](https://github.com/brunolopaiva/populacaoonline/blob/main/lib/main.dart) (Flutter entry)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_resident["Resident app"]
  node_app["Flutter entry<br/>[main.dart]"]
  node_mobilehome["Mobile home<br/>[mobile_home.dart]"]
  node_create1["Request details<br/>[create_step1.dart]"]
  node_create2["Evidence upload<br/>[create_step2.dart]"]
  node_create3["Location and submit<br/>[create_step3.dart]"]
  node_myrequests["My requests<br/>[requestList.dart]"]
  node_requestinfo["Request status<br/>[request_info.dart]"]
  node_help["Help<br/>[help.dart]"]
end

subgraph group_staff["Municipal web"]
  node_webhome["Staff home<br/>[web_home.dart]"]
  node_login["Staff login<br/>[web_login.dart]"]
  node_webrequests["Request management<br/>[web_requests.dart]"]
  node_webinfo["Request details"]
  node_webaction["Request actions"]
end

subgraph group_domain["Request domain"]
  node_requestmodel["Request model<br/>[request.dart]"]
  node_requestdata["Request operations<br/>[requests.dart]"]
end

subgraph group_insights["Dashboards and location"]
  node_summary["Effectiveness summary<br/>[sumary.dart]"]
  node_charts["Charts"]
  node_pie["Status breakdown<br/>[pie_chart.dart]"]
  node_map["Request map<br/>[map.dart]"]
end

node_resident(("Resident"))
node_staffuser(("Municipal staff"))

node_resident -->|"opens app"| node_app
node_app -->|"shows mobile"| node_mobilehome
node_resident -->|"starts request"| node_create1
node_create1 -->|"adds evidence"| node_create2
node_create2 -->|"continues submission"| node_create3
node_create3 -->|"submits request"| node_requestmodel
node_myrequests -->|"tracks status"| node_requestinfo
node_resident -->|"tracks requests"| node_myrequests
node_staffuser -->|"accesses portal"| node_login
node_login -->|"enters interface"| node_webhome
node_webhome -->|"manages requests"| node_webrequests
node_staffuser -->|"reviews requests"| node_webrequests
node_webrequests -->|"views details"| node_webinfo
node_webinfo -->|"updates request"| node_webaction
node_webaction -->|"updates status"| node_requestmodel
node_staffuser -->|"evaluates outcomes"| node_summary
node_summary -->|"presents metrics"| node_charts
node_summary -->|"presents breakdown"| node_pie
node_create3 -->|"shares location"| node_map
node_mobilehome -.->|"offers help"| node_help

click node_app "https://github.com/brunolopaiva/populacaoonline/blob/main/lib/main.dart"
click node_mobilehome "https://github.com/brunolopaiva/populacaoonline/blob/main/lib/mobile/mobile_home.dart"
click node_create1 "https://github.com/brunolopaiva/populacaoonline/blob/main/lib/mobile/create_step1.dart"
click node_create2 "https://github.com/brunolopaiva/populacaoonline/blob/main/lib/mobile/create_step2.dart"
click node_create3 "https://github.com/brunolopaiva/populacaoonline/blob/main/lib/mobile/create_step3.dart"
click node_myrequests "https://github.com/brunolopaiva/populacaoonline/blob/main/lib/mobile/requestList.dart"
click node_requestinfo "https://github.com/brunolopaiva/populacaoonline/blob/main/lib/mobile/request_info.dart"
click node_requestmodel "https://github.com/brunolopaiva/populacaoonline/blob/main/lib/models/request.dart"
click node_requestdata "https://github.com/brunolopaiva/populacaoonline/blob/main/lib/data/requests.dart"
click node_webhome "https://github.com/brunolopaiva/populacaoonline/blob/main/lib/web/web_home.dart"
click node_login "https://github.com/brunolopaiva/populacaoonline/blob/main/lib/web/web_login.dart"
click node_webrequests "https://github.com/brunolopaiva/populacaoonline/blob/main/lib/web/web_requests.dart"
click node_webinfo "https://github.com/brunolopaiva/populacaoonline/blob/main/lib/web/web_request_info.dart"
click node_webaction "https://github.com/brunolopaiva/populacaoonline/blob/main/lib/web/web_add_action.dart"
click node_summary "https://github.com/brunolopaiva/populacaoonline/blob/main/lib/widgets/sumary.dart"
click node_charts "https://github.com/brunolopaiva/populacaoonline/blob/main/lib/widgets/cartesian_chart.dart"
click node_pie "https://github.com/brunolopaiva/populacaoonline/blob/main/lib/widgets/pie_chart.dart"
click node_map "https://github.com/brunolopaiva/populacaoonline/blob/main/lib/widgets/map.dart"
click node_help "https://github.com/brunolopaiva/populacaoonline/blob/main/lib/mobile/help.dart"

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_mobilehome,node_create1,node_create2,node_create3,node_myrequests,node_requestinfo,node_help toneBlue
class node_webhome,node_login,node_webrequests,node_webinfo,node_webaction toneAmber
class node_requestmodel,node_requestdata toneMint
class node_summary,node_charts,node_pie,node_map toneRose
class node_resident,node_staffuser toneIndigo
```

## Components

### Resident app

- [Flutter entry](https://github.com/brunolopaiva/populacaoonline/blob/main/lib/main.dart): `lib/main.dart`
- [Mobile home](https://github.com/brunolopaiva/populacaoonline/blob/main/lib/mobile/mobile_home.dart): `lib/mobile/mobile_home.dart`
- [Request details](https://github.com/brunolopaiva/populacaoonline/blob/main/lib/mobile/create_step1.dart): `lib/mobile/create_step1.dart`
- [Evidence upload](https://github.com/brunolopaiva/populacaoonline/blob/main/lib/mobile/create_step2.dart): `lib/mobile/create_step2.dart`
- [Location and submit](https://github.com/brunolopaiva/populacaoonline/blob/main/lib/mobile/create_step3.dart): `lib/mobile/create_step3.dart`
- [My requests](https://github.com/brunolopaiva/populacaoonline/blob/main/lib/mobile/requestList.dart): `lib/mobile/requestList.dart`
- [Request status](https://github.com/brunolopaiva/populacaoonline/blob/main/lib/mobile/request_info.dart): `lib/mobile/request_info.dart`
- [Help](https://github.com/brunolopaiva/populacaoonline/blob/main/lib/mobile/help.dart): `lib/mobile/help.dart`

### Municipal web

- [Staff home](https://github.com/brunolopaiva/populacaoonline/blob/main/lib/web/web_home.dart): `lib/web/web_home.dart`
- [Staff login](https://github.com/brunolopaiva/populacaoonline/blob/main/lib/web/web_login.dart): `lib/web/web_login.dart`
- [Request management](https://github.com/brunolopaiva/populacaoonline/blob/main/lib/web/web_requests.dart): `lib/web/web_requests.dart`
- [Request details](https://github.com/brunolopaiva/populacaoonline/blob/main/lib/web/web_request_info.dart): `lib/web/web_request_info.dart`
- [Request actions](https://github.com/brunolopaiva/populacaoonline/blob/main/lib/web/web_add_action.dart): `lib/web/web_add_action.dart`

### Request domain

- [Request model](https://github.com/brunolopaiva/populacaoonline/blob/main/lib/models/request.dart): `lib/models/request.dart`
- [Request operations](https://github.com/brunolopaiva/populacaoonline/blob/main/lib/data/requests.dart): `lib/data/requests.dart`

### Dashboards and location

- [Effectiveness summary](https://github.com/brunolopaiva/populacaoonline/blob/main/lib/widgets/sumary.dart): `lib/widgets/sumary.dart`
- [Charts](https://github.com/brunolopaiva/populacaoonline/blob/main/lib/widgets/cartesian_chart.dart): `lib/widgets/cartesian_chart.dart`
- [Status breakdown](https://github.com/brunolopaiva/populacaoonline/blob/main/lib/widgets/pie_chart.dart): `lib/widgets/pie_chart.dart`
- [Request map](https://github.com/brunolopaiva/populacaoonline/blob/main/lib/widgets/map.dart): `lib/widgets/map.dart`

### Other components

- **Resident**
- **Municipal staff**

## Connections

- Resident → Flutter entry: opens app (evidence: `README.md`)
- Flutter entry → Mobile home: shows mobile (evidence: `README.md`)
- Resident → Request details: starts request (evidence: `README.md`)
- Request details → Evidence upload: adds evidence (evidence: `README.md`)
- Evidence upload → Location and submit: continues submission (evidence: `README.md`)
- Location and submit → Request model: submits request (evidence: `README.md`)
- My requests → Request status: tracks status (evidence: `README.md`)
- Resident → My requests: tracks requests (evidence: `README.md`)
- Municipal staff → Staff login: accesses portal (evidence: `README.md`)
- Staff login → Staff home: enters interface (evidence: `README.md`)
- Staff home → Request management: manages requests (evidence: `README.md`)
- Municipal staff → Request management: reviews requests (evidence: `README.md`)
- Request management → Request details: views details (evidence: `README.md`)
- Request details → Request actions: updates request (evidence: `README.md`)
- Request actions → Request model: updates status (evidence: `README.md`)
- Municipal staff → Effectiveness summary: evaluates outcomes (evidence: `README.md`)
- Effectiveness summary → Charts: presents metrics (evidence: `README.md`)
- Effectiveness summary → Status breakdown: presents breakdown (evidence: `README.md`)
- Location and submit → Request map: shares location (evidence: `README.md`)
- Mobile home → Help: offers help
