# dev-mjarir08/-e-commerce-platform- architecture

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

- Interactive diagram: https://gitdiagram.com/dev-mjarir08/-e-commerce-platform-
- Repository: https://github.com/dev-mjarir08/-e-commerce-platform-

## Overview

OmniKart Atelier is a multi-vendor commerce marketplace with customer, vendor, and administrator experiences. The customer journey spans catalog discovery, cart and checkout, payment, and post-purchase order management; vendor operations cover catalog, inventory, fulfillment, and reviews, while administrators govern the marketplace and its finances. The graph includes the frontend routing/state layer and backend API, domain controllers, and MongoDB models. Some major features are documented but their wiring was not sampled, so uncertain connections are omitted.

Main entry points: [`frontend/src/routes/AppRoutes.jsx`](https://github.com/dev-mjarir08/-e-commerce-platform-/blob/main/frontend/src/routes/AppRoutes.jsx) (Role Routes), [`backend/controllers/vendor.controller.js`](https://github.com/dev-mjarir08/-e-commerce-platform-/blob/main/backend/controllers/vendor.controller.js) (Vendor Services), [`backend/controllers/product.controller.js`](https://github.com/dev-mjarir08/-e-commerce-platform-/blob/main/backend/controllers/product.controller.js) (Product Management), [`backend/controllers/order.controller.js`](https://github.com/dev-mjarir08/-e-commerce-platform-/blob/main/backend/controllers/order.controller.js) (Order Processing)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_storefront["Customer Storefront"]
  node_catalog["Catalog Discovery<br/>[Shop.jsx]"]
  node_checkout["Cart and Checkout<br/>[Checkout.jsx]"]
  node_orders["Order Experience<br/>[Orders.jsx]"]
end

subgraph group_operations["Vendor Operations"]
  node_vendorportal["Vendor Portal<br/>[VendorLayout.jsx]"]
  node_vendorproducts["Product Studio<br/>[AddProduct.jsx]"]
  node_vendorinventory["Inventory Health<br/>[Inventory.jsx]"]
  node_vendororders["Vendor Fulfillment<br/>[Orders.jsx]"]
end

subgraph group_governance["Admin Governance"]
  node_adminportal["Admin Portal<br/>[AdminLayout.jsx]"]
  node_admincatalog["Catalog Governance<br/>[Products.jsx]"]
  node_adminvendors["Vendor and CRM<br/>[Vendors.jsx]"]
  node_adminfinance["Finance Oversight<br/>[Payment.jsx]"]
end

subgraph group_frontend["Frontend Runtime"]
  node_app["Application Shell<br/>[App.jsx]"]
  node_routes["Role Routes<br/>[AppRoutes.jsx]"]
  node_shopdata["Shop Data"]
end

subgraph group_backend["Backend Commerce"]
  node_api["HTTP API<br/>[server.js]"]
  node_auth["Identity and Roles<br/>[auth.controller.js]"]
  node_productctl["Product Management"]
  node_orderctl["Order Processing"]
  node_vendorctl["Vendor Services"]
  node_reviewctl["Review Moderation"]
  node_paymentctl["Payment Processing"]
  node_media["Media Uploads"]
  node_models[("Commerce Models")]
  node_productmodel["Product Schema<br/>[Product.js]"]
  node_ordermodel["Order Schemas<br/>[Order.js]"]
  node_usermodel["User Schema<br/>[User.js]"]
  node_storemodel["Store Schema<br/>[Store.js]"]
  node_reviewmodel["Review Schema<br/>[Review.js]"]
  node_paymentsvc["Stripe Gateway<br/>[stripe.js]"]
end

node_customer(("Customer"))
node_vendor(("Vendor"))
node_admin(("Administrator"))

node_app -->|"renders routes"| node_routes
node_app -->|"provides shop data"| node_shopdata
node_routes -->|"routes to"| node_catalog
node_routes -->|"routes to"| node_checkout
node_routes -->|"routes to"| node_orders
node_routes -->|"routes to"| node_vendorportal
node_routes -->|"routes to"| node_adminportal
node_shopdata -->|"supplies catalog"| node_catalog
node_api -.->|"routes requests"| node_auth
node_productctl -->|"reads and writes"| node_productmodel
node_productctl -->|"resolves store"| node_storemodel
node_productctl -->|"removes images"| node_media
node_orderctl -->|"creates and reads"| node_ordermodel
node_orderctl -->|"reads products"| node_productmodel
node_orderctl -->|"uses commerce records"| node_models
node_vendorctl -->|"reads users"| node_usermodel
node_vendorctl -->|"resolves store"| node_storemodel
node_vendorctl -->|"reads products"| node_productmodel
node_vendorctl -->|"reads orders"| node_ordermodel
node_vendorctl -->|"uses reviews"| node_reviewmodel
node_reviewctl -->|"queries and moderates"| node_reviewmodel
node_auth -->|"reads and writes"| node_usermodel
node_paymentctl -.->|"uses gateway"| node_paymentsvc

click node_app "https://github.com/dev-mjarir08/-e-commerce-platform-/blob/main/frontend/src/App.jsx"
click node_routes "https://github.com/dev-mjarir08/-e-commerce-platform-/blob/main/frontend/src/routes/AppRoutes.jsx"
click node_shopdata "https://github.com/dev-mjarir08/-e-commerce-platform-/blob/main/frontend/src/context/ShopDataContext.jsx"
click node_catalog "https://github.com/dev-mjarir08/-e-commerce-platform-/blob/main/frontend/src/pages/public/Shop.jsx"
click node_checkout "https://github.com/dev-mjarir08/-e-commerce-platform-/blob/main/frontend/src/pages/customer/Checkout.jsx"
click node_orders "https://github.com/dev-mjarir08/-e-commerce-platform-/blob/main/frontend/src/pages/customer/Orders.jsx"
click node_vendorportal "https://github.com/dev-mjarir08/-e-commerce-platform-/blob/main/frontend/src/layouts/VendorLayout.jsx"
click node_vendorproducts "https://github.com/dev-mjarir08/-e-commerce-platform-/blob/main/frontend/src/pages/admin/products/AddProduct.jsx"
click node_vendorinventory "https://github.com/dev-mjarir08/-e-commerce-platform-/blob/main/frontend/src/pages/admin/products/Inventory.jsx"
click node_vendororders "https://github.com/dev-mjarir08/-e-commerce-platform-/blob/main/frontend/src/pages/admin/Orders.jsx"
click node_adminportal "https://github.com/dev-mjarir08/-e-commerce-platform-/blob/main/frontend/src/layouts/AdminLayout.jsx"
click node_admincatalog "https://github.com/dev-mjarir08/-e-commerce-platform-/blob/main/frontend/src/pages/admin/Products.jsx"
click node_adminvendors "https://github.com/dev-mjarir08/-e-commerce-platform-/blob/main/frontend/src/pages/admin/Vendors.jsx"
click node_adminfinance "https://github.com/dev-mjarir08/-e-commerce-platform-/blob/main/frontend/src/pages/admin/Payment.jsx"
click node_api "https://github.com/dev-mjarir08/-e-commerce-platform-/blob/main/backend/server.js"
click node_auth "https://github.com/dev-mjarir08/-e-commerce-platform-/blob/main/backend/controllers/auth.controller.js"
click node_productctl "https://github.com/dev-mjarir08/-e-commerce-platform-/blob/main/backend/controllers/product.controller.js"
click node_orderctl "https://github.com/dev-mjarir08/-e-commerce-platform-/blob/main/backend/controllers/order.controller.js"
click node_vendorctl "https://github.com/dev-mjarir08/-e-commerce-platform-/blob/main/backend/controllers/vendor.controller.js"
click node_reviewctl "https://github.com/dev-mjarir08/-e-commerce-platform-/blob/main/backend/controllers/review.controller.js"
click node_paymentctl "https://github.com/dev-mjarir08/-e-commerce-platform-/blob/main/backend/controllers/payment.controller.js"
click node_media "https://github.com/dev-mjarir08/-e-commerce-platform-/blob/main/backend/middlewares/upload.middleware.js"
click node_models "https://github.com/dev-mjarir08/-e-commerce-platform-/tree/main/backend/models"
click node_productmodel "https://github.com/dev-mjarir08/-e-commerce-platform-/blob/main/backend/models/Product.js"
click node_ordermodel "https://github.com/dev-mjarir08/-e-commerce-platform-/blob/main/backend/models/Order.js"
click node_usermodel "https://github.com/dev-mjarir08/-e-commerce-platform-/blob/main/backend/models/User.js"
click node_storemodel "https://github.com/dev-mjarir08/-e-commerce-platform-/blob/main/backend/models/Store.js"
click node_reviewmodel "https://github.com/dev-mjarir08/-e-commerce-platform-/blob/main/backend/models/Review.js"
click node_paymentsvc "https://github.com/dev-mjarir08/-e-commerce-platform-/blob/main/backend/config/stripe.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_catalog,node_checkout,node_orders toneBlue
class node_vendorportal,node_vendorproducts,node_vendorinventory,node_vendororders toneAmber
class node_adminportal,node_admincatalog,node_adminvendors,node_adminfinance toneMint
class node_app,node_routes,node_shopdata toneRose
class node_api,node_auth,node_productctl,node_orderctl,node_vendorctl,node_reviewctl,node_paymentctl,node_media,node_models,node_productmodel,node_ordermodel,node_usermodel,node_storemodel,node_reviewmodel,node_paymentsvc,node_customer,node_vendor,node_admin toneIndigo
```

## Components

### Customer Storefront

- [Catalog Discovery](https://github.com/dev-mjarir08/-e-commerce-platform-/blob/main/frontend/src/pages/public/Shop.jsx): `frontend/src/pages/public/Shop.jsx`
- [Cart and Checkout](https://github.com/dev-mjarir08/-e-commerce-platform-/blob/main/frontend/src/pages/customer/Checkout.jsx): `frontend/src/pages/customer/Checkout.jsx`
- [Order Experience](https://github.com/dev-mjarir08/-e-commerce-platform-/blob/main/frontend/src/pages/customer/Orders.jsx): `frontend/src/pages/customer/Orders.jsx`

### Vendor Operations

- [Vendor Portal](https://github.com/dev-mjarir08/-e-commerce-platform-/blob/main/frontend/src/layouts/VendorLayout.jsx): `frontend/src/layouts/VendorLayout.jsx`
- [Product Studio](https://github.com/dev-mjarir08/-e-commerce-platform-/blob/main/frontend/src/pages/admin/products/AddProduct.jsx): `frontend/src/pages/admin/products/AddProduct.jsx`
- [Inventory Health](https://github.com/dev-mjarir08/-e-commerce-platform-/blob/main/frontend/src/pages/admin/products/Inventory.jsx): `frontend/src/pages/admin/products/Inventory.jsx`
- [Vendor Fulfillment](https://github.com/dev-mjarir08/-e-commerce-platform-/blob/main/frontend/src/pages/admin/Orders.jsx): `frontend/src/pages/admin/Orders.jsx`

### Admin Governance

- [Admin Portal](https://github.com/dev-mjarir08/-e-commerce-platform-/blob/main/frontend/src/layouts/AdminLayout.jsx): `frontend/src/layouts/AdminLayout.jsx`
- [Catalog Governance](https://github.com/dev-mjarir08/-e-commerce-platform-/blob/main/frontend/src/pages/admin/Products.jsx): `frontend/src/pages/admin/Products.jsx`
- [Vendor and CRM](https://github.com/dev-mjarir08/-e-commerce-platform-/blob/main/frontend/src/pages/admin/Vendors.jsx): `frontend/src/pages/admin/Vendors.jsx`
- [Finance Oversight](https://github.com/dev-mjarir08/-e-commerce-platform-/blob/main/frontend/src/pages/admin/Payment.jsx): `frontend/src/pages/admin/Payment.jsx`

### Frontend Runtime

- [Application Shell](https://github.com/dev-mjarir08/-e-commerce-platform-/blob/main/frontend/src/App.jsx): `frontend/src/App.jsx`
- [Role Routes](https://github.com/dev-mjarir08/-e-commerce-platform-/blob/main/frontend/src/routes/AppRoutes.jsx): `frontend/src/routes/AppRoutes.jsx`
- [Shop Data](https://github.com/dev-mjarir08/-e-commerce-platform-/blob/main/frontend/src/context/ShopDataContext.jsx): `frontend/src/context/ShopDataContext.jsx`

### Backend Commerce

- [HTTP API](https://github.com/dev-mjarir08/-e-commerce-platform-/blob/main/backend/server.js): `backend/server.js`
- [Identity and Roles](https://github.com/dev-mjarir08/-e-commerce-platform-/blob/main/backend/controllers/auth.controller.js): `backend/controllers/auth.controller.js`
- [Product Management](https://github.com/dev-mjarir08/-e-commerce-platform-/blob/main/backend/controllers/product.controller.js): `backend/controllers/product.controller.js`
- [Order Processing](https://github.com/dev-mjarir08/-e-commerce-platform-/blob/main/backend/controllers/order.controller.js): `backend/controllers/order.controller.js`
- [Vendor Services](https://github.com/dev-mjarir08/-e-commerce-platform-/blob/main/backend/controllers/vendor.controller.js): `backend/controllers/vendor.controller.js`
- [Review Moderation](https://github.com/dev-mjarir08/-e-commerce-platform-/blob/main/backend/controllers/review.controller.js): `backend/controllers/review.controller.js`
- [Payment Processing](https://github.com/dev-mjarir08/-e-commerce-platform-/blob/main/backend/controllers/payment.controller.js): `backend/controllers/payment.controller.js`
- [Media Uploads](https://github.com/dev-mjarir08/-e-commerce-platform-/blob/main/backend/middlewares/upload.middleware.js): `backend/middlewares/upload.middleware.js`
- [Commerce Models](https://github.com/dev-mjarir08/-e-commerce-platform-/tree/main/backend/models): `backend/models`
- [Product Schema](https://github.com/dev-mjarir08/-e-commerce-platform-/blob/main/backend/models/Product.js): `backend/models/Product.js`
- [Order Schemas](https://github.com/dev-mjarir08/-e-commerce-platform-/blob/main/backend/models/Order.js): `backend/models/Order.js`
- [User Schema](https://github.com/dev-mjarir08/-e-commerce-platform-/blob/main/backend/models/User.js): `backend/models/User.js`
- [Store Schema](https://github.com/dev-mjarir08/-e-commerce-platform-/blob/main/backend/models/Store.js): `backend/models/Store.js`
- [Review Schema](https://github.com/dev-mjarir08/-e-commerce-platform-/blob/main/backend/models/Review.js): `backend/models/Review.js`
- [Stripe Gateway](https://github.com/dev-mjarir08/-e-commerce-platform-/blob/main/backend/config/stripe.js): `backend/config/stripe.js`

### Other components

- **Customer**
- **Vendor**
- **Administrator**

## Connections

- Application Shell → Role Routes: renders routes (evidence: `frontend/src/App.jsx`)
- Application Shell → Shop Data: provides shop data (evidence: `frontend/src/App.jsx`)
- Role Routes → Catalog Discovery: routes to (evidence: `frontend/src/routes/AppRoutes.jsx`)
- Role Routes → Cart and Checkout: routes to (evidence: `frontend/src/routes/AppRoutes.jsx`)
- Role Routes → Order Experience: routes to (evidence: `frontend/src/routes/AppRoutes.jsx`)
- Role Routes → Vendor Portal: routes to (evidence: `frontend/src/routes/AppRoutes.jsx`)
- Role Routes → Admin Portal: routes to (evidence: `frontend/src/routes/AppRoutes.jsx`)
- Shop Data → Catalog Discovery: supplies catalog
- HTTP API → Identity and Roles: routes requests
- Product Management → Product Schema: reads and writes (evidence: `backend/controllers/product.controller.js`)
- Product Management → Store Schema: resolves store (evidence: `backend/controllers/product.controller.js`)
- Product Management → Media Uploads: removes images (evidence: `backend/controllers/product.controller.js`)
- Order Processing → Order Schemas: creates and reads (evidence: `backend/controllers/order.controller.js`)
- Order Processing → Product Schema: reads products (evidence: `backend/controllers/order.controller.js`)
- Order Processing → Commerce Models: uses commerce records (evidence: `backend/controllers/order.controller.js`)
- Vendor Services → User Schema: reads users (evidence: `backend/controllers/vendor.controller.js`)
- Vendor Services → Store Schema: resolves store (evidence: `backend/controllers/vendor.controller.js`)
- Vendor Services → Product Schema: reads products (evidence: `backend/controllers/vendor.controller.js`)
- Vendor Services → Order Schemas: reads orders (evidence: `backend/controllers/vendor.controller.js`)
- Vendor Services → Review Schema: uses reviews (evidence: `backend/controllers/vendor.controller.js`)
- Review Moderation → Review Schema: queries and moderates (evidence: `backend/controllers/review.controller.js`)
- Identity and Roles → User Schema: reads and writes (evidence: `backend/controllers/auth.controller.js`)
- Payment Processing → Stripe Gateway: uses gateway
