# parhamash96/mvp_web_shop architecture

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

- Interactive diagram: https://gitdiagram.com/parhamash96/mvp_web_shop
- Repository: https://github.com/parhamash96/mvp_web_shop

## Overview

MVP Web Shop is a multi-role marketplace: customers browse products and place orders, suppliers manage their products, and admins manage platform features such as promo codes. The Vue SPA routes users through account, catalog, profile, dashboard, and promo-code views; its Axios client calls an Express API, which routes requests to domain controllers and persists entities through Mongoose models and schemas. The README documents orders and other capabilities whose implementation was not sampled, so those subsystems are represented at their exact directories; their internal links are not asserted. Relationships shown are limited to the README and source references or excerpts.

Main entry points: [`server/model`](https://github.com/parhamash96/mvp_web_shop/tree/UI-design/server/model) (Mongoose models), [`client/src/Api.js`](https://github.com/parhamash96/mvp_web_shop/blob/UI-design/client/src/Api.js) (HTTP API client), [`server/app.js`](https://github.com/parhamash96/mvp_web_shop/blob/UI-design/server/app.js) (Express API host), [`client/src/main.js`](https://github.com/parhamash96/mvp_web_shop/blob/UI-design/client/src/main.js) (Vue application)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Web experience"]
  node_spa["Vue application<br/>[main.js]"]
  node_routing["Page routing<br/>[router.js]"]
  node_accountui["Account flows<br/>[Customer.vue]"]
  node_catalogui["Product browsing<br/>[Home.vue]"]
  node_supplierui["Supplier product tools<br/>[CreateProduct.vue]"]
  node_promoui["Promo code views<br/>[Promocodes.vue]"]
  node_profileui["Profile and dashboard<br/>[Profile.vue]"]
  node_supportui["Support pages<br/>[Support.vue]"]
  node_apiclient["HTTP API client<br/>[Api.js]"]
end

subgraph group_api["API and access"]
  node_express["Express API host<br/>[app.js]"]
  node_authroutes["Authentication routes<br/>[auth.js]"]
  node_authlogic["Login and tokens<br/>[auth.js]"]
  node_access["JWT access checks<br/>[auth.js]"]
  node_productroutes["Product routes<br/>[products.js]"]
  node_supplieroutes["Supplier product routes"]
end

subgraph group_market["Marketplace domains"]
  node_productlogic["Product operations<br/>[product.js]"]
  node_supplierlogic["Supplier product operations"]
  node_customerlogic["Customer accounts<br/>[customer.js]"]
  node_orderlogic["Order management<br/>[order.js]"]
  node_promologic["Promo code management<br/>[promocode.js]"]
  node_adminlogic["Admin management<br/>[admin.js]"]
end

subgraph group_data["Persistence"]
  node_models[("Mongoose models")]
  node_schemas["Entity schemas"]
end

node_visitor(("Marketplace user"))
node_mongo[("MongoDB")]

node_visitor -->|"uses"| node_spa
node_spa -->|"installs"| node_routing
node_spa -->|"exposes"| node_apiclient
node_visitor -->|"signs up"| node_accountui
node_visitor -->|"browses"| node_catalogui
node_visitor -->|"manages products"| node_supplierui
node_visitor -->|"views promos"| node_promoui
node_accountui -->|"requests"| node_apiclient
node_catalogui -->|"requests"| node_apiclient
node_supplierui -->|"requests"| node_apiclient
node_apiclient -.->|"HTTP requests"| node_express
node_express -->|"mounts"| node_authroutes
node_express -->|"mounts"| node_productroutes
node_express -->|"mounts"| node_supplieroutes
node_authroutes -->|"dispatches"| node_authlogic
node_productroutes -->|"dispatches"| node_productlogic
node_supplieroutes -->|"dispatches"| node_supplierlogic
node_authlogic -->|"queries accounts"| node_models
node_productlogic -->|"uses models"| node_models
node_customerlogic -->|"uses model"| node_models
node_promologic -->|"uses model"| node_models
node_models -->|"constructs models"| node_schemas
node_express -->|"connects"| node_mongo
node_orderlogic -.->|"persists orders"| node_models
node_promoui -.->|"requests"| node_apiclient
node_adminlogic -.->|"uses models"| node_models
node_access -.->|"verifies tokens"| node_authlogic

click node_spa "https://github.com/parhamash96/mvp_web_shop/blob/UI-design/client/src/main.js"
click node_routing "https://github.com/parhamash96/mvp_web_shop/blob/UI-design/client/src/router.js"
click node_accountui "https://github.com/parhamash96/mvp_web_shop/blob/UI-design/client/src/views/signup/Customer.vue"
click node_catalogui "https://github.com/parhamash96/mvp_web_shop/blob/UI-design/client/src/views/Home.vue"
click node_supplierui "https://github.com/parhamash96/mvp_web_shop/blob/UI-design/client/src/views/product/CreateProduct.vue"
click node_promoui "https://github.com/parhamash96/mvp_web_shop/blob/UI-design/client/src/views/Promocodes.vue"
click node_profileui "https://github.com/parhamash96/mvp_web_shop/blob/UI-design/client/src/views/Profile.vue"
click node_supportui "https://github.com/parhamash96/mvp_web_shop/blob/UI-design/client/src/views/contact/Support.vue"
click node_apiclient "https://github.com/parhamash96/mvp_web_shop/blob/UI-design/client/src/Api.js"
click node_express "https://github.com/parhamash96/mvp_web_shop/blob/UI-design/server/app.js"
click node_authroutes "https://github.com/parhamash96/mvp_web_shop/blob/UI-design/server/routers/auth.js"
click node_authlogic "https://github.com/parhamash96/mvp_web_shop/blob/UI-design/server/controller/auth.js"
click node_access "https://github.com/parhamash96/mvp_web_shop/blob/UI-design/server/middleware/auth.js"
click node_productroutes "https://github.com/parhamash96/mvp_web_shop/blob/UI-design/server/routers/products.js"
click node_supplieroutes "https://github.com/parhamash96/mvp_web_shop/blob/UI-design/server/routers/supplierProducts.js"
click node_productlogic "https://github.com/parhamash96/mvp_web_shop/blob/UI-design/server/controller/product.js"
click node_supplierlogic "https://github.com/parhamash96/mvp_web_shop/blob/UI-design/server/controller/supplierProducts.js"
click node_customerlogic "https://github.com/parhamash96/mvp_web_shop/blob/UI-design/server/controller/customer.js"
click node_orderlogic "https://github.com/parhamash96/mvp_web_shop/blob/UI-design/server/controller/order.js"
click node_promologic "https://github.com/parhamash96/mvp_web_shop/blob/UI-design/server/controller/promocode.js"
click node_adminlogic "https://github.com/parhamash96/mvp_web_shop/blob/UI-design/server/controller/admin.js"
click node_models "https://github.com/parhamash96/mvp_web_shop/tree/UI-design/server/model"
click node_schemas "https://github.com/parhamash96/mvp_web_shop/tree/UI-design/server/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_spa,node_routing,node_accountui,node_catalogui,node_supplierui,node_promoui,node_profileui,node_supportui,node_apiclient,node_visitor toneBlue
class node_express,node_authroutes,node_authlogic,node_access,node_productroutes,node_supplieroutes,node_mongo toneAmber
class node_productlogic,node_supplierlogic,node_customerlogic,node_orderlogic,node_promologic,node_adminlogic toneMint
class node_models,node_schemas toneRose
```

## Components

### Web experience

- [Vue application](https://github.com/parhamash96/mvp_web_shop/blob/UI-design/client/src/main.js): `client/src/main.js`
- [Page routing](https://github.com/parhamash96/mvp_web_shop/blob/UI-design/client/src/router.js): `client/src/router.js`
- [Account flows](https://github.com/parhamash96/mvp_web_shop/blob/UI-design/client/src/views/signup/Customer.vue): `client/src/views/signup/Customer.vue`
- [Product browsing](https://github.com/parhamash96/mvp_web_shop/blob/UI-design/client/src/views/Home.vue): `client/src/views/Home.vue`
- [Supplier product tools](https://github.com/parhamash96/mvp_web_shop/blob/UI-design/client/src/views/product/CreateProduct.vue): `client/src/views/product/CreateProduct.vue`
- [Promo code views](https://github.com/parhamash96/mvp_web_shop/blob/UI-design/client/src/views/Promocodes.vue): `client/src/views/Promocodes.vue`
- [Profile and dashboard](https://github.com/parhamash96/mvp_web_shop/blob/UI-design/client/src/views/Profile.vue): `client/src/views/Profile.vue`
- [Support pages](https://github.com/parhamash96/mvp_web_shop/blob/UI-design/client/src/views/contact/Support.vue): `client/src/views/contact/Support.vue`
- [HTTP API client](https://github.com/parhamash96/mvp_web_shop/blob/UI-design/client/src/Api.js): `client/src/Api.js`

### API and access

- [Express API host](https://github.com/parhamash96/mvp_web_shop/blob/UI-design/server/app.js): `server/app.js`
- [Authentication routes](https://github.com/parhamash96/mvp_web_shop/blob/UI-design/server/routers/auth.js): `server/routers/auth.js`
- [Login and tokens](https://github.com/parhamash96/mvp_web_shop/blob/UI-design/server/controller/auth.js): `server/controller/auth.js`
- [JWT access checks](https://github.com/parhamash96/mvp_web_shop/blob/UI-design/server/middleware/auth.js): `server/middleware/auth.js`
- [Product routes](https://github.com/parhamash96/mvp_web_shop/blob/UI-design/server/routers/products.js): `server/routers/products.js`
- [Supplier product routes](https://github.com/parhamash96/mvp_web_shop/blob/UI-design/server/routers/supplierProducts.js): `server/routers/supplierProducts.js`

### Marketplace domains

- [Product operations](https://github.com/parhamash96/mvp_web_shop/blob/UI-design/server/controller/product.js): `server/controller/product.js`
- [Supplier product operations](https://github.com/parhamash96/mvp_web_shop/blob/UI-design/server/controller/supplierProducts.js): `server/controller/supplierProducts.js`
- [Customer accounts](https://github.com/parhamash96/mvp_web_shop/blob/UI-design/server/controller/customer.js): `server/controller/customer.js`
- [Order management](https://github.com/parhamash96/mvp_web_shop/blob/UI-design/server/controller/order.js): `server/controller/order.js`
- [Promo code management](https://github.com/parhamash96/mvp_web_shop/blob/UI-design/server/controller/promocode.js): `server/controller/promocode.js`
- [Admin management](https://github.com/parhamash96/mvp_web_shop/blob/UI-design/server/controller/admin.js): `server/controller/admin.js`

### Persistence

- [Mongoose models](https://github.com/parhamash96/mvp_web_shop/tree/UI-design/server/model): `server/model`
- [Entity schemas](https://github.com/parhamash96/mvp_web_shop/tree/UI-design/server/schema): `server/schema`

### Other components

- **Marketplace user**
- **MongoDB**

## Connections

- Marketplace user → Vue application: uses (evidence: `README.md`)
- Vue application → Page routing: installs (evidence: `client/src/main.js`)
- Vue application → HTTP API client: exposes (evidence: `client/src/main.js`)
- Marketplace user → Account flows: signs up (evidence: `README.md`)
- Marketplace user → Product browsing: browses (evidence: `README.md`)
- Marketplace user → Supplier product tools: manages products (evidence: `README.md`)
- Marketplace user → Promo code views: views promos (evidence: `README.md`)
- Account flows → HTTP API client: requests (evidence: `client/src/views/signup/Customer.vue`)
- Product browsing → HTTP API client: requests (evidence: `client/src/views/Home.vue`)
- Supplier product tools → HTTP API client: requests (evidence: `client/src/views/product/CreateProduct.vue`)
- HTTP API client → Express API host: HTTP requests
- Express API host → Authentication routes: mounts (evidence: `server/app.js`)
- Express API host → Product routes: mounts (evidence: `server/app.js`)
- Express API host → Supplier product routes: mounts (evidence: `server/app.js`)
- Authentication routes → Login and tokens: dispatches (evidence: `server/routers/auth.js`)
- Product routes → Product operations: dispatches (evidence: `server/routers/products.js`)
- Supplier product routes → Supplier product operations: dispatches (evidence: `server/routers/supplierProducts.js`)
- Login and tokens → Mongoose models: queries accounts (evidence: `server/controller/auth.js`)
- Product operations → Mongoose models: uses models (evidence: `server/controller/product.js`)
- Customer accounts → Mongoose models: uses model (evidence: `server/controller/customer.js`)
- Promo code management → Mongoose models: uses model (evidence: `server/controller/promocode.js`)
- Mongoose models → Entity schemas: constructs models (evidence: `server/model/customer.js`)
- Express API host → MongoDB: connects (evidence: `server/app.js`)
- Order management → Mongoose models: persists orders
- Promo code views → HTTP API client: requests
- Admin management → Mongoose models: uses models
- JWT access checks → Login and tokens: verifies tokens
