# lekhai123/binstudio architecture

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

- Interactive diagram: https://gitdiagram.com/lekhai123/binstudio
- Repository: https://github.com/lekhai123/binstudio

## Overview

BinStudio is an online clothing storefront with customer accounts, product browsing and carts, checkout/payment, and order fulfillment; administrators manage products, users, orders, revenue, and homepage content. The main path runs from the Express server through shared routes into customer actions, which use Mongo-backed models; order handling also reaches payment and shipping integrations. The tree contains a second “Copy” implementation, represented as a separate legacy branch. Several route/controller links and unsampled capabilities are visible only by their module names, so those connections are omitted rather than inferred.

Main entry points: [`BinStudioFNFNFNFNFNFN/Controller/userOrderController.js`](https://github.com/lekhai123/binstudio/blob/main/BinStudioFNFNFNFNFNFN/Controller/userOrderController.js) (Checkout and orders), [`BinStudioFNFNFNFNFNFN/Models/product.js`](https://github.com/lekhai123/binstudio/blob/main/BinStudioFNFNFNFNFNFN/Models/product.js) (Products), [`BinStudioFNFNFNFNFNFN/Controller/adminController.js`](https://github.com/lekhai123/binstudio/blob/main/BinStudioFNFNFNFNFNFN/Controller/adminController.js) (Admin dashboard), [`BinStudioFNFNFNFNFNFN/Service/telegramService.js`](https://github.com/lekhai123/binstudio/blob/main/BinStudioFNFNFNFNFNFN/Service/telegramService.js) (Telegram order bot)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["Web entry"]
  node_server["Express server<br/>[server.js]"]
  node_user_routes["Customer routes<br/>[userIndexRoute.js]"]
  node_admin_routes["Admin routes<br/>[adminIndexRoute.js]"]
  node_auth_routes["Authentication routes<br/>[authRoute.js]"]
end

subgraph group_customer["Customer commerce"]
  node_auth_user["Customer authentication"]
  node_user_cart["Cart operations"]
  node_user_actions["Storefront actions<br/>[userController.js]"]
  node_user_order["Checkout and orders"]
end

subgraph group_admin["Store administration"]
  node_admin_actions["Admin dashboard<br/>[adminController.js]"]
  node_admin_products["Product management"]
  node_admin_orders["Order and revenue"]
end

subgraph group_data["Commerce data"]
  node_products[("Products<br/>[product.js]")]
  node_carts[("Carts<br/>[cart.js]")]
  node_orders[("Orders<br/>[order.js]")]
  node_users[("Users<br/>[user.js]")]
  node_page_content[("Homepage content<br/>[pagecontent.js]")]
  node_otp[("One-time codes<br/>[otp.js]")]
end

subgraph group_integrations["External services"]
  node_cloudinary_config["Image configuration<br/>[cloudinary.js]"]
  node_ghn_service["GHN shipping<br/>[ghnService.js]"]
  node_telegram["Telegram order bot<br/>[telegramService.js]"]
end

subgraph group_legacy["Copy implementation"]
  node_legacy_checkout["Legacy checkout"]
  node_legacy_cart[("Legacy carts<br/>[cart.js]")]
  node_legacy_orders[("Legacy orders<br/>[order.js]")]
  node_legacy_products[("Legacy products<br/>[product.js]")]
end

node_customer(("Customer"))
node_admin_actor(("Admin"))
node_cloudinary["Cloudinary"]
node_ghn["GHN carrier"]
node_telegram_service["Telegram"]
node_payos["PayOS payments"]
node_mongo[("MongoDB")]

node_customer -->|"uses storefront"| node_server
node_admin_actor -->|"uses admin"| node_server
node_server -->|"mounts routes"| node_user_routes
node_server -->|"mounts routes"| node_admin_routes
node_server -->|"connects"| node_mongo
node_auth_routes -->|"routes to"| node_auth_user
node_admin_routes -.->|"registers"| node_admin_products
node_user_order -->|"reads/writes"| node_orders
node_user_order -->|"reads/writes"| node_carts
node_user_order -->|"reads/writes"| node_products
node_user_order -->|"requests shipping"| node_ghn_service
node_user_order -->|"notifies"| node_telegram
node_user_order -->|"creates payment"| node_payos
node_ghn_service -->|"calls API"| node_ghn
node_telegram -->|"sends updates"| node_telegram_service
node_telegram -->|"updates"| node_orders
node_telegram -->|"restocks"| node_products
node_telegram -->|"requests fulfillment"| node_ghn_service
node_admin_actions -->|"reads"| node_users
node_admin_actions -->|"reads"| node_products
node_admin_actions -->|"reads"| node_orders
node_admin_actions -->|"manages"| node_page_content
node_admin_actions -->|"uses uploads"| node_cloudinary_config
node_cloudinary_config -->|"configures"| node_cloudinary
node_admin_products -->|"manages"| node_products
node_admin_orders -->|"reports on"| node_orders
node_admin_orders -->|"reads"| node_products
node_user_cart -->|"reads/writes"| node_carts
node_user_cart -->|"reads"| node_products
node_user_actions -->|"reads"| node_products
node_user_actions -->|"reads"| node_carts
node_user_actions -->|"reads"| node_orders
node_user_actions -->|"reads"| node_page_content
node_auth_user -->|"authenticates"| node_users
node_auth_user -->|"uses codes"| node_otp
node_legacy_checkout -->|"reads/writes"| node_legacy_orders
node_legacy_checkout -->|"reads/writes"| node_legacy_cart
node_legacy_checkout -->|"reads/writes"| node_legacy_products

click node_server "https://github.com/lekhai123/binstudio/blob/main/BinStudioFNFNFNFNFNFN/server.js"
click node_user_routes "https://github.com/lekhai123/binstudio/blob/main/BinStudioFNFNFNFNFNFN/route/userIndexRoute.js"
click node_admin_routes "https://github.com/lekhai123/binstudio/blob/main/BinStudioFNFNFNFNFNFN/route/adminIndexRoute.js"
click node_auth_routes "https://github.com/lekhai123/binstudio/blob/main/BinStudioFNFNFNFNFNFN/route/authRoute.js"
click node_auth_user "https://github.com/lekhai123/binstudio/blob/main/BinStudioFNFNFNFNFNFN/Controller/authUserController.js"
click node_user_cart "https://github.com/lekhai123/binstudio/blob/main/BinStudioFNFNFNFNFNFN/Controller/userCartController.js"
click node_user_actions "https://github.com/lekhai123/binstudio/blob/main/BinStudioFNFNFNFNFNFN/Controller/userController.js"
click node_user_order "https://github.com/lekhai123/binstudio/blob/main/BinStudioFNFNFNFNFNFN/Controller/userOrderController.js"
click node_admin_actions "https://github.com/lekhai123/binstudio/blob/main/BinStudioFNFNFNFNFNFN/Controller/adminController.js"
click node_admin_products "https://github.com/lekhai123/binstudio/blob/main/BinStudioFNFNFNFNFNFN/Controller/adminProductController.js"
click node_admin_orders "https://github.com/lekhai123/binstudio/blob/main/BinStudioFNFNFNFNFNFN/Controller/adminOrder%26RevenueController.js"
click node_products "https://github.com/lekhai123/binstudio/blob/main/BinStudioFNFNFNFNFNFN/Models/product.js"
click node_carts "https://github.com/lekhai123/binstudio/blob/main/BinStudioFNFNFNFNFNFN/Models/cart.js"
click node_orders "https://github.com/lekhai123/binstudio/blob/main/BinStudioFNFNFNFNFNFN/Models/order.js"
click node_users "https://github.com/lekhai123/binstudio/blob/main/BinStudioFNFNFNFNFNFN/Models/user.js"
click node_page_content "https://github.com/lekhai123/binstudio/blob/main/BinStudioFNFNFNFNFNFN/Models/pagecontent.js"
click node_otp "https://github.com/lekhai123/binstudio/blob/main/BinStudioFNFNFNFNFNFN/Models/otp.js"
click node_cloudinary_config "https://github.com/lekhai123/binstudio/blob/main/BinStudioFNFNFNFNFNFN/config/cloudinary.js"
click node_ghn_service "https://github.com/lekhai123/binstudio/blob/main/BinStudioFNFNFNFNFNFN/Service/ghnService.js"
click node_telegram "https://github.com/lekhai123/binstudio/blob/main/BinStudioFNFNFNFNFNFN/Service/telegramService.js"
click node_legacy_checkout "https://github.com/lekhai123/binstudio/blob/main/BinStudioFNFNFNFNFNFN/BinStudioFNFNFNFNFNFN%20-%20Copy/Controller/userOrderController.js"
click node_legacy_cart "https://github.com/lekhai123/binstudio/blob/main/BinStudioFNFNFNFNFNFN/BinStudioFNFNFNFNFNFN%20-%20Copy/Models/cart.js"
click node_legacy_orders "https://github.com/lekhai123/binstudio/blob/main/BinStudioFNFNFNFNFNFN/BinStudioFNFNFNFNFNFN%20-%20Copy/Models/order.js"
click node_legacy_products "https://github.com/lekhai123/binstudio/blob/main/BinStudioFNFNFNFNFNFN/BinStudioFNFNFNFNFNFN%20-%20Copy/Models/product.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_server,node_user_routes,node_admin_routes,node_auth_routes toneBlue
class node_auth_user,node_user_cart,node_user_actions,node_user_order,node_mongo toneAmber
class node_admin_actions,node_admin_products,node_admin_orders toneMint
class node_products,node_carts,node_orders,node_users,node_page_content,node_otp toneRose
class node_cloudinary_config,node_ghn_service,node_telegram,node_customer,node_admin_actor,node_cloudinary,node_ghn,node_telegram_service,node_payos toneIndigo
class node_legacy_checkout,node_legacy_cart,node_legacy_orders,node_legacy_products toneTeal
```

## Components

### Web entry

- [Express server](https://github.com/lekhai123/binstudio/blob/main/BinStudioFNFNFNFNFNFN/server.js): `BinStudioFNFNFNFNFNFN/server.js`
- [Customer routes](https://github.com/lekhai123/binstudio/blob/main/BinStudioFNFNFNFNFNFN/route/userIndexRoute.js): `BinStudioFNFNFNFNFNFN/route/userIndexRoute.js`
- [Admin routes](https://github.com/lekhai123/binstudio/blob/main/BinStudioFNFNFNFNFNFN/route/adminIndexRoute.js): `BinStudioFNFNFNFNFNFN/route/adminIndexRoute.js`
- [Authentication routes](https://github.com/lekhai123/binstudio/blob/main/BinStudioFNFNFNFNFNFN/route/authRoute.js): `BinStudioFNFNFNFNFNFN/route/authRoute.js`

### Customer commerce

- [Customer authentication](https://github.com/lekhai123/binstudio/blob/main/BinStudioFNFNFNFNFNFN/Controller/authUserController.js): `BinStudioFNFNFNFNFNFN/Controller/authUserController.js`
- [Cart operations](https://github.com/lekhai123/binstudio/blob/main/BinStudioFNFNFNFNFNFN/Controller/userCartController.js): `BinStudioFNFNFNFNFNFN/Controller/userCartController.js`
- [Storefront actions](https://github.com/lekhai123/binstudio/blob/main/BinStudioFNFNFNFNFNFN/Controller/userController.js): `BinStudioFNFNFNFNFNFN/Controller/userController.js`
- [Checkout and orders](https://github.com/lekhai123/binstudio/blob/main/BinStudioFNFNFNFNFNFN/Controller/userOrderController.js): `BinStudioFNFNFNFNFNFN/Controller/userOrderController.js`

### Store administration

- [Admin dashboard](https://github.com/lekhai123/binstudio/blob/main/BinStudioFNFNFNFNFNFN/Controller/adminController.js): `BinStudioFNFNFNFNFNFN/Controller/adminController.js`
- [Product management](https://github.com/lekhai123/binstudio/blob/main/BinStudioFNFNFNFNFNFN/Controller/adminProductController.js): `BinStudioFNFNFNFNFNFN/Controller/adminProductController.js`
- [Order and revenue](https://github.com/lekhai123/binstudio/blob/main/BinStudioFNFNFNFNFNFN/Controller/adminOrder%26RevenueController.js): `BinStudioFNFNFNFNFNFN/Controller/adminOrder&RevenueController.js`

### Commerce data

- [Products](https://github.com/lekhai123/binstudio/blob/main/BinStudioFNFNFNFNFNFN/Models/product.js): `BinStudioFNFNFNFNFNFN/Models/product.js`
- [Carts](https://github.com/lekhai123/binstudio/blob/main/BinStudioFNFNFNFNFNFN/Models/cart.js): `BinStudioFNFNFNFNFNFN/Models/cart.js`
- [Orders](https://github.com/lekhai123/binstudio/blob/main/BinStudioFNFNFNFNFNFN/Models/order.js): `BinStudioFNFNFNFNFNFN/Models/order.js`
- [Users](https://github.com/lekhai123/binstudio/blob/main/BinStudioFNFNFNFNFNFN/Models/user.js): `BinStudioFNFNFNFNFNFN/Models/user.js`
- [Homepage content](https://github.com/lekhai123/binstudio/blob/main/BinStudioFNFNFNFNFNFN/Models/pagecontent.js): `BinStudioFNFNFNFNFNFN/Models/pagecontent.js`
- [One-time codes](https://github.com/lekhai123/binstudio/blob/main/BinStudioFNFNFNFNFNFN/Models/otp.js): `BinStudioFNFNFNFNFNFN/Models/otp.js`

### External services

- [Image configuration](https://github.com/lekhai123/binstudio/blob/main/BinStudioFNFNFNFNFNFN/config/cloudinary.js): `BinStudioFNFNFNFNFNFN/config/cloudinary.js`
- [GHN shipping](https://github.com/lekhai123/binstudio/blob/main/BinStudioFNFNFNFNFNFN/Service/ghnService.js): `BinStudioFNFNFNFNFNFN/Service/ghnService.js`
- [Telegram order bot](https://github.com/lekhai123/binstudio/blob/main/BinStudioFNFNFNFNFNFN/Service/telegramService.js): `BinStudioFNFNFNFNFNFN/Service/telegramService.js`

### Copy implementation

- [Legacy checkout](https://github.com/lekhai123/binstudio/blob/main/BinStudioFNFNFNFNFNFN/BinStudioFNFNFNFNFNFN%20-%20Copy/Controller/userOrderController.js): `BinStudioFNFNFNFNFNFN/BinStudioFNFNFNFNFNFN - Copy/Controller/userOrderController.js`
- [Legacy carts](https://github.com/lekhai123/binstudio/blob/main/BinStudioFNFNFNFNFNFN/BinStudioFNFNFNFNFNFN%20-%20Copy/Models/cart.js): `BinStudioFNFNFNFNFNFN/BinStudioFNFNFNFNFNFN - Copy/Models/cart.js`
- [Legacy orders](https://github.com/lekhai123/binstudio/blob/main/BinStudioFNFNFNFNFNFN/BinStudioFNFNFNFNFNFN%20-%20Copy/Models/order.js): `BinStudioFNFNFNFNFNFN/BinStudioFNFNFNFNFNFN - Copy/Models/order.js`
- [Legacy products](https://github.com/lekhai123/binstudio/blob/main/BinStudioFNFNFNFNFNFN/BinStudioFNFNFNFNFNFN%20-%20Copy/Models/product.js): `BinStudioFNFNFNFNFNFN/BinStudioFNFNFNFNFNFN - Copy/Models/product.js`

### Other components

- **Customer**
- **Admin**
- **Cloudinary**
- **GHN carrier**
- **Telegram**
- **PayOS payments**
- **MongoDB**

## Connections

- Customer → Express server: uses storefront (evidence: `BinStudioFNFNFNFNFNFN/server.js`)
- Admin → Express server: uses admin (evidence: `BinStudioFNFNFNFNFNFN/server.js`)
- Express server → Customer routes: mounts routes (evidence: `BinStudioFNFNFNFNFNFN/server.js`)
- Express server → Admin routes: mounts routes (evidence: `BinStudioFNFNFNFNFNFN/server.js`)
- Express server → MongoDB: connects (evidence: `BinStudioFNFNFNFNFNFN/server.js`)
- Authentication routes → Customer authentication: routes to (evidence: `BinStudioFNFNFNFNFNFN/route/authRoute.js`)
- Admin routes → Product management: registers
- Checkout and orders → Orders: reads/writes (evidence: `BinStudioFNFNFNFNFNFN/Controller/userOrderController.js`)
- Checkout and orders → Carts: reads/writes (evidence: `BinStudioFNFNFNFNFNFN/Controller/userOrderController.js`)
- Checkout and orders → Products: reads/writes (evidence: `BinStudioFNFNFNFNFNFN/Controller/userOrderController.js`)
- Checkout and orders → GHN shipping: requests shipping (evidence: `BinStudioFNFNFNFNFNFN/Controller/userOrderController.js`)
- Checkout and orders → Telegram order bot: notifies (evidence: `BinStudioFNFNFNFNFNFN/Controller/userOrderController.js`)
- Checkout and orders → PayOS payments: creates payment (evidence: `BinStudioFNFNFNFNFNFN/Controller/userOrderController.js`)
- GHN shipping → GHN carrier: calls API (evidence: `BinStudioFNFNFNFNFNFN/Service/ghnService.js`)
- Telegram order bot → Telegram: sends updates (evidence: `BinStudioFNFNFNFNFNFN/Service/telegramService.js`)
- Telegram order bot → Orders: updates (evidence: `BinStudioFNFNFNFNFNFN/Service/telegramService.js`)
- Telegram order bot → Products: restocks (evidence: `BinStudioFNFNFNFNFNFN/Service/telegramService.js`)
- Telegram order bot → GHN shipping: requests fulfillment (evidence: `BinStudioFNFNFNFNFNFN/Service/telegramService.js`)
- Admin dashboard → Users: reads (evidence: `BinStudioFNFNFNFNFNFN/Controller/adminController.js`)
- Admin dashboard → Products: reads (evidence: `BinStudioFNFNFNFNFNFN/Controller/adminController.js`)
- Admin dashboard → Orders: reads (evidence: `BinStudioFNFNFNFNFNFN/Controller/adminController.js`)
- Admin dashboard → Homepage content: manages (evidence: `BinStudioFNFNFNFNFNFN/Controller/adminController.js`)
- Admin dashboard → Image configuration: uses uploads (evidence: `BinStudioFNFNFNFNFNFN/Controller/adminController.js`)
- Image configuration → Cloudinary: configures (evidence: `BinStudioFNFNFNFNFNFN/config/cloudinary.js`)
- Product management → Products: manages (evidence: `BinStudioFNFNFNFNFNFN/Controller/adminProductController.js`)
- Order and revenue → Orders: reports on (evidence: `BinStudioFNFNFNFNFNFN/Controller/adminOrder&RevenueController.js`)
- Order and revenue → Products: reads (evidence: `BinStudioFNFNFNFNFNFN/Controller/adminOrder&RevenueController.js`)
- Cart operations → Carts: reads/writes (evidence: `BinStudioFNFNFNFNFNFN/Controller/userCartController.js`)
- Cart operations → Products: reads (evidence: `BinStudioFNFNFNFNFNFN/Controller/userCartController.js`)
- Storefront actions → Products: reads (evidence: `BinStudioFNFNFNFNFNFN/Controller/userController.js`)
- Storefront actions → Carts: reads (evidence: `BinStudioFNFNFNFNFNFN/Controller/userController.js`)
- Storefront actions → Orders: reads (evidence: `BinStudioFNFNFNFNFNFN/Controller/userController.js`)
- Storefront actions → Homepage content: reads (evidence: `BinStudioFNFNFNFNFNFN/Controller/userController.js`)
- Customer authentication → Users: authenticates (evidence: `BinStudioFNFNFNFNFNFN/Controller/authUserController.js`)
- Customer authentication → One-time codes: uses codes (evidence: `BinStudioFNFNFNFNFNFN/Controller/authUserController.js`)
- Legacy checkout → Legacy orders: reads/writes (evidence: `BinStudioFNFNFNFNFNFN/BinStudioFNFNFNFNFNFN - Copy/Controller/userOrderController.js`)
- Legacy checkout → Legacy carts: reads/writes (evidence: `BinStudioFNFNFNFNFNFN/BinStudioFNFNFNFNFNFN - Copy/Controller/userOrderController.js`)
- Legacy checkout → Legacy products: reads/writes (evidence: `BinStudioFNFNFNFNFNFN/BinStudioFNFNFNFNFNFN - Copy/Controller/userOrderController.js`)
