# renukaparmar03/minute_kart architecture

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

- Interactive diagram: https://gitdiagram.com/renukaparmar03/minute_kart
- Repository: https://github.com/renukaparmar03/minute_kart

## Overview

This repository is a multi-module commerce platform: its frontend routes users into food, quick-commerce, seller, delivery, and milk experiences, while the backend exposes corresponding commerce and operational modules. A typical workflow enters a module’s API, performs a domain action, and reads or updates module state; the sampled quick-commerce routes show catalog, location, billing, and admin endpoints, and sampled auth/payment code shows OTP and finance operations. The tree documents broader food ordering, delivery, dining, and milk-plan capabilities. Source excerpts are partial, so uncertain wiring is omitted.

Main entry points: [`Backend/src/modules/quick-commerce/controllers/admin.controller.js`](https://github.com/renukaparmar03/minute_kart/blob/main/Backend/src/modules/quick-commerce/controllers/admin.controller.js) (Quick Admin), [`Backend/src/core/auth/auth.service.js`](https://github.com/renukaparmar03/minute_kart/blob/main/Backend/src/core/auth/auth.service.js) (Authentication), [`Backend/src/modules/quick-commerce/routes/quick-commerce.routes.js`](https://github.com/renukaparmar03/minute_kart/blob/main/Backend/src/modules/quick-commerce/routes/quick-commerce.routes.js) (Quick API Routes), [`Backend/src/modules/quick-commerce/services/content.service.js`](https://github.com/renukaparmar03/minute_kart/blob/main/Backend/src/modules/quick-commerce/services/content.service.js) (Storefront Content)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_quick["Quick Commerce"]
  node_qc_routes["Quick API Routes"]
  node_qc_admin["Quick Admin"]
  node_qc_catalog[("Product Catalog<br/>[product.model.js]")]
  node_qc_orders[("Quick Orders<br/>[order.model.js]")]
  node_qc_returns["Returns<br/>[return.service.js]"]
  node_qc_sellers["Seller Operations"]
  node_qc_content["Storefront Content<br/>[content.service.js]"]
end

subgraph group_food["Food Commerce"]
  node_food_orders["Food Ordering"]
  node_food_order_state[("Food Order State<br/>[order.model.js]")]
  node_restaurants["Restaurant Services"]
  node_food_admin["Food Administration"]
  node_delivery["Delivery Operations"]
  node_dining["Dining Services<br/>[dining.service.js]"]
end

subgraph group_platform["Platform Services"]
  node_auth["Authentication<br/>[auth.service.js]"]
  node_otp["OTP Service<br/>[otp.service.js]"]
  node_payments["Payment Operations"]
  node_payment_state[("Payment Records<br/>[payment.model.js]")]
  node_notifications["Push Notifications"]
end

subgraph group_milk["Milk Service"]
  node_milk_routes["Milk API Routes<br/>[index.js]"]
  node_milk_orders["Milk Plans"]
  node_milk_state[("Milk Plan State")]
end

node_shopper(("Shopper"))

node_shopper -->|"requests commerce"| node_qc_routes
node_qc_routes -->|"dispatches admin"| node_qc_admin
node_qc_admin -->|"reads products"| node_qc_catalog
node_qc_admin -->|"counts orders"| node_qc_orders
node_qc_admin -->|"loads content"| node_qc_content
node_qc_admin -->|"creates sections"| node_qc_content
node_qc_admin -->|"settles rider cash"| node_qc_sellers
node_auth -->|"creates OTP"| node_otp
node_auth -->|"verifies OTP"| node_otp
node_payments -->|"reads payment history"| node_payment_state

click node_qc_routes "https://github.com/renukaparmar03/minute_kart/blob/main/Backend/src/modules/quick-commerce/routes/quick-commerce.routes.js"
click node_qc_admin "https://github.com/renukaparmar03/minute_kart/blob/main/Backend/src/modules/quick-commerce/controllers/admin.controller.js"
click node_qc_catalog "https://github.com/renukaparmar03/minute_kart/blob/main/Backend/src/modules/quick-commerce/models/product.model.js"
click node_qc_orders "https://github.com/renukaparmar03/minute_kart/blob/main/Backend/src/modules/quick-commerce/models/order.model.js"
click node_qc_returns "https://github.com/renukaparmar03/minute_kart/blob/main/Backend/src/modules/quick-commerce/services/return.service.js"
click node_qc_sellers "https://github.com/renukaparmar03/minute_kart/blob/main/Backend/src/modules/quick-commerce/seller/controllers/seller.controller.js"
click node_qc_content "https://github.com/renukaparmar03/minute_kart/blob/main/Backend/src/modules/quick-commerce/services/content.service.js"
click node_food_orders "https://github.com/renukaparmar03/minute_kart/blob/main/Backend/src/modules/food/orders/controllers/order.controller.js"
click node_food_order_state "https://github.com/renukaparmar03/minute_kart/blob/main/Backend/src/modules/food/orders/models/order.model.js"
click node_restaurants "https://github.com/renukaparmar03/minute_kart/blob/main/Backend/src/modules/food/restaurant/controllers/restaurant.controller.js"
click node_food_admin "https://github.com/renukaparmar03/minute_kart/blob/main/Backend/src/modules/food/admin/controllers/admin.controller.js"
click node_delivery "https://github.com/renukaparmar03/minute_kart/blob/main/Backend/src/modules/food/delivery/controllers/delivery.controller.js"
click node_dining "https://github.com/renukaparmar03/minute_kart/blob/main/Backend/src/modules/food/dining/services/dining.service.js"
click node_auth "https://github.com/renukaparmar03/minute_kart/blob/main/Backend/src/core/auth/auth.service.js"
click node_otp "https://github.com/renukaparmar03/minute_kart/blob/main/Backend/src/core/otp/otp.service.js"
click node_payments "https://github.com/renukaparmar03/minute_kart/blob/main/Backend/src/core/payments/payment.controller.js"
click node_payment_state "https://github.com/renukaparmar03/minute_kart/blob/main/Backend/src/core/payments/models/payment.model.js"
click node_notifications "https://github.com/renukaparmar03/minute_kart/blob/main/Backend/src/core/notifications/firebase.service.js"
click node_milk_routes "https://github.com/renukaparmar03/minute_kart/blob/main/Backend/src/modules/dudhwala/routes/index.js"
click node_milk_orders "https://github.com/renukaparmar03/minute_kart/blob/main/Backend/src/modules/dudhwala/controllers/MilkOrder.controller.js"
click node_milk_state "https://github.com/renukaparmar03/minute_kart/blob/main/Backend/src/modules/dudhwala/models/MilkPlanOrder.model.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_qc_routes,node_qc_admin,node_qc_catalog,node_qc_orders,node_qc_returns,node_qc_sellers,node_qc_content toneBlue
class node_food_orders,node_food_order_state,node_restaurants,node_food_admin,node_delivery,node_dining toneAmber
class node_auth,node_otp,node_payments,node_payment_state,node_notifications toneMint
class node_milk_routes,node_milk_orders,node_milk_state toneRose
class node_shopper toneIndigo
```

## Components

### Quick Commerce

- [Quick API Routes](https://github.com/renukaparmar03/minute_kart/blob/main/Backend/src/modules/quick-commerce/routes/quick-commerce.routes.js): `Backend/src/modules/quick-commerce/routes/quick-commerce.routes.js`
- [Quick Admin](https://github.com/renukaparmar03/minute_kart/blob/main/Backend/src/modules/quick-commerce/controllers/admin.controller.js): `Backend/src/modules/quick-commerce/controllers/admin.controller.js`
- [Product Catalog](https://github.com/renukaparmar03/minute_kart/blob/main/Backend/src/modules/quick-commerce/models/product.model.js): `Backend/src/modules/quick-commerce/models/product.model.js`
- [Quick Orders](https://github.com/renukaparmar03/minute_kart/blob/main/Backend/src/modules/quick-commerce/models/order.model.js): `Backend/src/modules/quick-commerce/models/order.model.js`
- [Returns](https://github.com/renukaparmar03/minute_kart/blob/main/Backend/src/modules/quick-commerce/services/return.service.js): `Backend/src/modules/quick-commerce/services/return.service.js`
- [Seller Operations](https://github.com/renukaparmar03/minute_kart/blob/main/Backend/src/modules/quick-commerce/seller/controllers/seller.controller.js): `Backend/src/modules/quick-commerce/seller/controllers/seller.controller.js`
- [Storefront Content](https://github.com/renukaparmar03/minute_kart/blob/main/Backend/src/modules/quick-commerce/services/content.service.js): `Backend/src/modules/quick-commerce/services/content.service.js`

### Food Commerce

- [Food Ordering](https://github.com/renukaparmar03/minute_kart/blob/main/Backend/src/modules/food/orders/controllers/order.controller.js): `Backend/src/modules/food/orders/controllers/order.controller.js`
- [Food Order State](https://github.com/renukaparmar03/minute_kart/blob/main/Backend/src/modules/food/orders/models/order.model.js): `Backend/src/modules/food/orders/models/order.model.js`
- [Restaurant Services](https://github.com/renukaparmar03/minute_kart/blob/main/Backend/src/modules/food/restaurant/controllers/restaurant.controller.js): `Backend/src/modules/food/restaurant/controllers/restaurant.controller.js`
- [Food Administration](https://github.com/renukaparmar03/minute_kart/blob/main/Backend/src/modules/food/admin/controllers/admin.controller.js): `Backend/src/modules/food/admin/controllers/admin.controller.js`
- [Delivery Operations](https://github.com/renukaparmar03/minute_kart/blob/main/Backend/src/modules/food/delivery/controllers/delivery.controller.js): `Backend/src/modules/food/delivery/controllers/delivery.controller.js`
- [Dining Services](https://github.com/renukaparmar03/minute_kart/blob/main/Backend/src/modules/food/dining/services/dining.service.js): `Backend/src/modules/food/dining/services/dining.service.js`

### Platform Services

- [Authentication](https://github.com/renukaparmar03/minute_kart/blob/main/Backend/src/core/auth/auth.service.js): `Backend/src/core/auth/auth.service.js`
- [OTP Service](https://github.com/renukaparmar03/minute_kart/blob/main/Backend/src/core/otp/otp.service.js): `Backend/src/core/otp/otp.service.js`
- [Payment Operations](https://github.com/renukaparmar03/minute_kart/blob/main/Backend/src/core/payments/payment.controller.js): `Backend/src/core/payments/payment.controller.js`
- [Payment Records](https://github.com/renukaparmar03/minute_kart/blob/main/Backend/src/core/payments/models/payment.model.js): `Backend/src/core/payments/models/payment.model.js`
- [Push Notifications](https://github.com/renukaparmar03/minute_kart/blob/main/Backend/src/core/notifications/firebase.service.js): `Backend/src/core/notifications/firebase.service.js`

### Milk Service

- [Milk API Routes](https://github.com/renukaparmar03/minute_kart/blob/main/Backend/src/modules/dudhwala/routes/index.js): `Backend/src/modules/dudhwala/routes/index.js`
- [Milk Plans](https://github.com/renukaparmar03/minute_kart/blob/main/Backend/src/modules/dudhwala/controllers/MilkOrder.controller.js): `Backend/src/modules/dudhwala/controllers/MilkOrder.controller.js`
- [Milk Plan State](https://github.com/renukaparmar03/minute_kart/blob/main/Backend/src/modules/dudhwala/models/MilkPlanOrder.model.js): `Backend/src/modules/dudhwala/models/MilkPlanOrder.model.js`

### Other components

- **Shopper**

## Connections

- Shopper → Quick API Routes: requests commerce
- Quick API Routes → Quick Admin: dispatches admin
- Quick Admin → Product Catalog: reads products
- Quick Admin → Quick Orders: counts orders
- Quick Admin → Storefront Content: loads content
- Quick Admin → Storefront Content: creates sections
- Quick Admin → Seller Operations: settles rider cash
- Authentication → OTP Service: creates OTP
- Authentication → OTP Service: verifies OTP
- Payment Operations → Payment Records: reads payment history