# ashwin-r2/croprecomendation architecture

> Architecture diagram of the GitHub repository ashwin-r2/croprecomendation, 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/ashwin-r2/croprecomendation
- Repository: https://github.com/ashwin-r2/croprecomendation

## Overview

AgriPredict serves two prediction workflows: crop classification and yield regression. Requests pass through Flask routes, server-side validation, and startup-loaded services/models; yield forecasts additionally use historical regional yields and derive production from predicted yield × area. The broader product also includes model training/evaluation, a metrics page, prediction history, and both web and REST interfaces. Some route and storage wiring is documented rather than excerpted, so those edges cite the README; unsampled internals are not inferred.

Main entry points: [`app/routes/web.py`](https://github.com/ashwin-r2/croprecomendation/blob/main/app/routes/web.py) (Web routes), [`src/training/train_yield_model.py`](https://github.com/ashwin-r2/croprecomendation/blob/main/src/training/train_yield_model.py) (Yield model training), [`app/services/yield_service.py`](https://github.com/ashwin-r2/croprecomendation/blob/main/app/services/yield_service.py) (Yield service), [`src/training/train_crop_model.py`](https://github.com/ashwin-r2/croprecomendation/blob/main/src/training/train_crop_model.py) (Crop model training)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_experience["User interfaces"]
  node_webpages["Forms and results"]
  node_performance["Model performance page<br/>[performance.html]"]
  node_browserjs["Browser interactions<br/>[app.js]"]
end

subgraph group_serving["Flask serving"]
  node_web["Web routes<br/>[web.py]"]
  node_api["REST API<br/>[api.py]"]
  node_validator["Input validation<br/>[input_validator.py]"]
  node_cropservice["Crop service<br/>[crop_service.py]"]
  node_yieldservice["Yield service<br/>[yield_service.py]"]
  node_historyservice["History service<br/>[history_service.py]"]
  node_appfactory["App startup<br/>[app.py]"]
end

subgraph group_prediction["Prediction models"]
  node_cropmodel["Crop prediction<br/>[crop_model.py]"]
  node_yieldmodel["Yield prediction<br/>[yield_model.py]"]
  node_historyfeatures["Yield history features<br/>[features.py]"]
end

subgraph group_ml["ML lifecycle"]
  node_croptraining["Crop model training"]
  node_yieldtraining["Yield model training"]
  node_preprocessing["Dataset preprocessing<br/>[preprocessing.py]"]
  node_evaluation["Model evaluation<br/>[metrics.py]"]
  node_settings["ML paths and settings<br/>[settings.py]"]
end

subgraph group_state["Persisted data"]
  node_datasets["Crop and yield datasets"]
  node_artifacts["Saved models and metadata"]
  node_historydb[("Prediction history")]
  node_yieldhistory["Historical yields<br/>[yield_history.csv]"]
end

node_farmer(("Farmer / client"))

node_farmer -->|"submits forms"| node_web
node_farmer -->|"sends JSON"| node_api
node_web -->|"validates inputs"| node_validator
node_web -->|"requests crop"| node_cropservice
node_web -->|"requests forecast"| node_yieldservice
node_api -->|"requests prediction"| node_cropservice
node_api -->|"requests prediction"| node_yieldservice
node_cropservice -->|"validates input"| node_validator
node_cropservice -->|"predicts with"| node_cropmodel
node_yieldservice -->|"validates input"| node_validator
node_yieldservice -->|"predicts with"| node_yieldmodel
node_yieldmodel -->|"adds history features"| node_historyfeatures
node_yieldservice -->|"loads history"| node_yieldhistory
node_web -->|"renders pages"| node_webpages
node_browserjs -.->|"supports forms"| node_webpages
node_web -->|"serves history"| node_historyservice
node_historyservice -->|"reads and writes"| node_historydb
node_web -->|"serves metrics page"| node_performance
node_appfactory -->|"creates at startup"| node_cropservice
node_appfactory -->|"creates at startup"| node_yieldservice
node_appfactory -->|"registers routes"| node_web
node_appfactory -->|"registers routes"| node_api
node_croptraining -->|"uses pipelines"| node_preprocessing
node_croptraining -->|"selects classifier"| node_cropmodel
node_croptraining -->|"computes metrics"| node_evaluation
node_yieldtraining -->|"uses pipelines"| node_preprocessing
node_yieldtraining -->|"selects regressor"| node_yieldmodel
node_yieldtraining -->|"builds features"| node_historyfeatures
node_yieldtraining -->|"computes metrics"| node_evaluation
node_croptraining -->|"trains from data"| node_datasets
node_yieldtraining -->|"trains from data"| node_datasets
node_croptraining -->|"saves model results"| node_artifacts
node_yieldtraining -->|"saves model results"| node_artifacts
node_settings -->|"configures paths"| node_datasets
node_settings -->|"configures paths"| node_artifacts
node_settings -->|"configures path"| node_historydb

click node_web "https://github.com/ashwin-r2/croprecomendation/blob/main/app/routes/web.py"
click node_api "https://github.com/ashwin-r2/croprecomendation/blob/main/app/routes/api.py"
click node_validator "https://github.com/ashwin-r2/croprecomendation/blob/main/app/validators/input_validator.py"
click node_cropservice "https://github.com/ashwin-r2/croprecomendation/blob/main/app/services/crop_service.py"
click node_yieldservice "https://github.com/ashwin-r2/croprecomendation/blob/main/app/services/yield_service.py"
click node_historyservice "https://github.com/ashwin-r2/croprecomendation/blob/main/app/services/history_service.py"
click node_appfactory "https://github.com/ashwin-r2/croprecomendation/blob/main/app/app.py"
click node_cropmodel "https://github.com/ashwin-r2/croprecomendation/blob/main/src/models/crop_model.py"
click node_yieldmodel "https://github.com/ashwin-r2/croprecomendation/blob/main/src/models/yield_model.py"
click node_historyfeatures "https://github.com/ashwin-r2/croprecomendation/blob/main/src/data/features.py"
click node_webpages "https://github.com/ashwin-r2/croprecomendation/tree/main/templates"
click node_performance "https://github.com/ashwin-r2/croprecomendation/blob/main/templates/performance.html"
click node_browserjs "https://github.com/ashwin-r2/croprecomendation/blob/main/static/js/app.js"
click node_croptraining "https://github.com/ashwin-r2/croprecomendation/blob/main/src/training/train_crop_model.py"
click node_yieldtraining "https://github.com/ashwin-r2/croprecomendation/blob/main/src/training/train_yield_model.py"
click node_preprocessing "https://github.com/ashwin-r2/croprecomendation/blob/main/src/data/preprocessing.py"
click node_evaluation "https://github.com/ashwin-r2/croprecomendation/blob/main/src/evaluation/metrics.py"
click node_settings "https://github.com/ashwin-r2/croprecomendation/blob/main/src/settings.py"
click node_datasets "https://github.com/ashwin-r2/croprecomendation/tree/main/data/raw"
click node_artifacts "https://github.com/ashwin-r2/croprecomendation/tree/main/models"
click node_yieldhistory "https://github.com/ashwin-r2/croprecomendation/blob/main/models/yield_history.csv"

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_webpages,node_performance,node_browserjs,node_farmer toneBlue
class node_web,node_api,node_validator,node_cropservice,node_yieldservice,node_historyservice,node_appfactory toneAmber
class node_cropmodel,node_yieldmodel,node_historyfeatures toneMint
class node_croptraining,node_yieldtraining,node_preprocessing,node_evaluation,node_settings toneRose
class node_datasets,node_artifacts,node_historydb,node_yieldhistory toneIndigo
```

## Components

### User interfaces

- [Forms and results](https://github.com/ashwin-r2/croprecomendation/tree/main/templates): `templates`
- [Model performance page](https://github.com/ashwin-r2/croprecomendation/blob/main/templates/performance.html): `templates/performance.html`
- [Browser interactions](https://github.com/ashwin-r2/croprecomendation/blob/main/static/js/app.js): `static/js/app.js`

### Flask serving

- [Web routes](https://github.com/ashwin-r2/croprecomendation/blob/main/app/routes/web.py): `app/routes/web.py`
- [REST API](https://github.com/ashwin-r2/croprecomendation/blob/main/app/routes/api.py): `app/routes/api.py`
- [Input validation](https://github.com/ashwin-r2/croprecomendation/blob/main/app/validators/input_validator.py): `app/validators/input_validator.py`
- [Crop service](https://github.com/ashwin-r2/croprecomendation/blob/main/app/services/crop_service.py): `app/services/crop_service.py`
- [Yield service](https://github.com/ashwin-r2/croprecomendation/blob/main/app/services/yield_service.py): `app/services/yield_service.py`
- [History service](https://github.com/ashwin-r2/croprecomendation/blob/main/app/services/history_service.py): `app/services/history_service.py`
- [App startup](https://github.com/ashwin-r2/croprecomendation/blob/main/app/app.py): `app/app.py`

### Prediction models

- [Crop prediction](https://github.com/ashwin-r2/croprecomendation/blob/main/src/models/crop_model.py): `src/models/crop_model.py`
- [Yield prediction](https://github.com/ashwin-r2/croprecomendation/blob/main/src/models/yield_model.py): `src/models/yield_model.py`
- [Yield history features](https://github.com/ashwin-r2/croprecomendation/blob/main/src/data/features.py): `src/data/features.py`

### ML lifecycle

- [Crop model training](https://github.com/ashwin-r2/croprecomendation/blob/main/src/training/train_crop_model.py): `src/training/train_crop_model.py`
- [Yield model training](https://github.com/ashwin-r2/croprecomendation/blob/main/src/training/train_yield_model.py): `src/training/train_yield_model.py`
- [Dataset preprocessing](https://github.com/ashwin-r2/croprecomendation/blob/main/src/data/preprocessing.py): `src/data/preprocessing.py`
- [Model evaluation](https://github.com/ashwin-r2/croprecomendation/blob/main/src/evaluation/metrics.py): `src/evaluation/metrics.py`
- [ML paths and settings](https://github.com/ashwin-r2/croprecomendation/blob/main/src/settings.py): `src/settings.py`

### Persisted data

- [Crop and yield datasets](https://github.com/ashwin-r2/croprecomendation/tree/main/data/raw): `data/raw`
- [Saved models and metadata](https://github.com/ashwin-r2/croprecomendation/tree/main/models): `models`
- **Prediction history**
- [Historical yields](https://github.com/ashwin-r2/croprecomendation/blob/main/models/yield_history.csv): `models/yield_history.csv`

### Other components

- **Farmer / client**

## Connections

- Farmer / client → Web routes: submits forms (evidence: `README.md`)
- Farmer / client → REST API: sends JSON (evidence: `README.md`)
- Web routes → Input validation: validates inputs (evidence: `README.md`)
- Web routes → Crop service: requests crop (evidence: `README.md`)
- Web routes → Yield service: requests forecast (evidence: `README.md`)
- REST API → Crop service: requests prediction (evidence: `README.md`)
- REST API → Yield service: requests prediction (evidence: `README.md`)
- Crop service → Input validation: validates input (evidence: `app/services/crop_service.py`)
- Crop service → Crop prediction: predicts with (evidence: `app/services/crop_service.py`)
- Yield service → Input validation: validates input (evidence: `app/services/yield_service.py`)
- Yield service → Yield prediction: predicts with (evidence: `app/services/yield_service.py`)
- Yield prediction → Yield history features: adds history features (evidence: `src/models/yield_model.py`)
- Yield service → Historical yields: loads history (evidence: `README.md`)
- Web routes → Forms and results: renders pages (evidence: `README.md`)
- Browser interactions → Forms and results: supports forms
- Web routes → History service: serves history (evidence: `README.md`)
- History service → Prediction history: reads and writes (evidence: `README.md`)
- Web routes → Model performance page: serves metrics page (evidence: `README.md`)
- App startup → Crop service: creates at startup (evidence: `app/app.py`)
- App startup → Yield service: creates at startup (evidence: `app/app.py`)
- App startup → Web routes: registers routes (evidence: `app/app.py`)
- App startup → REST API: registers routes (evidence: `app/app.py`)
- Crop model training → Dataset preprocessing: uses pipelines (evidence: `src/training/train_crop_model.py`)
- Crop model training → Crop prediction: selects classifier (evidence: `src/training/train_crop_model.py`)
- Crop model training → Model evaluation: computes metrics (evidence: `src/training/train_crop_model.py`)
- Yield model training → Dataset preprocessing: uses pipelines (evidence: `src/training/train_yield_model.py`)
- Yield model training → Yield prediction: selects regressor (evidence: `src/training/train_yield_model.py`)
- Yield model training → Yield history features: builds features (evidence: `src/training/train_yield_model.py`)
- Yield model training → Model evaluation: computes metrics (evidence: `src/training/train_yield_model.py`)
- Crop model training → Crop and yield datasets: trains from data (evidence: `README.md`)
- Yield model training → Crop and yield datasets: trains from data (evidence: `README.md`)
- Crop model training → Saved models and metadata: saves model results (evidence: `README.md`)
- Yield model training → Saved models and metadata: saves model results (evidence: `README.md`)
- ML paths and settings → Crop and yield datasets: configures paths (evidence: `src/settings.py`)
- ML paths and settings → Saved models and metadata: configures paths (evidence: `src/settings.py`)
- ML paths and settings → Prediction history: configures path (evidence: `src/settings.py`)
