# hallmarkattars/hallmark-excellence architecture

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

- Interactive diagram: https://gitdiagram.com/hallmarkattars/hallmark-excellence
- Repository: https://github.com/hallmarkattars/hallmark-excellence

## Overview

Arees & Dahab is a perfume-commerce repository with separate customer storefront and admin React apps, plus an Express API in the supplied tree. The README describes the frontends as mock/localStorage-backed and says they do not yet call the backend, so the graph keeps those runtime paths separate. Customer flow centers on browsing, cart pricing, and order confirmation; admin flow covers authentication and catalog/order management. Several backend domain stages are visible in routes and sampled controllers; unsampled internals are represented conservatively.

Main entry points: [`storefront/src/App.jsx`](https://github.com/hallmarkattars/hallmark-excellence/blob/master/storefront/src/App.jsx) (Storefront routing), [`server/src/controllers/orders.controller.js`](https://github.com/hallmarkattars/hallmark-excellence/blob/master/server/src/controllers/orders.controller.js) (Order operations), [`admin/src/App.jsx`](https://github.com/hallmarkattars/hallmark-excellence/blob/master/admin/src/App.jsx) (Admin routing), [`server/src/routes/orders.routes.js`](https://github.com/hallmarkattars/hallmark-excellence/blob/master/server/src/routes/orders.routes.js) (Order endpoints)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_storefront["Customer storefront"]
  node_storefront_app["Storefront routing<br/>[App.jsx]"]
  node_catalog_browse["Catalog browsing<br/>[Shop.jsx]"]
  node_cart["Cart and pricing<br/>[CartContext.jsx]"]
  node_variant_pricing["Variant pricing<br/>[variantPricing.js]"]
  node_checkout["Order confirmation<br/>[Contact.jsx]"]
  node_seo["SEO utilities<br/>[seo.js]"]
end

subgraph group_admin["Admin console"]
  node_admin_app["Admin routing<br/>[App.jsx]"]
  node_auth["Admin session<br/>[AuthContext.jsx]"]
  node_admin_products["Product management<br/>[ProductForm.jsx]"]
  node_admin_orders["Order management<br/>[Orders.jsx]"]
  node_admin_api["Admin mock data<br/>[mockApi.js]"]
end

subgraph group_api["Commerce API"]
  node_api_app["API route mounting<br/>[app.js]"]
  node_product_routes["Product endpoints<br/>[products.routes.js]"]
  node_product_controller["Product operations"]
  node_brand_routes["Brand endpoints<br/>[brands.routes.js]"]
  node_brand_controller["Brand operations"]
  node_order_routes["Order endpoints<br/>[orders.routes.js]"]
  node_order_controller["Order operations"]
  node_tracking["Order tracking"]
  node_auth_middleware["Authorization<br/>[auth.middleware.js]"]
end

subgraph group_data["Persistence and services"]
  node_database[("Supabase database<br/>[supabase.js]")]
  node_email_service["Order email service"]
  node_email_validation["Email validation<br/>[emailValidation.js]"]
  node_order_history["Status history"]
  node_display_order["Display ordering<br/>[displayOrder.js]"]
end

node_customer(("Shopper"))
node_admin_user(("Administrator"))

node_customer -->|"browses"| node_storefront_app
node_storefront_app -->|"routes to"| node_catalog_browse
node_storefront_app -->|"routes to"| node_checkout
node_storefront_app -->|"provides state"| node_cart
node_cart -->|"prices lines"| node_variant_pricing
node_cart -->|"supplies cart"| node_checkout
node_checkout -->|"shows confirmation"| node_customer
node_storefront_app -->|"uses SEO"| node_seo
node_admin_user -->|"manages"| node_admin_app
node_admin_app -->|"provides session"| node_auth
node_admin_app -->|"routes to"| node_admin_products
node_admin_app -->|"routes to"| node_admin_orders
node_auth -->|"calls login"| node_admin_api
node_admin_orders -->|"loads orders"| node_admin_api
node_api_app -->|"mounts routes"| node_product_routes
node_api_app -->|"mounts routes"| node_brand_routes
node_api_app -->|"mounts routes"| node_order_routes
node_product_routes -->|"dispatches to"| node_product_controller
node_brand_routes -->|"dispatches to"| node_brand_controller
node_order_routes -->|"dispatches to"| node_order_controller
node_order_routes -->|"dispatches to"| node_tracking
node_order_routes -->|"guards admin routes"| node_auth_middleware
node_brand_controller -->|"loads variants"| node_product_controller
node_product_controller -->|"orders results"| node_display_order
node_product_controller -->|"reads and writes"| node_database
node_brand_controller -->|"reads and writes"| node_database
node_order_controller -->|"reads and writes"| node_database
node_order_controller -->|"sends order email"| node_email_service
node_order_controller -->|"validates email"| node_email_validation
node_order_controller -->|"updates status history"| node_order_history
node_auth_middleware -->|"loads user"| node_database
node_email_service -->|"validates recipient"| node_email_validation

click node_storefront_app "https://github.com/hallmarkattars/hallmark-excellence/blob/master/storefront/src/App.jsx"
click node_catalog_browse "https://github.com/hallmarkattars/hallmark-excellence/blob/master/storefront/src/pages/Shop.jsx"
click node_cart "https://github.com/hallmarkattars/hallmark-excellence/blob/master/storefront/src/context/CartContext.jsx"
click node_variant_pricing "https://github.com/hallmarkattars/hallmark-excellence/blob/master/storefront/src/utils/variantPricing.js"
click node_checkout "https://github.com/hallmarkattars/hallmark-excellence/blob/master/storefront/src/pages/Contact.jsx"
click node_seo "https://github.com/hallmarkattars/hallmark-excellence/blob/master/storefront/src/utils/seo.js"
click node_admin_app "https://github.com/hallmarkattars/hallmark-excellence/blob/master/admin/src/App.jsx"
click node_auth "https://github.com/hallmarkattars/hallmark-excellence/blob/master/admin/src/context/AuthContext.jsx"
click node_admin_products "https://github.com/hallmarkattars/hallmark-excellence/blob/master/admin/src/pages/ProductForm.jsx"
click node_admin_orders "https://github.com/hallmarkattars/hallmark-excellence/blob/master/admin/src/pages/Orders.jsx"
click node_admin_api "https://github.com/hallmarkattars/hallmark-excellence/blob/master/admin/src/services/mockApi.js"
click node_api_app "https://github.com/hallmarkattars/hallmark-excellence/blob/master/server/src/app.js"
click node_product_routes "https://github.com/hallmarkattars/hallmark-excellence/blob/master/server/src/routes/products.routes.js"
click node_product_controller "https://github.com/hallmarkattars/hallmark-excellence/blob/master/server/src/controllers/products.controller.js"
click node_brand_routes "https://github.com/hallmarkattars/hallmark-excellence/blob/master/server/src/routes/brands.routes.js"
click node_brand_controller "https://github.com/hallmarkattars/hallmark-excellence/blob/master/server/src/controllers/brands.controller.js"
click node_order_routes "https://github.com/hallmarkattars/hallmark-excellence/blob/master/server/src/routes/orders.routes.js"
click node_order_controller "https://github.com/hallmarkattars/hallmark-excellence/blob/master/server/src/controllers/orders.controller.js"
click node_tracking "https://github.com/hallmarkattars/hallmark-excellence/blob/master/server/src/controllers/tracking.controller.js"
click node_auth_middleware "https://github.com/hallmarkattars/hallmark-excellence/blob/master/server/src/middleware/auth.middleware.js"
click node_database "https://github.com/hallmarkattars/hallmark-excellence/blob/master/server/src/config/supabase.js"
click node_email_service "https://github.com/hallmarkattars/hallmark-excellence/blob/master/server/src/services/orderEmailService.js"
click node_email_validation "https://github.com/hallmarkattars/hallmark-excellence/blob/master/server/src/utils/emailValidation.js"
click node_order_history "https://github.com/hallmarkattars/hallmark-excellence/blob/master/server/src/utils/orderStatusHistory.js"
click node_display_order "https://github.com/hallmarkattars/hallmark-excellence/blob/master/server/src/utils/displayOrder.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_storefront_app,node_catalog_browse,node_cart,node_variant_pricing,node_checkout,node_seo toneBlue
class node_admin_app,node_auth,node_admin_products,node_admin_orders,node_admin_api toneAmber
class node_api_app,node_product_routes,node_product_controller,node_brand_routes,node_brand_controller,node_order_routes,node_order_controller,node_tracking,node_auth_middleware toneMint
class node_database,node_email_service,node_email_validation,node_order_history,node_display_order toneRose
class node_customer,node_admin_user toneIndigo
```

## Components

### Customer storefront

- [Storefront routing](https://github.com/hallmarkattars/hallmark-excellence/blob/master/storefront/src/App.jsx): `storefront/src/App.jsx`
- [Catalog browsing](https://github.com/hallmarkattars/hallmark-excellence/blob/master/storefront/src/pages/Shop.jsx): `storefront/src/pages/Shop.jsx`
- [Cart and pricing](https://github.com/hallmarkattars/hallmark-excellence/blob/master/storefront/src/context/CartContext.jsx): `storefront/src/context/CartContext.jsx`
- [Variant pricing](https://github.com/hallmarkattars/hallmark-excellence/blob/master/storefront/src/utils/variantPricing.js): `storefront/src/utils/variantPricing.js`
- [Order confirmation](https://github.com/hallmarkattars/hallmark-excellence/blob/master/storefront/src/pages/Contact.jsx): `storefront/src/pages/Contact.jsx`
- [SEO utilities](https://github.com/hallmarkattars/hallmark-excellence/blob/master/storefront/src/utils/seo.js): `storefront/src/utils/seo.js`

### Admin console

- [Admin routing](https://github.com/hallmarkattars/hallmark-excellence/blob/master/admin/src/App.jsx): `admin/src/App.jsx`
- [Admin session](https://github.com/hallmarkattars/hallmark-excellence/blob/master/admin/src/context/AuthContext.jsx): `admin/src/context/AuthContext.jsx`
- [Product management](https://github.com/hallmarkattars/hallmark-excellence/blob/master/admin/src/pages/ProductForm.jsx): `admin/src/pages/ProductForm.jsx`
- [Order management](https://github.com/hallmarkattars/hallmark-excellence/blob/master/admin/src/pages/Orders.jsx): `admin/src/pages/Orders.jsx`
- [Admin mock data](https://github.com/hallmarkattars/hallmark-excellence/blob/master/admin/src/services/mockApi.js): `admin/src/services/mockApi.js`

### Commerce API

- [API route mounting](https://github.com/hallmarkattars/hallmark-excellence/blob/master/server/src/app.js): `server/src/app.js`
- [Product endpoints](https://github.com/hallmarkattars/hallmark-excellence/blob/master/server/src/routes/products.routes.js): `server/src/routes/products.routes.js`
- [Product operations](https://github.com/hallmarkattars/hallmark-excellence/blob/master/server/src/controllers/products.controller.js): `server/src/controllers/products.controller.js`
- [Brand endpoints](https://github.com/hallmarkattars/hallmark-excellence/blob/master/server/src/routes/brands.routes.js): `server/src/routes/brands.routes.js`
- [Brand operations](https://github.com/hallmarkattars/hallmark-excellence/blob/master/server/src/controllers/brands.controller.js): `server/src/controllers/brands.controller.js`
- [Order endpoints](https://github.com/hallmarkattars/hallmark-excellence/blob/master/server/src/routes/orders.routes.js): `server/src/routes/orders.routes.js`
- [Order operations](https://github.com/hallmarkattars/hallmark-excellence/blob/master/server/src/controllers/orders.controller.js): `server/src/controllers/orders.controller.js`
- [Order tracking](https://github.com/hallmarkattars/hallmark-excellence/blob/master/server/src/controllers/tracking.controller.js): `server/src/controllers/tracking.controller.js`
- [Authorization](https://github.com/hallmarkattars/hallmark-excellence/blob/master/server/src/middleware/auth.middleware.js): `server/src/middleware/auth.middleware.js`

### Persistence and services

- [Supabase database](https://github.com/hallmarkattars/hallmark-excellence/blob/master/server/src/config/supabase.js): `server/src/config/supabase.js`
- [Order email service](https://github.com/hallmarkattars/hallmark-excellence/blob/master/server/src/services/orderEmailService.js): `server/src/services/orderEmailService.js`
- [Email validation](https://github.com/hallmarkattars/hallmark-excellence/blob/master/server/src/utils/emailValidation.js): `server/src/utils/emailValidation.js`
- [Status history](https://github.com/hallmarkattars/hallmark-excellence/blob/master/server/src/utils/orderStatusHistory.js): `server/src/utils/orderStatusHistory.js`
- [Display ordering](https://github.com/hallmarkattars/hallmark-excellence/blob/master/server/src/utils/displayOrder.js): `server/src/utils/displayOrder.js`

### Other components

- **Shopper**
- **Administrator**

## Connections

- Shopper → Storefront routing: browses (evidence: `storefront/src/App.jsx`)
- Storefront routing → Catalog browsing: routes to (evidence: `storefront/src/App.jsx`)
- Storefront routing → Order confirmation: routes to (evidence: `storefront/src/App.jsx`)
- Storefront routing → Cart and pricing: provides state (evidence: `storefront/src/App.jsx`)
- Cart and pricing → Variant pricing: prices lines (evidence: `storefront/src/context/CartContext.jsx`)
- Cart and pricing → Order confirmation: supplies cart (evidence: `storefront/src/pages/Contact.jsx`)
- Order confirmation → Shopper: shows confirmation (evidence: `storefront/src/pages/Contact.jsx`)
- Storefront routing → SEO utilities: uses SEO (evidence: `storefront/src/App.jsx`)
- Administrator → Admin routing: manages (evidence: `admin/src/App.jsx`)
- Admin routing → Admin session: provides session (evidence: `admin/src/App.jsx`)
- Admin routing → Product management: routes to (evidence: `admin/src/App.jsx`)
- Admin routing → Order management: routes to (evidence: `admin/src/App.jsx`)
- Admin session → Admin mock data: calls login (evidence: `admin/src/context/AuthContext.jsx`)
- Order management → Admin mock data: loads orders (evidence: `admin/src/pages/Orders.jsx`)
- API route mounting → Product endpoints: mounts routes (evidence: `server/src/app.js`)
- API route mounting → Brand endpoints: mounts routes (evidence: `server/src/app.js`)
- API route mounting → Order endpoints: mounts routes (evidence: `server/src/app.js`)
- Product endpoints → Product operations: dispatches to (evidence: `server/src/controllers/products.controller.js`)
- Brand endpoints → Brand operations: dispatches to (evidence: `server/src/routes/brands.routes.js`)
- Order endpoints → Order operations: dispatches to (evidence: `server/src/routes/orders.routes.js`)
- Order endpoints → Order tracking: dispatches to (evidence: `server/src/routes/orders.routes.js`)
- Order endpoints → Authorization: guards admin routes (evidence: `server/src/routes/orders.routes.js`)
- Brand operations → Product operations: loads variants (evidence: `server/src/controllers/brands.controller.js`)
- Product operations → Display ordering: orders results (evidence: `server/src/controllers/products.controller.js`)
- Product operations → Supabase database: reads and writes (evidence: `server/src/controllers/products.controller.js`)
- Brand operations → Supabase database: reads and writes (evidence: `server/src/controllers/brands.controller.js`)
- Order operations → Supabase database: reads and writes (evidence: `server/src/controllers/orders.controller.js`)
- Order operations → Order email service: sends order email (evidence: `server/src/controllers/orders.controller.js`)
- Order operations → Email validation: validates email (evidence: `server/src/controllers/orders.controller.js`)
- Order operations → Status history: updates status history (evidence: `server/src/controllers/orders.controller.js`)
- Authorization → Supabase database: loads user (evidence: `server/src/middleware/auth.middleware.js`)
- Order email service → Email validation: validates recipient (evidence: `server/src/services/orderEmailService.js`)
