# infogudkart-maker/goodkart-new architecture

> Architecture diagram of the GitHub repository infogudkart-maker/goodkart-new, 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/infogudkart-maker/goodkart-new
- Repository: https://github.com/infogudkart-maker/goodkart-new

## Overview

Goodkart is a multi-sided marketplace: shoppers discover products, authenticate, check out and track orders; sellers onboard and manage products and orders; administrators manage the platform. The backend exposes these capabilities through Express routes and controllers, with Firebase-backed state and payment, invoicing, email and shipping integrations. The graph preserves the major marketplace, seller and admin domains visible in the repository tree. Several frontend page-to-page transitions and unsampled controller behavior are not evidenced in the excerpts, so those links are omitted.

Main entry points: [`backend/src/config/firebase.js`](https://github.com/infogudkart-maker/goodkart-new/blob/main/backend/src/config/firebase.js) (Firebase data and auth), [`backend/src/modules/payment/controllers/paymentController.js`](https://github.com/infogudkart-maker/goodkart-new/blob/main/backend/src/modules/payment/controllers/paymentController.js) (Payment processing), [`frontend/src/modules/shared/utils/api.js`](https://github.com/infogudkart-maker/goodkart-new/blob/main/frontend/src/modules/shared/utils/api.js) (Frontend API client), [`backend/src/modules/orders/controllers/orderController.js`](https://github.com/infogudkart-maker/goodkart-new/blob/main/backend/src/modules/orders/controllers/orderController.js) (Order lifecycle)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_shop["Shopper marketplace"]
  node_catalog_ui["Product discovery<br/>[ProductListing.jsx]"]
  node_detail_ui["Product details<br/>[ProductDetail.jsx]"]
  node_checkout_ui["Checkout<br/>[Checkout.jsx]"]
  node_consumer_ui["Customer account<br/>[Dashboard.jsx]"]
  node_api_client["Frontend API client<br/>[api.js]"]
end

subgraph group_identity["Identity and sellers"]
  node_auth_ui["Sign-in UI<br/>[PhoneOtpForm.jsx]"]
  node_seller_ui["Seller portal<br/>[Dashboard.jsx]"]
  node_auth_routes["Auth routes<br/>[authRoutes.js]"]
  node_auth_controller["Identity and onboarding<br/>[authController.js]"]
  node_auth_middleware["Access control<br/>[auth.js]"]
  node_seller_controller["Seller operations"]
end

subgraph group_commerce["Commerce backend"]
  node_server["HTTP application<br/>[server.js]"]
  node_product_controller["Product catalog"]
  node_order_controller["Order lifecycle<br/>[orderController.js]"]
  node_payment_controller["Payment processing"]
  node_review_controller["Product reviews"]
  node_shipping_estimate["Shipping estimates"]
  node_firebase[("Firebase data and auth<br/>[firebase.js]")]
  node_pricing["Pricing calculations<br/>[pricing.js]"]
  node_stock["Stock updates<br/>[stockUtils.js]"]
  node_cache["In-memory cache<br/>[cache.js]"]
end

subgraph group_operations["Platform operations"]
  node_admin_ui["Admin dashboard<br/>[Dashboard.jsx]"]
  node_admin_routes["Admin routes<br/>[adminRoutes.js]"]
  node_admin_sellers["Seller administration"]
  node_admin_reviews["Review administration"]
  node_invoices["Invoice generation<br/>[invoiceService.js]"]
  node_email["Email notifications<br/>[emailService.js]"]
  node_shipping_provider["Shiprocket integration"]
end

node_shopper(("Shopper"))
node_razorpay["Razorpay"]

node_shopper -.->|"signs in"| node_auth_ui
node_shopper -.->|"browses"| node_catalog_ui
node_shopper -.->|"checks out"| node_checkout_ui
node_shopper -.->|"manages account"| node_consumer_ui
node_auth_ui -.->|"requests auth"| node_api_client
node_catalog_ui -.->|"requests products"| node_api_client
node_checkout_ui -.->|"submits purchase"| node_api_client
node_seller_ui -.->|"manages selling"| node_api_client
node_admin_ui -.->|"manages platform"| node_api_client
node_api_client -.->|"calls API"| node_server
node_server -->|"mounts routes"| node_auth_routes
node_server -->|"mounts routes"| node_admin_routes
node_auth_routes -->|"dispatches"| node_auth_controller
node_auth_routes -->|"guards routes"| node_auth_middleware
node_auth_controller -->|"reads identity"| node_firebase
node_auth_middleware -->|"verifies tokens"| node_firebase
node_admin_routes -->|"dispatches"| node_admin_sellers
node_admin_routes -->|"dispatches"| node_admin_reviews
node_product_controller -->|"reads catalog"| node_firebase
node_seller_controller -->|"reads seller data"| node_firebase
node_seller_controller -->|"calculates revenue"| node_pricing
node_seller_controller -->|"invalidates cache"| node_cache
node_order_controller -->|"reads orders"| node_firebase
node_order_controller -->|"reads order cache"| node_cache
node_order_controller -->|"generates invoice"| node_invoices
node_order_controller -->|"cancels shipment"| node_shipping_provider
node_payment_controller -->|"creates payment"| node_razorpay
node_payment_controller -->|"stores order"| node_firebase
node_payment_controller -->|"reduces stock"| node_stock
node_payment_controller -->|"generates invoice"| node_invoices
node_payment_controller -->|"notifies sellers"| node_email
node_payment_controller -->|"creates shipment"| node_shipping_provider
node_review_controller -->|"updates reviews"| node_firebase
node_review_controller -->|"caches results"| node_cache
node_shipping_estimate -.->|"estimates shipping"| node_shipping_provider
node_admin_sellers -->|"reads seller records"| node_firebase
node_admin_reviews -->|"manages reviews"| node_firebase

click node_auth_ui "https://github.com/infogudkart-maker/goodkart-new/blob/main/frontend/src/modules/auth/components/PhoneOtpForm.jsx"
click node_catalog_ui "https://github.com/infogudkart-maker/goodkart-new/blob/main/frontend/src/modules/marketplace/pages/ProductListing.jsx"
click node_detail_ui "https://github.com/infogudkart-maker/goodkart-new/blob/main/frontend/src/modules/marketplace/pages/ProductDetail.jsx"
click node_checkout_ui "https://github.com/infogudkart-maker/goodkart-new/blob/main/frontend/src/modules/marketplace/pages/Checkout.jsx"
click node_consumer_ui "https://github.com/infogudkart-maker/goodkart-new/blob/main/frontend/src/modules/consumer/pages/Dashboard.jsx"
click node_seller_ui "https://github.com/infogudkart-maker/goodkart-new/blob/main/frontend/src/modules/seller/pages/Dashboard.jsx"
click node_admin_ui "https://github.com/infogudkart-maker/goodkart-new/blob/main/frontend/src/modules/admin/pages/Dashboard.jsx"
click node_api_client "https://github.com/infogudkart-maker/goodkart-new/blob/main/frontend/src/modules/shared/utils/api.js"
click node_server "https://github.com/infogudkart-maker/goodkart-new/blob/main/backend/src/server.js"
click node_auth_routes "https://github.com/infogudkart-maker/goodkart-new/blob/main/backend/src/modules/auth/routes/authRoutes.js"
click node_auth_controller "https://github.com/infogudkart-maker/goodkart-new/blob/main/backend/src/modules/auth/controllers/authController.js"
click node_auth_middleware "https://github.com/infogudkart-maker/goodkart-new/blob/main/backend/src/middleware/auth.js"
click node_product_controller "https://github.com/infogudkart-maker/goodkart-new/blob/main/backend/src/modules/products/controllers/productController.js"
click node_seller_controller "https://github.com/infogudkart-maker/goodkart-new/blob/main/backend/src/modules/seller/controllers/sellerController.js"
click node_order_controller "https://github.com/infogudkart-maker/goodkart-new/blob/main/backend/src/modules/orders/controllers/orderController.js"
click node_payment_controller "https://github.com/infogudkart-maker/goodkart-new/blob/main/backend/src/modules/payment/controllers/paymentController.js"
click node_review_controller "https://github.com/infogudkart-maker/goodkart-new/blob/main/backend/src/modules/reviews/controllers/reviewController.js"
click node_shipping_estimate "https://github.com/infogudkart-maker/goodkart-new/blob/main/backend/src/modules/shipping/controllers/shippingEstimateController.js"
click node_admin_routes "https://github.com/infogudkart-maker/goodkart-new/blob/main/backend/src/modules/admin/routes/adminRoutes.js"
click node_admin_sellers "https://github.com/infogudkart-maker/goodkart-new/blob/main/backend/src/modules/admin/controllers/sellerManagementController.js"
click node_admin_reviews "https://github.com/infogudkart-maker/goodkart-new/blob/main/backend/src/modules/admin/controllers/reviewManagementController.js"
click node_firebase "https://github.com/infogudkart-maker/goodkart-new/blob/main/backend/src/config/firebase.js"
click node_pricing "https://github.com/infogudkart-maker/goodkart-new/blob/main/backend/src/utils/pricing.js"
click node_stock "https://github.com/infogudkart-maker/goodkart-new/blob/main/backend/src/utils/stockUtils.js"
click node_cache "https://github.com/infogudkart-maker/goodkart-new/blob/main/backend/src/utils/cache.js"
click node_invoices "https://github.com/infogudkart-maker/goodkart-new/blob/main/backend/src/shared/services/invoiceService.js"
click node_email "https://github.com/infogudkart-maker/goodkart-new/blob/main/backend/src/shared/services/emailService.js"
click node_shipping_provider "https://github.com/infogudkart-maker/goodkart-new/blob/main/backend/src/shared/services/shiprocketService.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_ui,node_detail_ui,node_checkout_ui,node_consumer_ui,node_api_client toneBlue
class node_auth_ui,node_seller_ui,node_auth_routes,node_auth_controller,node_auth_middleware,node_seller_controller toneAmber
class node_server,node_product_controller,node_order_controller,node_payment_controller,node_review_controller,node_shipping_estimate,node_firebase,node_pricing,node_stock,node_cache toneMint
class node_admin_ui,node_admin_routes,node_admin_sellers,node_admin_reviews,node_invoices,node_email,node_shipping_provider toneRose
class node_shopper,node_razorpay toneIndigo
```

## Components

### Shopper marketplace

- [Product discovery](https://github.com/infogudkart-maker/goodkart-new/blob/main/frontend/src/modules/marketplace/pages/ProductListing.jsx): `frontend/src/modules/marketplace/pages/ProductListing.jsx`
- [Product details](https://github.com/infogudkart-maker/goodkart-new/blob/main/frontend/src/modules/marketplace/pages/ProductDetail.jsx): `frontend/src/modules/marketplace/pages/ProductDetail.jsx`
- [Checkout](https://github.com/infogudkart-maker/goodkart-new/blob/main/frontend/src/modules/marketplace/pages/Checkout.jsx): `frontend/src/modules/marketplace/pages/Checkout.jsx`
- [Customer account](https://github.com/infogudkart-maker/goodkart-new/blob/main/frontend/src/modules/consumer/pages/Dashboard.jsx): `frontend/src/modules/consumer/pages/Dashboard.jsx`
- [Frontend API client](https://github.com/infogudkart-maker/goodkart-new/blob/main/frontend/src/modules/shared/utils/api.js): `frontend/src/modules/shared/utils/api.js`

### Identity and sellers

- [Sign-in UI](https://github.com/infogudkart-maker/goodkart-new/blob/main/frontend/src/modules/auth/components/PhoneOtpForm.jsx): `frontend/src/modules/auth/components/PhoneOtpForm.jsx`
- [Seller portal](https://github.com/infogudkart-maker/goodkart-new/blob/main/frontend/src/modules/seller/pages/Dashboard.jsx): `frontend/src/modules/seller/pages/Dashboard.jsx`
- [Auth routes](https://github.com/infogudkart-maker/goodkart-new/blob/main/backend/src/modules/auth/routes/authRoutes.js): `backend/src/modules/auth/routes/authRoutes.js`
- [Identity and onboarding](https://github.com/infogudkart-maker/goodkart-new/blob/main/backend/src/modules/auth/controllers/authController.js): `backend/src/modules/auth/controllers/authController.js`
- [Access control](https://github.com/infogudkart-maker/goodkart-new/blob/main/backend/src/middleware/auth.js): `backend/src/middleware/auth.js`
- [Seller operations](https://github.com/infogudkart-maker/goodkart-new/blob/main/backend/src/modules/seller/controllers/sellerController.js): `backend/src/modules/seller/controllers/sellerController.js`

### Commerce backend

- [HTTP application](https://github.com/infogudkart-maker/goodkart-new/blob/main/backend/src/server.js): `backend/src/server.js`
- [Product catalog](https://github.com/infogudkart-maker/goodkart-new/blob/main/backend/src/modules/products/controllers/productController.js): `backend/src/modules/products/controllers/productController.js`
- [Order lifecycle](https://github.com/infogudkart-maker/goodkart-new/blob/main/backend/src/modules/orders/controllers/orderController.js): `backend/src/modules/orders/controllers/orderController.js`
- [Payment processing](https://github.com/infogudkart-maker/goodkart-new/blob/main/backend/src/modules/payment/controllers/paymentController.js): `backend/src/modules/payment/controllers/paymentController.js`
- [Product reviews](https://github.com/infogudkart-maker/goodkart-new/blob/main/backend/src/modules/reviews/controllers/reviewController.js): `backend/src/modules/reviews/controllers/reviewController.js`
- [Shipping estimates](https://github.com/infogudkart-maker/goodkart-new/blob/main/backend/src/modules/shipping/controllers/shippingEstimateController.js): `backend/src/modules/shipping/controllers/shippingEstimateController.js`
- [Firebase data and auth](https://github.com/infogudkart-maker/goodkart-new/blob/main/backend/src/config/firebase.js): `backend/src/config/firebase.js`
- [Pricing calculations](https://github.com/infogudkart-maker/goodkart-new/blob/main/backend/src/utils/pricing.js): `backend/src/utils/pricing.js`
- [Stock updates](https://github.com/infogudkart-maker/goodkart-new/blob/main/backend/src/utils/stockUtils.js): `backend/src/utils/stockUtils.js`
- [In-memory cache](https://github.com/infogudkart-maker/goodkart-new/blob/main/backend/src/utils/cache.js): `backend/src/utils/cache.js`

### Platform operations

- [Admin dashboard](https://github.com/infogudkart-maker/goodkart-new/blob/main/frontend/src/modules/admin/pages/Dashboard.jsx): `frontend/src/modules/admin/pages/Dashboard.jsx`
- [Admin routes](https://github.com/infogudkart-maker/goodkart-new/blob/main/backend/src/modules/admin/routes/adminRoutes.js): `backend/src/modules/admin/routes/adminRoutes.js`
- [Seller administration](https://github.com/infogudkart-maker/goodkart-new/blob/main/backend/src/modules/admin/controllers/sellerManagementController.js): `backend/src/modules/admin/controllers/sellerManagementController.js`
- [Review administration](https://github.com/infogudkart-maker/goodkart-new/blob/main/backend/src/modules/admin/controllers/reviewManagementController.js): `backend/src/modules/admin/controllers/reviewManagementController.js`
- [Invoice generation](https://github.com/infogudkart-maker/goodkart-new/blob/main/backend/src/shared/services/invoiceService.js): `backend/src/shared/services/invoiceService.js`
- [Email notifications](https://github.com/infogudkart-maker/goodkart-new/blob/main/backend/src/shared/services/emailService.js): `backend/src/shared/services/emailService.js`
- [Shiprocket integration](https://github.com/infogudkart-maker/goodkart-new/blob/main/backend/src/shared/services/shiprocketService.js): `backend/src/shared/services/shiprocketService.js`

### Other components

- **Shopper**
- **Razorpay**

## Connections

- Shopper → Sign-in UI: signs in
- Shopper → Product discovery: browses
- Shopper → Checkout: checks out
- Shopper → Customer account: manages account
- Sign-in UI → Frontend API client: requests auth
- Product discovery → Frontend API client: requests products
- Checkout → Frontend API client: submits purchase
- Seller portal → Frontend API client: manages selling
- Admin dashboard → Frontend API client: manages platform
- Frontend API client → HTTP application: calls API
- HTTP application → Auth routes: mounts routes (evidence: `backend/src/server.js`)
- HTTP application → Admin routes: mounts routes (evidence: `backend/src/server.js`)
- Auth routes → Identity and onboarding: dispatches (evidence: `backend/src/modules/auth/routes/authRoutes.js`)
- Auth routes → Access control: guards routes (evidence: `backend/src/modules/auth/routes/authRoutes.js`)
- Identity and onboarding → Firebase data and auth: reads identity (evidence: `backend/src/modules/auth/controllers/authController.js`)
- Access control → Firebase data and auth: verifies tokens (evidence: `backend/src/middleware/auth.js`)
- Admin routes → Seller administration: dispatches (evidence: `backend/src/modules/admin/routes/adminRoutes.js`)
- Admin routes → Review administration: dispatches (evidence: `backend/src/modules/admin/routes/adminRoutes.js`)
- Product catalog → Firebase data and auth: reads catalog (evidence: `backend/src/modules/products/controllers/productController.js`)
- Seller operations → Firebase data and auth: reads seller data (evidence: `backend/src/modules/seller/controllers/sellerController.js`)
- Seller operations → Pricing calculations: calculates revenue (evidence: `backend/src/modules/seller/controllers/sellerController.js`)
- Seller operations → In-memory cache: invalidates cache (evidence: `backend/src/modules/seller/controllers/sellerController.js`)
- Order lifecycle → Firebase data and auth: reads orders (evidence: `backend/src/modules/orders/controllers/orderController.js`)
- Order lifecycle → In-memory cache: reads order cache (evidence: `backend/src/modules/orders/controllers/orderController.js`)
- Order lifecycle → Invoice generation: generates invoice (evidence: `backend/src/modules/orders/controllers/orderController.js`)
- Order lifecycle → Shiprocket integration: cancels shipment (evidence: `backend/src/modules/orders/controllers/orderController.js`)
- Payment processing → Razorpay: creates payment (evidence: `backend/src/modules/payment/controllers/paymentController.js`)
- Payment processing → Firebase data and auth: stores order (evidence: `backend/src/modules/payment/controllers/paymentController.js`)
- Payment processing → Stock updates: reduces stock (evidence: `backend/src/modules/payment/controllers/paymentController.js`)
- Payment processing → Invoice generation: generates invoice (evidence: `backend/src/modules/payment/controllers/paymentController.js`)
- Payment processing → Email notifications: notifies sellers (evidence: `backend/src/modules/payment/controllers/paymentController.js`)
- Payment processing → Shiprocket integration: creates shipment (evidence: `backend/src/modules/payment/controllers/paymentController.js`)
- Product reviews → Firebase data and auth: updates reviews (evidence: `backend/src/modules/reviews/controllers/reviewController.js`)
- Product reviews → In-memory cache: caches results (evidence: `backend/src/modules/reviews/controllers/reviewController.js`)
- Shipping estimates → Shiprocket integration: estimates shipping
- Seller administration → Firebase data and auth: reads seller records (evidence: `backend/src/modules/admin/controllers/sellerManagementController.js`)
- Review administration → Firebase data and auth: manages reviews (evidence: `backend/src/modules/admin/controllers/reviewManagementController.js`)
