# saniya454/textileb2b architecture

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

## Overview

TextileHub is a B2B fabric procurement marketplace connecting garment buyers with verified mills. The primary workflow is browsing and comparing fabrics or suppliers, then using buyer-portal ordering; suppliers manage listings and inventory, while role-aware authentication and AI assistance support both sides. The backend exposes Express APIs over MongoDB, with a documented Vercel serverless entry point. The graph emphasizes documented routes and sampled imports; unsampled page-to-service and order-processing details are left unconnected where evidence is unavailable.

Main entry points: [`frontend/src/routes/AppRoutes.jsx`](https://github.com/saniya454/textileb2b/blob/main/frontend/src/routes/AppRoutes.jsx) (App routes), [`backend/services/aiService.js`](https://github.com/saniya454/textileb2b/blob/main/backend/services/aiService.js) (Contextual AI), [`backend/models/Supplier.js`](https://github.com/saniya454/textileb2b/blob/main/backend/models/Supplier.js) (Supplier records), [`backend/app.js`](https://github.com/saniya454/textileb2b/blob/main/backend/app.js) (Express API)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Marketplace client"]
  node_app_routes["App routes<br/>[AppRoutes.jsx]"]
  node_auth_context["Role and session<br/>[AuthContext.jsx]"]
  node_auth_service["Authentication client<br/>[authService.js]"]
  node_api_client["API client<br/>[api.js]"]
end

subgraph group_commerce["Procurement and mills"]
  node_public_market["Public marketplace"]
  node_supplier_directory["Supplier directory<br/>[SuppliersPage.jsx]"]
  node_buyer_portal["Buyer portal"]
  node_supplier_inventory["Supplier inventory"]
end

subgraph group_backend["API and domain services"]
  node_express_app["Express API<br/>[app.js]"]
  node_auth_routes["Authentication routes<br/>[authRoutes.js]"]
  node_product_routes["Product routes<br/>[productRoutes.js]"]
  node_ai_routes["AI routes<br/>[aiRoutes.js]"]
  node_auth_controller["Auth and profile<br/>[authController.js]"]
  node_product_controller["Product catalog"]
  node_supplier_controller["Supplier profiles"]
  node_order_controller["Order handling<br/>[orderController.js]"]
  node_ai_controller["AI chat API<br/>[aiController.js]"]
  node_ai_service["Contextual AI<br/>[aiService.js]"]
end

subgraph group_data["Persistent data"]
  node_user_model[("User records<br/>[User.js]")]
  node_supplier_model[("Supplier records<br/>[Supplier.js]")]
  node_product_model[("Product records<br/>[Product.js]")]
  node_order_model[("Order records<br/>[Order.js]")]
  node_chat_model[("Chat history<br/>[Chat.js]")]
end

node_buyer(("Buyer"))
node_supplier_actor(("Supplier"))
node_mongodb[("MongoDB Atlas")]
node_llm(("Hugging Face LLM"))

node_buyer -->|"browses and signs in"| node_app_routes
node_supplier_actor -->|"opens supplier portal"| node_app_routes
node_app_routes -->|"routes public"| node_public_market
node_app_routes -->|"routes public"| node_supplier_directory
node_app_routes -->|"protects buyer routes"| node_buyer_portal
node_app_routes -->|"protects supplier routes"| node_supplier_inventory
node_auth_context -->|"uses"| node_auth_service
node_auth_service -->|"sends requests"| node_api_client
node_api_client -->|"calls API"| node_express_app
node_express_app -->|"mounts"| node_auth_routes
node_express_app -->|"mounts"| node_product_routes
node_express_app -->|"mounts"| node_ai_routes
node_auth_routes -->|"dispatches"| node_auth_controller
node_product_routes -->|"dispatches"| node_product_controller
node_ai_routes -->|"dispatches"| node_ai_controller
node_auth_controller -->|"reads and writes"| node_user_model
node_auth_controller -->|"syncs profiles"| node_supplier_model
node_product_controller -->|"queries listings"| node_product_model
node_product_controller -->|"updates supplier count"| node_supplier_model
node_supplier_controller -->|"manages profiles"| node_supplier_model
node_supplier_controller -->|"synchronizes users"| node_user_model
node_supplier_controller -->|"updates listings"| node_product_model
node_order_controller -->|"handles orders"| node_order_model
node_ai_controller -->|"delegates inference"| node_ai_service
node_ai_controller -->|"persists history"| node_chat_model
node_ai_service -->|"reads catalog"| node_product_model
node_ai_service -->|"reads suppliers"| node_supplier_model
node_ai_service -->|"reads purchases"| node_order_model
node_user_model -.->|"persists"| node_mongodb
node_supplier_model -.->|"persists"| node_mongodb
node_product_model -.->|"persists"| node_mongodb
node_order_model -.->|"persists"| node_mongodb
node_chat_model -.->|"persists"| node_mongodb
node_ai_service -.->|"requests inference"| node_llm

click node_app_routes "https://github.com/saniya454/textileb2b/blob/main/frontend/src/routes/AppRoutes.jsx"
click node_public_market "https://github.com/saniya454/textileb2b/blob/main/frontend/src/pages/MarketplacePage.jsx"
click node_supplier_directory "https://github.com/saniya454/textileb2b/blob/main/frontend/src/pages/SuppliersPage.jsx"
click node_buyer_portal "https://github.com/saniya454/textileb2b/blob/main/frontend/src/pages/buyer/BuyerMarketplace.jsx"
click node_supplier_inventory "https://github.com/saniya454/textileb2b/blob/main/frontend/src/pages/supplier/SupplierInventory.jsx"
click node_auth_context "https://github.com/saniya454/textileb2b/blob/main/frontend/src/context/AuthContext.jsx"
click node_auth_service "https://github.com/saniya454/textileb2b/blob/main/frontend/src/services/authService.js"
click node_api_client "https://github.com/saniya454/textileb2b/blob/main/frontend/src/services/api.js"
click node_express_app "https://github.com/saniya454/textileb2b/blob/main/backend/app.js"
click node_auth_routes "https://github.com/saniya454/textileb2b/blob/main/backend/routes/authRoutes.js"
click node_product_routes "https://github.com/saniya454/textileb2b/blob/main/backend/routes/productRoutes.js"
click node_ai_routes "https://github.com/saniya454/textileb2b/blob/main/backend/routes/aiRoutes.js"
click node_auth_controller "https://github.com/saniya454/textileb2b/blob/main/backend/controllers/authController.js"
click node_product_controller "https://github.com/saniya454/textileb2b/blob/main/backend/controllers/productController.js"
click node_supplier_controller "https://github.com/saniya454/textileb2b/blob/main/backend/controllers/supplierController.js"
click node_order_controller "https://github.com/saniya454/textileb2b/blob/main/backend/controllers/orderController.js"
click node_ai_controller "https://github.com/saniya454/textileb2b/blob/main/backend/controllers/aiController.js"
click node_ai_service "https://github.com/saniya454/textileb2b/blob/main/backend/services/aiService.js"
click node_user_model "https://github.com/saniya454/textileb2b/blob/main/backend/models/User.js"
click node_supplier_model "https://github.com/saniya454/textileb2b/blob/main/backend/models/Supplier.js"
click node_product_model "https://github.com/saniya454/textileb2b/blob/main/backend/models/Product.js"
click node_order_model "https://github.com/saniya454/textileb2b/blob/main/backend/models/Order.js"
click node_chat_model "https://github.com/saniya454/textileb2b/blob/main/backend/models/Chat.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_routes,node_auth_context,node_auth_service,node_api_client toneBlue
class node_public_market,node_supplier_directory,node_buyer_portal,node_supplier_inventory,node_mongodb toneAmber
class node_express_app,node_auth_routes,node_product_routes,node_ai_routes,node_auth_controller,node_product_controller,node_supplier_controller,node_order_controller,node_ai_controller,node_ai_service toneMint
class node_user_model,node_supplier_model,node_product_model,node_order_model,node_chat_model toneRose
class node_buyer,node_supplier_actor,node_llm toneIndigo
```

## Components

### Marketplace client

- [App routes](https://github.com/saniya454/textileb2b/blob/main/frontend/src/routes/AppRoutes.jsx): `frontend/src/routes/AppRoutes.jsx`
- [Role and session](https://github.com/saniya454/textileb2b/blob/main/frontend/src/context/AuthContext.jsx): `frontend/src/context/AuthContext.jsx`
- [Authentication client](https://github.com/saniya454/textileb2b/blob/main/frontend/src/services/authService.js): `frontend/src/services/authService.js`
- [API client](https://github.com/saniya454/textileb2b/blob/main/frontend/src/services/api.js): `frontend/src/services/api.js`

### Procurement and mills

- [Public marketplace](https://github.com/saniya454/textileb2b/blob/main/frontend/src/pages/MarketplacePage.jsx): `frontend/src/pages/MarketplacePage.jsx`
- [Supplier directory](https://github.com/saniya454/textileb2b/blob/main/frontend/src/pages/SuppliersPage.jsx): `frontend/src/pages/SuppliersPage.jsx`
- [Buyer portal](https://github.com/saniya454/textileb2b/blob/main/frontend/src/pages/buyer/BuyerMarketplace.jsx): `frontend/src/pages/buyer/BuyerMarketplace.jsx`
- [Supplier inventory](https://github.com/saniya454/textileb2b/blob/main/frontend/src/pages/supplier/SupplierInventory.jsx): `frontend/src/pages/supplier/SupplierInventory.jsx`

### API and domain services

- [Express API](https://github.com/saniya454/textileb2b/blob/main/backend/app.js): `backend/app.js`
- [Authentication routes](https://github.com/saniya454/textileb2b/blob/main/backend/routes/authRoutes.js): `backend/routes/authRoutes.js`
- [Product routes](https://github.com/saniya454/textileb2b/blob/main/backend/routes/productRoutes.js): `backend/routes/productRoutes.js`
- [AI routes](https://github.com/saniya454/textileb2b/blob/main/backend/routes/aiRoutes.js): `backend/routes/aiRoutes.js`
- [Auth and profile](https://github.com/saniya454/textileb2b/blob/main/backend/controllers/authController.js): `backend/controllers/authController.js`
- [Product catalog](https://github.com/saniya454/textileb2b/blob/main/backend/controllers/productController.js): `backend/controllers/productController.js`
- [Supplier profiles](https://github.com/saniya454/textileb2b/blob/main/backend/controllers/supplierController.js): `backend/controllers/supplierController.js`
- [Order handling](https://github.com/saniya454/textileb2b/blob/main/backend/controllers/orderController.js): `backend/controllers/orderController.js`
- [AI chat API](https://github.com/saniya454/textileb2b/blob/main/backend/controllers/aiController.js): `backend/controllers/aiController.js`
- [Contextual AI](https://github.com/saniya454/textileb2b/blob/main/backend/services/aiService.js): `backend/services/aiService.js`

### Persistent data

- [User records](https://github.com/saniya454/textileb2b/blob/main/backend/models/User.js): `backend/models/User.js`
- [Supplier records](https://github.com/saniya454/textileb2b/blob/main/backend/models/Supplier.js): `backend/models/Supplier.js`
- [Product records](https://github.com/saniya454/textileb2b/blob/main/backend/models/Product.js): `backend/models/Product.js`
- [Order records](https://github.com/saniya454/textileb2b/blob/main/backend/models/Order.js): `backend/models/Order.js`
- [Chat history](https://github.com/saniya454/textileb2b/blob/main/backend/models/Chat.js): `backend/models/Chat.js`

### Other components

- **Buyer**
- **Supplier**
- **MongoDB Atlas**
- **Hugging Face LLM**

## Connections

- Buyer → App routes: browses and signs in (evidence: `frontend/src/routes/AppRoutes.jsx`)
- Supplier → App routes: opens supplier portal (evidence: `frontend/src/routes/AppRoutes.jsx`)
- App routes → Public marketplace: routes public (evidence: `frontend/src/routes/AppRoutes.jsx`)
- App routes → Supplier directory: routes public (evidence: `frontend/src/routes/AppRoutes.jsx`)
- App routes → Buyer portal: protects buyer routes (evidence: `frontend/src/routes/AppRoutes.jsx`)
- App routes → Supplier inventory: protects supplier routes (evidence: `frontend/src/routes/AppRoutes.jsx`)
- Role and session → Authentication client: uses (evidence: `frontend/src/context/AuthContext.jsx`)
- Authentication client → API client: sends requests (evidence: `frontend/src/services/authService.js`)
- API client → Express API: calls API (evidence: `README.md`)
- Express API → Authentication routes: mounts (evidence: `backend/app.js`)
- Express API → Product routes: mounts (evidence: `backend/app.js`)
- Express API → AI routes: mounts (evidence: `backend/app.js`)
- Authentication routes → Auth and profile: dispatches (evidence: `backend/routes/authRoutes.js`)
- Product routes → Product catalog: dispatches (evidence: `backend/routes/productRoutes.js`)
- AI routes → AI chat API: dispatches (evidence: `backend/routes/aiRoutes.js`)
- Auth and profile → User records: reads and writes (evidence: `backend/controllers/authController.js`)
- Auth and profile → Supplier records: syncs profiles (evidence: `backend/controllers/authController.js`)
- Product catalog → Product records: queries listings (evidence: `backend/controllers/productController.js`)
- Product catalog → Supplier records: updates supplier count (evidence: `backend/controllers/productController.js`)
- Supplier profiles → Supplier records: manages profiles (evidence: `backend/controllers/supplierController.js`)
- Supplier profiles → User records: synchronizes users (evidence: `backend/controllers/supplierController.js`)
- Supplier profiles → Product records: updates listings (evidence: `backend/controllers/supplierController.js`)
- Order handling → Order records: handles orders (evidence: `backend/controllers/orderController.js`)
- AI chat API → Contextual AI: delegates inference (evidence: `backend/controllers/aiController.js`)
- AI chat API → Chat history: persists history (evidence: `backend/controllers/aiController.js`)
- Contextual AI → Product records: reads catalog (evidence: `backend/services/aiService.js`)
- Contextual AI → Supplier records: reads suppliers (evidence: `backend/services/aiService.js`)
- Contextual AI → Order records: reads purchases (evidence: `backend/services/aiService.js`)
- User records → MongoDB Atlas: persists
- Supplier records → MongoDB Atlas: persists
- Product records → MongoDB Atlas: persists
- Order records → MongoDB Atlas: persists
- Chat history → MongoDB Atlas: persists
- Contextual AI → Hugging Face LLM: requests inference
