# rohannes64/home-design-prot architecture

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

- Interactive diagram: https://gitdiagram.com/rohannes64/home-design-prot
- Repository: https://github.com/rohannes64/home-design-prot

## Overview

DSYN Luxury’s Stratum AI Room Visualizer lets clients apply stone and moulding products to room photos, then save/share renders, request quotes, or purchase materials. The main path runs from the React visualizer through the Express visualizer API to the Python segmentation and texture-mapping service; catalog, render, quote, and checkout features extend that flow. Admin tools manage catalogues, users, orders, renders, and quote CRM. Edges reflect shown imports, route mounts, or README-documented relationships; unsampled feature internals are represented at their existing directory paths.

Main entry points: [`server/index.js`](https://github.com/rohannes64/home-design-prot/blob/main/server/index.js) (Express API), [`server/routes/visualizer.js`](https://github.com/rohannes64/home-design-prot/blob/main/server/routes/visualizer.js) (Render generation API), [`server/routes/admin.js`](https://github.com/rohannes64/home-design-prot/blob/main/server/routes/admin.js) (Admin management API), [`client/src/utils/api.js`](https://github.com/rohannes64/home-design-prot/blob/main/client/src/utils/api.js) (API client)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Client experience"]
  node_app["React routes<br/>[App.js]"]
  node_auth_context["Auth context<br/>[AuthContext.js]"]
  node_catalog_ui["Product catalogue<br/>[ProductsPage.js]"]
  node_visualizer_ui["Room visualizer<br/>[VisualizerPage.js]"]
  node_dashboard_ui["Render dashboard<br/>[DashboardPage.js]"]
  node_api_client["API client<br/>[api.js]"]
  node_checkout_ui["Cart checkout<br/>[CheckoutModal.js]"]
  node_quote_ui["Quote form<br/>[QuoteModal.js]"]
end

subgraph group_visualizer["Visualization pipeline"]
  node_visualizer_route["Render generation API<br/>[visualizer.js]"]
  node_segment_bridge["AI service bridge<br/>[segment_bridge.js]"]
  node_ai_service["Segmentation and mapping<br/>[segment_api.py]"]
  node_render_route["Render sharing<br/>[renders.js]"]
  node_upload["Image upload<br/>[upload.js]"]
end

subgraph group_commerce["Commerce and persistence"]
  node_product_route["Product catalogue API<br/>[products.js]"]
  node_quote_route["Quote CRM API<br/>[quotes.js]"]
  node_cart_route["Cart API<br/>[cart.js]"]
  node_order_route["Orders and payments<br/>[orders.js]"]
  node_product_model[("Product records<br/>[Product.js]")]
  node_render_model[("Render records<br/>[Render.js]")]
  node_user_model[("User records<br/>[User.js]")]
  node_quote_model[("Quote records<br/>[Quote.js]")]
  node_order_model[("Order records<br/>[Order.js]")]
end

subgraph group_operations["Admin and platform"]
  node_admin_ui["Admin console"]
  node_server["Express API<br/>[index.js]"]
  node_auth_route["Authentication<br/>[auth.js]"]
  node_admin_route["Admin management API<br/>[admin.js]"]
  node_auth_middleware["JWT access control<br/>[auth.js]"]
end

node_visitor(("Client"))
node_cloudinary[("Cloudinary storage")]
node_razorpay["Razorpay payments"]

node_visitor -->|"uses"| node_app
node_app -->|"routes to"| node_visualizer_ui
node_app -->|"routes to"| node_catalog_ui
node_app -->|"provides"| node_auth_context
node_visualizer_ui -->|"requests"| node_api_client
node_catalog_ui -.->|"requests"| node_api_client
node_api_client -->|"sends API calls"| node_server
node_server -->|"mounts"| node_auth_route
node_server -->|"mounts"| node_product_route
node_server -->|"mounts"| node_visualizer_route
node_server -->|"mounts"| node_render_route
node_server -->|"mounts"| node_quote_route
node_server -->|"mounts"| node_cart_route
node_server -->|"mounts"| node_order_route
node_server -->|"mounts"| node_admin_route
node_visualizer_route -->|"delegates to"| node_segment_bridge
node_segment_bridge -->|"calls service"| node_ai_service
node_visualizer_route -->|"uses upload"| node_upload
node_upload -->|"stores images"| node_cloudinary
node_visualizer_route -->|"loads materials"| node_product_model
node_visualizer_route -->|"saves renders"| node_render_model
node_render_route -->|"reads and updates"| node_render_model
node_product_route -->|"manages products"| node_product_model
node_quote_route -->|"records quotes"| node_quote_model
node_quote_route -->|"references products"| node_product_model
node_cart_route -->|"references products"| node_product_model
node_order_route -->|"records orders"| node_order_model
node_order_route -.->|"processes payment"| node_razorpay
node_auth_route -->|"manages accounts"| node_user_model
node_auth_route -->|"uses access control"| node_auth_middleware
node_visualizer_route -->|"protects endpoints"| node_auth_middleware
node_render_route -->|"protects endpoints"| node_auth_middleware
node_admin_ui -.->|"uses API"| node_api_client
node_admin_route -->|"manages users"| node_user_model
node_admin_route -->|"manages products"| node_product_model
node_admin_route -->|"manages renders"| node_render_model
node_admin_route -->|"manages quotes"| node_quote_model
node_admin_route -->|"reads orders"| node_order_model
node_dashboard_ui -->|"loads history"| node_api_client
node_visualizer_ui -->|"opens quote"| node_quote_ui
node_visualizer_ui -->|"opens checkout"| node_checkout_ui

click node_app "https://github.com/rohannes64/home-design-prot/blob/main/client/src/App.js"
click node_auth_context "https://github.com/rohannes64/home-design-prot/blob/main/client/src/context/AuthContext.js"
click node_catalog_ui "https://github.com/rohannes64/home-design-prot/blob/main/client/src/pages/ProductsPage.js"
click node_visualizer_ui "https://github.com/rohannes64/home-design-prot/blob/main/client/src/pages/VisualizerPage.js"
click node_dashboard_ui "https://github.com/rohannes64/home-design-prot/blob/main/client/src/pages/DashboardPage.js"
click node_api_client "https://github.com/rohannes64/home-design-prot/blob/main/client/src/utils/api.js"
click node_checkout_ui "https://github.com/rohannes64/home-design-prot/blob/main/client/src/components/visualizer/CheckoutModal.js"
click node_quote_ui "https://github.com/rohannes64/home-design-prot/blob/main/client/src/components/visualizer/QuoteModal.js"
click node_admin_ui "https://github.com/rohannes64/home-design-prot/tree/main/client/src/pages/admin"
click node_server "https://github.com/rohannes64/home-design-prot/blob/main/server/index.js"
click node_auth_route "https://github.com/rohannes64/home-design-prot/blob/main/server/routes/auth.js"
click node_product_route "https://github.com/rohannes64/home-design-prot/blob/main/server/routes/products.js"
click node_visualizer_route "https://github.com/rohannes64/home-design-prot/blob/main/server/routes/visualizer.js"
click node_segment_bridge "https://github.com/rohannes64/home-design-prot/blob/main/server/utils/segment_bridge.js"
click node_ai_service "https://github.com/rohannes64/home-design-prot/blob/main/server/segment_api.py"
click node_render_route "https://github.com/rohannes64/home-design-prot/blob/main/server/routes/renders.js"
click node_quote_route "https://github.com/rohannes64/home-design-prot/blob/main/server/routes/quotes.js"
click node_cart_route "https://github.com/rohannes64/home-design-prot/blob/main/server/routes/cart.js"
click node_order_route "https://github.com/rohannes64/home-design-prot/blob/main/server/routes/orders.js"
click node_product_model "https://github.com/rohannes64/home-design-prot/blob/main/server/models/Product.js"
click node_render_model "https://github.com/rohannes64/home-design-prot/blob/main/server/models/Render.js"
click node_user_model "https://github.com/rohannes64/home-design-prot/blob/main/server/models/User.js"
click node_quote_model "https://github.com/rohannes64/home-design-prot/blob/main/server/models/Quote.js"
click node_order_model "https://github.com/rohannes64/home-design-prot/blob/main/server/models/Order.js"
click node_admin_route "https://github.com/rohannes64/home-design-prot/blob/main/server/routes/admin.js"
click node_upload "https://github.com/rohannes64/home-design-prot/blob/main/server/middleware/upload.js"
click node_auth_middleware "https://github.com/rohannes64/home-design-prot/blob/main/server/middleware/auth.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,node_auth_context,node_catalog_ui,node_visualizer_ui,node_dashboard_ui,node_api_client,node_checkout_ui,node_quote_ui,node_visitor toneBlue
class node_visualizer_route,node_segment_bridge,node_ai_service,node_render_route,node_upload,node_cloudinary toneAmber
class node_product_route,node_quote_route,node_cart_route,node_order_route,node_product_model,node_render_model,node_user_model,node_quote_model,node_order_model toneMint
class node_admin_ui,node_server,node_auth_route,node_admin_route,node_auth_middleware toneRose
class node_razorpay toneIndigo
```

## Components

### Client experience

- [React routes](https://github.com/rohannes64/home-design-prot/blob/main/client/src/App.js): `client/src/App.js`
- [Auth context](https://github.com/rohannes64/home-design-prot/blob/main/client/src/context/AuthContext.js): `client/src/context/AuthContext.js`
- [Product catalogue](https://github.com/rohannes64/home-design-prot/blob/main/client/src/pages/ProductsPage.js): `client/src/pages/ProductsPage.js`
- [Room visualizer](https://github.com/rohannes64/home-design-prot/blob/main/client/src/pages/VisualizerPage.js): `client/src/pages/VisualizerPage.js`
- [Render dashboard](https://github.com/rohannes64/home-design-prot/blob/main/client/src/pages/DashboardPage.js): `client/src/pages/DashboardPage.js`
- [API client](https://github.com/rohannes64/home-design-prot/blob/main/client/src/utils/api.js): `client/src/utils/api.js`
- [Cart checkout](https://github.com/rohannes64/home-design-prot/blob/main/client/src/components/visualizer/CheckoutModal.js): `client/src/components/visualizer/CheckoutModal.js`
- [Quote form](https://github.com/rohannes64/home-design-prot/blob/main/client/src/components/visualizer/QuoteModal.js): `client/src/components/visualizer/QuoteModal.js`

### Visualization pipeline

- [Render generation API](https://github.com/rohannes64/home-design-prot/blob/main/server/routes/visualizer.js): `server/routes/visualizer.js`
- [AI service bridge](https://github.com/rohannes64/home-design-prot/blob/main/server/utils/segment_bridge.js): `server/utils/segment_bridge.js`
- [Segmentation and mapping](https://github.com/rohannes64/home-design-prot/blob/main/server/segment_api.py): `server/segment_api.py`
- [Render sharing](https://github.com/rohannes64/home-design-prot/blob/main/server/routes/renders.js): `server/routes/renders.js`
- [Image upload](https://github.com/rohannes64/home-design-prot/blob/main/server/middleware/upload.js): `server/middleware/upload.js`

### Commerce and persistence

- [Product catalogue API](https://github.com/rohannes64/home-design-prot/blob/main/server/routes/products.js): `server/routes/products.js`
- [Quote CRM API](https://github.com/rohannes64/home-design-prot/blob/main/server/routes/quotes.js): `server/routes/quotes.js`
- [Cart API](https://github.com/rohannes64/home-design-prot/blob/main/server/routes/cart.js): `server/routes/cart.js`
- [Orders and payments](https://github.com/rohannes64/home-design-prot/blob/main/server/routes/orders.js): `server/routes/orders.js`
- [Product records](https://github.com/rohannes64/home-design-prot/blob/main/server/models/Product.js): `server/models/Product.js`
- [Render records](https://github.com/rohannes64/home-design-prot/blob/main/server/models/Render.js): `server/models/Render.js`
- [User records](https://github.com/rohannes64/home-design-prot/blob/main/server/models/User.js): `server/models/User.js`
- [Quote records](https://github.com/rohannes64/home-design-prot/blob/main/server/models/Quote.js): `server/models/Quote.js`
- [Order records](https://github.com/rohannes64/home-design-prot/blob/main/server/models/Order.js): `server/models/Order.js`

### Admin and platform

- [Admin console](https://github.com/rohannes64/home-design-prot/tree/main/client/src/pages/admin): `client/src/pages/admin`
- [Express API](https://github.com/rohannes64/home-design-prot/blob/main/server/index.js): `server/index.js`
- [Authentication](https://github.com/rohannes64/home-design-prot/blob/main/server/routes/auth.js): `server/routes/auth.js`
- [Admin management API](https://github.com/rohannes64/home-design-prot/blob/main/server/routes/admin.js): `server/routes/admin.js`
- [JWT access control](https://github.com/rohannes64/home-design-prot/blob/main/server/middleware/auth.js): `server/middleware/auth.js`

### Other components

- **Client**
- **Cloudinary storage**
- **Razorpay payments**

## Connections

- Client → React routes: uses (evidence: `client/src/App.js`)
- React routes → Room visualizer: routes to (evidence: `client/src/App.js`)
- React routes → Product catalogue: routes to (evidence: `client/src/App.js`)
- React routes → Auth context: provides (evidence: `client/src/App.js`)
- Room visualizer → API client: requests (evidence: `client/src/pages/VisualizerPage.js`)
- Product catalogue → API client: requests
- API client → Express API: sends API calls
- Express API → Authentication: mounts (evidence: `server/index.js`)
- Express API → Product catalogue API: mounts (evidence: `server/index.js`)
- Express API → Render generation API: mounts (evidence: `server/index.js`)
- Express API → Render sharing: mounts (evidence: `server/index.js`)
- Express API → Quote CRM API: mounts (evidence: `server/index.js`)
- Express API → Cart API: mounts (evidence: `server/index.js`)
- Express API → Orders and payments: mounts (evidence: `server/index.js`)
- Express API → Admin management API: mounts (evidence: `server/index.js`)
- Render generation API → AI service bridge: delegates to (evidence: `server/routes/visualizer.js`)
- AI service bridge → Segmentation and mapping: calls service
- Render generation API → Image upload: uses upload (evidence: `server/routes/visualizer.js`)
- Image upload → Cloudinary storage: stores images
- Render generation API → Product records: loads materials (evidence: `server/routes/visualizer.js`)
- Render generation API → Render records: saves renders (evidence: `server/routes/visualizer.js`)
- Render sharing → Render records: reads and updates (evidence: `server/routes/renders.js`)
- Product catalogue API → Product records: manages products (evidence: `server/routes/products.js`)
- Quote CRM API → Quote records: records quotes (evidence: `server/routes/quotes.js`)
- Quote CRM API → Product records: references products (evidence: `server/routes/quotes.js`)
- Cart API → Product records: references products (evidence: `server/routes/cart.js`)
- Orders and payments → Order records: records orders (evidence: `server/routes/orders.js`)
- Orders and payments → Razorpay payments: processes payment
- Authentication → User records: manages accounts (evidence: `server/routes/auth.js`)
- Authentication → JWT access control: uses access control (evidence: `server/routes/auth.js`)
- Render generation API → JWT access control: protects endpoints (evidence: `server/routes/visualizer.js`)
- Render sharing → JWT access control: protects endpoints (evidence: `server/routes/renders.js`)
- Admin console → API client: uses API (evidence: `client/src/pages/admin/AdminClients.js`)
- Admin management API → User records: manages users (evidence: `server/routes/admin.js`)
- Admin management API → Product records: manages products (evidence: `server/routes/admin.js`)
- Admin management API → Render records: manages renders (evidence: `server/routes/admin.js`)
- Admin management API → Quote records: manages quotes (evidence: `server/routes/admin.js`)
- Admin management API → Order records: reads orders (evidence: `server/routes/admin.js`)
- Render dashboard → API client: loads history (evidence: `client/src/pages/DashboardPage.js`)
- Room visualizer → Quote form: opens quote (evidence: `client/src/pages/VisualizerPage.js`)
- Room visualizer → Cart checkout: opens checkout (evidence: `client/src/pages/VisualizerPage.js`)
