# surya252006/kisanconnect architecture

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

## Overview

KisanConnect is a direct farmer-to-buyer produce marketplace. Users browse and compare listings, farmers manage inventory, buyers place and track orders, and administrators govern verification and view analytics. The React client uses a shared API/auth layer to reach Express routes and controllers, which operate on MongoDB models and optional Cloudinary image storage. The README documents the major features; some client pages and backend controllers were not sampled, so their internal call relationships are not inferred.

Main entry points: [`client/src/App.jsx`](https://github.com/surya252006/kisanconnect/blob/main/client/src/App.jsx) (React app and routes), [`server/server.js`](https://github.com/surya252006/kisanconnect/blob/main/server/server.js) (Express API), [`client/src/services/api.js`](https://github.com/surya252006/kisanconnect/blob/main/client/src/services/api.js) (API client), [`client/src/context/AuthContext.jsx`](https://github.com/surya252006/kisanconnect/blob/main/client/src/context/AuthContext.jsx) (Session context)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Web client"]
  node_app["React app and routes<br/>[App.jsx]"]
  node_authui["Login and registration<br/>[Login.jsx]"]
  node_authstate["Session context<br/>[AuthContext.jsx]"]
  node_api_client["API client<br/>[api.js]"]
end

subgraph group_commerce["Marketplace and orders"]
  node_home["Home<br/>[Home.jsx]"]
  node_marketplace["Marketplace browsing<br/>[Marketplace.jsx]"]
  node_productdetails["Product details<br/>[ProductDetails.jsx]"]
  node_farmer_listings["Farmer listings<br/>[MyProducts.jsx]"]
  node_buyer_orders["Buyer order views<br/>[MyOrders.jsx]"]
  node_farmer_orders["Farmer order queue<br/>[FarmerOrders.jsx]"]
end

subgraph group_operations["Trust and insights"]
  node_price_ui["Price insights<br/>[PriceInsights.jsx]"]
  node_admin_verify["Verification admin<br/>[Verification.jsx]"]
  node_admin_analytics["Admin analytics<br/>[AdminDashboard.jsx]"]
end

subgraph group_api["API and access"]
  node_backend["Express API<br/>[server.js]"]
  node_auth_routes["Authentication routes<br/>[authRoutes.js]"]
  node_product_routes["Product routes<br/>[productRoutes.js]"]
  node_order_routes["Order routes<br/>[orderRoutes.js]"]
  node_price_routes["Price routes"]
  node_verify_routes["Verification routes"]
  node_analytics_routes["Analytics routes<br/>[analyticsRoutes.js]"]
  node_auth_controller["Authentication logic<br/>[authController.js]"]
  node_product_controller["Listing logic"]
  node_order_controller["Order and logistics logic<br/>[orderController.js]"]
  node_price_controller["Benchmark logic"]
  node_verify_controller["Verification logic"]
  node_analytics_controller["Analytics logic"]
  node_auth_middleware["JWT authentication<br/>[authMiddleware.js]"]
  node_role_middleware["Role authorization<br/>[roleMiddleware.js]"]
end

subgraph group_data["Domain data"]
  node_products[("Product records<br/>[Product.js]")]
  node_orders[("Order records<br/>[Order.js]")]
  node_users[("User records<br/>[User.js]")]
  node_price_records[("Price insights<br/>[PriceInsight.js]")]
end

node_visitor(("Marketplace users"))
node_cloudinary(("Cloudinary storage"))

node_visitor -->|"uses"| node_app
node_app -->|"provides session"| node_authstate
node_app -->|"routes to"| node_home
node_app -->|"routes to"| node_marketplace
node_app -->|"routes to"| node_productdetails
node_app -->|"routes to"| node_farmer_listings
node_app -->|"routes to"| node_buyer_orders
node_app -->|"routes to"| node_farmer_orders
node_app -->|"routes to"| node_price_ui
node_app -->|"routes to"| node_admin_verify
node_app -->|"routes to"| node_admin_analytics
node_authui -->|"authenticates through"| node_authstate
node_authstate -->|"calls"| node_api_client
node_home -->|"reads session"| node_authstate
node_productdetails -->|"requests data"| node_api_client
node_productdetails -->|"reads session"| node_authstate
node_farmer_listings -->|"updates listings"| node_api_client
node_buyer_orders -->|"requests orders"| node_api_client
node_price_ui -->|"requests benchmarks"| node_api_client
node_price_ui -->|"reads session"| node_authstate
node_admin_verify -->|"manages requests"| node_api_client
node_admin_analytics -->|"requests metrics"| node_api_client
node_api_client -->|"REST requests"| node_backend
node_backend -->|"mounts"| node_auth_routes
node_backend -->|"mounts"| node_product_routes
node_backend -->|"mounts"| node_order_routes
node_backend -->|"mounts"| node_price_routes
node_backend -->|"mounts"| node_verify_routes
node_backend -->|"mounts"| node_analytics_routes
node_auth_routes -->|"dispatches"| node_auth_controller
node_product_routes -->|"dispatches"| node_product_controller
node_order_routes -->|"dispatches"| node_order_controller
node_price_routes -->|"dispatches"| node_price_controller
node_verify_routes -->|"dispatches"| node_verify_controller
node_analytics_routes -->|"dispatches"| node_analytics_controller
node_auth_routes -->|"protects routes"| node_auth_middleware
node_product_routes -->|"protects routes"| node_auth_middleware
node_order_routes -->|"protects routes"| node_auth_middleware
node_product_routes -->|"checks roles"| node_role_middleware
node_order_routes -->|"checks roles"| node_role_middleware
node_auth_controller -->|"reads and writes"| node_users
node_auth_middleware -->|"loads user"| node_users
node_product_controller -->|"reads and writes"| node_products
node_product_controller -.->|"uploads images"| node_cloudinary
node_order_controller -->|"checks and adjusts stock"| node_products

click node_app "https://github.com/surya252006/kisanconnect/blob/main/client/src/App.jsx"
click node_authui "https://github.com/surya252006/kisanconnect/blob/main/client/src/pages/auth/Login.jsx"
click node_authstate "https://github.com/surya252006/kisanconnect/blob/main/client/src/context/AuthContext.jsx"
click node_api_client "https://github.com/surya252006/kisanconnect/blob/main/client/src/services/api.js"
click node_home "https://github.com/surya252006/kisanconnect/blob/main/client/src/pages/home/Home.jsx"
click node_marketplace "https://github.com/surya252006/kisanconnect/blob/main/client/src/pages/marketplace/Marketplace.jsx"
click node_productdetails "https://github.com/surya252006/kisanconnect/blob/main/client/src/pages/marketplace/ProductDetails.jsx"
click node_farmer_listings "https://github.com/surya252006/kisanconnect/blob/main/client/src/pages/farmer/MyProducts.jsx"
click node_buyer_orders "https://github.com/surya252006/kisanconnect/blob/main/client/src/pages/orders/MyOrders.jsx"
click node_farmer_orders "https://github.com/surya252006/kisanconnect/blob/main/client/src/pages/farmer/FarmerOrders.jsx"
click node_price_ui "https://github.com/surya252006/kisanconnect/blob/main/client/src/pages/price/PriceInsights.jsx"
click node_admin_verify "https://github.com/surya252006/kisanconnect/blob/main/client/src/pages/admin/Verification.jsx"
click node_admin_analytics "https://github.com/surya252006/kisanconnect/blob/main/client/src/pages/admin/AdminDashboard.jsx"
click node_backend "https://github.com/surya252006/kisanconnect/blob/main/server/server.js"
click node_auth_routes "https://github.com/surya252006/kisanconnect/blob/main/server/routes/authRoutes.js"
click node_product_routes "https://github.com/surya252006/kisanconnect/blob/main/server/routes/productRoutes.js"
click node_order_routes "https://github.com/surya252006/kisanconnect/blob/main/server/routes/orderRoutes.js"
click node_price_routes "https://github.com/surya252006/kisanconnect/blob/main/server/routes/priceInsightRoutes.js"
click node_verify_routes "https://github.com/surya252006/kisanconnect/blob/main/server/routes/verificationRoutes.js"
click node_analytics_routes "https://github.com/surya252006/kisanconnect/blob/main/server/routes/analyticsRoutes.js"
click node_auth_controller "https://github.com/surya252006/kisanconnect/blob/main/server/controllers/authController.js"
click node_product_controller "https://github.com/surya252006/kisanconnect/blob/main/server/controllers/productController.js"
click node_order_controller "https://github.com/surya252006/kisanconnect/blob/main/server/controllers/orderController.js"
click node_price_controller "https://github.com/surya252006/kisanconnect/blob/main/server/controllers/priceInsightController.js"
click node_verify_controller "https://github.com/surya252006/kisanconnect/blob/main/server/controllers/verificationController.js"
click node_analytics_controller "https://github.com/surya252006/kisanconnect/blob/main/server/controllers/analyticsController.js"
click node_auth_middleware "https://github.com/surya252006/kisanconnect/blob/main/server/middleware/authMiddleware.js"
click node_role_middleware "https://github.com/surya252006/kisanconnect/blob/main/server/middleware/roleMiddleware.js"
click node_products "https://github.com/surya252006/kisanconnect/blob/main/server/models/Product.js"
click node_orders "https://github.com/surya252006/kisanconnect/blob/main/server/models/Order.js"
click node_users "https://github.com/surya252006/kisanconnect/blob/main/server/models/User.js"
click node_price_records "https://github.com/surya252006/kisanconnect/blob/main/server/models/PriceInsight.js"

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_authstate,node_api_client,node_visitor toneBlue
class node_home,node_marketplace,node_productdetails,node_farmer_listings,node_buyer_orders,node_farmer_orders,node_cloudinary toneAmber
class node_price_ui,node_admin_verify,node_admin_analytics toneMint
class node_backend,node_auth_routes,node_product_routes,node_order_routes,node_price_routes,node_verify_routes,node_analytics_routes,node_auth_controller,node_product_controller,node_order_controller,node_price_controller,node_verify_controller,node_analytics_controller,node_auth_middleware,node_role_middleware toneRose
class node_products,node_orders,node_users,node_price_records toneIndigo
```

## Components

### Web client

- [React app and routes](https://github.com/surya252006/kisanconnect/blob/main/client/src/App.jsx): `client/src/App.jsx`
- [Login and registration](https://github.com/surya252006/kisanconnect/blob/main/client/src/pages/auth/Login.jsx): `client/src/pages/auth/Login.jsx`
- [Session context](https://github.com/surya252006/kisanconnect/blob/main/client/src/context/AuthContext.jsx): `client/src/context/AuthContext.jsx`
- [API client](https://github.com/surya252006/kisanconnect/blob/main/client/src/services/api.js): `client/src/services/api.js`

### Marketplace and orders

- [Home](https://github.com/surya252006/kisanconnect/blob/main/client/src/pages/home/Home.jsx): `client/src/pages/home/Home.jsx`
- [Marketplace browsing](https://github.com/surya252006/kisanconnect/blob/main/client/src/pages/marketplace/Marketplace.jsx): `client/src/pages/marketplace/Marketplace.jsx`
- [Product details](https://github.com/surya252006/kisanconnect/blob/main/client/src/pages/marketplace/ProductDetails.jsx): `client/src/pages/marketplace/ProductDetails.jsx`
- [Farmer listings](https://github.com/surya252006/kisanconnect/blob/main/client/src/pages/farmer/MyProducts.jsx): `client/src/pages/farmer/MyProducts.jsx`
- [Buyer order views](https://github.com/surya252006/kisanconnect/blob/main/client/src/pages/orders/MyOrders.jsx): `client/src/pages/orders/MyOrders.jsx`
- [Farmer order queue](https://github.com/surya252006/kisanconnect/blob/main/client/src/pages/farmer/FarmerOrders.jsx): `client/src/pages/farmer/FarmerOrders.jsx`

### Trust and insights

- [Price insights](https://github.com/surya252006/kisanconnect/blob/main/client/src/pages/price/PriceInsights.jsx): `client/src/pages/price/PriceInsights.jsx`
- [Verification admin](https://github.com/surya252006/kisanconnect/blob/main/client/src/pages/admin/Verification.jsx): `client/src/pages/admin/Verification.jsx`
- [Admin analytics](https://github.com/surya252006/kisanconnect/blob/main/client/src/pages/admin/AdminDashboard.jsx): `client/src/pages/admin/AdminDashboard.jsx`

### API and access

- [Express API](https://github.com/surya252006/kisanconnect/blob/main/server/server.js): `server/server.js`
- [Authentication routes](https://github.com/surya252006/kisanconnect/blob/main/server/routes/authRoutes.js): `server/routes/authRoutes.js`
- [Product routes](https://github.com/surya252006/kisanconnect/blob/main/server/routes/productRoutes.js): `server/routes/productRoutes.js`
- [Order routes](https://github.com/surya252006/kisanconnect/blob/main/server/routes/orderRoutes.js): `server/routes/orderRoutes.js`
- [Price routes](https://github.com/surya252006/kisanconnect/blob/main/server/routes/priceInsightRoutes.js): `server/routes/priceInsightRoutes.js`
- [Verification routes](https://github.com/surya252006/kisanconnect/blob/main/server/routes/verificationRoutes.js): `server/routes/verificationRoutes.js`
- [Analytics routes](https://github.com/surya252006/kisanconnect/blob/main/server/routes/analyticsRoutes.js): `server/routes/analyticsRoutes.js`
- [Authentication logic](https://github.com/surya252006/kisanconnect/blob/main/server/controllers/authController.js): `server/controllers/authController.js`
- [Listing logic](https://github.com/surya252006/kisanconnect/blob/main/server/controllers/productController.js): `server/controllers/productController.js`
- [Order and logistics logic](https://github.com/surya252006/kisanconnect/blob/main/server/controllers/orderController.js): `server/controllers/orderController.js`
- [Benchmark logic](https://github.com/surya252006/kisanconnect/blob/main/server/controllers/priceInsightController.js): `server/controllers/priceInsightController.js`
- [Verification logic](https://github.com/surya252006/kisanconnect/blob/main/server/controllers/verificationController.js): `server/controllers/verificationController.js`
- [Analytics logic](https://github.com/surya252006/kisanconnect/blob/main/server/controllers/analyticsController.js): `server/controllers/analyticsController.js`
- [JWT authentication](https://github.com/surya252006/kisanconnect/blob/main/server/middleware/authMiddleware.js): `server/middleware/authMiddleware.js`
- [Role authorization](https://github.com/surya252006/kisanconnect/blob/main/server/middleware/roleMiddleware.js): `server/middleware/roleMiddleware.js`

### Domain data

- [Product records](https://github.com/surya252006/kisanconnect/blob/main/server/models/Product.js): `server/models/Product.js`
- [Order records](https://github.com/surya252006/kisanconnect/blob/main/server/models/Order.js): `server/models/Order.js`
- [User records](https://github.com/surya252006/kisanconnect/blob/main/server/models/User.js): `server/models/User.js`
- [Price insights](https://github.com/surya252006/kisanconnect/blob/main/server/models/PriceInsight.js): `server/models/PriceInsight.js`

### Other components

- **Marketplace users**
- **Cloudinary storage**

## Connections

- Marketplace users → React app and routes: uses
- React app and routes → Session context: provides session (evidence: `client/src/App.jsx`)
- React app and routes → Home: routes to (evidence: `client/src/App.jsx`)
- React app and routes → Marketplace browsing: routes to (evidence: `client/src/App.jsx`)
- React app and routes → Product details: routes to (evidence: `client/src/App.jsx`)
- React app and routes → Farmer listings: routes to (evidence: `client/src/App.jsx`)
- React app and routes → Buyer order views: routes to (evidence: `client/src/App.jsx`)
- React app and routes → Farmer order queue: routes to (evidence: `client/src/App.jsx`)
- React app and routes → Price insights: routes to (evidence: `client/src/App.jsx`)
- React app and routes → Verification admin: routes to (evidence: `client/src/App.jsx`)
- React app and routes → Admin analytics: routes to (evidence: `client/src/App.jsx`)
- Login and registration → Session context: authenticates through (evidence: `client/src/context/AuthContext.jsx`)
- Session context → API client: calls (evidence: `client/src/context/AuthContext.jsx`)
- Home → Session context: reads session (evidence: `client/src/pages/home/Home.jsx`)
- Product details → API client: requests data (evidence: `client/src/pages/marketplace/ProductDetails.jsx`)
- Product details → Session context: reads session (evidence: `client/src/pages/marketplace/ProductDetails.jsx`)
- Farmer listings → API client: updates listings
- Buyer order views → API client: requests orders
- Price insights → API client: requests benchmarks (evidence: `client/src/pages/price/PriceInsights.jsx`)
- Price insights → Session context: reads session (evidence: `client/src/pages/price/PriceInsights.jsx`)
- Verification admin → API client: manages requests (evidence: `client/src/pages/admin/Verification.jsx`)
- Admin analytics → API client: requests metrics (evidence: `client/src/pages/admin/AdminDashboard.jsx`)
- API client → Express API: REST requests
- Express API → Authentication routes: mounts (evidence: `server/server.js`)
- Express API → Product routes: mounts (evidence: `server/server.js`)
- Express API → Order routes: mounts (evidence: `server/server.js`)
- Express API → Price routes: mounts (evidence: `server/server.js`)
- Express API → Verification routes: mounts (evidence: `server/server.js`)
- Express API → Analytics routes: mounts (evidence: `server/server.js`)
- Authentication routes → Authentication logic: dispatches (evidence: `server/routes/authRoutes.js`)
- Product routes → Listing logic: dispatches (evidence: `server/routes/productRoutes.js`)
- Order routes → Order and logistics logic: dispatches (evidence: `server/routes/orderRoutes.js`)
- Price routes → Benchmark logic: dispatches (evidence: `server/routes/priceInsightRoutes.js`)
- Verification routes → Verification logic: dispatches (evidence: `server/routes/verificationRoutes.js`)
- Analytics routes → Analytics logic: dispatches (evidence: `server/routes/analyticsRoutes.js`)
- Authentication routes → JWT authentication: protects routes (evidence: `server/routes/authRoutes.js`)
- Product routes → JWT authentication: protects routes (evidence: `server/routes/productRoutes.js`)
- Order routes → JWT authentication: protects routes (evidence: `server/routes/orderRoutes.js`)
- Product routes → Role authorization: checks roles (evidence: `server/routes/productRoutes.js`)
- Order routes → Role authorization: checks roles (evidence: `server/routes/orderRoutes.js`)
- Authentication logic → User records: reads and writes (evidence: `server/controllers/authController.js`)
- JWT authentication → User records: loads user (evidence: `server/middleware/authMiddleware.js`)
- Listing logic → Product records: reads and writes (evidence: `server/controllers/productController.js`)
- Listing logic → Cloudinary storage: uploads images (evidence: `server/controllers/productController.js`)
- Order and logistics logic → Product records: checks and adjusts stock (evidence: `server/controllers/orderController.js`)
