# gajini-prasanth/smart-agriculture-software-platform architecture

> Architecture diagram of the GitHub repository gajini-prasanth/smart-agriculture-software-platform, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-06). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/gajini-prasanth/smart-agriculture-software-platform
- Repository: https://github.com/gajini-prasanth/smart-agriculture-software-platform

## Overview

Smart Agriculture is a software-only farm decision-support platform. Farmers and experts use the React interface to manage farm data and access crop, disease, weather, market, fertilizer, yield, scheme, and consultation features; administrators manage platform data and audit activity. Requests pass through the Spring API, with agricultural logic in a service layer and persistence in JPA repositories. The README documents an ML microservice; the sampled backend excerpt shows outbound request construction but not its endpoint, so that connection is marked unverified. Several feature implementations were not sampled.

Main entry points: [`frontend/src/App.jsx`](https://github.com/gajini-prasanth/smart-agriculture-software-platform/blob/main/frontend/src/App.jsx) (Application router), [`frontend/src/services/api.js`](https://github.com/gajini-prasanth/smart-agriculture-software-platform/blob/main/frontend/src/services/api.js) (API client), [`backend/src/main/java/com/smartagri/repository`](https://github.com/gajini-prasanth/smart-agriculture-software-platform/tree/main/backend/src/main/java/com/smartagri/repository) (JPA repositories), [`backend/src/main/java/com/smartagri/controller/AgricultureController.java`](https://github.com/gajini-prasanth/smart-agriculture-software-platform/blob/main/backend/src/main/java/com/smartagri/controller/AgricultureController.java) (Agriculture API)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_frontend["Web interface"]
  node_app["Application router<br/>[App.jsx]"]
  node_authstate["Auth context<br/>[AuthContext.jsx]"]
  node_api["API client<br/>[api.js]"]
  node_farmerfeatures["Farm and advisory features"]
  node_diseaseui["Disease diagnosis"]
  node_consultui["Expert consultations"]
  node_adminui["Administration<br/>[AdminDashboard.jsx]"]
end

subgraph group_backend["Backend workflows"]
  node_agcontroller["Agriculture API"]
  node_agservice["Agriculture services"]
  node_admincontroller["Admin API"]
end

subgraph group_security["Identity and access"]
  node_authcontroller["Authentication API"]
  node_authservice["Authentication service<br/>[AuthService.java]"]
  node_jwt["JWT security"]
end

subgraph group_persistence["Domain data"]
  node_repositories["JPA repositories"]
  node_domain["Agriculture records"]
  node_mysql[("MySQL database")]
end

subgraph group_ml["ML inference"]
  node_mlapi["ML inference API<br/>[main.py]"]
  node_predictor["Model prediction<br/>[predictor.py]"]
  node_imageprep["Image preprocessing"]
end

node_farmer(("Farmer"))
node_expert(("Agronomist"))
node_admin(("Administrator"))

node_farmer -->|"uses"| node_app
node_expert -->|"uses"| node_app
node_admin -->|"uses"| node_app
node_app -->|"provides auth"| node_authstate
node_app -->|"routes to"| node_farmerfeatures
node_app -->|"routes to"| node_diseaseui
node_app -->|"routes to"| node_consultui
node_app -->|"routes to"| node_adminui
node_api -->|"HTTP requests"| node_authcontroller
node_api -->|"HTTP requests"| node_agcontroller
node_api -->|"HTTP requests"| node_admincontroller
node_authcontroller -->|"delegates to"| node_authservice
node_authservice -->|"reads and writes"| node_repositories
node_authservice -->|"creates tokens"| node_jwt
node_agcontroller -->|"delegates to"| node_agservice
node_agcontroller -->|"queries records"| node_repositories
node_agservice -->|"reads and writes"| node_repositories
node_admincontroller -->|"manages records"| node_repositories
node_repositories -->|"persists entities"| node_domain
node_repositories -.->|"stores data"| node_mysql
node_agservice -.->|"sends inference data"| node_mlapi
node_mlapi -->|"invokes predictor"| node_predictor
node_predictor -->|"uses preprocessing"| node_imageprep
node_diseaseui -.->|"calls API"| node_api
node_consultui -->|"calls API"| node_api
node_adminui -->|"calls API"| node_api

click node_app "https://github.com/gajini-prasanth/smart-agriculture-software-platform/blob/main/frontend/src/App.jsx"
click node_authstate "https://github.com/gajini-prasanth/smart-agriculture-software-platform/blob/main/frontend/src/utils/AuthContext.jsx"
click node_api "https://github.com/gajini-prasanth/smart-agriculture-software-platform/blob/main/frontend/src/services/api.js"
click node_farmerfeatures "https://github.com/gajini-prasanth/smart-agriculture-software-platform/tree/main/frontend/src/pages"
click node_diseaseui "https://github.com/gajini-prasanth/smart-agriculture-software-platform/blob/main/frontend/src/pages/DiseaseDetection.jsx"
click node_consultui "https://github.com/gajini-prasanth/smart-agriculture-software-platform/blob/main/frontend/src/pages/ExpertConsultation.jsx"
click node_adminui "https://github.com/gajini-prasanth/smart-agriculture-software-platform/blob/main/frontend/src/pages/AdminDashboard.jsx"
click node_authcontroller "https://github.com/gajini-prasanth/smart-agriculture-software-platform/blob/main/backend/src/main/java/com/smartagri/controller/AuthController.java"
click node_authservice "https://github.com/gajini-prasanth/smart-agriculture-software-platform/blob/main/backend/src/main/java/com/smartagri/service/AuthService.java"
click node_jwt "https://github.com/gajini-prasanth/smart-agriculture-software-platform/blob/main/backend/src/main/java/com/smartagri/security/AuthTokenFilter.java"
click node_agcontroller "https://github.com/gajini-prasanth/smart-agriculture-software-platform/blob/main/backend/src/main/java/com/smartagri/controller/AgricultureController.java"
click node_agservice "https://github.com/gajini-prasanth/smart-agriculture-software-platform/blob/main/backend/src/main/java/com/smartagri/service/AgricultureService.java"
click node_admincontroller "https://github.com/gajini-prasanth/smart-agriculture-software-platform/blob/main/backend/src/main/java/com/smartagri/controller/AdminController.java"
click node_mlapi "https://github.com/gajini-prasanth/smart-agriculture-software-platform/blob/main/ml-service/main.py"
click node_predictor "https://github.com/gajini-prasanth/smart-agriculture-software-platform/blob/main/ml-service/inference/predictor.py"
click node_imageprep "https://github.com/gajini-prasanth/smart-agriculture-software-platform/blob/main/ml-service/preprocessing/image_preprocessor.py"
click node_repositories "https://github.com/gajini-prasanth/smart-agriculture-software-platform/tree/main/backend/src/main/java/com/smartagri/repository"
click node_domain "https://github.com/gajini-prasanth/smart-agriculture-software-platform/tree/main/backend/src/main/java/com/smartagri/entity"

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_authstate,node_api,node_farmerfeatures,node_diseaseui,node_consultui,node_adminui toneBlue
class node_agcontroller,node_agservice,node_admincontroller toneAmber
class node_authcontroller,node_authservice,node_jwt toneMint
class node_repositories,node_domain,node_mysql toneRose
class node_mlapi,node_predictor,node_imageprep,node_farmer,node_expert,node_admin toneIndigo
```

## Components

### Web interface

- [Application router](https://github.com/gajini-prasanth/smart-agriculture-software-platform/blob/main/frontend/src/App.jsx): `frontend/src/App.jsx`
- [Auth context](https://github.com/gajini-prasanth/smart-agriculture-software-platform/blob/main/frontend/src/utils/AuthContext.jsx): `frontend/src/utils/AuthContext.jsx`
- [API client](https://github.com/gajini-prasanth/smart-agriculture-software-platform/blob/main/frontend/src/services/api.js): `frontend/src/services/api.js`
- [Farm and advisory features](https://github.com/gajini-prasanth/smart-agriculture-software-platform/tree/main/frontend/src/pages): `frontend/src/pages`
- [Disease diagnosis](https://github.com/gajini-prasanth/smart-agriculture-software-platform/blob/main/frontend/src/pages/DiseaseDetection.jsx): `frontend/src/pages/DiseaseDetection.jsx`
- [Expert consultations](https://github.com/gajini-prasanth/smart-agriculture-software-platform/blob/main/frontend/src/pages/ExpertConsultation.jsx): `frontend/src/pages/ExpertConsultation.jsx`
- [Administration](https://github.com/gajini-prasanth/smart-agriculture-software-platform/blob/main/frontend/src/pages/AdminDashboard.jsx): `frontend/src/pages/AdminDashboard.jsx`

### Backend workflows

- [Agriculture API](https://github.com/gajini-prasanth/smart-agriculture-software-platform/blob/main/backend/src/main/java/com/smartagri/controller/AgricultureController.java): `backend/src/main/java/com/smartagri/controller/AgricultureController.java`
- [Agriculture services](https://github.com/gajini-prasanth/smart-agriculture-software-platform/blob/main/backend/src/main/java/com/smartagri/service/AgricultureService.java): `backend/src/main/java/com/smartagri/service/AgricultureService.java`
- [Admin API](https://github.com/gajini-prasanth/smart-agriculture-software-platform/blob/main/backend/src/main/java/com/smartagri/controller/AdminController.java): `backend/src/main/java/com/smartagri/controller/AdminController.java`

### Identity and access

- [Authentication API](https://github.com/gajini-prasanth/smart-agriculture-software-platform/blob/main/backend/src/main/java/com/smartagri/controller/AuthController.java): `backend/src/main/java/com/smartagri/controller/AuthController.java`
- [Authentication service](https://github.com/gajini-prasanth/smart-agriculture-software-platform/blob/main/backend/src/main/java/com/smartagri/service/AuthService.java): `backend/src/main/java/com/smartagri/service/AuthService.java`
- [JWT security](https://github.com/gajini-prasanth/smart-agriculture-software-platform/blob/main/backend/src/main/java/com/smartagri/security/AuthTokenFilter.java): `backend/src/main/java/com/smartagri/security/AuthTokenFilter.java`

### Domain data

- [JPA repositories](https://github.com/gajini-prasanth/smart-agriculture-software-platform/tree/main/backend/src/main/java/com/smartagri/repository): `backend/src/main/java/com/smartagri/repository`
- [Agriculture records](https://github.com/gajini-prasanth/smart-agriculture-software-platform/tree/main/backend/src/main/java/com/smartagri/entity): `backend/src/main/java/com/smartagri/entity`
- **MySQL database**

### ML inference

- [ML inference API](https://github.com/gajini-prasanth/smart-agriculture-software-platform/blob/main/ml-service/main.py): `ml-service/main.py`
- [Model prediction](https://github.com/gajini-prasanth/smart-agriculture-software-platform/blob/main/ml-service/inference/predictor.py): `ml-service/inference/predictor.py`
- [Image preprocessing](https://github.com/gajini-prasanth/smart-agriculture-software-platform/blob/main/ml-service/preprocessing/image_preprocessor.py): `ml-service/preprocessing/image_preprocessor.py`

### Other components

- **Farmer**
- **Agronomist**
- **Administrator**

## Connections

- Farmer → Application router: uses (evidence: `README.md`)
- Agronomist → Application router: uses (evidence: `README.md`)
- Administrator → Application router: uses (evidence: `README.md`)
- Application router → Auth context: provides auth (evidence: `frontend/src/App.jsx`)
- Application router → Farm and advisory features: routes to (evidence: `frontend/src/App.jsx`)
- Application router → Disease diagnosis: routes to (evidence: `frontend/src/App.jsx`)
- Application router → Expert consultations: routes to (evidence: `frontend/src/App.jsx`)
- Application router → Administration: routes to (evidence: `frontend/src/App.jsx`)
- API client → Authentication API: HTTP requests (evidence: `frontend/src/services/api.js`)
- API client → Agriculture API: HTTP requests (evidence: `frontend/src/services/api.js`)
- API client → Admin API: HTTP requests (evidence: `frontend/src/services/api.js`)
- Authentication API → Authentication service: delegates to (evidence: `backend/src/main/java/com/smartagri/controller/AuthController.java`)
- Authentication service → JPA repositories: reads and writes (evidence: `backend/src/main/java/com/smartagri/service/AuthService.java`)
- Authentication service → JWT security: creates tokens (evidence: `backend/src/main/java/com/smartagri/service/AuthService.java`)
- Agriculture API → Agriculture services: delegates to (evidence: `backend/src/main/java/com/smartagri/controller/AgricultureController.java`)
- Agriculture API → JPA repositories: queries records (evidence: `backend/src/main/java/com/smartagri/controller/AgricultureController.java`)
- Agriculture services → JPA repositories: reads and writes (evidence: `backend/src/main/java/com/smartagri/service/AgricultureService.java`)
- Admin API → JPA repositories: manages records (evidence: `backend/src/main/java/com/smartagri/controller/AdminController.java`)
- JPA repositories → Agriculture records: persists entities (evidence: `backend/src/main/java/com/smartagri/repository/MarketPriceRepository.java`)
- JPA repositories → MySQL database: stores data (evidence: `README.md`)
- Agriculture services → ML inference API: sends inference data
- ML inference API → Model prediction: invokes predictor (evidence: `ml-service/main.py`)
- Model prediction → Image preprocessing: uses preprocessing (evidence: `ml-service/inference/predictor.py`)
- Disease diagnosis → API client: calls API
- Expert consultations → API client: calls API (evidence: `frontend/src/pages/ExpertConsultation.jsx`)
- Administration → API client: calls API (evidence: `frontend/src/pages/AdminDashboard.jsx`)
