How hallmarkattars/hallmark-excellence works
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: src/App.jsx Storefront routing · orders.controller.js Order operations · src/App.jsx Admin routing · orders.routes.js Order endpoints
Components 27
Customer storefront
- Storefront routing
storefront/src/App.jsx - Catalog browsing
storefront/src/pages/Shop.jsx - Cart and pricing
storefront/src/context/CartContext.jsx - Variant pricing
storefront/src/utils/variantPricing.js - Order confirmation
storefront/src/pages/Contact.jsx - SEO utilities
storefront/src/utils/seo.js
Admin console
- Admin routing
admin/src/App.jsx - Admin session
admin/src/context/AuthContext.jsx - Product management
admin/src/pages/ProductForm.jsx - Order management
admin/src/pages/Orders.jsx - Admin mock data
admin/src/services/mockApi.js
Commerce API
- API route mounting
server/src/app.js - Product endpoints
server/src/routes/products.routes.js - Product operations
server/src/controllers/products.controller.js - Brand endpoints
server/src/routes/brands.routes.js - Brand operations
server/src/controllers/brands.controller.js - Order endpoints
server/src/routes/orders.routes.js - Order operations
server/src/controllers/orders.controller.js - Order tracking
server/src/controllers/tracking.controller.js - Authorization
server/src/middleware/auth.middleware.js
Persistence and services
- Supabase database
server/src/config/supabase.js - Order email service
server/src/services/orderEmailService.js - Email validation
server/src/utils/emailValidation.js - Status history
server/src/utils/orderStatusHistory.js - Display ordering
server/src/utils/displayOrder.js
Other components
- Shopper
- Administrator
Connections 32
- Shopper → Storefront routing: browses
storefront/src/App.jsx - Storefront routing → Catalog browsing: routes to
storefront/src/App.jsx - Storefront routing → Order confirmation: routes to
storefront/src/App.jsx - Storefront routing → Cart and pricing: provides state
storefront/src/App.jsx - Cart and pricing → Variant pricing: prices lines
storefront/src/context/CartContext.jsx - Cart and pricing → Order confirmation: supplies cart
storefront/src/pages/Contact.jsx - Order confirmation → Shopper: shows confirmation
storefront/src/pages/Contact.jsx - Storefront routing → SEO utilities: uses SEO
storefront/src/App.jsx - Administrator → Admin routing: manages
admin/src/App.jsx - Admin routing → Admin session: provides session
admin/src/App.jsx - Admin routing → Product management: routes to
admin/src/App.jsx - Admin routing → Order management: routes to
admin/src/App.jsx - Admin session → Admin mock data: calls login
admin/src/context/AuthContext.jsx - Order management → Admin mock data: loads orders
admin/src/pages/Orders.jsx - API route mounting → Product endpoints: mounts routes
server/src/app.js - API route mounting → Brand endpoints: mounts routes
server/src/app.js - API route mounting → Order endpoints: mounts routes
server/src/app.js - Product endpoints → Product operations: dispatches to
server/src/controllers/products.controller.js - Brand endpoints → Brand operations: dispatches to
server/src/routes/brands.routes.js - Order endpoints → Order operations: dispatches to
server/src/routes/orders.routes.js - Order endpoints → Order tracking: dispatches to
server/src/routes/orders.routes.js - Order endpoints → Authorization: guards admin routes
server/src/routes/orders.routes.js - Brand operations → Product operations: loads variants
server/src/controllers/brands.controller.js - Product operations → Display ordering: orders results
server/src/controllers/products.controller.js - Product operations → Supabase database: reads and writes
server/src/controllers/products.controller.js - Brand operations → Supabase database: reads and writes
server/src/controllers/brands.controller.js - Order operations → Supabase database: reads and writes
server/src/controllers/orders.controller.js - Order operations → Order email service: sends order email
server/src/controllers/orders.controller.js - Order operations → Email validation: validates email
server/src/controllers/orders.controller.js - Order operations → Status history: updates status history
server/src/controllers/orders.controller.js - Authorization → Supabase database: loads user
server/src/middleware/auth.middleware.js - Order email service → Email validation: validates recipient
server/src/services/orderEmailService.js