# mahirsinthia007/agrisync architecture

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

- Interactive diagram: https://gitdiagram.com/mahirsinthia007/agrisync
- Repository: https://github.com/mahirsinthia007/agrisync

## Overview

AgriSync is a farm-to-buyer marketplace: users browse or manage produce, then buyers cart and order it, with delivery tracking completing fulfillment. The React app routes role-specific pages to an Express API, whose domain routes dispatch to controllers and persist through Prisma. The graph also preserves the documented platform’s supporting capabilities—comparison, offers and negotiation, inventory, reviews, payments, messaging, delivery zones, and administration. Some controller and page implementations were not sampled, so links between those subsystems are limited to supported entry-point and directory-level relationships.

Main entry points: [`backend/server.js`](https://github.com/mahirsinthia007/agrisync/blob/main/backend/server.js) (API routing), [`frontend-app/src/App.jsx`](https://github.com/mahirsinthia007/agrisync/blob/main/frontend-app/src/App.jsx) (App routing), [`backend/config/db.js`](https://github.com/mahirsinthia007/agrisync/blob/main/backend/config/db.js) (Application database), [`backend/controllers/productController.js`](https://github.com/mahirsinthia007/agrisync/blob/main/backend/controllers/productController.js) (Product APIs)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_experience["Web experience"]
  node_app["App routing<br/>[App.jsx]"]
  node_browse["Product browsing<br/>[BrowseProducts.jsx]"]
  node_farmerproducts["Farmer products<br/>[MyProducts.jsx]"]
  node_checkout["Cart and checkout<br/>[CheckoutPage.jsx]"]
  node_ordersui["Order views<br/>[OrdersPage.jsx]"]
end

subgraph group_marketplace["Marketplace"]
  node_products["Product APIs"]
  node_compare["Comparison"]
  node_inventory["Inventory"]
  node_offers["Offers and negotiation<br/>[offerController.js]"]
  node_reviews["Reviews and moderation"]
end

subgraph group_commerce["Commerce"]
  node_cart["Cart<br/>[cartController.js]"]
  node_orders["Order management<br/>[orderController.js]"]
  node_payments["Payments"]
  node_messages["Messaging"]
end

subgraph group_fulfillment["Fulfillment"]
  node_delivery["Delivery operations"]
  node_zones["Delivery zones"]
end

subgraph group_platform["Platform services"]
  node_adminsrv["Administration<br/>[adminController.js]"]
  node_users["Users and access<br/>[userController.js]"]
  node_api["API routing<br/>[server.js]"]
  node_db[("Application database<br/>[db.js]")]
  node_storage["Image storage<br/>[storage.js]"]
end

node_buyers(("Buyers"))
node_farmers(("Farmers"))
node_admins(("Administrators"))
node_deliverypeople(("Delivery people"))
node_supabase[("Supabase Storage")]

node_buyers -->|"use"| node_app
node_farmers -->|"use"| node_app
node_admins -->|"use"| node_app
node_deliverypeople -->|"use"| node_app
node_app -->|"routes to"| node_browse
node_app -->|"routes to"| node_farmerproducts
node_app -->|"routes to"| node_checkout
node_app -->|"routes to"| node_ordersui
node_api -->|"dispatches"| node_products
node_api -->|"dispatches"| node_cart
node_api -->|"dispatches"| node_orders
node_api -->|"dispatches"| node_reviews
node_api -->|"dispatches"| node_delivery
node_api -->|"dispatches"| node_zones
node_api -->|"dispatches"| node_compare
node_api -->|"dispatches"| node_inventory
node_api -->|"dispatches"| node_offers
node_api -->|"dispatches"| node_payments
node_api -->|"dispatches"| node_messages
node_api -->|"dispatches"| node_adminsrv
node_api -->|"dispatches"| node_users
node_products -->|"reads and writes"| node_db
node_cart -->|"reads and writes"| node_db
node_orders -->|"reads and writes"| node_db
node_reviews -->|"reads and writes"| node_db
node_delivery -->|"reads and writes"| node_db
node_adminsrv -->|"reads and writes"| node_db
node_storage -.->|"uploads and deletes"| node_supabase

click node_app "https://github.com/mahirsinthia007/agrisync/blob/main/frontend-app/src/App.jsx"
click node_browse "https://github.com/mahirsinthia007/agrisync/blob/main/frontend-app/src/pages/BrowseProducts.jsx"
click node_farmerproducts "https://github.com/mahirsinthia007/agrisync/blob/main/frontend-app/src/pages/MyProducts.jsx"
click node_checkout "https://github.com/mahirsinthia007/agrisync/blob/main/frontend-app/src/pages/CheckoutPage.jsx"
click node_ordersui "https://github.com/mahirsinthia007/agrisync/blob/main/frontend-app/src/pages/OrdersPage.jsx"
click node_products "https://github.com/mahirsinthia007/agrisync/blob/main/backend/controllers/productController.js"
click node_compare "https://github.com/mahirsinthia007/agrisync/blob/main/backend/controllers/comparisonController.js"
click node_inventory "https://github.com/mahirsinthia007/agrisync/blob/main/backend/controllers/inventoryController.js"
click node_offers "https://github.com/mahirsinthia007/agrisync/blob/main/backend/controllers/offerController.js"
click node_reviews "https://github.com/mahirsinthia007/agrisync/blob/main/backend/controllers/reviewController.js"
click node_cart "https://github.com/mahirsinthia007/agrisync/blob/main/backend/controllers/cartController.js"
click node_orders "https://github.com/mahirsinthia007/agrisync/blob/main/backend/controllers/orderController.js"
click node_payments "https://github.com/mahirsinthia007/agrisync/blob/main/backend/controllers/paymentController.js"
click node_messages "https://github.com/mahirsinthia007/agrisync/blob/main/backend/controllers/messageController.js"
click node_delivery "https://github.com/mahirsinthia007/agrisync/blob/main/backend/controllers/deliveryController.js"
click node_zones "https://github.com/mahirsinthia007/agrisync/blob/main/backend/controllers/deliveryZoneController.js"
click node_adminsrv "https://github.com/mahirsinthia007/agrisync/blob/main/backend/controllers/adminController.js"
click node_users "https://github.com/mahirsinthia007/agrisync/blob/main/backend/controllers/userController.js"
click node_api "https://github.com/mahirsinthia007/agrisync/blob/main/backend/server.js"
click node_db "https://github.com/mahirsinthia007/agrisync/blob/main/backend/config/db.js"
click node_storage "https://github.com/mahirsinthia007/agrisync/blob/main/backend/config/storage.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_browse,node_farmerproducts,node_checkout,node_ordersui toneBlue
class node_products,node_compare,node_inventory,node_offers,node_reviews,node_supabase toneAmber
class node_cart,node_orders,node_payments,node_messages toneMint
class node_delivery,node_zones toneRose
class node_adminsrv,node_users,node_api,node_db,node_storage,node_buyers,node_farmers,node_admins,node_deliverypeople toneIndigo
```

## Components

### Web experience

- [App routing](https://github.com/mahirsinthia007/agrisync/blob/main/frontend-app/src/App.jsx): `frontend-app/src/App.jsx`
- [Product browsing](https://github.com/mahirsinthia007/agrisync/blob/main/frontend-app/src/pages/BrowseProducts.jsx): `frontend-app/src/pages/BrowseProducts.jsx`
- [Farmer products](https://github.com/mahirsinthia007/agrisync/blob/main/frontend-app/src/pages/MyProducts.jsx): `frontend-app/src/pages/MyProducts.jsx`
- [Cart and checkout](https://github.com/mahirsinthia007/agrisync/blob/main/frontend-app/src/pages/CheckoutPage.jsx): `frontend-app/src/pages/CheckoutPage.jsx`
- [Order views](https://github.com/mahirsinthia007/agrisync/blob/main/frontend-app/src/pages/OrdersPage.jsx): `frontend-app/src/pages/OrdersPage.jsx`

### Marketplace

- [Product APIs](https://github.com/mahirsinthia007/agrisync/blob/main/backend/controllers/productController.js): `backend/controllers/productController.js`
- [Comparison](https://github.com/mahirsinthia007/agrisync/blob/main/backend/controllers/comparisonController.js): `backend/controllers/comparisonController.js`
- [Inventory](https://github.com/mahirsinthia007/agrisync/blob/main/backend/controllers/inventoryController.js): `backend/controllers/inventoryController.js`
- [Offers and negotiation](https://github.com/mahirsinthia007/agrisync/blob/main/backend/controllers/offerController.js): `backend/controllers/offerController.js`
- [Reviews and moderation](https://github.com/mahirsinthia007/agrisync/blob/main/backend/controllers/reviewController.js): `backend/controllers/reviewController.js`

### Commerce

- [Cart](https://github.com/mahirsinthia007/agrisync/blob/main/backend/controllers/cartController.js): `backend/controllers/cartController.js`
- [Order management](https://github.com/mahirsinthia007/agrisync/blob/main/backend/controllers/orderController.js): `backend/controllers/orderController.js`
- [Payments](https://github.com/mahirsinthia007/agrisync/blob/main/backend/controllers/paymentController.js): `backend/controllers/paymentController.js`
- [Messaging](https://github.com/mahirsinthia007/agrisync/blob/main/backend/controllers/messageController.js): `backend/controllers/messageController.js`

### Fulfillment

- [Delivery operations](https://github.com/mahirsinthia007/agrisync/blob/main/backend/controllers/deliveryController.js): `backend/controllers/deliveryController.js`
- [Delivery zones](https://github.com/mahirsinthia007/agrisync/blob/main/backend/controllers/deliveryZoneController.js): `backend/controllers/deliveryZoneController.js`

### Platform services

- [Administration](https://github.com/mahirsinthia007/agrisync/blob/main/backend/controllers/adminController.js): `backend/controllers/adminController.js`
- [Users and access](https://github.com/mahirsinthia007/agrisync/blob/main/backend/controllers/userController.js): `backend/controllers/userController.js`
- [API routing](https://github.com/mahirsinthia007/agrisync/blob/main/backend/server.js): `backend/server.js`
- [Application database](https://github.com/mahirsinthia007/agrisync/blob/main/backend/config/db.js): `backend/config/db.js`
- [Image storage](https://github.com/mahirsinthia007/agrisync/blob/main/backend/config/storage.js): `backend/config/storage.js`

### Other components

- **Buyers**
- **Farmers**
- **Administrators**
- **Delivery people**
- **Supabase Storage**

## Connections

- Buyers → App routing: use
- Farmers → App routing: use
- Administrators → App routing: use
- Delivery people → App routing: use
- App routing → Product browsing: routes to
- App routing → Farmer products: routes to
- App routing → Cart and checkout: routes to
- App routing → Order views: routes to
- API routing → Product APIs: dispatches
- API routing → Cart: dispatches
- API routing → Order management: dispatches
- API routing → Reviews and moderation: dispatches
- API routing → Delivery operations: dispatches
- API routing → Delivery zones: dispatches
- API routing → Comparison: dispatches
- API routing → Inventory: dispatches
- API routing → Offers and negotiation: dispatches
- API routing → Payments: dispatches
- API routing → Messaging: dispatches
- API routing → Administration: dispatches
- API routing → Users and access: dispatches
- Product APIs → Application database: reads and writes
- Cart → Application database: reads and writes
- Order management → Application database: reads and writes
- Reviews and moderation → Application database: reads and writes
- Delivery operations → Application database: reads and writes
- Administration → Application database: reads and writes
- Image storage → Supabase Storage: uploads and deletes