How gugah-com-h/agroguardai works
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: MapaPericulosidade.jsx Risk map and results · App.jsx Route shell · ConfirmarLocalizacao.jsx Confirm pin · Localizacao.jsx Choose location
Components 20
Navigation
- Route shell
src/App.jsx - Home
src/pages/Home.jsx - 404 page
src/components/NaoEncontrado.jsx - Error boundary
src/components/ErrorBoundary.jsx
Location selection
- Choose location
src/pages/Localizacao.jsx - Confirm pin
src/pages/ConfirmarLocalizacao.jsx
Risk results
- Risk map and results
src/pages/MapaPericulosidade.jsx - AI message renderer
src/components/Mensagem.jsx
Services and helpers
- Geospatial checks
src/lib/geo.js - AgroGuard API client
src/lib/api.js - Score definitions
src/lib/score.js - Number formatting
src/lib/format.js - Assistant prompt
src/lib/prompt.js - Gemini client
src/lib/gemini.js - Leaflet marker setup
src/lib/leafletIcone.js
Other components
- Visitor
- AgroGuard backend
- OpenStreetMap tiles
- Nominatim geocoder
- Google Gemini
Connections 26
- Visitor → Route shell: opens app
src/App.jsx - Route shell → Home: routes to
src/App.jsx - Route shell → Choose location: routes to
src/App.jsx - Route shell → Confirm pin: routes to
src/App.jsx - Route shell → Risk map and results: routes to
src/App.jsx - Route shell → 404 page: routes to
src/App.jsx - Route shell → Error boundary: wraps routes
src/App.jsx - Choose location → AgroGuard API client: loads municipalities
src/pages/Localizacao.jsx - Choose location → Nominatim geocoder: geocodes address
src/pages/Localizacao.jsx - Choose location → Confirm pin: navigates with pin
src/pages/Localizacao.jsx - Confirm pin → AgroGuard API client: loads state outline
src/pages/ConfirmarLocalizacao.jsx - Confirm pin → Geospatial checks: checks pin bounds
src/pages/ConfirmarLocalizacao.jsx - Confirm pin → Risk map and results: navigates with coordinates
src/pages/ConfirmarLocalizacao.jsx - Confirm pin → OpenStreetMap tiles: loads map tiles
src/pages/ConfirmarLocalizacao.jsx - Confirm pin → Leaflet marker setup: sets marker icons
src/pages/ConfirmarLocalizacao.jsx - Risk map and results → AgroGuard API client: requests municipal score
src/pages/MapaPericulosidade.jsx - AgroGuard API client → AgroGuard backend: sends API requests
README.md - Risk map and results → Assistant prompt: builds assistant context
src/pages/MapaPericulosidade.jsx - Assistant prompt → Number formatting: formats prompt values
src/lib/prompt.js - Risk map and results → Gemini client: sends chat history
src/pages/MapaPericulosidade.jsx - Gemini client → Google Gemini: requests generation
src/lib/gemini.js - Risk map and results → Score definitions: colors score cards
src/pages/MapaPericulosidade.jsx - Risk map and results → Number formatting: formats result values
src/pages/MapaPericulosidade.jsx - Risk map and results → AI message renderer: renders AI replies
src/pages/MapaPericulosidade.jsx - Risk map and results → Leaflet marker setup: sets marker icons
src/pages/MapaPericulosidade.jsx - Risk map and results → OpenStreetMap tiles: loads map tiles