# mrsethzintwoaccoundrealnofakeonthemix/final-year_capstone-project architecture

> Architecture diagram of the GitHub repository mrsethzintwoaccoundrealnofakeonthemix/final-year_capstone-project, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-03). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/mrsethzintwoaccoundrealnofakeonthemix/final-year_capstone-project
- Repository: https://github.com/mrsethzintwoaccoundrealnofakeonthemix/final-year_capstone-project

## Overview

Luxe Jewelry is an accountless social-commerce platform for browsing a jewelry catalog, verifying Messenger-linked customer identity, placing orders, and paying by COD or Bakong KHQR. Its runtime spans customer and owner webviews, Express APIs, order and inventory coordination, SQLite persistence, and Messenger/Telegram integrations. The README documents major capabilities not fully visible in the sampled source; those are represented where paths are supported, with only documented or indexed relationships shown.

Main entry points: [`src/services/order.service.js`](https://github.com/mrsethzintwoaccoundrealnofakeonthemix/final-year_capstone-project/blob/master/src/services/order.service.js) (Order coordinator), [`src/controllers/admin.controller.js`](https://github.com/mrsethzintwoaccoundrealnofakeonthemix/final-year_capstone-project/blob/master/src/controllers/admin.controller.js) (Admin operations), [`src/controllers/customer.controller.js`](https://github.com/mrsethzintwoaccoundrealnofakeonthemix/final-year_capstone-project/blob/master/src/controllers/customer.controller.js) (Customer endpoints), [`src/db/index.js`](https://github.com/mrsethzintwoaccoundrealnofakeonthemix/final-year_capstone-project/blob/master/src/db/index.js) (SQLite database)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_experience["Storefront &amp; Admin"]
  node_webview["Customer webview<br/>[webview.js]"]
  node_adminui["Admin dashboard<br/>[admin.js]"]
end

subgraph group_api["HTTP API"]
  node_app["Express app<br/>[app.js]"]
  node_customerctl["Customer endpoints"]
  node_adminctl["Admin operations"]
  node_webhookctl["Messenger webhook"]
  node_customeroutes["Customer routes<br/>[customer.routes.js]"]
  node_adminroutes["Admin routes<br/>[admin.routes.js]"]
  node_webhookroutes["Webhook routes<br/>[webhook.routes.js]"]
end

subgraph group_commerce["Commerce Services"]
  node_ordersvc["Order coordinator<br/>[order.service.js]"]
  node_identity["Signed identity"]
  node_auth["Admin authentication<br/>[auth.service.js]"]
  node_images["Image processing<br/>[image.service.js]"]
end

subgraph group_data["Catalog &amp; Persistence"]
  node_productrepo["Product catalog"]
  node_variantrepo["Product variants"]
  node_categoryrepo["Categories"]
  node_posrepo["POS sales<br/>[pos.repository.js]"]
  node_orderrepo["Orders &amp; lifecycle"]
  node_sqlite[("SQLite database<br/>[index.js]")]
end

subgraph group_channels["Messaging &amp; Payments"]
  node_messenger["Messenger integration"]
  node_telegram["Telegram owner tools"]
  node_bakong["Bakong KHQR<br/>[bakong.service.js]"]
end

node_customer(("Customer"))
node_owner(("Store owner"))

node_customer -->|"uses"| node_webview
node_owner -->|"manages"| node_adminui
node_webview -.->|"requests"| node_customeroutes
node_adminui -.->|"requests"| node_adminroutes
node_app -->|"mounts"| node_customeroutes
node_app -->|"mounts"| node_adminroutes
node_app -->|"mounts"| node_webhookroutes
node_customeroutes -->|"routes to"| node_customerctl
node_adminroutes -->|"routes to"| node_adminctl
node_webhookroutes -->|"routes to"| node_webhookctl
node_customerctl -->|"reads catalog"| node_productrepo
node_customerctl -->|"verifies identity"| node_identity
node_customerctl -->|"places order"| node_ordersvc
node_customerctl -->|"reads order"| node_orderrepo
node_customerctl -->|"requests payment"| node_bakong
node_adminctl -->|"authenticates"| node_auth
node_adminctl -->|"manages catalog"| node_productrepo
node_adminctl -->|"manages categories"| node_categoryrepo
node_adminctl -->|"manages variants"| node_variantrepo
node_adminctl -->|"records sales"| node_posrepo
node_adminctl -->|"updates orders"| node_ordersvc
node_adminctl -->|"processes images"| node_images
node_webhookctl -->|"signs customer links"| node_identity
node_webhookctl -->|"sends replies"| node_messenger
node_ordersvc -->|"persists lifecycle"| node_orderrepo
node_ordersvc -->|"checks products"| node_productrepo
node_ordersvc -->|"checks variants"| node_variantrepo
node_ordersvc -->|"validates customer"| node_identity
node_ordersvc -->|"sends receipts"| node_messenger
node_ordersvc -->|"alerts owner"| node_telegram
node_ordersvc -->|"coordinates payment"| node_bakong
node_productrepo -->|"queries"| node_sqlite
node_variantrepo -->|"queries"| node_sqlite
node_orderrepo -->|"queries transactions"| node_sqlite
node_categoryrepo -->|"queries"| node_sqlite
node_posrepo -->|"queries"| node_sqlite
node_telegram -->|"dispatches owner actions"| node_ordersvc
node_telegram -->|"alerts and controls"| node_owner
node_messenger -->|"sends commerce messages"| node_customer
node_bakong -->|"provides KHQR payment"| node_customer

click node_webview "https://github.com/mrsethzintwoaccoundrealnofakeonthemix/final-year_capstone-project/blob/master/public/js/webview.js"
click node_adminui "https://github.com/mrsethzintwoaccoundrealnofakeonthemix/final-year_capstone-project/blob/master/public/js/admin.js"
click node_app "https://github.com/mrsethzintwoaccoundrealnofakeonthemix/final-year_capstone-project/blob/master/src/app.js"
click node_customerctl "https://github.com/mrsethzintwoaccoundrealnofakeonthemix/final-year_capstone-project/blob/master/src/controllers/customer.controller.js"
click node_adminctl "https://github.com/mrsethzintwoaccoundrealnofakeonthemix/final-year_capstone-project/blob/master/src/controllers/admin.controller.js"
click node_webhookctl "https://github.com/mrsethzintwoaccoundrealnofakeonthemix/final-year_capstone-project/blob/master/src/controllers/webhook.controller.js"
click node_customeroutes "https://github.com/mrsethzintwoaccoundrealnofakeonthemix/final-year_capstone-project/blob/master/src/routes/customer.routes.js"
click node_adminroutes "https://github.com/mrsethzintwoaccoundrealnofakeonthemix/final-year_capstone-project/blob/master/src/routes/admin.routes.js"
click node_webhookroutes "https://github.com/mrsethzintwoaccoundrealnofakeonthemix/final-year_capstone-project/blob/master/src/routes/webhook.routes.js"
click node_ordersvc "https://github.com/mrsethzintwoaccoundrealnofakeonthemix/final-year_capstone-project/blob/master/src/services/order.service.js"
click node_identity "https://github.com/mrsethzintwoaccoundrealnofakeonthemix/final-year_capstone-project/blob/master/src/services/identity.service.js"
click node_auth "https://github.com/mrsethzintwoaccoundrealnofakeonthemix/final-year_capstone-project/blob/master/src/services/auth.service.js"
click node_images "https://github.com/mrsethzintwoaccoundrealnofakeonthemix/final-year_capstone-project/blob/master/src/services/image.service.js"
click node_productrepo "https://github.com/mrsethzintwoaccoundrealnofakeonthemix/final-year_capstone-project/blob/master/src/repositories/product.repository.js"
click node_variantrepo "https://github.com/mrsethzintwoaccoundrealnofakeonthemix/final-year_capstone-project/blob/master/src/repositories/variant.repository.js"
click node_categoryrepo "https://github.com/mrsethzintwoaccoundrealnofakeonthemix/final-year_capstone-project/blob/master/src/repositories/category.repository.js"
click node_posrepo "https://github.com/mrsethzintwoaccoundrealnofakeonthemix/final-year_capstone-project/blob/master/src/repositories/pos.repository.js"
click node_orderrepo "https://github.com/mrsethzintwoaccoundrealnofakeonthemix/final-year_capstone-project/blob/master/src/repositories/order.repository.js"
click node_sqlite "https://github.com/mrsethzintwoaccoundrealnofakeonthemix/final-year_capstone-project/blob/master/src/db/index.js"
click node_messenger "https://github.com/mrsethzintwoaccoundrealnofakeonthemix/final-year_capstone-project/blob/master/src/services/messenger.service.js"
click node_telegram "https://github.com/mrsethzintwoaccoundrealnofakeonthemix/final-year_capstone-project/blob/master/src/services/telegram.service.js"
click node_bakong "https://github.com/mrsethzintwoaccoundrealnofakeonthemix/final-year_capstone-project/blob/master/src/services/bakong.service.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_webview,node_adminui toneBlue
class node_app,node_customerctl,node_adminctl,node_webhookctl,node_customeroutes,node_adminroutes,node_webhookroutes toneAmber
class node_ordersvc,node_identity,node_auth,node_images toneMint
class node_productrepo,node_variantrepo,node_categoryrepo,node_posrepo,node_orderrepo,node_sqlite toneRose
class node_messenger,node_telegram,node_bakong,node_customer,node_owner toneIndigo
```

## Components

### Storefront & Admin

- [Customer webview](https://github.com/mrsethzintwoaccoundrealnofakeonthemix/final-year_capstone-project/blob/master/public/js/webview.js): `public/js/webview.js`
- [Admin dashboard](https://github.com/mrsethzintwoaccoundrealnofakeonthemix/final-year_capstone-project/blob/master/public/js/admin.js): `public/js/admin.js`

### HTTP API

- [Express app](https://github.com/mrsethzintwoaccoundrealnofakeonthemix/final-year_capstone-project/blob/master/src/app.js): `src/app.js`
- [Customer endpoints](https://github.com/mrsethzintwoaccoundrealnofakeonthemix/final-year_capstone-project/blob/master/src/controllers/customer.controller.js): `src/controllers/customer.controller.js`
- [Admin operations](https://github.com/mrsethzintwoaccoundrealnofakeonthemix/final-year_capstone-project/blob/master/src/controllers/admin.controller.js): `src/controllers/admin.controller.js`
- [Messenger webhook](https://github.com/mrsethzintwoaccoundrealnofakeonthemix/final-year_capstone-project/blob/master/src/controllers/webhook.controller.js): `src/controllers/webhook.controller.js`
- [Customer routes](https://github.com/mrsethzintwoaccoundrealnofakeonthemix/final-year_capstone-project/blob/master/src/routes/customer.routes.js): `src/routes/customer.routes.js`
- [Admin routes](https://github.com/mrsethzintwoaccoundrealnofakeonthemix/final-year_capstone-project/blob/master/src/routes/admin.routes.js): `src/routes/admin.routes.js`
- [Webhook routes](https://github.com/mrsethzintwoaccoundrealnofakeonthemix/final-year_capstone-project/blob/master/src/routes/webhook.routes.js): `src/routes/webhook.routes.js`

### Commerce Services

- [Order coordinator](https://github.com/mrsethzintwoaccoundrealnofakeonthemix/final-year_capstone-project/blob/master/src/services/order.service.js): `src/services/order.service.js`
- [Signed identity](https://github.com/mrsethzintwoaccoundrealnofakeonthemix/final-year_capstone-project/blob/master/src/services/identity.service.js): `src/services/identity.service.js`
- [Admin authentication](https://github.com/mrsethzintwoaccoundrealnofakeonthemix/final-year_capstone-project/blob/master/src/services/auth.service.js): `src/services/auth.service.js`
- [Image processing](https://github.com/mrsethzintwoaccoundrealnofakeonthemix/final-year_capstone-project/blob/master/src/services/image.service.js): `src/services/image.service.js`

### Catalog & Persistence

- [Product catalog](https://github.com/mrsethzintwoaccoundrealnofakeonthemix/final-year_capstone-project/blob/master/src/repositories/product.repository.js): `src/repositories/product.repository.js`
- [Product variants](https://github.com/mrsethzintwoaccoundrealnofakeonthemix/final-year_capstone-project/blob/master/src/repositories/variant.repository.js): `src/repositories/variant.repository.js`
- [Categories](https://github.com/mrsethzintwoaccoundrealnofakeonthemix/final-year_capstone-project/blob/master/src/repositories/category.repository.js): `src/repositories/category.repository.js`
- [POS sales](https://github.com/mrsethzintwoaccoundrealnofakeonthemix/final-year_capstone-project/blob/master/src/repositories/pos.repository.js): `src/repositories/pos.repository.js`
- [Orders & lifecycle](https://github.com/mrsethzintwoaccoundrealnofakeonthemix/final-year_capstone-project/blob/master/src/repositories/order.repository.js): `src/repositories/order.repository.js`
- [SQLite database](https://github.com/mrsethzintwoaccoundrealnofakeonthemix/final-year_capstone-project/blob/master/src/db/index.js): `src/db/index.js`

### Messaging & Payments

- [Messenger integration](https://github.com/mrsethzintwoaccoundrealnofakeonthemix/final-year_capstone-project/blob/master/src/services/messenger.service.js): `src/services/messenger.service.js`
- [Telegram owner tools](https://github.com/mrsethzintwoaccoundrealnofakeonthemix/final-year_capstone-project/blob/master/src/services/telegram.service.js): `src/services/telegram.service.js`
- [Bakong KHQR](https://github.com/mrsethzintwoaccoundrealnofakeonthemix/final-year_capstone-project/blob/master/src/services/bakong.service.js): `src/services/bakong.service.js`

### Other components

- **Customer**
- **Store owner**

## Connections

- Customer → Customer webview: uses
- Store owner → Admin dashboard: manages
- Customer webview → Customer routes: requests
- Admin dashboard → Admin routes: requests
- Express app → Customer routes: mounts
- Express app → Admin routes: mounts
- Express app → Webhook routes: mounts
- Customer routes → Customer endpoints: routes to (evidence: `src/routes/customer.routes.js`)
- Admin routes → Admin operations: routes to (evidence: `src/routes/admin.routes.js`)
- Webhook routes → Messenger webhook: routes to (evidence: `src/routes/webhook.routes.js`)
- Customer endpoints → Product catalog: reads catalog (evidence: `src/controllers/customer.controller.js`)
- Customer endpoints → Signed identity: verifies identity (evidence: `src/controllers/customer.controller.js`)
- Customer endpoints → Order coordinator: places order (evidence: `src/controllers/customer.controller.js`)
- Customer endpoints → Orders & lifecycle: reads order (evidence: `src/controllers/customer.controller.js`)
- Customer endpoints → Bakong KHQR: requests payment (evidence: `src/controllers/customer.controller.js`)
- Admin operations → Admin authentication: authenticates (evidence: `src/controllers/admin.controller.js`)
- Admin operations → Product catalog: manages catalog (evidence: `src/controllers/admin.controller.js`)
- Admin operations → Categories: manages categories (evidence: `src/controllers/admin.controller.js`)
- Admin operations → Product variants: manages variants (evidence: `src/controllers/admin.controller.js`)
- Admin operations → POS sales: records sales (evidence: `src/controllers/admin.controller.js`)
- Admin operations → Order coordinator: updates orders (evidence: `src/controllers/admin.controller.js`)
- Admin operations → Image processing: processes images (evidence: `src/controllers/admin.controller.js`)
- Messenger webhook → Signed identity: signs customer links (evidence: `src/controllers/webhook.controller.js`)
- Messenger webhook → Messenger integration: sends replies (evidence: `src/controllers/webhook.controller.js`)
- Order coordinator → Orders & lifecycle: persists lifecycle (evidence: `src/services/order.service.js`)
- Order coordinator → Product catalog: checks products (evidence: `src/services/order.service.js`)
- Order coordinator → Product variants: checks variants (evidence: `src/services/order.service.js`)
- Order coordinator → Signed identity: validates customer (evidence: `src/services/order.service.js`)
- Order coordinator → Messenger integration: sends receipts (evidence: `src/services/order.service.js`)
- Order coordinator → Telegram owner tools: alerts owner (evidence: `src/services/order.service.js`)
- Order coordinator → Bakong KHQR: coordinates payment (evidence: `src/services/order.service.js`)
- Product catalog → SQLite database: queries (evidence: `src/repositories/product.repository.js`)
- Product variants → SQLite database: queries (evidence: `src/repositories/variant.repository.js`)
- Orders & lifecycle → SQLite database: queries transactions (evidence: `src/repositories/order.repository.js`)
- Categories → SQLite database: queries (evidence: `src/repositories/category.repository.js`)
- POS sales → SQLite database: queries (evidence: `src/repositories/pos.repository.js`)
- Telegram owner tools → Order coordinator: dispatches owner actions (evidence: `src/services/telegram.service.js`)
- Telegram owner tools → Store owner: alerts and controls
- Messenger integration → Customer: sends commerce messages
- Bakong KHQR → Customer: provides KHQR payment
