# gugah-com-h/agroguardai architecture

> Architecture diagram of the GitHub repository gugah-com-h/agroguardai, 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/gugah-com-h/agroguardai
- Repository: https://github.com/gugah-com-h/agroguardai

## Overview

AgroGuard Ai is a React frontend for exploring environmental risk and agricultural suitability by Brazilian municipality. The primary journey is to choose a location (or use geolocation), adjust and confirm its map pin, then view municipal scores and heat-map information and ask an AI assistant to explain the results. The README documents the backend API and major capabilities; sampled excerpts show the main page calls and helpers. The frontend’s map-data API endpoints and some map-layer wiring are not fully shown, so only documented or excerpt-supported relationships are drawn.

Main entry points: [`src/pages/MapaPericulosidade.jsx`](https://github.com/gugah-com-h/agroguardai/blob/main/src/pages/MapaPericulosidade.jsx) (Risk map and results), [`src/App.jsx`](https://github.com/gugah-com-h/agroguardai/blob/main/src/App.jsx) (Route shell), [`src/pages/ConfirmarLocalizacao.jsx`](https://github.com/gugah-com-h/agroguardai/blob/main/src/pages/ConfirmarLocalizacao.jsx) (Confirm pin), [`src/pages/Localizacao.jsx`](https://github.com/gugah-com-h/agroguardai/blob/main/src/pages/Localizacao.jsx) (Choose location)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_navigation["Navigation"]
  node_app["Route shell<br/>[App.jsx]"]
  node_home["Home<br/>[Home.jsx]"]
  node_notfound["404 page<br/>[NaoEncontrado.jsx]"]
  node_errorboundary["Error boundary<br/>[ErrorBoundary.jsx]"]
end

subgraph group_location["Location selection"]
  node_location_page["Choose location<br/>[Localizacao.jsx]"]
  node_confirm["Confirm pin"]
end

subgraph group_results["Risk results"]
  node_result["Risk map and results"]
  node_message["AI message renderer<br/>[Mensagem.jsx]"]
end

subgraph group_services["Services and helpers"]
  node_geo["Geospatial checks<br/>[geo.js]"]
  node_api["AgroGuard API client<br/>[api.js]"]
  node_score["Score definitions<br/>[score.js]"]
  node_format["Number formatting<br/>[format.js]"]
  node_prompt["Assistant prompt<br/>[prompt.js]"]
  node_gemini_client["Gemini client<br/>[gemini.js]"]
  node_leaflet_icon["Leaflet marker setup<br/>[leafletIcone.js]"]
end

node_user(("Visitor"))
node_backend["AgroGuard backend"]
node_osm["OpenStreetMap tiles"]
node_nominatim["Nominatim geocoder"]
node_gemini_service["Google Gemini"]

node_user -->|"opens app"| node_app
node_app -->|"routes to"| node_home
node_app -->|"routes to"| node_location_page
node_app -->|"routes to"| node_confirm
node_app -->|"routes to"| node_result
node_app -->|"routes to"| node_notfound
node_app -->|"wraps routes"| node_errorboundary
node_location_page -->|"loads municipalities"| node_api
node_location_page -->|"geocodes address"| node_nominatim
node_location_page -->|"navigates with pin"| node_confirm
node_confirm -->|"loads state outline"| node_api
node_confirm -->|"checks pin bounds"| node_geo
node_confirm -->|"navigates with coordinates"| node_result
node_confirm -->|"loads map tiles"| node_osm
node_confirm -->|"sets marker icons"| node_leaflet_icon
node_result -->|"requests municipal score"| node_api
node_api -->|"sends API requests"| node_backend
node_result -->|"builds assistant context"| node_prompt
node_prompt -->|"formats prompt values"| node_format
node_result -->|"sends chat history"| node_gemini_client
node_gemini_client -->|"requests generation"| node_gemini_service
node_result -->|"colors score cards"| node_score
node_result -->|"formats result values"| node_format
node_result -->|"renders AI replies"| node_message
node_result -->|"sets marker icons"| node_leaflet_icon
node_result -.->|"loads map tiles"| node_osm

click node_app "https://github.com/gugah-com-h/agroguardai/blob/main/src/App.jsx"
click node_home "https://github.com/gugah-com-h/agroguardai/blob/main/src/pages/Home.jsx"
click node_notfound "https://github.com/gugah-com-h/agroguardai/blob/main/src/components/NaoEncontrado.jsx"
click node_errorboundary "https://github.com/gugah-com-h/agroguardai/blob/main/src/components/ErrorBoundary.jsx"
click node_location_page "https://github.com/gugah-com-h/agroguardai/blob/main/src/pages/Localizacao.jsx"
click node_confirm "https://github.com/gugah-com-h/agroguardai/blob/main/src/pages/ConfirmarLocalizacao.jsx"
click node_geo "https://github.com/gugah-com-h/agroguardai/blob/main/src/lib/geo.js"
click node_result "https://github.com/gugah-com-h/agroguardai/blob/main/src/pages/MapaPericulosidade.jsx"
click node_message "https://github.com/gugah-com-h/agroguardai/blob/main/src/components/Mensagem.jsx"
click node_api "https://github.com/gugah-com-h/agroguardai/blob/main/src/lib/api.js"
click node_score "https://github.com/gugah-com-h/agroguardai/blob/main/src/lib/score.js"
click node_format "https://github.com/gugah-com-h/agroguardai/blob/main/src/lib/format.js"
click node_prompt "https://github.com/gugah-com-h/agroguardai/blob/main/src/lib/prompt.js"
click node_gemini_client "https://github.com/gugah-com-h/agroguardai/blob/main/src/lib/gemini.js"
click node_leaflet_icon "https://github.com/gugah-com-h/agroguardai/blob/main/src/lib/leafletIcone.js"

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_home,node_notfound,node_errorboundary toneBlue
class node_location_page,node_confirm toneAmber
class node_result,node_message toneMint
class node_geo,node_api,node_score,node_format,node_prompt,node_gemini_client,node_leaflet_icon toneRose
class node_user,node_backend,node_osm,node_nominatim,node_gemini_service toneIndigo
```

## Components

### Navigation

- [Route shell](https://github.com/gugah-com-h/agroguardai/blob/main/src/App.jsx): `src/App.jsx`
- [Home](https://github.com/gugah-com-h/agroguardai/blob/main/src/pages/Home.jsx): `src/pages/Home.jsx`
- [404 page](https://github.com/gugah-com-h/agroguardai/blob/main/src/components/NaoEncontrado.jsx): `src/components/NaoEncontrado.jsx`
- [Error boundary](https://github.com/gugah-com-h/agroguardai/blob/main/src/components/ErrorBoundary.jsx): `src/components/ErrorBoundary.jsx`

### Location selection

- [Choose location](https://github.com/gugah-com-h/agroguardai/blob/main/src/pages/Localizacao.jsx): `src/pages/Localizacao.jsx`
- [Confirm pin](https://github.com/gugah-com-h/agroguardai/blob/main/src/pages/ConfirmarLocalizacao.jsx): `src/pages/ConfirmarLocalizacao.jsx`

### Risk results

- [Risk map and results](https://github.com/gugah-com-h/agroguardai/blob/main/src/pages/MapaPericulosidade.jsx): `src/pages/MapaPericulosidade.jsx`
- [AI message renderer](https://github.com/gugah-com-h/agroguardai/blob/main/src/components/Mensagem.jsx): `src/components/Mensagem.jsx`

### Services and helpers

- [Geospatial checks](https://github.com/gugah-com-h/agroguardai/blob/main/src/lib/geo.js): `src/lib/geo.js`
- [AgroGuard API client](https://github.com/gugah-com-h/agroguardai/blob/main/src/lib/api.js): `src/lib/api.js`
- [Score definitions](https://github.com/gugah-com-h/agroguardai/blob/main/src/lib/score.js): `src/lib/score.js`
- [Number formatting](https://github.com/gugah-com-h/agroguardai/blob/main/src/lib/format.js): `src/lib/format.js`
- [Assistant prompt](https://github.com/gugah-com-h/agroguardai/blob/main/src/lib/prompt.js): `src/lib/prompt.js`
- [Gemini client](https://github.com/gugah-com-h/agroguardai/blob/main/src/lib/gemini.js): `src/lib/gemini.js`
- [Leaflet marker setup](https://github.com/gugah-com-h/agroguardai/blob/main/src/lib/leafletIcone.js): `src/lib/leafletIcone.js`

### Other components

- **Visitor**
- **AgroGuard backend**
- **OpenStreetMap tiles**
- **Nominatim geocoder**
- **Google Gemini**

## Connections

- Visitor → Route shell: opens app (evidence: `src/App.jsx`)
- Route shell → Home: routes to (evidence: `src/App.jsx`)
- Route shell → Choose location: routes to (evidence: `src/App.jsx`)
- Route shell → Confirm pin: routes to (evidence: `src/App.jsx`)
- Route shell → Risk map and results: routes to (evidence: `src/App.jsx`)
- Route shell → 404 page: routes to (evidence: `src/App.jsx`)
- Route shell → Error boundary: wraps routes (evidence: `src/App.jsx`)
- Choose location → AgroGuard API client: loads municipalities (evidence: `src/pages/Localizacao.jsx`)
- Choose location → Nominatim geocoder: geocodes address (evidence: `src/pages/Localizacao.jsx`)
- Choose location → Confirm pin: navigates with pin (evidence: `src/pages/Localizacao.jsx`)
- Confirm pin → AgroGuard API client: loads state outline (evidence: `src/pages/ConfirmarLocalizacao.jsx`)
- Confirm pin → Geospatial checks: checks pin bounds (evidence: `src/pages/ConfirmarLocalizacao.jsx`)
- Confirm pin → Risk map and results: navigates with coordinates (evidence: `src/pages/ConfirmarLocalizacao.jsx`)
- Confirm pin → OpenStreetMap tiles: loads map tiles (evidence: `src/pages/ConfirmarLocalizacao.jsx`)
- Confirm pin → Leaflet marker setup: sets marker icons (evidence: `src/pages/ConfirmarLocalizacao.jsx`)
- Risk map and results → AgroGuard API client: requests municipal score (evidence: `src/pages/MapaPericulosidade.jsx`)
- AgroGuard API client → AgroGuard backend: sends API requests (evidence: `README.md`)
- Risk map and results → Assistant prompt: builds assistant context (evidence: `src/pages/MapaPericulosidade.jsx`)
- Assistant prompt → Number formatting: formats prompt values (evidence: `src/lib/prompt.js`)
- Risk map and results → Gemini client: sends chat history (evidence: `src/pages/MapaPericulosidade.jsx`)
- Gemini client → Google Gemini: requests generation (evidence: `src/lib/gemini.js`)
- Risk map and results → Score definitions: colors score cards (evidence: `src/pages/MapaPericulosidade.jsx`)
- Risk map and results → Number formatting: formats result values (evidence: `src/pages/MapaPericulosidade.jsx`)
- Risk map and results → AI message renderer: renders AI replies (evidence: `src/pages/MapaPericulosidade.jsx`)
- Risk map and results → Leaflet marker setup: sets marker icons (evidence: `src/pages/MapaPericulosidade.jsx`)
- Risk map and results → OpenStreetMap tiles: loads map tiles
