# harshpatel57000/farmerexpensetracker architecture

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

## Overview

This is a Spring-based farm management backend, with a Flutter platform shell represented in the tree but no application UI source shown. Its domain covers user sign-up and password/OTP login, village–region–farm setup, crop-cycle tracking, and agro-input and farm-labor expense records. The sampled services show repository-backed operations and some cross-domain lookups; controller links are included only where the source index identifies their service dependencies. The README is empty, so broader capabilities and frontend-to-backend wiring cannot be verified.

Main entry points: [`backend/src/main/java/com/farmer/Login_page/UserService.java`](https://github.com/harshpatel57000/farmerexpensetracker/blob/main/backend/src/main/java/com/farmer/Login_page/UserService.java) (User service), [`backend/src/main/java/com/farmer/Agro_expense/AgroService.java`](https://github.com/harshpatel57000/farmerexpensetracker/blob/main/backend/src/main/java/com/farmer/Agro_expense/AgroService.java) (Agro expenses), [`backend/src/main/java/com/farmer/Farm_expense/FarmExpenseService.java`](https://github.com/harshpatel57000/farmerexpensetracker/blob/main/backend/src/main/java/com/farmer/Farm_expense/FarmExpenseService.java) (Farm expenses), [`backend/src/main/java/com/farmer/Login_page/UserRepository.java`](https://github.com/harshpatel57000/farmerexpensetracker/blob/main/backend/src/main/java/com/farmer/Login_page/UserRepository.java) (User repository)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_identity["Identity"]
  node_user_api["User API"]
  node_user_service["User service<br/>[UserService.java]"]
  node_user_store[("User repository")]
  node_jwt["JWT service<br/>[JwtService.java]"]
  node_email["Email service<br/>[EmailService.java]"]
end

subgraph group_places["Farm locations"]
  node_village_service["Village service"]
  node_village_store[("Village repository")]
  node_region_service["Region service<br/>[RegionService.java]"]
  node_region_store[("Region repository")]
  node_farm_service["Farm service<br/>[FarmService.java]"]
  node_farm_store[("Farm repository")]
end

subgraph group_cultivation["Cultivation"]
  node_crop_service["Crop-cycle service"]
  node_crop_store[("Crop-cycle repository")]
end

subgraph group_expenses["Expense tracking"]
  node_agro_api["Agro API"]
  node_agro_service["Agro expenses<br/>[AgroService.java]"]
  node_agro_contract["Agro data contract<br/>[AgroDTO.java]"]
  node_agro_store[("Agro repository")]
  node_farm_expense_api["Farm-expense API"]
  node_farm_expense_service["Farm expenses"]
  node_farm_expense_contract["Expense data contract"]
  node_farm_expense_store[("Expense repository")]
end

subgraph group_shared["Shared backend"]
  node_errors["Error handling"]
end

node_farmer(("Farmer"))

node_farmer -.->|"uses"| node_user_api
node_user_api -->|"delegates"| node_user_service
node_user_service -->|"reads and saves"| node_user_store
node_user_service -->|"issues token"| node_jwt
node_user_service -->|"sends OTP"| node_email
node_user_service -->|"uses user links"| node_village_store
node_village_service -->|"reads and saves"| node_village_store
node_village_service -->|"updates membership"| node_user_store
node_region_service -->|"loads village"| node_village_store
node_region_service -->|"reads and saves"| node_region_store
node_farm_service -->|"loads region"| node_region_store
node_farm_service -->|"reads and saves"| node_farm_store
node_crop_service -->|"loads farm"| node_farm_store
node_crop_service -->|"reads and saves"| node_crop_store
node_agro_api -->|"delegates"| node_agro_service
node_agro_service -->|"reads and saves"| node_agro_store
node_agro_service -->|"loads owner"| node_user_store
node_agro_service -->|"maps records"| node_agro_contract
node_farm_expense_api -->|"delegates"| node_farm_expense_service
node_farm_expense_service -->|"reads and saves"| node_farm_expense_store
node_farm_expense_service -->|"maps records"| node_farm_expense_contract

click node_user_api "https://github.com/harshpatel57000/farmerexpensetracker/blob/main/backend/src/main/java/com/farmer/Login_page/UserController.java"
click node_user_service "https://github.com/harshpatel57000/farmerexpensetracker/blob/main/backend/src/main/java/com/farmer/Login_page/UserService.java"
click node_user_store "https://github.com/harshpatel57000/farmerexpensetracker/blob/main/backend/src/main/java/com/farmer/Login_page/UserRepository.java"
click node_jwt "https://github.com/harshpatel57000/farmerexpensetracker/blob/main/backend/src/main/java/com/farmer/Login_page/jwt_token/JwtService.java"
click node_email "https://github.com/harshpatel57000/farmerexpensetracker/blob/main/backend/src/main/java/com/farmer/Login_page/EmailService.java"
click node_village_service "https://github.com/harshpatel57000/farmerexpensetracker/blob/main/backend/src/main/java/com/farmer/add_region_page/VillagePage/VillageService.java"
click node_village_store "https://github.com/harshpatel57000/farmerexpensetracker/blob/main/backend/src/main/java/com/farmer/add_region_page/VillagePage/VillageRepository.java"
click node_region_service "https://github.com/harshpatel57000/farmerexpensetracker/blob/main/backend/src/main/java/com/farmer/add_region_page/RegionPage/RegionService.java"
click node_region_store "https://github.com/harshpatel57000/farmerexpensetracker/blob/main/backend/src/main/java/com/farmer/add_region_page/RegionPage/RegionRepository.java"
click node_farm_service "https://github.com/harshpatel57000/farmerexpensetracker/blob/main/backend/src/main/java/com/farmer/add_region_page/FarmPage/FarmService.java"
click node_farm_store "https://github.com/harshpatel57000/farmerexpensetracker/blob/main/backend/src/main/java/com/farmer/add_region_page/FarmPage/FarmRepository.java"
click node_crop_service "https://github.com/harshpatel57000/farmerexpensetracker/blob/main/backend/src/main/java/com/farmer/Farm_expense/CropCycle/CropCycleService.java"
click node_crop_store "https://github.com/harshpatel57000/farmerexpensetracker/blob/main/backend/src/main/java/com/farmer/Farm_expense/CropCycle/CropCycleRepository.java"
click node_agro_api "https://github.com/harshpatel57000/farmerexpensetracker/blob/main/backend/src/main/java/com/farmer/Agro_expense/AgroController.java"
click node_agro_service "https://github.com/harshpatel57000/farmerexpensetracker/blob/main/backend/src/main/java/com/farmer/Agro_expense/AgroService.java"
click node_agro_contract "https://github.com/harshpatel57000/farmerexpensetracker/blob/main/backend/src/main/java/com/farmer/Agro_expense/AgroDTO.java"
click node_agro_store "https://github.com/harshpatel57000/farmerexpensetracker/blob/main/backend/src/main/java/com/farmer/Agro_expense/AgroRepository.java"
click node_farm_expense_api "https://github.com/harshpatel57000/farmerexpensetracker/blob/main/backend/src/main/java/com/farmer/Farm_expense/FarmExpenseController.java"
click node_farm_expense_service "https://github.com/harshpatel57000/farmerexpensetracker/blob/main/backend/src/main/java/com/farmer/Farm_expense/FarmExpenseService.java"
click node_farm_expense_contract "https://github.com/harshpatel57000/farmerexpensetracker/blob/main/backend/src/main/java/com/farmer/Farm_expense/FarmExpenseDTO.java"
click node_farm_expense_store "https://github.com/harshpatel57000/farmerexpensetracker/blob/main/backend/src/main/java/com/farmer/Farm_expense/FarmExpenseRepository.java"
click node_errors "https://github.com/harshpatel57000/farmerexpensetracker/blob/main/backend/src/main/java/com/farmer/exception/GlobleExceptionHandler.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_user_api,node_user_service,node_user_store,node_jwt,node_email toneBlue
class node_village_service,node_village_store,node_region_service,node_region_store,node_farm_service,node_farm_store toneAmber
class node_crop_service,node_crop_store toneMint
class node_agro_api,node_agro_service,node_agro_contract,node_agro_store,node_farm_expense_api,node_farm_expense_service,node_farm_expense_contract,node_farm_expense_store toneRose
class node_errors,node_farmer toneIndigo
```

## Components

### Identity

- [User API](https://github.com/harshpatel57000/farmerexpensetracker/blob/main/backend/src/main/java/com/farmer/Login_page/UserController.java): `backend/src/main/java/com/farmer/Login_page/UserController.java`
- [User service](https://github.com/harshpatel57000/farmerexpensetracker/blob/main/backend/src/main/java/com/farmer/Login_page/UserService.java): `backend/src/main/java/com/farmer/Login_page/UserService.java`
- [User repository](https://github.com/harshpatel57000/farmerexpensetracker/blob/main/backend/src/main/java/com/farmer/Login_page/UserRepository.java): `backend/src/main/java/com/farmer/Login_page/UserRepository.java`
- [JWT service](https://github.com/harshpatel57000/farmerexpensetracker/blob/main/backend/src/main/java/com/farmer/Login_page/jwt_token/JwtService.java): `backend/src/main/java/com/farmer/Login_page/jwt_token/JwtService.java`
- [Email service](https://github.com/harshpatel57000/farmerexpensetracker/blob/main/backend/src/main/java/com/farmer/Login_page/EmailService.java): `backend/src/main/java/com/farmer/Login_page/EmailService.java`

### Farm locations

- [Village service](https://github.com/harshpatel57000/farmerexpensetracker/blob/main/backend/src/main/java/com/farmer/add_region_page/VillagePage/VillageService.java): `backend/src/main/java/com/farmer/add_region_page/VillagePage/VillageService.java`
- [Village repository](https://github.com/harshpatel57000/farmerexpensetracker/blob/main/backend/src/main/java/com/farmer/add_region_page/VillagePage/VillageRepository.java): `backend/src/main/java/com/farmer/add_region_page/VillagePage/VillageRepository.java`
- [Region service](https://github.com/harshpatel57000/farmerexpensetracker/blob/main/backend/src/main/java/com/farmer/add_region_page/RegionPage/RegionService.java): `backend/src/main/java/com/farmer/add_region_page/RegionPage/RegionService.java`
- [Region repository](https://github.com/harshpatel57000/farmerexpensetracker/blob/main/backend/src/main/java/com/farmer/add_region_page/RegionPage/RegionRepository.java): `backend/src/main/java/com/farmer/add_region_page/RegionPage/RegionRepository.java`
- [Farm service](https://github.com/harshpatel57000/farmerexpensetracker/blob/main/backend/src/main/java/com/farmer/add_region_page/FarmPage/FarmService.java): `backend/src/main/java/com/farmer/add_region_page/FarmPage/FarmService.java`
- [Farm repository](https://github.com/harshpatel57000/farmerexpensetracker/blob/main/backend/src/main/java/com/farmer/add_region_page/FarmPage/FarmRepository.java): `backend/src/main/java/com/farmer/add_region_page/FarmPage/FarmRepository.java`

### Cultivation

- [Crop-cycle service](https://github.com/harshpatel57000/farmerexpensetracker/blob/main/backend/src/main/java/com/farmer/Farm_expense/CropCycle/CropCycleService.java): `backend/src/main/java/com/farmer/Farm_expense/CropCycle/CropCycleService.java`
- [Crop-cycle repository](https://github.com/harshpatel57000/farmerexpensetracker/blob/main/backend/src/main/java/com/farmer/Farm_expense/CropCycle/CropCycleRepository.java): `backend/src/main/java/com/farmer/Farm_expense/CropCycle/CropCycleRepository.java`

### Expense tracking

- [Agro API](https://github.com/harshpatel57000/farmerexpensetracker/blob/main/backend/src/main/java/com/farmer/Agro_expense/AgroController.java): `backend/src/main/java/com/farmer/Agro_expense/AgroController.java`
- [Agro expenses](https://github.com/harshpatel57000/farmerexpensetracker/blob/main/backend/src/main/java/com/farmer/Agro_expense/AgroService.java): `backend/src/main/java/com/farmer/Agro_expense/AgroService.java`
- [Agro data contract](https://github.com/harshpatel57000/farmerexpensetracker/blob/main/backend/src/main/java/com/farmer/Agro_expense/AgroDTO.java): `backend/src/main/java/com/farmer/Agro_expense/AgroDTO.java`
- [Agro repository](https://github.com/harshpatel57000/farmerexpensetracker/blob/main/backend/src/main/java/com/farmer/Agro_expense/AgroRepository.java): `backend/src/main/java/com/farmer/Agro_expense/AgroRepository.java`
- [Farm-expense API](https://github.com/harshpatel57000/farmerexpensetracker/blob/main/backend/src/main/java/com/farmer/Farm_expense/FarmExpenseController.java): `backend/src/main/java/com/farmer/Farm_expense/FarmExpenseController.java`
- [Farm expenses](https://github.com/harshpatel57000/farmerexpensetracker/blob/main/backend/src/main/java/com/farmer/Farm_expense/FarmExpenseService.java): `backend/src/main/java/com/farmer/Farm_expense/FarmExpenseService.java`
- [Expense data contract](https://github.com/harshpatel57000/farmerexpensetracker/blob/main/backend/src/main/java/com/farmer/Farm_expense/FarmExpenseDTO.java): `backend/src/main/java/com/farmer/Farm_expense/FarmExpenseDTO.java`
- [Expense repository](https://github.com/harshpatel57000/farmerexpensetracker/blob/main/backend/src/main/java/com/farmer/Farm_expense/FarmExpenseRepository.java): `backend/src/main/java/com/farmer/Farm_expense/FarmExpenseRepository.java`

### Shared backend

- [Error handling](https://github.com/harshpatel57000/farmerexpensetracker/blob/main/backend/src/main/java/com/farmer/exception/GlobleExceptionHandler.java): `backend/src/main/java/com/farmer/exception/GlobleExceptionHandler.java`

### Other components

- **Farmer**

## Connections

- Farmer → User API: uses
- User API → User service: delegates (evidence: `backend/src/main/java/com/farmer/Login_page/UserService.java`)
- User service → User repository: reads and saves (evidence: `backend/src/main/java/com/farmer/Login_page/UserService.java`)
- User service → JWT service: issues token (evidence: `backend/src/main/java/com/farmer/Login_page/UserService.java`)
- User service → Email service: sends OTP (evidence: `backend/src/main/java/com/farmer/Login_page/UserService.java`)
- User service → Village repository: uses user links
- Village service → Village repository: reads and saves (evidence: `backend/src/main/java/com/farmer/add_region_page/VillagePage/VillageService.java`)
- Village service → User repository: updates membership (evidence: `backend/src/main/java/com/farmer/add_region_page/VillagePage/VillageService.java`)
- Region service → Village repository: loads village (evidence: `backend/src/main/java/com/farmer/add_region_page/RegionPage/RegionService.java`)
- Region service → Region repository: reads and saves (evidence: `backend/src/main/java/com/farmer/add_region_page/RegionPage/RegionService.java`)
- Farm service → Region repository: loads region (evidence: `backend/src/main/java/com/farmer/add_region_page/FarmPage/FarmService.java`)
- Farm service → Farm repository: reads and saves (evidence: `backend/src/main/java/com/farmer/add_region_page/FarmPage/FarmService.java`)
- Crop-cycle service → Farm repository: loads farm (evidence: `backend/src/main/java/com/farmer/Farm_expense/CropCycle/CropCycleService.java`)
- Crop-cycle service → Crop-cycle repository: reads and saves (evidence: `backend/src/main/java/com/farmer/Farm_expense/CropCycle/CropCycleService.java`)
- Agro API → Agro expenses: delegates (evidence: `backend/src/main/java/com/farmer/Agro_expense/AgroController.java`)
- Agro expenses → Agro repository: reads and saves (evidence: `backend/src/main/java/com/farmer/Agro_expense/AgroService.java`)
- Agro expenses → User repository: loads owner (evidence: `backend/src/main/java/com/farmer/Agro_expense/AgroService.java`)
- Agro expenses → Agro data contract: maps records (evidence: `backend/src/main/java/com/farmer/Agro_expense/AgroService.java`)
- Farm-expense API → Farm expenses: delegates (evidence: `backend/src/main/java/com/farmer/Farm_expense/FarmExpenseController.java`)
- Farm expenses → Expense repository: reads and saves (evidence: `backend/src/main/java/com/farmer/Farm_expense/FarmExpenseService.java`)
- Farm expenses → Expense data contract: maps records (evidence: `backend/src/main/java/com/farmer/Farm_expense/FarmExpenseService.java`)
