# avn2312/marketnest architecture

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

## Overview

MarketNest is a grocery-commerce application: customers browse products, manage a cart and delivery address, apply coupons, pay by COD or Razorpay, and track orders; sellers manage products, stock, coupons, and orders. React routes and shared context drive the storefront and seller dashboard, while Express exposes the API and backend services handle catalog, checkout, order state, payments, and notifications. The README documents additional capabilities not fully sampled; those are represented at subsystem level. Some backend route/controller wiring and frontend API usage are unsampled, so uncertain links are omitted.

Main entry points: [`frontend/src/App.jsx`](https://github.com/avn2312/marketnest/blob/main/frontend/src/App.jsx) (Route application), [`backend/src/services/orderService.js`](https://github.com/avn2312/marketnest/blob/main/backend/src/services/orderService.js) (Order lifecycle), [`backend/src/controllers`](https://github.com/avn2312/marketnest/tree/main/backend/src/controllers) (API controllers), [`backend/src/services/razorpayPaymentService.js`](https://github.com/avn2312/marketnest/blob/main/backend/src/services/razorpayPaymentService.js) (Razorpay payments)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Customer storefront"]
  node_app["Route application<br/>[App.jsx]"]
  node_context["Shared app context<br/>[AppContext.jsx]"]
  node_catalog_ui["Browse products<br/>[ProductDetails.jsx]"]
  node_cart_ui["Cart and checkout<br/>[Cart.jsx]"]
  node_orders_ui["Order history<br/>[MyOrders.jsx]"]
end

subgraph group_seller["Seller workspace"]
  node_seller_ui["Seller dashboard<br/>[Orders.jsx]"]
  node_seller_products_ui["Product and stock tools<br/>[ProductList.jsx]"]
  node_seller_coupons_ui["Coupon management<br/>[Coupons.jsx]"]
end

subgraph group_api["Express API"]
  node_server["API server<br/>[server.js]"]
  node_gateway["API gateway<br/>[apiGateway.js]"]
  node_controllers["API controllers"]
end

subgraph group_commerce["Commerce services"]
  node_catalog["Product catalog"]
  node_orders["Order lifecycle<br/>[orderService.js]"]
  node_checkout["Checkout calculations<br/>[checkoutService.js]"]
  node_payment["Razorpay payments"]
  node_inventory["Inventory controls"]
  node_events["Order event bus<br/>[orderEventBus.js]"]
  node_notifications["Notifications"]
end

subgraph group_data["Persistence and integrations"]
  node_models[("Mongo domain models")]
  node_pg_checkout[("Postgres checkout writes")]
  node_pg_orders[("Postgres order repository")]
  node_pg_payments[("Postgres payment repository")]
  node_postgres[("Postgres connection<br/>[postgres.js]")]
end

node_customer(("Customer"))
node_seller_actor(("Seller"))
node_razorpay_service["Razorpay"]

node_customer -->|"uses"| node_app
node_seller_actor -->|"uses"| node_app
node_app -->|"routes to"| node_catalog_ui
node_app -->|"routes to"| node_cart_ui
node_app -->|"routes to"| node_orders_ui
node_app -->|"routes to"| node_seller_ui
node_app -->|"routes to"| node_seller_products_ui
node_app -->|"routes to"| node_seller_coupons_ui
node_app -->|"reads"| node_context
node_cart_ui -->|"reads"| node_context
node_orders_ui -->|"reads"| node_context
node_cart_ui -->|"requests checkout"| node_controllers
node_seller_ui -->|"manages orders"| node_controllers
node_seller_products_ui -->|"manages products"| node_controllers
node_seller_coupons_ui -->|"manages coupons"| node_controllers
node_server -->|"mounts"| node_gateway
node_server -->|"registers consumers"| node_notifications
node_server -->|"routes webhook"| node_payment
node_controllers -->|"calls catalog"| node_catalog
node_controllers -->|"calls order service"| node_orders
node_controllers -->|"calls payment service"| node_payment
node_catalog -->|"reads and writes"| node_models
node_orders -->|"calculates subtotal"| node_checkout
node_orders -->|"initiates payment"| node_payment
node_orders -->|"reserves stock"| node_inventory
node_orders -->|"publishes events"| node_events
node_orders -->|"reads and writes"| node_models
node_orders -->|"uses checkout storage"| node_pg_checkout
node_orders -->|"uses order storage"| node_pg_orders
node_payment -->|"persists payment events"| node_models
node_payment -->|"writes payments"| node_pg_payments
node_pg_checkout -->|"runs transactions"| node_postgres
node_pg_orders -->|"uses connection"| node_postgres
node_pg_payments -->|"uses connection"| node_postgres
node_payment -->|"calls API"| node_razorpay_service
node_notifications -->|"subscribes"| node_events

click node_app "https://github.com/avn2312/marketnest/blob/main/frontend/src/App.jsx"
click node_context "https://github.com/avn2312/marketnest/blob/main/frontend/src/context/AppContext.jsx"
click node_catalog_ui "https://github.com/avn2312/marketnest/blob/main/frontend/src/pages/ProductDetails.jsx"
click node_cart_ui "https://github.com/avn2312/marketnest/blob/main/frontend/src/pages/Cart.jsx"
click node_orders_ui "https://github.com/avn2312/marketnest/blob/main/frontend/src/pages/MyOrders.jsx"
click node_seller_ui "https://github.com/avn2312/marketnest/blob/main/frontend/src/pages/seller/Orders.jsx"
click node_seller_products_ui "https://github.com/avn2312/marketnest/blob/main/frontend/src/pages/seller/ProductList.jsx"
click node_seller_coupons_ui "https://github.com/avn2312/marketnest/blob/main/frontend/src/pages/seller/Coupons.jsx"
click node_server "https://github.com/avn2312/marketnest/blob/main/backend/server.js"
click node_gateway "https://github.com/avn2312/marketnest/blob/main/backend/src/gateway/apiGateway.js"
click node_controllers "https://github.com/avn2312/marketnest/tree/main/backend/src/controllers"
click node_catalog "https://github.com/avn2312/marketnest/blob/main/backend/src/services/productCatalogService.js"
click node_orders "https://github.com/avn2312/marketnest/blob/main/backend/src/services/orderService.js"
click node_checkout "https://github.com/avn2312/marketnest/blob/main/backend/src/services/checkoutService.js"
click node_payment "https://github.com/avn2312/marketnest/blob/main/backend/src/services/razorpayPaymentService.js"
click node_inventory "https://github.com/avn2312/marketnest/blob/main/backend/src/services/inventoryService.js"
click node_events "https://github.com/avn2312/marketnest/blob/main/backend/src/services/orderEventBus.js"
click node_notifications "https://github.com/avn2312/marketnest/blob/main/backend/src/services/notificationService.js"
click node_models "https://github.com/avn2312/marketnest/tree/main/backend/src/models"
click node_pg_checkout "https://github.com/avn2312/marketnest/blob/main/backend/src/repositories/postgresCheckoutRepository.js"
click node_pg_orders "https://github.com/avn2312/marketnest/blob/main/backend/src/repositories/postgresOrderRepository.js"
click node_pg_payments "https://github.com/avn2312/marketnest/blob/main/backend/src/repositories/postgresPaymentRepository.js"
click node_postgres "https://github.com/avn2312/marketnest/blob/main/backend/src/db/postgres.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_context,node_catalog_ui,node_cart_ui,node_orders_ui toneBlue
class node_seller_ui,node_seller_products_ui,node_seller_coupons_ui toneAmber
class node_server,node_gateway,node_controllers toneMint
class node_catalog,node_orders,node_checkout,node_payment,node_inventory,node_events,node_notifications toneRose
class node_models,node_pg_checkout,node_pg_orders,node_pg_payments,node_postgres,node_customer,node_seller_actor,node_razorpay_service toneIndigo
```

## Components

### Customer storefront

- [Route application](https://github.com/avn2312/marketnest/blob/main/frontend/src/App.jsx): `frontend/src/App.jsx`
- [Shared app context](https://github.com/avn2312/marketnest/blob/main/frontend/src/context/AppContext.jsx): `frontend/src/context/AppContext.jsx`
- [Browse products](https://github.com/avn2312/marketnest/blob/main/frontend/src/pages/ProductDetails.jsx): `frontend/src/pages/ProductDetails.jsx`
- [Cart and checkout](https://github.com/avn2312/marketnest/blob/main/frontend/src/pages/Cart.jsx): `frontend/src/pages/Cart.jsx`
- [Order history](https://github.com/avn2312/marketnest/blob/main/frontend/src/pages/MyOrders.jsx): `frontend/src/pages/MyOrders.jsx`

### Seller workspace

- [Seller dashboard](https://github.com/avn2312/marketnest/blob/main/frontend/src/pages/seller/Orders.jsx): `frontend/src/pages/seller/Orders.jsx`
- [Product and stock tools](https://github.com/avn2312/marketnest/blob/main/frontend/src/pages/seller/ProductList.jsx): `frontend/src/pages/seller/ProductList.jsx`
- [Coupon management](https://github.com/avn2312/marketnest/blob/main/frontend/src/pages/seller/Coupons.jsx): `frontend/src/pages/seller/Coupons.jsx`

### Express API

- [API server](https://github.com/avn2312/marketnest/blob/main/backend/server.js): `backend/server.js`
- [API gateway](https://github.com/avn2312/marketnest/blob/main/backend/src/gateway/apiGateway.js): `backend/src/gateway/apiGateway.js`
- [API controllers](https://github.com/avn2312/marketnest/tree/main/backend/src/controllers): `backend/src/controllers`

### Commerce services

- [Product catalog](https://github.com/avn2312/marketnest/blob/main/backend/src/services/productCatalogService.js): `backend/src/services/productCatalogService.js`
- [Order lifecycle](https://github.com/avn2312/marketnest/blob/main/backend/src/services/orderService.js): `backend/src/services/orderService.js`
- [Checkout calculations](https://github.com/avn2312/marketnest/blob/main/backend/src/services/checkoutService.js): `backend/src/services/checkoutService.js`
- [Razorpay payments](https://github.com/avn2312/marketnest/blob/main/backend/src/services/razorpayPaymentService.js): `backend/src/services/razorpayPaymentService.js`
- [Inventory controls](https://github.com/avn2312/marketnest/blob/main/backend/src/services/inventoryService.js): `backend/src/services/inventoryService.js`
- [Order event bus](https://github.com/avn2312/marketnest/blob/main/backend/src/services/orderEventBus.js): `backend/src/services/orderEventBus.js`
- [Notifications](https://github.com/avn2312/marketnest/blob/main/backend/src/services/notificationService.js): `backend/src/services/notificationService.js`

### Persistence and integrations

- [Mongo domain models](https://github.com/avn2312/marketnest/tree/main/backend/src/models): `backend/src/models`
- [Postgres checkout writes](https://github.com/avn2312/marketnest/blob/main/backend/src/repositories/postgresCheckoutRepository.js): `backend/src/repositories/postgresCheckoutRepository.js`
- [Postgres order repository](https://github.com/avn2312/marketnest/blob/main/backend/src/repositories/postgresOrderRepository.js): `backend/src/repositories/postgresOrderRepository.js`
- [Postgres payment repository](https://github.com/avn2312/marketnest/blob/main/backend/src/repositories/postgresPaymentRepository.js): `backend/src/repositories/postgresPaymentRepository.js`
- [Postgres connection](https://github.com/avn2312/marketnest/blob/main/backend/src/db/postgres.js): `backend/src/db/postgres.js`

### Other components

- **Customer**
- **Seller**
- **Razorpay**

## Connections

- Customer → Route application: uses (evidence: `README.md`)
- Seller → Route application: uses (evidence: `README.md`)
- Route application → Browse products: routes to (evidence: `frontend/src/App.jsx`)
- Route application → Cart and checkout: routes to (evidence: `frontend/src/App.jsx`)
- Route application → Order history: routes to (evidence: `frontend/src/App.jsx`)
- Route application → Seller dashboard: routes to (evidence: `frontend/src/App.jsx`)
- Route application → Product and stock tools: routes to (evidence: `frontend/src/App.jsx`)
- Route application → Coupon management: routes to (evidence: `frontend/src/App.jsx`)
- Route application → Shared app context: reads (evidence: `frontend/src/App.jsx`)
- Cart and checkout → Shared app context: reads (evidence: `frontend/src/pages/Cart.jsx`)
- Order history → Shared app context: reads (evidence: `frontend/src/pages/MyOrders.jsx`)
- Cart and checkout → API controllers: requests checkout (evidence: `frontend/src/pages/Cart.jsx`)
- Seller dashboard → API controllers: manages orders (evidence: `README.md`)
- Product and stock tools → API controllers: manages products (evidence: `README.md`)
- Coupon management → API controllers: manages coupons (evidence: `README.md`)
- API server → API gateway: mounts (evidence: `backend/server.js`)
- API server → Notifications: registers consumers (evidence: `backend/server.js`)
- API server → Razorpay payments: routes webhook (evidence: `backend/server.js`)
- API controllers → Product catalog: calls catalog (evidence: `backend/src/controllers/productController.js`)
- API controllers → Order lifecycle: calls order service (evidence: `backend/src/controllers/orderController.js`)
- API controllers → Razorpay payments: calls payment service (evidence: `backend/src/controllers/paymentController.js`)
- Product catalog → Mongo domain models: reads and writes (evidence: `backend/src/services/productCatalogService.js`)
- Order lifecycle → Checkout calculations: calculates subtotal (evidence: `backend/src/services/orderService.js`)
- Order lifecycle → Razorpay payments: initiates payment (evidence: `backend/src/services/orderService.js`)
- Order lifecycle → Inventory controls: reserves stock (evidence: `backend/src/services/orderService.js`)
- Order lifecycle → Order event bus: publishes events (evidence: `backend/src/services/orderService.js`)
- Order lifecycle → Mongo domain models: reads and writes (evidence: `backend/src/services/orderService.js`)
- Order lifecycle → Postgres checkout writes: uses checkout storage (evidence: `backend/src/services/orderService.js`)
- Order lifecycle → Postgres order repository: uses order storage (evidence: `backend/src/services/orderService.js`)
- Razorpay payments → Mongo domain models: persists payment events (evidence: `backend/src/services/razorpayPaymentService.js`)
- Razorpay payments → Postgres payment repository: writes payments (evidence: `backend/src/services/razorpayPaymentService.js`)
- Postgres checkout writes → Postgres connection: runs transactions (evidence: `backend/src/repositories/postgresCheckoutRepository.js`)
- Postgres order repository → Postgres connection: uses connection (evidence: `backend/src/repositories/postgresOrderRepository.js`)
- Postgres payment repository → Postgres connection: uses connection (evidence: `backend/src/repositories/postgresPaymentRepository.js`)
- Razorpay payments → Razorpay: calls API (evidence: `backend/src/services/razorpayPaymentService.js`)
- Notifications → Order event bus: subscribes (evidence: `backend/src/services/notificationService.js`)
