# ujjalacharya/awesome-ecom architecture

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

## Overview

Awesome-Ecom is a multi-client shopping platform: shoppers browse and search products, manage carts and orders, and use account, review, and Q&A features; merchants manage products and orders through a CRM, while superadmins manage merchants and products. The repository also contains a React Native app and a Next.js storefront backed by a Node API and MongoDB models. The graph emphasizes these product stages and the CRM dashboard; some client-to-API wiring is documented, but most unsampled request paths are not asserted.

Main entry points: [`server/server.js`](https://github.com/ujjalacharya/awesome-ecom/blob/master/server/server.js) (HTTP and socket API), [`server/models`](https://github.com/ujjalacharya/awesome-ecom/tree/master/server/models) (Commerce records), [`CRM/src/router/MainRouter.js`](https://github.com/ujjalacharya/awesome-ecom/blob/master/CRM/src/router/MainRouter.js) (Role-based routes), [`client/pages`](https://github.com/ujjalacharya/awesome-ecom/tree/master/client/pages) (Storefront pages)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_storefront["Web storefront"]
  node_webstore["Storefront pages"]
  node_webstate["Web state and services"]
  node_webhome["Home discovery<br/>[index.js]"]
end

subgraph group_mobile["Mobile shopping"]
  node_mobilescreens["Shopping screens"]
  node_mobileroutes["App navigation"]
  node_mobilestate["Mobile state and services"]
end

subgraph group_crm["Merchant CRM"]
  node_crmapp["CRM entry<br/>[App.js]"]
  node_crmrouter["Role-based routes<br/>[MainRouter.js]"]
  node_crmdashboard["Merchant dashboard"]
  node_crmproducts["Product management"]
  node_crmorders["Order management"]
  node_crmstate["CRM state and APIs"]
end

subgraph group_backend["API and domain"]
  node_api["HTTP and socket API<br/>[server.js]"]
  node_authroutes["User authentication<br/>[user_auth.js]"]
  node_productapi["Product operations<br/>[product.js]"]
  node_merchantapi["Merchant operations<br/>[admin.js]"]
  node_reviewapi["Reviews and Q&amp;A<br/>[review_qna.js]"]
end

subgraph group_data["Domain data"]
  node_domainmodels[("Commerce records")]
  node_sharedschemas[("Shared schemas")]
end

node_webshopper(("Web shopper"))
node_mobileuser(("Mobile shopper"))
node_merchant(("Merchant admin"))

node_webshopper -->|"shops through"| node_webstore
node_webstore -->|"renders home"| node_webhome
node_webhome -->|"dispatches actions"| node_webstate
node_webstore -.->|"uses state"| node_webstate
node_mobileuser -->|"shops through"| node_mobilescreens
node_mobilescreens -.->|"uses navigation"| node_mobileroutes
node_mobileroutes -.->|"uses app state"| node_mobilestate
node_merchant -->|"manages shop"| node_crmapp
node_crmapp -->|"renders routes"| node_crmrouter
node_crmrouter -->|"routes to"| node_crmdashboard
node_crmrouter -->|"routes to"| node_crmproducts
node_crmrouter -->|"routes to"| node_crmorders
node_crmapp -.->|"loads auth"| node_crmstate
node_api -->|"mounts routes"| node_authroutes
node_api -->|"mounts routes"| node_productapi
node_api -->|"mounts routes"| node_merchantapi
node_api -->|"mounts routes"| node_reviewapi
node_authroutes -.->|"uses records"| node_domainmodels
node_productapi -.->|"uses records"| node_domainmodels
node_merchantapi -.->|"uses records"| node_domainmodels
node_reviewapi -->|"reads and writes"| node_domainmodels
node_reviewapi -->|"notifies seller"| node_domainmodels
node_webstate -.->|"calls API"| node_api
node_mobilestate -.->|"calls API"| node_api
node_crmstate -.->|"calls API"| node_api
node_domainmodels -.->|"shares schema"| node_sharedschemas

click node_webstore "https://github.com/ujjalacharya/awesome-ecom/tree/master/client/pages"
click node_webstate "https://github.com/ujjalacharya/awesome-ecom/tree/master/client/redux"
click node_webhome "https://github.com/ujjalacharya/awesome-ecom/blob/master/client/pages/index.js"
click node_mobilescreens "https://github.com/ujjalacharya/awesome-ecom/tree/master/app/src/screens"
click node_mobileroutes "https://github.com/ujjalacharya/awesome-ecom/tree/master/app/src/routes"
click node_mobilestate "https://github.com/ujjalacharya/awesome-ecom/tree/master/app/redux"
click node_crmapp "https://github.com/ujjalacharya/awesome-ecom/blob/master/CRM/src/App.js"
click node_crmrouter "https://github.com/ujjalacharya/awesome-ecom/blob/master/CRM/src/router/MainRouter.js"
click node_crmdashboard "https://github.com/ujjalacharya/awesome-ecom/tree/master/CRM/src/components/pages/Home"
click node_crmproducts "https://github.com/ujjalacharya/awesome-ecom/tree/master/CRM/src/components/pages/Product"
click node_crmorders "https://github.com/ujjalacharya/awesome-ecom/tree/master/CRM/src/components/pages/Order"
click node_crmstate "https://github.com/ujjalacharya/awesome-ecom/tree/master/CRM/src/redux"
click node_api "https://github.com/ujjalacharya/awesome-ecom/blob/master/server/server.js"
click node_authroutes "https://github.com/ujjalacharya/awesome-ecom/blob/master/server/routes/user_auth.js"
click node_productapi "https://github.com/ujjalacharya/awesome-ecom/blob/master/server/controllers/product.js"
click node_merchantapi "https://github.com/ujjalacharya/awesome-ecom/blob/master/server/controllers/admin.js"
click node_reviewapi "https://github.com/ujjalacharya/awesome-ecom/blob/master/server/controllers/review_qna.js"
click node_domainmodels "https://github.com/ujjalacharya/awesome-ecom/tree/master/server/models"
click node_sharedschemas "https://github.com/ujjalacharya/awesome-ecom/tree/master/schema"

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_webstore,node_webstate,node_webhome toneBlue
class node_mobilescreens,node_mobileroutes,node_mobilestate toneAmber
class node_crmapp,node_crmrouter,node_crmdashboard,node_crmproducts,node_crmorders,node_crmstate toneMint
class node_api,node_authroutes,node_productapi,node_merchantapi,node_reviewapi toneRose
class node_domainmodels,node_sharedschemas,node_webshopper,node_mobileuser,node_merchant toneIndigo
```

## Components

### Web storefront

- [Storefront pages](https://github.com/ujjalacharya/awesome-ecom/tree/master/client/pages): `client/pages`
- [Web state and services](https://github.com/ujjalacharya/awesome-ecom/tree/master/client/redux): `client/redux`
- [Home discovery](https://github.com/ujjalacharya/awesome-ecom/blob/master/client/pages/index.js): `client/pages/index.js`

### Mobile shopping

- [Shopping screens](https://github.com/ujjalacharya/awesome-ecom/tree/master/app/src/screens): `app/src/screens`
- [App navigation](https://github.com/ujjalacharya/awesome-ecom/tree/master/app/src/routes): `app/src/routes`
- [Mobile state and services](https://github.com/ujjalacharya/awesome-ecom/tree/master/app/redux): `app/redux`

### Merchant CRM

- [CRM entry](https://github.com/ujjalacharya/awesome-ecom/blob/master/CRM/src/App.js): `CRM/src/App.js`
- [Role-based routes](https://github.com/ujjalacharya/awesome-ecom/blob/master/CRM/src/router/MainRouter.js): `CRM/src/router/MainRouter.js`
- [Merchant dashboard](https://github.com/ujjalacharya/awesome-ecom/tree/master/CRM/src/components/pages/Home): `CRM/src/components/pages/Home`
- [Product management](https://github.com/ujjalacharya/awesome-ecom/tree/master/CRM/src/components/pages/Product): `CRM/src/components/pages/Product`
- [Order management](https://github.com/ujjalacharya/awesome-ecom/tree/master/CRM/src/components/pages/Order): `CRM/src/components/pages/Order`
- [CRM state and APIs](https://github.com/ujjalacharya/awesome-ecom/tree/master/CRM/src/redux): `CRM/src/redux`

### API and domain

- [HTTP and socket API](https://github.com/ujjalacharya/awesome-ecom/blob/master/server/server.js): `server/server.js`
- [User authentication](https://github.com/ujjalacharya/awesome-ecom/blob/master/server/routes/user_auth.js): `server/routes/user_auth.js`
- [Product operations](https://github.com/ujjalacharya/awesome-ecom/blob/master/server/controllers/product.js): `server/controllers/product.js`
- [Merchant operations](https://github.com/ujjalacharya/awesome-ecom/blob/master/server/controllers/admin.js): `server/controllers/admin.js`
- [Reviews and Q&A](https://github.com/ujjalacharya/awesome-ecom/blob/master/server/controllers/review_qna.js): `server/controllers/review_qna.js`

### Domain data

- [Commerce records](https://github.com/ujjalacharya/awesome-ecom/tree/master/server/models): `server/models`
- [Shared schemas](https://github.com/ujjalacharya/awesome-ecom/tree/master/schema): `schema`

### Other components

- **Web shopper**
- **Mobile shopper**
- **Merchant admin**

## Connections

- Web shopper → Storefront pages: shops through
- Storefront pages → Home discovery: renders home (evidence: `client/pages/index.js`)
- Home discovery → Web state and services: dispatches actions (evidence: `client/pages/index.js`)
- Storefront pages → Web state and services: uses state (evidence: `client/pages/index.js`)
- Mobile shopper → Shopping screens: shops through
- Shopping screens → App navigation: uses navigation
- App navigation → Mobile state and services: uses app state
- Merchant admin → CRM entry: manages shop
- CRM entry → Role-based routes: renders routes (evidence: `CRM/src/App.js`)
- Role-based routes → Merchant dashboard: routes to (evidence: `CRM/src/router/MainRouter.js`)
- Role-based routes → Product management: routes to (evidence: `CRM/src/router/MainRouter.js`)
- Role-based routes → Order management: routes to (evidence: `CRM/src/router/MainRouter.js`)
- CRM entry → CRM state and APIs: loads auth (evidence: `CRM/src/App.js`)
- HTTP and socket API → User authentication: mounts routes (evidence: `server/server.js`)
- HTTP and socket API → Product operations: mounts routes (evidence: `server/server.js`)
- HTTP and socket API → Merchant operations: mounts routes (evidence: `server/server.js`)
- HTTP and socket API → Reviews and Q&A: mounts routes (evidence: `server/server.js`)
- User authentication → Commerce records: uses records
- Product operations → Commerce records: uses records
- Merchant operations → Commerce records: uses records
- Reviews and Q&A → Commerce records: reads and writes (evidence: `server/controllers/review_qna.js`)
- Reviews and Q&A → Commerce records: notifies seller (evidence: `server/controllers/review_qna.js`)
- Web state and services → HTTP and socket API: calls API
- Mobile state and services → HTTP and socket API: calls API
- CRM state and APIs → HTTP and socket API: calls API
- Commerce records → Shared schemas: shares schema
