# 8029sashank-svg/geofarm_sih architecture

> Architecture diagram of the GitHub repository 8029sashank-svg/geofarm_sih, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-02). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/8029sashank-svg/geofarm_sih
- Repository: https://github.com/8029sashank-svg/geofarm_sih

## Overview

Geo-Farm is a mobile-first field-scout portal for crop disease and pest surveillance. Scouts receive missions, visit fields, collect photo or trap evidence, review simulated AI assistance, verify findings, and submit reports for officer review; reports can sync to a small Express backend. The tree also contains a satellite-data API with demo and Google Earth Engine providers. Edges reflect the documented workflow and shown imports; unsampled UI and ML internals limit finer-grained call relationships.

Main entry points: [`src/scout/ScoutApp.jsx`](https://github.com/8029sashank-svg/geofarm_sih/blob/main/src/scout/ScoutApp.jsx) (Scout app), [`ml/satellite/providers/__init__.py`](https://github.com/8029sashank-svg/geofarm_sih/blob/main/ml/satellite/providers/__init__.py) (Provider registry), [`src/scout/components/FieldVisit.jsx`](https://github.com/8029sashank-svg/geofarm_sih/blob/main/src/scout/components/FieldVisit.jsx) (Field visit), [`ml/satellite/providers/demo_provider.py`](https://github.com/8029sashank-svg/geofarm_sih/blob/main/ml/satellite/providers/demo_provider.py) (Demo provider)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_scout["Scout operations"]
  node_app["App entry<br/>[App.jsx]"]
  node_scout_app["Scout app<br/>[ScoutApp.jsx]"]
  node_scout_state["Scout state<br/>[ScoutContext.jsx]"]
  node_missions["Missions<br/>[Missions.jsx]"]
  node_field_visit["Field visit<br/>[FieldVisit.jsx]"]
  node_ai_assist["AI assistance<br/>[aiSim.js]"]
  node_field_maps["Field maps<br/>[FieldMap.jsx]"]
  node_location["Live location"]
  node_field_guide["Field guide<br/>[FieldGuide.jsx]"]
  node_language["Language support"]
end

subgraph group_reporting["Report sync"]
  node_reports["Scout reports<br/>[Reports.jsx]"]
  node_api_client["Report API client<br/>[api.js]"]
  node_backend["Express API<br/>[server.js]"]
  node_report_store[("JSON report storage")]
end

subgraph group_satellite["Satellite analytics"]
  node_sat_api["Satellite API<br/>[api.py]"]
  node_provider_registry["Provider registry<br/>[__init__.py]"]
  node_provider_base["Provider interface<br/>[base.py]"]
  node_demo_provider["Demo provider<br/>[demo_provider.py]"]
  node_gee_provider["Earth Engine provider<br/>[gee_provider.py]"]
  node_quality["Data quality<br/>[quality.py]"]
  node_aggregation["District aggregation"]
  node_ml_config["Satellite config<br/>[config.py]"]
end

node_scout_actor(("Field scout"))

node_scout_actor -->|"uses"| node_app
node_app -->|"mounts"| node_scout_app
node_scout_app -->|"uses"| node_scout_state
node_scout_app -->|"routes to"| node_missions
node_scout_app -->|"routes to"| node_field_visit
node_scout_app -->|"routes to"| node_reports
node_scout_actor -->|"receives"| node_missions
node_missions -->|"starts visit"| node_field_visit
node_field_visit -.->|"gets preliminary result"| node_ai_assist
node_field_visit -->|"submits findings"| node_reports
node_scout_app -->|"routes to"| node_field_maps
node_field_maps -.->|"uses location"| node_location
node_scout_app -->|"routes to"| node_field_guide
node_scout_state -->|"posts reports"| node_api_client
node_api_client -->|"syncs reports"| node_backend
node_backend -->|"stores reports"| node_report_store
node_scout_app -.->|"uses translations"| node_language
node_sat_api -->|"selects provider"| node_provider_registry
node_provider_registry -->|"exports interface"| node_provider_base
node_provider_registry -->|"exports provider"| node_demo_provider
node_provider_registry -->|"exports provider"| node_gee_provider
node_demo_provider -->|"implements"| node_provider_base
node_gee_provider -->|"implements"| node_provider_base
node_demo_provider -->|"uses checks"| node_quality
node_gee_provider -->|"uses checks"| node_quality
node_sat_api -->|"reads settings"| node_ml_config
node_aggregation -->|"uses provider"| node_demo_provider
node_aggregation -->|"uses registry"| node_provider_registry

click node_app "https://github.com/8029sashank-svg/geofarm_sih/blob/main/src/App.jsx"
click node_scout_app "https://github.com/8029sashank-svg/geofarm_sih/blob/main/src/scout/ScoutApp.jsx"
click node_scout_state "https://github.com/8029sashank-svg/geofarm_sih/blob/main/src/scout/ScoutContext.jsx"
click node_missions "https://github.com/8029sashank-svg/geofarm_sih/blob/main/src/scout/components/Missions.jsx"
click node_field_visit "https://github.com/8029sashank-svg/geofarm_sih/blob/main/src/scout/components/FieldVisit.jsx"
click node_ai_assist "https://github.com/8029sashank-svg/geofarm_sih/blob/main/src/scout/utils/aiSim.js"
click node_field_maps "https://github.com/8029sashank-svg/geofarm_sih/blob/main/src/scout/components/FieldMap.jsx"
click node_location "https://github.com/8029sashank-svg/geofarm_sih/blob/main/src/scout/contexts/livelocationcontext.jsx"
click node_field_guide "https://github.com/8029sashank-svg/geofarm_sih/blob/main/src/scout/components/FieldGuide.jsx"
click node_language "https://github.com/8029sashank-svg/geofarm_sih/blob/main/src/contexts/LanguageContext.jsx"
click node_reports "https://github.com/8029sashank-svg/geofarm_sih/blob/main/src/scout/components/Reports.jsx"
click node_api_client "https://github.com/8029sashank-svg/geofarm_sih/blob/main/src/scout/api.js"
click node_backend "https://github.com/8029sashank-svg/geofarm_sih/blob/main/server/server.js"
click node_report_store "https://github.com/8029sashank-svg/geofarm_sih/tree/main/server/data"
click node_sat_api "https://github.com/8029sashank-svg/geofarm_sih/blob/main/ml/api.py"
click node_provider_registry "https://github.com/8029sashank-svg/geofarm_sih/blob/main/ml/satellite/providers/__init__.py"
click node_provider_base "https://github.com/8029sashank-svg/geofarm_sih/blob/main/ml/satellite/providers/base.py"
click node_demo_provider "https://github.com/8029sashank-svg/geofarm_sih/blob/main/ml/satellite/providers/demo_provider.py"
click node_gee_provider "https://github.com/8029sashank-svg/geofarm_sih/blob/main/ml/satellite/providers/gee_provider.py"
click node_quality "https://github.com/8029sashank-svg/geofarm_sih/blob/main/ml/satellite/processing/quality.py"
click node_aggregation "https://github.com/8029sashank-svg/geofarm_sih/blob/main/ml/satellite/processing/district_aggregation.py"
click node_ml_config "https://github.com/8029sashank-svg/geofarm_sih/blob/main/ml/satellite/config.py"

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_scout_app,node_scout_state,node_missions,node_field_visit,node_ai_assist,node_field_maps,node_location,node_field_guide,node_language toneBlue
class node_reports,node_api_client,node_backend,node_report_store toneAmber
class node_sat_api,node_provider_registry,node_provider_base,node_demo_provider,node_gee_provider,node_quality,node_aggregation,node_ml_config toneMint
class node_scout_actor toneIndigo
```

## Components

### Scout operations

- [App entry](https://github.com/8029sashank-svg/geofarm_sih/blob/main/src/App.jsx): `src/App.jsx`
- [Scout app](https://github.com/8029sashank-svg/geofarm_sih/blob/main/src/scout/ScoutApp.jsx): `src/scout/ScoutApp.jsx`
- [Scout state](https://github.com/8029sashank-svg/geofarm_sih/blob/main/src/scout/ScoutContext.jsx): `src/scout/ScoutContext.jsx`
- [Missions](https://github.com/8029sashank-svg/geofarm_sih/blob/main/src/scout/components/Missions.jsx): `src/scout/components/Missions.jsx`
- [Field visit](https://github.com/8029sashank-svg/geofarm_sih/blob/main/src/scout/components/FieldVisit.jsx): `src/scout/components/FieldVisit.jsx`
- [AI assistance](https://github.com/8029sashank-svg/geofarm_sih/blob/main/src/scout/utils/aiSim.js): `src/scout/utils/aiSim.js`
- [Field maps](https://github.com/8029sashank-svg/geofarm_sih/blob/main/src/scout/components/FieldMap.jsx): `src/scout/components/FieldMap.jsx`
- [Live location](https://github.com/8029sashank-svg/geofarm_sih/blob/main/src/scout/contexts/livelocationcontext.jsx): `src/scout/contexts/livelocationcontext.jsx`
- [Field guide](https://github.com/8029sashank-svg/geofarm_sih/blob/main/src/scout/components/FieldGuide.jsx): `src/scout/components/FieldGuide.jsx`
- [Language support](https://github.com/8029sashank-svg/geofarm_sih/blob/main/src/contexts/LanguageContext.jsx): `src/contexts/LanguageContext.jsx`

### Report sync

- [Scout reports](https://github.com/8029sashank-svg/geofarm_sih/blob/main/src/scout/components/Reports.jsx): `src/scout/components/Reports.jsx`
- [Report API client](https://github.com/8029sashank-svg/geofarm_sih/blob/main/src/scout/api.js): `src/scout/api.js`
- [Express API](https://github.com/8029sashank-svg/geofarm_sih/blob/main/server/server.js): `server/server.js`
- [JSON report storage](https://github.com/8029sashank-svg/geofarm_sih/tree/main/server/data): `server/data`

### Satellite analytics

- [Satellite API](https://github.com/8029sashank-svg/geofarm_sih/blob/main/ml/api.py): `ml/api.py`
- [Provider registry](https://github.com/8029sashank-svg/geofarm_sih/blob/main/ml/satellite/providers/__init__.py): `ml/satellite/providers/__init__.py`
- [Provider interface](https://github.com/8029sashank-svg/geofarm_sih/blob/main/ml/satellite/providers/base.py): `ml/satellite/providers/base.py`
- [Demo provider](https://github.com/8029sashank-svg/geofarm_sih/blob/main/ml/satellite/providers/demo_provider.py): `ml/satellite/providers/demo_provider.py`
- [Earth Engine provider](https://github.com/8029sashank-svg/geofarm_sih/blob/main/ml/satellite/providers/gee_provider.py): `ml/satellite/providers/gee_provider.py`
- [Data quality](https://github.com/8029sashank-svg/geofarm_sih/blob/main/ml/satellite/processing/quality.py): `ml/satellite/processing/quality.py`
- [District aggregation](https://github.com/8029sashank-svg/geofarm_sih/blob/main/ml/satellite/processing/district_aggregation.py): `ml/satellite/processing/district_aggregation.py`
- [Satellite config](https://github.com/8029sashank-svg/geofarm_sih/blob/main/ml/satellite/config.py): `ml/satellite/config.py`

### Other components

- **Field scout**

## Connections

- Field scout → App entry: uses
- App entry → Scout app: mounts (evidence: `src/App.jsx`)
- Scout app → Scout state: uses (evidence: `src/scout/ScoutApp.jsx`)
- Scout app → Missions: routes to (evidence: `src/scout/ScoutApp.jsx`)
- Scout app → Field visit: routes to (evidence: `src/scout/ScoutApp.jsx`)
- Scout app → Scout reports: routes to (evidence: `src/scout/ScoutApp.jsx`)
- Field scout → Missions: receives
- Missions → Field visit: starts visit
- Field visit → AI assistance: gets preliminary result
- Field visit → Scout reports: submits findings
- Scout app → Field maps: routes to (evidence: `src/scout/ScoutApp.jsx`)
- Field maps → Live location: uses location
- Scout app → Field guide: routes to (evidence: `src/scout/ScoutApp.jsx`)
- Scout state → Report API client: posts reports (evidence: `src/scout/ScoutContext.jsx`)
- Report API client → Express API: syncs reports
- Express API → JSON report storage: stores reports
- Scout app → Language support: uses translations
- Satellite API → Provider registry: selects provider (evidence: `ml/api.py`)
- Provider registry → Provider interface: exports interface (evidence: `ml/satellite/providers/__init__.py`)
- Provider registry → Demo provider: exports provider (evidence: `ml/satellite/providers/__init__.py`)
- Provider registry → Earth Engine provider: exports provider (evidence: `ml/satellite/providers/__init__.py`)
- Demo provider → Provider interface: implements (evidence: `ml/satellite/providers/demo_provider.py`)
- Earth Engine provider → Provider interface: implements (evidence: `ml/satellite/providers/gee_provider.py`)
- Demo provider → Data quality: uses checks (evidence: `ml/satellite/providers/demo_provider.py`)
- Earth Engine provider → Data quality: uses checks (evidence: `ml/satellite/providers/gee_provider.py`)
- Satellite API → Satellite config: reads settings (evidence: `ml/api.py`)
- District aggregation → Demo provider: uses provider (evidence: `ml/satellite/processing/district_aggregation.py`)
- District aggregation → Provider registry: uses registry (evidence: `ml/satellite/processing/district_aggregation.py`)
