# kishan-025/agri architecture

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

- Interactive diagram: https://gitdiagram.com/kishan-025/agri
- Repository: https://github.com/kishan-025/agri

## Overview

This repository combines soil-model research assets with a farmer-facing soil fertility application. The principal workflow is farmer sign-in, farm boundary submission, satellite-based fertility checking, and persistence of assessment results. The sampled backend shows the farm and assessment orchestration and its call to a Python service; the AI implementation and frontend source were not excerpted, so their internal behavior and connections are not asserted. Dataset construction and model-training notebooks are present, but their contents were not inspected.

Main entry points: [`capstone/backend-spring/src/main/java/com/agri/soil/service/FarmService.java`](https://github.com/kishan-025/agri/blob/main/capstone/backend-spring/src/main/java/com/agri/soil/service/FarmService.java) (Farm service), [`capstone/frontend/app.js`](https://github.com/kishan-025/agri/blob/main/capstone/frontend/app.js) (Web interface), [`capstone/backend-spring/src/main/java/com/agri/soil/controller/FarmController.java`](https://github.com/kishan-025/agri/blob/main/capstone/backend-spring/src/main/java/com/agri/soil/controller/FarmController.java) (Farm API), [`capstone/backend-spring/src/main/java/com/agri/soil/service/PythonClientService.java`](https://github.com/kishan-025/agri/blob/main/capstone/backend-spring/src/main/java/com/agri/soil/service/PythonClientService.java) (AI service client)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Farmer interface"]
  node_frontend["Web interface<br/>[app.js]"]
end

subgraph group_backend["Application backend"]
  node_auth_api["Authentication API"]
  node_auth_service["Account service<br/>[AuthService.java]"]
  node_farmer_repo["Farmer repository"]
  node_farm_api["Farm API"]
  node_farm_service["Farm service<br/>[FarmService.java]"]
  node_farm_repo["Farm repository"]
  node_assessment_repo["Assessment repository"]
  node_domain_models["Farm and assessment records<br/>[Farm.java]"]
  node_python_client["AI service client"]
end

subgraph group_ai["Fertility analysis"]
  node_ai_service["Fertility analysis service<br/>[app.py]"]
  node_model_files["Trained soil models"]
end

subgraph group_research["Model research"]
  node_dataset_builder["Dataset construction"]
  node_training["Model training and validation"]
  node_ph_tuning["Soil pH tuning"]
end

node_farmer(("Farmer"))
node_database[("PostgreSQL / PostGIS")]

node_farmer -.->|"uses"| node_frontend
node_frontend -.->|"submits requests"| node_auth_api
node_frontend -.->|"submits requests"| node_farm_api
node_auth_api -->|"delegates"| node_auth_service
node_auth_service -->|"reads and saves"| node_farmer_repo
node_farm_api -->|"delegates"| node_farm_service
node_farm_api -->|"starts assessment"| node_python_client
node_farm_service -->|"reads and writes"| node_farm_repo
node_farm_service -->|"loads farmer"| node_farmer_repo
node_farm_service -->|"deletes assessments"| node_assessment_repo
node_python_client -->|"posts farm boundary"| node_ai_service
node_python_client -->|"saves result"| node_assessment_repo
node_farm_repo -.->|"queries farm data"| node_database
node_farmer_repo -.->|"stores accounts"| node_database
node_assessment_repo -.->|"stores assessments"| node_database
node_ai_service -.->|"uses models"| node_model_files

click node_frontend "https://github.com/kishan-025/agri/blob/main/capstone/frontend/app.js"
click node_auth_api "https://github.com/kishan-025/agri/blob/main/capstone/backend-spring/src/main/java/com/agri/soil/controller/AuthController.java"
click node_auth_service "https://github.com/kishan-025/agri/blob/main/capstone/backend-spring/src/main/java/com/agri/soil/service/AuthService.java"
click node_farmer_repo "https://github.com/kishan-025/agri/blob/main/capstone/backend-spring/src/main/java/com/agri/soil/repository/FarmerRepository.java"
click node_farm_api "https://github.com/kishan-025/agri/blob/main/capstone/backend-spring/src/main/java/com/agri/soil/controller/FarmController.java"
click node_farm_service "https://github.com/kishan-025/agri/blob/main/capstone/backend-spring/src/main/java/com/agri/soil/service/FarmService.java"
click node_farm_repo "https://github.com/kishan-025/agri/blob/main/capstone/backend-spring/src/main/java/com/agri/soil/repository/FarmRepository.java"
click node_assessment_repo "https://github.com/kishan-025/agri/blob/main/capstone/backend-spring/src/main/java/com/agri/soil/repository/FertilityAssessmentRepository.java"
click node_domain_models "https://github.com/kishan-025/agri/blob/main/capstone/backend-spring/src/main/java/com/agri/soil/entity/Farm.java"
click node_python_client "https://github.com/kishan-025/agri/blob/main/capstone/backend-spring/src/main/java/com/agri/soil/service/PythonClientService.java"
click node_ai_service "https://github.com/kishan-025/agri/blob/main/capstone/ai-service/app.py"
click node_model_files "https://github.com/kishan-025/agri/blob/main/capstone/ai-service/models/xgboost_Nitrogen.json"
click node_dataset_builder "https://github.com/kishan-025/agri/blob/main/Build_Soil_Dataset_From_Satellite_LUCAS.ipynb"
click node_training "https://github.com/kishan-025/agri/blob/main/Train_XGBoost_Soil_Model_Spatial_CV.ipynb"
click node_ph_tuning "https://github.com/kishan-025/agri/blob/main/Tune_Soil_pH_WandB_Sweep.ipynb"

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_frontend toneBlue
class node_auth_api,node_auth_service,node_farmer_repo,node_farm_api,node_farm_service,node_farm_repo,node_assessment_repo,node_domain_models,node_python_client,node_database toneAmber
class node_ai_service,node_model_files toneMint
class node_dataset_builder,node_training,node_ph_tuning toneRose
class node_farmer toneIndigo
```

## Components

### Farmer interface

- [Web interface](https://github.com/kishan-025/agri/blob/main/capstone/frontend/app.js): `capstone/frontend/app.js`

### Application backend

- [Authentication API](https://github.com/kishan-025/agri/blob/main/capstone/backend-spring/src/main/java/com/agri/soil/controller/AuthController.java): `capstone/backend-spring/src/main/java/com/agri/soil/controller/AuthController.java`
- [Account service](https://github.com/kishan-025/agri/blob/main/capstone/backend-spring/src/main/java/com/agri/soil/service/AuthService.java): `capstone/backend-spring/src/main/java/com/agri/soil/service/AuthService.java`
- [Farmer repository](https://github.com/kishan-025/agri/blob/main/capstone/backend-spring/src/main/java/com/agri/soil/repository/FarmerRepository.java): `capstone/backend-spring/src/main/java/com/agri/soil/repository/FarmerRepository.java`
- [Farm API](https://github.com/kishan-025/agri/blob/main/capstone/backend-spring/src/main/java/com/agri/soil/controller/FarmController.java): `capstone/backend-spring/src/main/java/com/agri/soil/controller/FarmController.java`
- [Farm service](https://github.com/kishan-025/agri/blob/main/capstone/backend-spring/src/main/java/com/agri/soil/service/FarmService.java): `capstone/backend-spring/src/main/java/com/agri/soil/service/FarmService.java`
- [Farm repository](https://github.com/kishan-025/agri/blob/main/capstone/backend-spring/src/main/java/com/agri/soil/repository/FarmRepository.java): `capstone/backend-spring/src/main/java/com/agri/soil/repository/FarmRepository.java`
- [Assessment repository](https://github.com/kishan-025/agri/blob/main/capstone/backend-spring/src/main/java/com/agri/soil/repository/FertilityAssessmentRepository.java): `capstone/backend-spring/src/main/java/com/agri/soil/repository/FertilityAssessmentRepository.java`
- [Farm and assessment records](https://github.com/kishan-025/agri/blob/main/capstone/backend-spring/src/main/java/com/agri/soil/entity/Farm.java): `capstone/backend-spring/src/main/java/com/agri/soil/entity/Farm.java`
- [AI service client](https://github.com/kishan-025/agri/blob/main/capstone/backend-spring/src/main/java/com/agri/soil/service/PythonClientService.java): `capstone/backend-spring/src/main/java/com/agri/soil/service/PythonClientService.java`

### Fertility analysis

- [Fertility analysis service](https://github.com/kishan-025/agri/blob/main/capstone/ai-service/app.py): `capstone/ai-service/app.py`
- [Trained soil models](https://github.com/kishan-025/agri/blob/main/capstone/ai-service/models/xgboost_Nitrogen.json): `capstone/ai-service/models/xgboost_Nitrogen.json`

### Model research

- [Dataset construction](https://github.com/kishan-025/agri/blob/main/Build_Soil_Dataset_From_Satellite_LUCAS.ipynb): `Build_Soil_Dataset_From_Satellite_LUCAS.ipynb`
- [Model training and validation](https://github.com/kishan-025/agri/blob/main/Train_XGBoost_Soil_Model_Spatial_CV.ipynb): `Train_XGBoost_Soil_Model_Spatial_CV.ipynb`
- [Soil pH tuning](https://github.com/kishan-025/agri/blob/main/Tune_Soil_pH_WandB_Sweep.ipynb): `Tune_Soil_pH_WandB_Sweep.ipynb`

### Other components

- **Farmer**
- **PostgreSQL / PostGIS**

## Connections

- Farmer → Web interface: uses
- Web interface → Authentication API: submits requests
- Web interface → Farm API: submits requests
- Authentication API → Account service: delegates (evidence: `capstone/backend-spring/src/main/java/com/agri/soil/controller/AuthController.java`)
- Account service → Farmer repository: reads and saves (evidence: `capstone/backend-spring/src/main/java/com/agri/soil/service/AuthService.java`)
- Farm API → Farm service: delegates (evidence: `capstone/backend-spring/src/main/java/com/agri/soil/controller/FarmController.java`)
- Farm API → AI service client: starts assessment (evidence: `capstone/backend-spring/src/main/java/com/agri/soil/controller/FarmController.java`)
- Farm service → Farm repository: reads and writes (evidence: `capstone/backend-spring/src/main/java/com/agri/soil/service/FarmService.java`)
- Farm service → Farmer repository: loads farmer (evidence: `capstone/backend-spring/src/main/java/com/agri/soil/service/FarmService.java`)
- Farm service → Assessment repository: deletes assessments (evidence: `capstone/backend-spring/src/main/java/com/agri/soil/service/FarmService.java`)
- AI service client → Fertility analysis service: posts farm boundary (evidence: `capstone/backend-spring/src/main/java/com/agri/soil/service/PythonClientService.java`)
- AI service client → Assessment repository: saves result (evidence: `capstone/backend-spring/src/main/java/com/agri/soil/service/PythonClientService.java`)
- Farm repository → PostgreSQL / PostGIS: queries farm data
- Farmer repository → PostgreSQL / PostGIS: stores accounts
- Assessment repository → PostgreSQL / PostGIS: stores assessments
- Fertility analysis service → Trained soil models: uses models
