# vikram-04/farmsync architecture

> Architecture diagram of the GitHub repository vikram-04/farmsync, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-17). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/vikram-04/farmsync
- Repository: https://github.com/vikram-04/farmsync

## Overview

FarmSync lets farmers register, create crop cycles, and monitor each cycle’s yield, mandi prices, weather, disease status, and finances. The React client calls an Express API backed by MongoDB; prediction is delegated to separate ML services, while price and weather features use external providers. The graph preserves those product branches and the principal cycle-creation flow. Some route and service details are known only from the source index or README, so unverified service integrations are shown as dashed links.

Main entry points: [`server/src/index.js`](https://github.com/vikram-04/farmsync/blob/master/server/src/index.js) (Express API), [`server/src/models`](https://github.com/vikram-04/farmsync/tree/master/server/src/models) (Farm records), [`client/src/App.jsx`](https://github.com/vikram-04/farmsync/blob/master/client/src/App.jsx) (App routing), [`server/src/routes/cycles.js`](https://github.com/vikram-04/farmsync/blob/master/server/src/routes/cycles.js) (Cycle endpoints)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Farmer app"]
  node_app["App routing<br/>[App.jsx]"]
  node_authui["Sign in / register<br/>[Login.jsx]"]
  node_cycleui["Cycle management<br/>[CreateCycle.jsx]"]
  node_detailui["Cycle dashboard<br/>[CycleDetail.jsx]"]
  node_api_client["API client<br/>[api.js]"]
end

subgraph group_api["Application API"]
  node_server["Express API<br/>[index.js]"]
  node_auth_routes["Authentication<br/>[auth.js]"]
  node_cycle_routes["Cycle endpoints<br/>[cycles.js]"]
  node_insight_routes["Cycle insight endpoints<br/>[cycleData.js]"]
  node_disease_routes["Disease endpoint<br/>[disease.js]"]
  node_reference_routes["Reference data<br/>[meta.js]"]
  node_finance_routes["Finance endpoints<br/>[expenses.js]"]
end

subgraph group_data["Farm data"]
  node_farm_models[("Farm records")]
end

subgraph group_insights["Cycle insights"]
  node_yield_service["Yield adapter<br/>[yieldPrediction.js]"]
  node_price_service["Mandi pricing<br/>[priceService.js]"]
  node_price_api["Price provider adapter<br/>[priceApi.js]"]
  node_weather_service["Weather alerts<br/>[weatherService.js]"]
  node_disease_service["Disease adapter"]
end

subgraph group_ml["Prediction services"]
  node_yield_model["Yield prediction<br/>[app.py]"]
  node_disease_model["Leaf disease detection<br/>[app.py]"]
end

node_farmer(("Farmer"))
node_weather_provider["Open-Meteo"]
node_price_provider["data.gov.in"]

node_farmer -->|"uses"| node_app
node_app -->|"routes to"| node_authui
node_app -->|"routes to"| node_cycleui
node_app -->|"routes to"| node_detailui
node_authui -->|"calls"| node_api_client
node_cycleui -->|"calls"| node_api_client
node_detailui -->|"calls"| node_api_client
node_api_client -->|"sends API requests"| node_server
node_server -->|"mounts"| node_auth_routes
node_server -->|"mounts"| node_cycle_routes
node_server -->|"mounts"| node_insight_routes
node_server -->|"mounts"| node_disease_routes
node_server -->|"mounts"| node_reference_routes
node_server -->|"mounts"| node_finance_routes
node_auth_routes -->|"reads and writes users"| node_farm_models
node_cycle_routes -->|"reads and writes cycles"| node_farm_models
node_cycle_routes -->|"requests estimate"| node_yield_service
node_cycle_routes -->|"updates cycle prices"| node_price_service
node_insight_routes -->|"reads cycle data"| node_farm_models
node_insight_routes -->|"fetches forecast"| node_weather_service
node_disease_routes -->|"stores predictions"| node_farm_models
node_disease_routes -->|"requests detection"| node_disease_service
node_reference_routes -->|"reads reference data"| node_farm_models
node_finance_routes -.->|"stores finance records"| node_farm_models
node_yield_service -.->|"requests prediction"| node_yield_model
node_disease_service -.->|"requests detection"| node_disease_model
node_price_service -->|"reads and writes prices"| node_farm_models
node_price_service -->|"fetches commodity data"| node_price_api
node_price_api -.->|"queries"| node_price_provider
node_weather_service -->|"fetches forecast"| node_weather_provider

click node_app "https://github.com/vikram-04/farmsync/blob/master/client/src/App.jsx"
click node_authui "https://github.com/vikram-04/farmsync/blob/master/client/src/pages/Login.jsx"
click node_cycleui "https://github.com/vikram-04/farmsync/blob/master/client/src/pages/CreateCycle.jsx"
click node_detailui "https://github.com/vikram-04/farmsync/blob/master/client/src/pages/CycleDetail.jsx"
click node_api_client "https://github.com/vikram-04/farmsync/blob/master/client/src/lib/api.js"
click node_server "https://github.com/vikram-04/farmsync/blob/master/server/src/index.js"
click node_auth_routes "https://github.com/vikram-04/farmsync/blob/master/server/src/routes/auth.js"
click node_cycle_routes "https://github.com/vikram-04/farmsync/blob/master/server/src/routes/cycles.js"
click node_insight_routes "https://github.com/vikram-04/farmsync/blob/master/server/src/routes/cycleData.js"
click node_disease_routes "https://github.com/vikram-04/farmsync/blob/master/server/src/routes/disease.js"
click node_reference_routes "https://github.com/vikram-04/farmsync/blob/master/server/src/routes/meta.js"
click node_finance_routes "https://github.com/vikram-04/farmsync/blob/master/server/src/routes/expenses.js"
click node_farm_models "https://github.com/vikram-04/farmsync/tree/master/server/src/models"
click node_yield_service "https://github.com/vikram-04/farmsync/blob/master/server/src/services/yieldPrediction.js"
click node_price_service "https://github.com/vikram-04/farmsync/blob/master/server/src/services/priceService.js"
click node_price_api "https://github.com/vikram-04/farmsync/blob/master/server/src/services/priceApi.js"
click node_weather_service "https://github.com/vikram-04/farmsync/blob/master/server/src/services/weatherService.js"
click node_disease_service "https://github.com/vikram-04/farmsync/blob/master/server/src/services/diseasePrediction.js"
click node_yield_model "https://github.com/vikram-04/farmsync/blob/master/ml_service/yield-prediction/app.py"
click node_disease_model "https://github.com/vikram-04/farmsync/blob/master/ml_service/disease-prediction/app.py"

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_authui,node_cycleui,node_detailui,node_api_client toneBlue
class node_server,node_auth_routes,node_cycle_routes,node_insight_routes,node_disease_routes,node_reference_routes,node_finance_routes toneAmber
class node_farm_models toneMint
class node_yield_service,node_price_service,node_price_api,node_weather_service,node_disease_service toneRose
class node_yield_model,node_disease_model,node_farmer,node_weather_provider,node_price_provider toneIndigo
```

## Components

### Farmer app

- [App routing](https://github.com/vikram-04/farmsync/blob/master/client/src/App.jsx): `client/src/App.jsx`
- [Sign in / register](https://github.com/vikram-04/farmsync/blob/master/client/src/pages/Login.jsx): `client/src/pages/Login.jsx`
- [Cycle management](https://github.com/vikram-04/farmsync/blob/master/client/src/pages/CreateCycle.jsx): `client/src/pages/CreateCycle.jsx`
- [Cycle dashboard](https://github.com/vikram-04/farmsync/blob/master/client/src/pages/CycleDetail.jsx): `client/src/pages/CycleDetail.jsx`
- [API client](https://github.com/vikram-04/farmsync/blob/master/client/src/lib/api.js): `client/src/lib/api.js`

### Application API

- [Express API](https://github.com/vikram-04/farmsync/blob/master/server/src/index.js): `server/src/index.js`
- [Authentication](https://github.com/vikram-04/farmsync/blob/master/server/src/routes/auth.js): `server/src/routes/auth.js`
- [Cycle endpoints](https://github.com/vikram-04/farmsync/blob/master/server/src/routes/cycles.js): `server/src/routes/cycles.js`
- [Cycle insight endpoints](https://github.com/vikram-04/farmsync/blob/master/server/src/routes/cycleData.js): `server/src/routes/cycleData.js`
- [Disease endpoint](https://github.com/vikram-04/farmsync/blob/master/server/src/routes/disease.js): `server/src/routes/disease.js`
- [Reference data](https://github.com/vikram-04/farmsync/blob/master/server/src/routes/meta.js): `server/src/routes/meta.js`
- [Finance endpoints](https://github.com/vikram-04/farmsync/blob/master/server/src/routes/expenses.js): `server/src/routes/expenses.js`

### Farm data

- [Farm records](https://github.com/vikram-04/farmsync/tree/master/server/src/models): `server/src/models`

### Cycle insights

- [Yield adapter](https://github.com/vikram-04/farmsync/blob/master/server/src/services/yieldPrediction.js): `server/src/services/yieldPrediction.js`
- [Mandi pricing](https://github.com/vikram-04/farmsync/blob/master/server/src/services/priceService.js): `server/src/services/priceService.js`
- [Price provider adapter](https://github.com/vikram-04/farmsync/blob/master/server/src/services/priceApi.js): `server/src/services/priceApi.js`
- [Weather alerts](https://github.com/vikram-04/farmsync/blob/master/server/src/services/weatherService.js): `server/src/services/weatherService.js`
- [Disease adapter](https://github.com/vikram-04/farmsync/blob/master/server/src/services/diseasePrediction.js): `server/src/services/diseasePrediction.js`

### Prediction services

- [Yield prediction](https://github.com/vikram-04/farmsync/blob/master/ml_service/yield-prediction/app.py): `ml_service/yield-prediction/app.py`
- [Leaf disease detection](https://github.com/vikram-04/farmsync/blob/master/ml_service/disease-prediction/app.py): `ml_service/disease-prediction/app.py`

### Other components

- **Farmer**
- **Open-Meteo**
- **data.gov.in**

## Connections

- Farmer → App routing: uses (evidence: `README.md`)
- App routing → Sign in / register: routes to (evidence: `client/src/App.jsx`)
- App routing → Cycle management: routes to (evidence: `client/src/App.jsx`)
- App routing → Cycle dashboard: routes to (evidence: `client/src/App.jsx`)
- Sign in / register → API client: calls (evidence: `client/src/pages/Login.jsx`)
- Cycle management → API client: calls (evidence: `client/src/pages/CreateCycle.jsx`)
- Cycle dashboard → API client: calls (evidence: `client/src/pages/CycleDetail.jsx`)
- API client → Express API: sends API requests (evidence: `README.md`)
- Express API → Authentication: mounts (evidence: `server/src/index.js`)
- Express API → Cycle endpoints: mounts (evidence: `server/src/index.js`)
- Express API → Cycle insight endpoints: mounts (evidence: `server/src/index.js`)
- Express API → Disease endpoint: mounts (evidence: `server/src/index.js`)
- Express API → Reference data: mounts (evidence: `server/src/index.js`)
- Express API → Finance endpoints: mounts (evidence: `server/src/index.js`)
- Authentication → Farm records: reads and writes users (evidence: `server/src/routes/auth.js`)
- Cycle endpoints → Farm records: reads and writes cycles (evidence: `server/src/routes/cycles.js`)
- Cycle endpoints → Yield adapter: requests estimate (evidence: `server/src/routes/cycles.js`)
- Cycle endpoints → Mandi pricing: updates cycle prices (evidence: `server/src/routes/cycles.js`)
- Cycle insight endpoints → Farm records: reads cycle data (evidence: `server/src/routes/cycleData.js`)
- Cycle insight endpoints → Weather alerts: fetches forecast (evidence: `server/src/routes/cycleData.js`)
- Disease endpoint → Farm records: stores predictions (evidence: `server/src/routes/disease.js`)
- Disease endpoint → Disease adapter: requests detection (evidence: `server/src/routes/disease.js`)
- Reference data → Farm records: reads reference data (evidence: `server/src/routes/meta.js`)
- Finance endpoints → Farm records: stores finance records
- Yield adapter → Yield prediction: requests prediction
- Disease adapter → Leaf disease detection: requests detection
- Mandi pricing → Farm records: reads and writes prices (evidence: `server/src/services/priceService.js`)
- Mandi pricing → Price provider adapter: fetches commodity data (evidence: `server/src/services/priceService.js`)
- Price provider adapter → data.gov.in: queries
- Weather alerts → Open-Meteo: fetches forecast (evidence: `server/src/services/weatherService.js`)
