# techverse26/buyzenshop architecture

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

- Interactive diagram: https://gitdiagram.com/techverse26/buyzenshop
- Repository: https://github.com/techverse26/buyzenshop

## Overview

Shop Verse is a static, browser-based e-commerce platform with a customer storefront and a role-based admin panel; Firebase Auth, Firestore, and Storage provide its backend, with no custom server. The customer path runs from browsing and account/cart use through checkout to order tracking; staff manage the resulting catalog, orders, and store operations. The README documents the broader admin capabilities and Firestore rule-based validation. Some page and data modules were not sampled, so those branches are represented at their existing directories; edges are limited to documented or indexed relationships.

Main entry points: [`js/store/routes.js`](https://github.com/techverse26/buyzenshop/blob/shop/js/store/routes.js) (Store routes), [`js/admin/routes.js`](https://github.com/techverse26/buyzenshop/blob/shop/js/admin/routes.js) (Admin routes), [`js/store/pages/checkout.js`](https://github.com/techverse26/buyzenshop/blob/shop/js/store/pages/checkout.js) (Checkout), [`js/store/app.js`](https://github.com/techverse26/buyzenshop/blob/shop/js/store/app.js) (Store app)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_store["Storefront"]
  node_store_app["Store app<br/>[app.js]"]
  node_store_routes["Store routes<br/>[routes.js]"]
  node_catalog_browse["Catalog browsing<br/>[shop.js]"]
  node_product_detail["Product detail<br/>[product.js]"]
  node_cart["Cart<br/>[cart.js]"]
  node_checkout["Checkout<br/>[checkout.js]"]
  node_account["Customer account"]
  node_order_tracking["Order tracking<br/>[track.js]"]
end

subgraph group_admin["Administration"]
  node_admin_app["Admin app<br/>[app.js]"]
  node_admin_routes["Admin routes<br/>[routes.js]"]
  node_catalog_ops["Catalog operations"]
  node_order_ops["Order operations"]
  node_customer_support["Customer support"]
  node_store_management["Store management"]
  node_reports_audit["Reports and audit"]
  node_review_moderation["Review moderation<br/>[reviews.js]"]
end

subgraph group_domain["Commerce domain"]
  node_pricing["Pricing rules<br/>[pricing.js]"]
end

subgraph group_data["Data and services"]
  node_catalog_data["Catalog data<br/>[catalog.js]"]
  node_cart_data["Cart data<br/>[cart.js]"]
  node_order_data["Order data<br/>[orders.js]"]
  node_auth_data["Authentication<br/>[auth.js]"]
  node_settings_data["Settings data<br/>[settings.js]"]
  node_firestore[("Firebase services<br/>[firebase.js]")]
end

subgraph group_shared["Browser foundations"]
  node_browser_ui["Browser UI<br/>[ui.js]"]
  node_local_storage[("Local storage<br/>[storage.js]")]
end

node_shopper(("Shopper"))
node_admin_staff(("Store staff"))

node_shopper -->|"uses"| node_store_app
node_store_app -->|"loads routes"| node_store_routes
node_store_routes -->|"routes to"| node_catalog_browse
node_store_routes -->|"routes to"| node_product_detail
node_store_routes -->|"routes to"| node_cart
node_store_routes -->|"routes to"| node_checkout
node_store_routes -->|"routes to"| node_account
node_store_routes -->|"routes to"| node_order_tracking
node_catalog_browse -->|"reads catalog"| node_catalog_data
node_product_detail -.->|"reads catalog"| node_catalog_data
node_cart -.->|"uses cart"| node_cart_data
node_checkout -->|"uses cart"| node_cart_data
node_checkout -->|"places orders"| node_order_data
node_checkout -->|"calculates totals"| node_pricing
node_order_tracking -.->|"tracks orders"| node_order_data
node_admin_staff -->|"uses"| node_admin_app
node_admin_app -->|"loads routes"| node_admin_routes
node_admin_routes -->|"routes to"| node_catalog_ops
node_admin_routes -->|"routes to"| node_order_ops
node_admin_routes -->|"routes to"| node_customer_support
node_admin_routes -->|"routes to"| node_store_management
node_admin_routes -.->|"routes to"| node_reports_audit
node_admin_routes -->|"routes to"| node_review_moderation
node_review_moderation -->|"checks staff"| node_auth_data
node_review_moderation -.->|"moderates reviews"| node_order_data
node_catalog_data -->|"accesses"| node_firestore
node_cart_data -->|"accesses"| node_firestore
node_order_data -->|"accesses"| node_firestore
node_auth_data -->|"stores profiles"| node_firestore
node_settings_data -->|"reads settings"| node_firestore
node_checkout -->|"loads settings"| node_settings_data
node_store_app -->|"uses auth"| node_auth_data
node_store_app -.->|"uses storage"| node_local_storage
node_browser_ui -.->|"persists preferences"| node_local_storage
node_browser_ui -.->|"renders interface"| node_store_app

click node_store_app "https://github.com/techverse26/buyzenshop/blob/shop/js/store/app.js"
click node_store_routes "https://github.com/techverse26/buyzenshop/blob/shop/js/store/routes.js"
click node_catalog_browse "https://github.com/techverse26/buyzenshop/blob/shop/js/store/pages/shop.js"
click node_product_detail "https://github.com/techverse26/buyzenshop/blob/shop/js/store/pages/product.js"
click node_cart "https://github.com/techverse26/buyzenshop/blob/shop/js/store/pages/cart.js"
click node_checkout "https://github.com/techverse26/buyzenshop/blob/shop/js/store/pages/checkout.js"
click node_account "https://github.com/techverse26/buyzenshop/tree/shop/js/store/pages/account"
click node_order_tracking "https://github.com/techverse26/buyzenshop/blob/shop/js/store/pages/track.js"
click node_admin_app "https://github.com/techverse26/buyzenshop/blob/shop/js/admin/app.js"
click node_admin_routes "https://github.com/techverse26/buyzenshop/blob/shop/js/admin/routes.js"
click node_catalog_ops "https://github.com/techverse26/buyzenshop/tree/shop/js/admin/pages"
click node_order_ops "https://github.com/techverse26/buyzenshop/tree/shop/js/admin/pages"
click node_customer_support "https://github.com/techverse26/buyzenshop/tree/shop/js/admin/pages"
click node_store_management "https://github.com/techverse26/buyzenshop/tree/shop/js/admin/pages"
click node_reports_audit "https://github.com/techverse26/buyzenshop/tree/shop/js/admin/pages"
click node_catalog_data "https://github.com/techverse26/buyzenshop/blob/shop/js/data/catalog.js"
click node_cart_data "https://github.com/techverse26/buyzenshop/blob/shop/js/data/cart.js"
click node_order_data "https://github.com/techverse26/buyzenshop/blob/shop/js/data/orders.js"
click node_auth_data "https://github.com/techverse26/buyzenshop/blob/shop/js/data/auth.js"
click node_settings_data "https://github.com/techverse26/buyzenshop/blob/shop/js/data/settings.js"
click node_firestore "https://github.com/techverse26/buyzenshop/blob/shop/js/core/firebase.js"
click node_pricing "https://github.com/techverse26/buyzenshop/blob/shop/js/shared/pricing.js"
click node_review_moderation "https://github.com/techverse26/buyzenshop/blob/shop/js/admin/pages/reviews.js"
click node_browser_ui "https://github.com/techverse26/buyzenshop/blob/shop/js/core/ui.js"
click node_local_storage "https://github.com/techverse26/buyzenshop/blob/shop/js/core/storage.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_store_app,node_store_routes,node_catalog_browse,node_product_detail,node_cart,node_checkout,node_account,node_order_tracking toneBlue
class node_admin_app,node_admin_routes,node_catalog_ops,node_order_ops,node_customer_support,node_store_management,node_reports_audit,node_review_moderation toneAmber
class node_pricing toneMint
class node_catalog_data,node_cart_data,node_order_data,node_auth_data,node_settings_data,node_firestore toneRose
class node_browser_ui,node_local_storage,node_shopper,node_admin_staff toneIndigo
```

## Components

### Storefront

- [Store app](https://github.com/techverse26/buyzenshop/blob/shop/js/store/app.js): `js/store/app.js`
- [Store routes](https://github.com/techverse26/buyzenshop/blob/shop/js/store/routes.js): `js/store/routes.js`
- [Catalog browsing](https://github.com/techverse26/buyzenshop/blob/shop/js/store/pages/shop.js): `js/store/pages/shop.js`
- [Product detail](https://github.com/techverse26/buyzenshop/blob/shop/js/store/pages/product.js): `js/store/pages/product.js`
- [Cart](https://github.com/techverse26/buyzenshop/blob/shop/js/store/pages/cart.js): `js/store/pages/cart.js`
- [Checkout](https://github.com/techverse26/buyzenshop/blob/shop/js/store/pages/checkout.js): `js/store/pages/checkout.js`
- [Customer account](https://github.com/techverse26/buyzenshop/tree/shop/js/store/pages/account): `js/store/pages/account`
- [Order tracking](https://github.com/techverse26/buyzenshop/blob/shop/js/store/pages/track.js): `js/store/pages/track.js`

### Administration

- [Admin app](https://github.com/techverse26/buyzenshop/blob/shop/js/admin/app.js): `js/admin/app.js`
- [Admin routes](https://github.com/techverse26/buyzenshop/blob/shop/js/admin/routes.js): `js/admin/routes.js`
- [Catalog operations](https://github.com/techverse26/buyzenshop/tree/shop/js/admin/pages): `js/admin/pages`
- [Order operations](https://github.com/techverse26/buyzenshop/tree/shop/js/admin/pages): `js/admin/pages`
- [Customer support](https://github.com/techverse26/buyzenshop/tree/shop/js/admin/pages): `js/admin/pages`
- [Store management](https://github.com/techverse26/buyzenshop/tree/shop/js/admin/pages): `js/admin/pages`
- [Reports and audit](https://github.com/techverse26/buyzenshop/tree/shop/js/admin/pages): `js/admin/pages`
- [Review moderation](https://github.com/techverse26/buyzenshop/blob/shop/js/admin/pages/reviews.js): `js/admin/pages/reviews.js`

### Commerce domain

- [Pricing rules](https://github.com/techverse26/buyzenshop/blob/shop/js/shared/pricing.js): `js/shared/pricing.js`

### Data and services

- [Catalog data](https://github.com/techverse26/buyzenshop/blob/shop/js/data/catalog.js): `js/data/catalog.js`
- [Cart data](https://github.com/techverse26/buyzenshop/blob/shop/js/data/cart.js): `js/data/cart.js`
- [Order data](https://github.com/techverse26/buyzenshop/blob/shop/js/data/orders.js): `js/data/orders.js`
- [Authentication](https://github.com/techverse26/buyzenshop/blob/shop/js/data/auth.js): `js/data/auth.js`
- [Settings data](https://github.com/techverse26/buyzenshop/blob/shop/js/data/settings.js): `js/data/settings.js`
- [Firebase services](https://github.com/techverse26/buyzenshop/blob/shop/js/core/firebase.js): `js/core/firebase.js`

### Browser foundations

- [Browser UI](https://github.com/techverse26/buyzenshop/blob/shop/js/core/ui.js): `js/core/ui.js`
- [Local storage](https://github.com/techverse26/buyzenshop/blob/shop/js/core/storage.js): `js/core/storage.js`

### Other components

- **Shopper**
- **Store staff**

## Connections

- Shopper → Store app: uses (evidence: `README.md`)
- Store app → Store routes: loads routes (evidence: `js/store/app.js`)
- Store routes → Catalog browsing: routes to (evidence: `js/store/routes.js`)
- Store routes → Product detail: routes to (evidence: `js/store/routes.js`)
- Store routes → Cart: routes to (evidence: `js/store/routes.js`)
- Store routes → Checkout: routes to (evidence: `js/store/routes.js`)
- Store routes → Customer account: routes to (evidence: `js/store/routes.js`)
- Store routes → Order tracking: routes to (evidence: `js/store/routes.js`)
- Catalog browsing → Catalog data: reads catalog (evidence: `js/data/catalog.js`)
- Product detail → Catalog data: reads catalog
- Cart → Cart data: uses cart
- Checkout → Cart data: uses cart (evidence: `js/store/pages/checkout.js`)
- Checkout → Order data: places orders (evidence: `js/store/pages/checkout.js`)
- Checkout → Pricing rules: calculates totals (evidence: `js/store/pages/checkout.js`)
- Order tracking → Order data: tracks orders
- Store staff → Admin app: uses (evidence: `README.md`)
- Admin app → Admin routes: loads routes (evidence: `js/admin/app.js`)
- Admin routes → Catalog operations: routes to (evidence: `js/admin/routes.js`)
- Admin routes → Order operations: routes to (evidence: `js/admin/routes.js`)
- Admin routes → Customer support: routes to (evidence: `js/admin/routes.js`)
- Admin routes → Store management: routes to (evidence: `js/admin/routes.js`)
- Admin routes → Reports and audit: routes to (evidence: `js/admin/routes.js`)
- Admin routes → Review moderation: routes to (evidence: `js/admin/routes.js`)
- Review moderation → Authentication: checks staff (evidence: `js/admin/pages/reviews.js`)
- Review moderation → Order data: moderates reviews
- Catalog data → Firebase services: accesses (evidence: `js/data/catalog.js`)
- Cart data → Firebase services: accesses (evidence: `js/data/cart.js`)
- Order data → Firebase services: accesses (evidence: `js/data/orders.js`)
- Authentication → Firebase services: stores profiles (evidence: `js/data/auth.js`)
- Settings data → Firebase services: reads settings (evidence: `js/data/settings.js`)
- Checkout → Settings data: loads settings (evidence: `js/store/pages/checkout.js`)
- Store app → Authentication: uses auth (evidence: `js/store/app.js`)
- Store app → Local storage: uses storage
- Browser UI → Local storage: persists preferences
- Browser UI → Store app: renders interface (evidence: `js/store/app.js`)
