# jamesmangao/star-dom architecture

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

- Interactive diagram: https://gitdiagram.com/jamesmangao/star-dom
- Repository: https://github.com/jamesmangao/star-dom

## Overview

STAR:DOM is a server-rendered VB.NET marketplace for handmade goods, pop-up events, and artist commissions. The main customer journey runs from catalog browsing through cart and checkout to order tracking and pickup or delivery; separate owner workflows manage products, events, commissions, orders, and reports. The README documents the application’s page → service → repository → database layers. Source excerpts do not cover the Web Forms business modules, so domain links below rely on README descriptions rather than claims of source-level inspection.

Main entry points: [`STAR-DOM-Web/App/Merchant/Dashboard.aspx.vb`](https://github.com/jamesmangao/star-dom/blob/main/STAR-DOM-Web/App/Merchant/Dashboard.aspx.vb) (Merchant Studio), [`STAR-DOM-Web/App`](https://github.com/jamesmangao/star-dom/tree/main/STAR-DOM-Web/App) (Web Forms Pages), [`STAR-DOM-Web/App/Checkout.aspx.vb`](https://github.com/jamesmangao/star-dom/blob/main/STAR-DOM-Web/App/Checkout.aspx.vb) (Cart and Checkout), [`STAR-DOM-Web/App/Orders.aspx.vb`](https://github.com/jamesmangao/star-dom/blob/main/STAR-DOM-Web/App/Orders.aspx.vb) (Order Tracking)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_customer["Customer Commerce"]
  node_webpages["Web Forms Pages"]
  node_catalog["Catalog Browsing<br/>[Catalog.aspx.vb]"]
  node_cartcheckout["Cart and Checkout<br/>[Checkout.aspx.vb]"]
  node_orders["Order Tracking<br/>[Orders.aspx.vb]"]
  node_fulfillment["Pickup and Delivery"]
end

subgraph group_artist["Commissions and Events"]
  node_commissions["Commission Requests"]
  node_commissionpipe["Commission Pipeline<br/>[Pipeline.aspx.vb]"]
  node_events["Pop-up Events<br/>[Events.aspx.vb]"]
  node_locations["Pop-up Locations"]
end

subgraph group_operations["Merchant Operations"]
  node_merchant["Merchant Studio<br/>[Dashboard.aspx.vb]"]
  node_products["Product Management<br/>[Products.aspx.vb]"]
  node_reports["Sales Reports<br/>[Reports.aspx.vb]"]
  node_reviews["Review Moderation<br/>[Reviews.aspx.vb]"]
  node_admin["Admin Console<br/>[Users.aspx.vb]"]
end

subgraph group_core["Application Core"]
  node_services["Business Services"]
  node_repositories["SQL Repositories"]
  node_dbaccess["Database Access<br/>[Db.vb]"]
  node_postgres[("PostgreSQL")]
  node_webui["Shared UI Rendering<br/>[WebUi.vb]"]
end

node_browser(("Customer or Owner"))

node_browser -->|"requests pages"| node_webpages
node_webpages -->|"calls services"| node_services
node_services -->|"calls repositories"| node_repositories
node_repositories -->|"uses database access"| node_dbaccess
node_dbaccess -->|"reads and writes"| node_postgres
node_webpages -->|"renders through"| node_webui
node_catalog -->|"continues to cart"| node_cartcheckout
node_cartcheckout -->|"creates orders"| node_orders
node_orders -->|"tracks fulfillment"| node_fulfillment
node_browser -->|"requests custom work"| node_commissions
node_commissions -->|"enters pipeline"| node_commissionpipe
node_browser -->|"views schedules"| node_locations
node_merchant -->|"manages products"| node_products
node_merchant -->|"manages events"| node_events
node_merchant -->|"handles requests"| node_commissionpipe
node_merchant -->|"views sales"| node_reports
node_merchant -->|"moderates reviews"| node_reviews
node_merchant -->|"manages accounts"| node_admin

click node_webpages "https://github.com/jamesmangao/star-dom/tree/main/STAR-DOM-Web/App"
click node_catalog "https://github.com/jamesmangao/star-dom/blob/main/STAR-DOM-Web/App/Catalog.aspx.vb"
click node_cartcheckout "https://github.com/jamesmangao/star-dom/blob/main/STAR-DOM-Web/App/Checkout.aspx.vb"
click node_orders "https://github.com/jamesmangao/star-dom/blob/main/STAR-DOM-Web/App/Orders.aspx.vb"
click node_fulfillment "https://github.com/jamesmangao/star-dom/blob/main/STAR-DOM-Web/App/OrderDetail.aspx.vb"
click node_commissions "https://github.com/jamesmangao/star-dom/blob/main/STAR-DOM-Web/App/CommissionRequest.aspx.vb"
click node_commissionpipe "https://github.com/jamesmangao/star-dom/blob/main/STAR-DOM-Web/App/Merchant/Pipeline.aspx.vb"
click node_events "https://github.com/jamesmangao/star-dom/blob/main/STAR-DOM-Web/App/Merchant/Events.aspx.vb"
click node_locations "https://github.com/jamesmangao/star-dom/blob/main/STAR-DOM-Web/App/PopupLocations.aspx.vb"
click node_merchant "https://github.com/jamesmangao/star-dom/blob/main/STAR-DOM-Web/App/Merchant/Dashboard.aspx.vb"
click node_products "https://github.com/jamesmangao/star-dom/blob/main/STAR-DOM-Web/App/Merchant/Products.aspx.vb"
click node_reports "https://github.com/jamesmangao/star-dom/blob/main/STAR-DOM-Web/App/Merchant/Reports.aspx.vb"
click node_reviews "https://github.com/jamesmangao/star-dom/blob/main/STAR-DOM-Web/App/Merchant/Reviews.aspx.vb"
click node_admin "https://github.com/jamesmangao/star-dom/blob/main/STAR-DOM-Web/App/Admin/Users.aspx.vb"
click node_services "https://github.com/jamesmangao/star-dom/tree/main/STAR-DOM-Web/Shared/Services"
click node_repositories "https://github.com/jamesmangao/star-dom/tree/main/STAR-DOM-Web/Shared/Repositories"
click node_dbaccess "https://github.com/jamesmangao/star-dom/blob/main/STAR-DOM-Web/Code/Db.vb"
click node_postgres "https://github.com/jamesmangao/star-dom/blob/main/STAR-DOM-Web/Database/supabase_schema.sql"
click node_webui "https://github.com/jamesmangao/star-dom/blob/main/STAR-DOM-Web/Code/WebUi.vb"

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_webpages,node_catalog,node_cartcheckout,node_orders,node_fulfillment toneBlue
class node_commissions,node_commissionpipe,node_events,node_locations toneAmber
class node_merchant,node_products,node_reports,node_reviews,node_admin toneMint
class node_services,node_repositories,node_dbaccess,node_postgres,node_webui toneRose
class node_browser toneIndigo
```

## Components

### Customer Commerce

- [Web Forms Pages](https://github.com/jamesmangao/star-dom/tree/main/STAR-DOM-Web/App): `STAR-DOM-Web/App`
- [Catalog Browsing](https://github.com/jamesmangao/star-dom/blob/main/STAR-DOM-Web/App/Catalog.aspx.vb): `STAR-DOM-Web/App/Catalog.aspx.vb`
- [Cart and Checkout](https://github.com/jamesmangao/star-dom/blob/main/STAR-DOM-Web/App/Checkout.aspx.vb): `STAR-DOM-Web/App/Checkout.aspx.vb`
- [Order Tracking](https://github.com/jamesmangao/star-dom/blob/main/STAR-DOM-Web/App/Orders.aspx.vb): `STAR-DOM-Web/App/Orders.aspx.vb`
- [Pickup and Delivery](https://github.com/jamesmangao/star-dom/blob/main/STAR-DOM-Web/App/OrderDetail.aspx.vb): `STAR-DOM-Web/App/OrderDetail.aspx.vb`

### Commissions and Events

- [Commission Requests](https://github.com/jamesmangao/star-dom/blob/main/STAR-DOM-Web/App/CommissionRequest.aspx.vb): `STAR-DOM-Web/App/CommissionRequest.aspx.vb`
- [Commission Pipeline](https://github.com/jamesmangao/star-dom/blob/main/STAR-DOM-Web/App/Merchant/Pipeline.aspx.vb): `STAR-DOM-Web/App/Merchant/Pipeline.aspx.vb`
- [Pop-up Events](https://github.com/jamesmangao/star-dom/blob/main/STAR-DOM-Web/App/Merchant/Events.aspx.vb): `STAR-DOM-Web/App/Merchant/Events.aspx.vb`
- [Pop-up Locations](https://github.com/jamesmangao/star-dom/blob/main/STAR-DOM-Web/App/PopupLocations.aspx.vb): `STAR-DOM-Web/App/PopupLocations.aspx.vb`

### Merchant Operations

- [Merchant Studio](https://github.com/jamesmangao/star-dom/blob/main/STAR-DOM-Web/App/Merchant/Dashboard.aspx.vb): `STAR-DOM-Web/App/Merchant/Dashboard.aspx.vb`
- [Product Management](https://github.com/jamesmangao/star-dom/blob/main/STAR-DOM-Web/App/Merchant/Products.aspx.vb): `STAR-DOM-Web/App/Merchant/Products.aspx.vb`
- [Sales Reports](https://github.com/jamesmangao/star-dom/blob/main/STAR-DOM-Web/App/Merchant/Reports.aspx.vb): `STAR-DOM-Web/App/Merchant/Reports.aspx.vb`
- [Review Moderation](https://github.com/jamesmangao/star-dom/blob/main/STAR-DOM-Web/App/Merchant/Reviews.aspx.vb): `STAR-DOM-Web/App/Merchant/Reviews.aspx.vb`
- [Admin Console](https://github.com/jamesmangao/star-dom/blob/main/STAR-DOM-Web/App/Admin/Users.aspx.vb): `STAR-DOM-Web/App/Admin/Users.aspx.vb`

### Application Core

- [Business Services](https://github.com/jamesmangao/star-dom/tree/main/STAR-DOM-Web/Shared/Services): `STAR-DOM-Web/Shared/Services`
- [SQL Repositories](https://github.com/jamesmangao/star-dom/tree/main/STAR-DOM-Web/Shared/Repositories): `STAR-DOM-Web/Shared/Repositories`
- [Database Access](https://github.com/jamesmangao/star-dom/blob/main/STAR-DOM-Web/Code/Db.vb): `STAR-DOM-Web/Code/Db.vb`
- [PostgreSQL](https://github.com/jamesmangao/star-dom/blob/main/STAR-DOM-Web/Database/supabase_schema.sql): `STAR-DOM-Web/Database/supabase_schema.sql`
- [Shared UI Rendering](https://github.com/jamesmangao/star-dom/blob/main/STAR-DOM-Web/Code/WebUi.vb): `STAR-DOM-Web/Code/WebUi.vb`

### Other components

- **Customer or Owner**

## Connections

- Customer or Owner → Web Forms Pages: requests pages (evidence: `README.md`)
- Web Forms Pages → Business Services: calls services (evidence: `README.md`)
- Business Services → SQL Repositories: calls repositories (evidence: `README.md`)
- SQL Repositories → Database Access: uses database access (evidence: `README.md`)
- Database Access → PostgreSQL: reads and writes (evidence: `README.md`)
- Web Forms Pages → Shared UI Rendering: renders through (evidence: `README.md`)
- Catalog Browsing → Cart and Checkout: continues to cart (evidence: `README.md`)
- Cart and Checkout → Order Tracking: creates orders (evidence: `README.md`)
- Order Tracking → Pickup and Delivery: tracks fulfillment (evidence: `README.md`)
- Customer or Owner → Commission Requests: requests custom work (evidence: `README.md`)
- Commission Requests → Commission Pipeline: enters pipeline (evidence: `README.md`)
- Customer or Owner → Pop-up Locations: views schedules (evidence: `README.md`)
- Merchant Studio → Product Management: manages products (evidence: `README.md`)
- Merchant Studio → Pop-up Events: manages events (evidence: `README.md`)
- Merchant Studio → Commission Pipeline: handles requests (evidence: `README.md`)
- Merchant Studio → Sales Reports: views sales (evidence: `README.md`)
- Merchant Studio → Review Moderation: moderates reviews (evidence: `README.md`)
- Merchant Studio → Admin Console: manages accounts (evidence: `README.md`)
