# sainath1754/sainadh-fertilizers-and-pesticides architecture

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

- Interactive diagram: https://gitdiagram.com/sainath1754/sainadh-fertilizers-and-pesticides
- Repository: https://github.com/sainath1754/sainadh-fertilizers-and-pesticides

## Overview

Sainadh Fertilizers is an agriculture storefront paired with a plant-disease advisory service. The principal workflow is: a farmer submits a leaf image, Spring routes the request to the Python service for ViT classification and RAG treatment advice, then returns a structured advisory. Commerce is a separate workflow: browse products, manage a cart, check out, persist an order, and send a receipt. The graph combines sampled calls, SOURCE INDEX references, and README-documented links; unsampled features and integrations are included only where documented, so some edges are omitted.

Main entry points: [`python_ai_service/app.py`](https://github.com/sainath1754/sainadh-fertilizers-and-pesticides/blob/master/python_ai_service/app.py) (Python AI API), [`src/main/java/com/sainadh/fertilizers/service/CartService.java`](https://github.com/sainath1754/sainadh-fertilizers-and-pesticides/blob/master/src/main/java/com/sainadh/fertilizers/service/CartService.java) (Cart operations), [`src/main/java/com/sainadh/fertilizers/repository/UserRepository.java`](https://github.com/sainath1754/sainadh-fertilizers-and-pesticides/blob/master/src/main/java/com/sainadh/fertilizers/repository/UserRepository.java) (User repository), [`src/main/java/com/sainadh/fertilizers/service/OrderService.java`](https://github.com/sainath1754/sainadh-fertilizers-and-pesticides/blob/master/src/main/java/com/sainadh/fertilizers/service/OrderService.java) (Order management)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Web and security"]
  node_webui["Web portal"]
  node_websecurity["Session and API security"]
  node_jwt["JWT authentication<br/>[JwtUtil.java]"]
  node_auth["Account and API auth"]
end

subgraph group_commerce["Commerce"]
  node_store["Store browsing"]
  node_products["Product catalog"]
  node_cart["Cart operations<br/>[CartService.java]"]
  node_checkout["Cart and checkout"]
  node_orders["Order management<br/>[OrderService.java]"]
  node_receipts["Order receipts<br/>[EmailService.java]"]
end

subgraph group_advisory["Plant advisory"]
  node_chatbot["Chatbot and advisor"]
  node_disease["Disease diagnosis route"]
  node_aihttp["AI service client"]
  node_flask["Python AI API<br/>[app.py]"]
  node_preprocess["Image preprocessing<br/>[preprocessing.py]"]
  node_vit["ViT classifier<br/>[vit_model.py]"]
  node_rag["Treatment retrieval<br/>[rag_module.py]"]
  node_config["AI configuration<br/>[config.py]"]
end

subgraph group_data["Persistence and cache"]
  node_users[("User records<br/>[User.java]")]
  node_userrepo["User repository"]
  node_productrepo["Product repository"]
  node_cartrepo["Cart repository"]
  node_orderrepo["Order repository"]
  node_redis[("Redis cache<br/>[RedisConfig.java]")]
end

node_farmer(("Farmer / browser"))
node_mysql[("MySQL database")]
node_mail["Email service"]

node_farmer -->|"uses"| node_webui
node_webui -->|"authenticates through"| node_websecurity
node_webui -->|"browses"| node_store
node_store -->|"requests catalog"| node_products
node_products -->|"queries"| node_productrepo
node_webui -->|"checks out"| node_checkout
node_checkout -->|"manages cart"| node_cart
node_checkout -->|"places order"| node_orders
node_orders -->|"saves order"| node_orderrepo
node_orders -->|"clears cart"| node_cartrepo
node_orders -->|"sends receipt"| node_receipts
node_receipts -->|"sends email"| node_mail
node_cart -->|"reads and writes"| node_cartrepo
node_cart -->|"loads products"| node_productrepo
node_cart -->|"loads users"| node_userrepo
node_cart -->|"caches count"| node_redis
node_webui -->|"signs in"| node_auth
node_auth -->|"issues tokens"| node_jwt
node_auth -->|"looks up users"| node_userrepo
node_websecurity -->|"validates tokens"| node_jwt
node_websecurity -->|"loads account"| node_userrepo
node_userrepo -->|"persists"| node_users
node_productrepo -->|"reads catalog"| node_mysql
node_cartrepo -->|"persists cart"| node_mysql
node_orderrepo -->|"persists orders"| node_mysql
node_userrepo -->|"persists accounts"| node_mysql
node_redis -->|"falls back to"| node_mysql
node_farmer -->|"submits leaf image"| node_disease
node_disease -->|"delegates diagnosis"| node_aihttp
node_chatbot -->|"requests advice"| node_aihttp
node_aihttp -->|"posts image"| node_flask
node_flask -->|"preprocesses image"| node_preprocess
node_flask -->|"runs inference"| node_vit
node_flask -->|"requests treatment"| node_rag
node_rag -->|"uses settings"| node_config
node_flask -->|"loads settings"| node_config
node_flask -->|"returns advisory"| node_disease

click node_websecurity "https://github.com/sainath1754/sainadh-fertilizers-and-pesticides/blob/master/src/main/java/com/sainadh/fertilizers/config/SecurityConfig.java"
click node_jwt "https://github.com/sainath1754/sainadh-fertilizers-and-pesticides/blob/master/src/main/java/com/sainadh/fertilizers/config/JwtUtil.java"
click node_auth "https://github.com/sainath1754/sainadh-fertilizers-and-pesticides/blob/master/src/main/java/com/sainadh/fertilizers/controller/ApiAuthController.java"
click node_store "https://github.com/sainath1754/sainadh-fertilizers-and-pesticides/blob/master/src/main/java/com/sainadh/fertilizers/controller/StoreController.java"
click node_products "https://github.com/sainath1754/sainadh-fertilizers-and-pesticides/blob/master/src/main/java/com/sainadh/fertilizers/service/ProductService.java"
click node_cart "https://github.com/sainath1754/sainadh-fertilizers-and-pesticides/blob/master/src/main/java/com/sainadh/fertilizers/service/CartService.java"
click node_checkout "https://github.com/sainath1754/sainadh-fertilizers-and-pesticides/blob/master/src/main/java/com/sainadh/fertilizers/controller/CartController.java"
click node_orders "https://github.com/sainath1754/sainadh-fertilizers-and-pesticides/blob/master/src/main/java/com/sainadh/fertilizers/service/OrderService.java"
click node_receipts "https://github.com/sainath1754/sainadh-fertilizers-and-pesticides/blob/master/src/main/java/com/sainadh/fertilizers/service/EmailService.java"
click node_chatbot "https://github.com/sainath1754/sainadh-fertilizers-and-pesticides/blob/master/src/main/java/com/sainadh/fertilizers/controller/ChatbotController.java"
click node_disease "https://github.com/sainath1754/sainadh-fertilizers-and-pesticides/blob/master/src/main/java/com/sainadh/fertilizers/controller/PlantDiseaseAdvisorController.java"
click node_aihttp "https://github.com/sainath1754/sainadh-fertilizers-and-pesticides/blob/master/src/main/java/com/sainadh/fertilizers/service/PythonAIService.java"
click node_flask "https://github.com/sainath1754/sainadh-fertilizers-and-pesticides/blob/master/python_ai_service/app.py"
click node_preprocess "https://github.com/sainath1754/sainadh-fertilizers-and-pesticides/blob/master/python_ai_service/utils/preprocessing.py"
click node_vit "https://github.com/sainath1754/sainadh-fertilizers-and-pesticides/blob/master/python_ai_service/models/vit_model.py"
click node_rag "https://github.com/sainath1754/sainadh-fertilizers-and-pesticides/blob/master/python_ai_service/models/rag_module.py"
click node_config "https://github.com/sainath1754/sainadh-fertilizers-and-pesticides/blob/master/python_ai_service/config.py"
click node_users "https://github.com/sainath1754/sainadh-fertilizers-and-pesticides/blob/master/src/main/java/com/sainadh/fertilizers/model/User.java"
click node_userrepo "https://github.com/sainath1754/sainadh-fertilizers-and-pesticides/blob/master/src/main/java/com/sainadh/fertilizers/repository/UserRepository.java"
click node_productrepo "https://github.com/sainath1754/sainadh-fertilizers-and-pesticides/blob/master/src/main/java/com/sainadh/fertilizers/repository/ProductRepository.java"
click node_cartrepo "https://github.com/sainath1754/sainadh-fertilizers-and-pesticides/blob/master/src/main/java/com/sainadh/fertilizers/repository/CartItemRepository.java"
click node_orderrepo "https://github.com/sainath1754/sainadh-fertilizers-and-pesticides/blob/master/src/main/java/com/sainadh/fertilizers/repository/OrderRepository.java"
click node_redis "https://github.com/sainath1754/sainadh-fertilizers-and-pesticides/blob/master/src/main/java/com/sainadh/fertilizers/config/RedisConfig.java"

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_webui,node_websecurity,node_jwt,node_auth,node_farmer toneBlue
class node_store,node_products,node_cart,node_checkout,node_orders,node_receipts,node_mysql toneAmber
class node_chatbot,node_disease,node_aihttp,node_flask,node_preprocess,node_vit,node_rag,node_config toneMint
class node_users,node_userrepo,node_productrepo,node_cartrepo,node_orderrepo,node_redis toneRose
class node_mail toneIndigo
```

## Components

### Web and security

- **Web portal**
- [Session and API security](https://github.com/sainath1754/sainadh-fertilizers-and-pesticides/blob/master/src/main/java/com/sainadh/fertilizers/config/SecurityConfig.java): `src/main/java/com/sainadh/fertilizers/config/SecurityConfig.java`
- [JWT authentication](https://github.com/sainath1754/sainadh-fertilizers-and-pesticides/blob/master/src/main/java/com/sainadh/fertilizers/config/JwtUtil.java): `src/main/java/com/sainadh/fertilizers/config/JwtUtil.java`
- [Account and API auth](https://github.com/sainath1754/sainadh-fertilizers-and-pesticides/blob/master/src/main/java/com/sainadh/fertilizers/controller/ApiAuthController.java): `src/main/java/com/sainadh/fertilizers/controller/ApiAuthController.java`

### Commerce

- [Store browsing](https://github.com/sainath1754/sainadh-fertilizers-and-pesticides/blob/master/src/main/java/com/sainadh/fertilizers/controller/StoreController.java): `src/main/java/com/sainadh/fertilizers/controller/StoreController.java`
- [Product catalog](https://github.com/sainath1754/sainadh-fertilizers-and-pesticides/blob/master/src/main/java/com/sainadh/fertilizers/service/ProductService.java): `src/main/java/com/sainadh/fertilizers/service/ProductService.java`
- [Cart operations](https://github.com/sainath1754/sainadh-fertilizers-and-pesticides/blob/master/src/main/java/com/sainadh/fertilizers/service/CartService.java): `src/main/java/com/sainadh/fertilizers/service/CartService.java`
- [Cart and checkout](https://github.com/sainath1754/sainadh-fertilizers-and-pesticides/blob/master/src/main/java/com/sainadh/fertilizers/controller/CartController.java): `src/main/java/com/sainadh/fertilizers/controller/CartController.java`
- [Order management](https://github.com/sainath1754/sainadh-fertilizers-and-pesticides/blob/master/src/main/java/com/sainadh/fertilizers/service/OrderService.java): `src/main/java/com/sainadh/fertilizers/service/OrderService.java`
- [Order receipts](https://github.com/sainath1754/sainadh-fertilizers-and-pesticides/blob/master/src/main/java/com/sainadh/fertilizers/service/EmailService.java): `src/main/java/com/sainadh/fertilizers/service/EmailService.java`

### Plant advisory

- [Chatbot and advisor](https://github.com/sainath1754/sainadh-fertilizers-and-pesticides/blob/master/src/main/java/com/sainadh/fertilizers/controller/ChatbotController.java): `src/main/java/com/sainadh/fertilizers/controller/ChatbotController.java`
- [Disease diagnosis route](https://github.com/sainath1754/sainadh-fertilizers-and-pesticides/blob/master/src/main/java/com/sainadh/fertilizers/controller/PlantDiseaseAdvisorController.java): `src/main/java/com/sainadh/fertilizers/controller/PlantDiseaseAdvisorController.java`
- [AI service client](https://github.com/sainath1754/sainadh-fertilizers-and-pesticides/blob/master/src/main/java/com/sainadh/fertilizers/service/PythonAIService.java): `src/main/java/com/sainadh/fertilizers/service/PythonAIService.java`
- [Python AI API](https://github.com/sainath1754/sainadh-fertilizers-and-pesticides/blob/master/python_ai_service/app.py): `python_ai_service/app.py`
- [Image preprocessing](https://github.com/sainath1754/sainadh-fertilizers-and-pesticides/blob/master/python_ai_service/utils/preprocessing.py): `python_ai_service/utils/preprocessing.py`
- [ViT classifier](https://github.com/sainath1754/sainadh-fertilizers-and-pesticides/blob/master/python_ai_service/models/vit_model.py): `python_ai_service/models/vit_model.py`
- [Treatment retrieval](https://github.com/sainath1754/sainadh-fertilizers-and-pesticides/blob/master/python_ai_service/models/rag_module.py): `python_ai_service/models/rag_module.py`
- [AI configuration](https://github.com/sainath1754/sainadh-fertilizers-and-pesticides/blob/master/python_ai_service/config.py): `python_ai_service/config.py`

### Persistence and cache

- [User records](https://github.com/sainath1754/sainadh-fertilizers-and-pesticides/blob/master/src/main/java/com/sainadh/fertilizers/model/User.java): `src/main/java/com/sainadh/fertilizers/model/User.java`
- [User repository](https://github.com/sainath1754/sainadh-fertilizers-and-pesticides/blob/master/src/main/java/com/sainadh/fertilizers/repository/UserRepository.java): `src/main/java/com/sainadh/fertilizers/repository/UserRepository.java`
- [Product repository](https://github.com/sainath1754/sainadh-fertilizers-and-pesticides/blob/master/src/main/java/com/sainadh/fertilizers/repository/ProductRepository.java): `src/main/java/com/sainadh/fertilizers/repository/ProductRepository.java`
- [Cart repository](https://github.com/sainath1754/sainadh-fertilizers-and-pesticides/blob/master/src/main/java/com/sainadh/fertilizers/repository/CartItemRepository.java): `src/main/java/com/sainadh/fertilizers/repository/CartItemRepository.java`
- [Order repository](https://github.com/sainath1754/sainadh-fertilizers-and-pesticides/blob/master/src/main/java/com/sainadh/fertilizers/repository/OrderRepository.java): `src/main/java/com/sainadh/fertilizers/repository/OrderRepository.java`
- [Redis cache](https://github.com/sainath1754/sainadh-fertilizers-and-pesticides/blob/master/src/main/java/com/sainadh/fertilizers/config/RedisConfig.java): `src/main/java/com/sainadh/fertilizers/config/RedisConfig.java`

### Other components

- **Farmer / browser**
- **MySQL database**
- **Email service**

## Connections

- Farmer / browser → Web portal: uses (evidence: `README.md`)
- Web portal → Session and API security: authenticates through (evidence: `README.md`)
- Web portal → Store browsing: browses (evidence: `README.md`)
- Store browsing → Product catalog: requests catalog (evidence: `src/main/java/com/sainadh/fertilizers/controller/StoreController.java`)
- Product catalog → Product repository: queries (evidence: `src/main/java/com/sainadh/fertilizers/service/ProductService.java`)
- Web portal → Cart and checkout: checks out (evidence: `README.md`)
- Cart and checkout → Cart operations: manages cart (evidence: `src/main/java/com/sainadh/fertilizers/controller/CartController.java`)
- Cart and checkout → Order management: places order (evidence: `src/main/java/com/sainadh/fertilizers/controller/CartController.java`)
- Order management → Order repository: saves order (evidence: `src/main/java/com/sainadh/fertilizers/service/OrderService.java`)
- Order management → Cart repository: clears cart (evidence: `src/main/java/com/sainadh/fertilizers/service/OrderService.java`)
- Order management → Order receipts: sends receipt (evidence: `src/main/java/com/sainadh/fertilizers/service/OrderService.java`)
- Order receipts → Email service: sends email (evidence: `src/main/java/com/sainadh/fertilizers/service/EmailService.java`)
- Cart operations → Cart repository: reads and writes (evidence: `src/main/java/com/sainadh/fertilizers/service/CartService.java`)
- Cart operations → Product repository: loads products (evidence: `src/main/java/com/sainadh/fertilizers/service/CartService.java`)
- Cart operations → User repository: loads users (evidence: `src/main/java/com/sainadh/fertilizers/service/CartService.java`)
- Cart operations → Redis cache: caches count (evidence: `src/main/java/com/sainadh/fertilizers/service/CartService.java`)
- Web portal → Account and API auth: signs in (evidence: `README.md`)
- Account and API auth → JWT authentication: issues tokens (evidence: `src/main/java/com/sainadh/fertilizers/controller/ApiAuthController.java`)
- Account and API auth → User repository: looks up users (evidence: `src/main/java/com/sainadh/fertilizers/controller/ApiAuthController.java`)
- Session and API security → JWT authentication: validates tokens (evidence: `README.md`)
- Session and API security → User repository: loads account
- User repository → User records: persists (evidence: `src/main/java/com/sainadh/fertilizers/repository/UserRepository.java`)
- Product repository → MySQL database: reads catalog (evidence: `README.md`)
- Cart repository → MySQL database: persists cart (evidence: `README.md`)
- Order repository → MySQL database: persists orders (evidence: `README.md`)
- User repository → MySQL database: persists accounts (evidence: `README.md`)
- Redis cache → MySQL database: falls back to (evidence: `README.md`)
- Farmer / browser → Disease diagnosis route: submits leaf image (evidence: `README.md`)
- Disease diagnosis route → AI service client: delegates diagnosis (evidence: `README.md`)
- Chatbot and advisor → AI service client: requests advice (evidence: `src/main/java/com/sainadh/fertilizers/controller/ChatbotController.java`)
- AI service client → Python AI API: posts image (evidence: `README.md`)
- Python AI API → Image preprocessing: preprocesses image (evidence: `python_ai_service/app.py`)
- Python AI API → ViT classifier: runs inference (evidence: `python_ai_service/app.py`)
- Python AI API → Treatment retrieval: requests treatment (evidence: `python_ai_service/app.py`)
- Treatment retrieval → AI configuration: uses settings (evidence: `python_ai_service/models/rag_module.py`)
- Python AI API → AI configuration: loads settings (evidence: `python_ai_service/app.py`)
- Python AI API → Disease diagnosis route: returns advisory (evidence: `README.md`)
