# saadullah990123/aura-dial architecture

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

- Interactive diagram: https://gitdiagram.com/saadullah990123/aura-dial
- Repository: https://github.com/saadullah990123/aura-dial

## Overview

Aura Dial is a COD-first luxury watch and eyewear store with public shopping and order lookup alongside an owner-facing management dashboard. The customer flow covers catalog discovery, product reviews, cart, validated order creation, and later tracking; admin capabilities include catalog, orders, reviews, content, settings, account security, and media. The excerpts establish the order, tracking, login/session, store-query, and review-moderation connections; documented but unsampled admin areas are shown without speculative internal wiring.

Main entry points: [`src/app/admin/(dashboard)`](https://github.com/saadullah990123/aura-dial/tree/main/src/app/admin/(dashboard)) (Admin dashboard), [`src/app/api/orders/route.ts`](https://github.com/saadullah990123/aura-dial/blob/main/src/app/api/orders/route.ts) (Order endpoint), [`src/db/index.ts`](https://github.com/saadullah990123/aura-dial/blob/main/src/db/index.ts) (Neon PostgreSQL), [`src/app/api/orders/track/route.ts`](https://github.com/saadullah990123/aura-dial/blob/main/src/app/api/orders/track/route.ts) (Tracking endpoint)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_storefront["Shopping experience"]
  node_store_pages["Storefront pages"]
  node_store_ui["Shopping UI"]
  node_cart["Cart and wishlist"]
  node_reviews["Product reviews"]
  node_review_actions["Review submission<br/>[review-actions.ts]"]
end

subgraph group_orders["Order lifecycle"]
  node_checkout["Checkout form<br/>[checkout-form.tsx]"]
  node_order_api["Order endpoint<br/>[route.ts]"]
  node_order_creation["Order creation<br/>[create.ts]"]
  node_tracking_ui["Tracking form"]
  node_tracking_api["Tracking endpoint<br/>[route.ts]"]
  node_order_success["Order confirmation<br/>[page.tsx]"]
end

subgraph group_admin["Store administration"]
  node_admin_pages["Admin dashboard"]
  node_admin_api["Admin APIs"]
  node_login["Admin login<br/>[route.ts]"]
  node_reviews_manager["Review moderation"]
  node_admin_actions["Review actions<br/>[actions.ts]"]
  node_media_upload["Media uploads<br/>[route.ts]"]
  node_content["Content and policies"]
  node_account_settings["Account and settings"]
  node_order_management["Order management"]
  node_catalog_management["Catalog management"]
end

subgraph group_platform["Data and services"]
  node_catalog_queries["Catalog queries<br/>[store.ts]"]
  node_sessions["Admin sessions<br/>[session.ts]"]
  node_admin_queries["Admin queries<br/>[admin.ts]"]
  node_cloudinary["Cloudinary<br/>[server.ts]"]
  node_database[("Neon PostgreSQL<br/>[index.ts]")]
  node_schema["Drizzle schema<br/>[index.ts]"]
  node_order_validation["Order validation<br/>[order.ts]"]
  node_rate_limit["Rate limiting<br/>[rate-limit.ts]"]
  node_csrf["Origin checks<br/>[csrf.ts]"]
  node_store_settings["Store settings<br/>[store.ts]"]
  node_admin_auth["Admin security<br/>[require-admin.ts]"]
end

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

node_customer -->|"browses"| node_store_pages
node_store_pages -->|"loads catalog"| node_catalog_queries
node_store_pages -.->|"renders"| node_store_ui
node_customer -.->|"shops"| node_store_ui
node_store_ui -->|"updates cart"| node_cart
node_store_pages -->|"shows reviews"| node_reviews
node_reviews -->|"loads ratings"| node_catalog_queries
node_reviews -->|"submits review"| node_review_actions
node_customer -->|"places order"| node_checkout
node_checkout -->|"submits order"| node_order_api
node_order_api -->|"checks origin"| node_csrf
node_order_api -->|"validates input"| node_order_validation
node_order_api -->|"limits requests"| node_rate_limit
node_order_api -->|"loads settings"| node_store_settings
node_order_api -->|"creates order"| node_order_creation
node_order_creation -->|"writes order"| node_database
node_customer -->|"requests status"| node_tracking_ui
node_tracking_ui -.->|"looks up order"| node_tracking_api
node_tracking_api -->|"checks origin"| node_csrf
node_tracking_api -->|"validates details"| node_order_validation
node_tracking_api -->|"limits requests"| node_rate_limit
node_tracking_api -->|"reads order"| node_database
node_order_api -.->|"returns confirmation"| node_order_success
node_owner -->|"manages store"| node_admin_pages
node_admin_pages -->|"loads dashboard data"| node_admin_queries
node_admin_pages -->|"manages reviews"| node_reviews_manager
node_reviews_manager -->|"calls moderation"| node_admin_actions
node_admin_actions -->|"updates reviews"| node_database
node_admin_pages -.->|"edits content"| node_content
node_admin_pages -.->|"changes settings"| node_account_settings
node_admin_pages -.->|"updates orders"| node_order_management
node_admin_pages -.->|"manages catalog"| node_catalog_management
node_owner -->|"authenticates"| node_login
node_login -->|"checks origin"| node_csrf
node_login -->|"limits attempts"| node_rate_limit
node_login -->|"checks credentials"| node_database
node_login -->|"creates session"| node_sessions
node_admin_pages -.->|"guards access"| node_admin_auth
node_admin_auth -.->|"checks session"| node_sessions
node_admin_pages -.->|"requests signed upload"| node_media_upload
node_media_upload -->|"signs upload"| node_cloudinary
node_catalog_queries -->|"reads catalog"| node_database
node_admin_queries -->|"reads admin data"| node_database
node_database -->|"uses schema"| node_schema

click node_store_pages "https://github.com/saadullah990123/aura-dial/tree/main/src/app/(store)"
click node_catalog_queries "https://github.com/saadullah990123/aura-dial/blob/main/src/lib/queries/store.ts"
click node_store_ui "https://github.com/saadullah990123/aura-dial/tree/main/src/components/store"
click node_cart "https://github.com/saadullah990123/aura-dial/tree/main/src/store"
click node_reviews "https://github.com/saadullah990123/aura-dial/blob/main/src/components/store/product-reviews.tsx"
click node_review_actions "https://github.com/saadullah990123/aura-dial/blob/main/src/app/(store)/products/%5Bslug%5D/review-actions.ts"
click node_checkout "https://github.com/saadullah990123/aura-dial/blob/main/src/components/store/checkout-form.tsx"
click node_order_api "https://github.com/saadullah990123/aura-dial/blob/main/src/app/api/orders/route.ts"
click node_order_creation "https://github.com/saadullah990123/aura-dial/blob/main/src/lib/orders/create.ts"
click node_tracking_ui "https://github.com/saadullah990123/aura-dial/blob/main/src/components/store/track-order-form.tsx"
click node_tracking_api "https://github.com/saadullah990123/aura-dial/blob/main/src/app/api/orders/track/route.ts"
click node_order_success "https://github.com/saadullah990123/aura-dial/blob/main/src/app/(store)/order-success/%5BorderNumber%5D/page.tsx"
click node_admin_pages "https://github.com/saadullah990123/aura-dial/tree/main/src/app/admin/(dashboard)"
click node_admin_api "https://github.com/saadullah990123/aura-dial/tree/main/src/app/api/admin"
click node_login "https://github.com/saadullah990123/aura-dial/blob/main/src/app/api/admin/auth/login/route.ts"
click node_sessions "https://github.com/saadullah990123/aura-dial/blob/main/src/lib/auth/session.ts"
click node_admin_queries "https://github.com/saadullah990123/aura-dial/blob/main/src/lib/queries/admin.ts"
click node_reviews_manager "https://github.com/saadullah990123/aura-dial/blob/main/src/components/admin/reviews-manager.tsx"
click node_admin_actions "https://github.com/saadullah990123/aura-dial/blob/main/src/app/admin/(dashboard)/reviews/actions.ts"
click node_media_upload "https://github.com/saadullah990123/aura-dial/blob/main/src/app/api/admin/uploads/sign/route.ts"
click node_cloudinary "https://github.com/saadullah990123/aura-dial/blob/main/src/lib/cloudinary/server.ts"
click node_database "https://github.com/saadullah990123/aura-dial/blob/main/src/db/index.ts"
click node_schema "https://github.com/saadullah990123/aura-dial/blob/main/src/db/schema/index.ts"
click node_order_validation "https://github.com/saadullah990123/aura-dial/blob/main/src/lib/validations/order.ts"
click node_rate_limit "https://github.com/saadullah990123/aura-dial/blob/main/src/lib/security/rate-limit.ts"
click node_csrf "https://github.com/saadullah990123/aura-dial/blob/main/src/lib/security/csrf.ts"
click node_store_settings "https://github.com/saadullah990123/aura-dial/blob/main/src/lib/queries/store.ts"
click node_admin_auth "https://github.com/saadullah990123/aura-dial/blob/main/src/lib/auth/require-admin.ts"
click node_content "https://github.com/saadullah990123/aura-dial/tree/main/src/app/admin/(dashboard)/pages"
click node_account_settings "https://github.com/saadullah990123/aura-dial/tree/main/src/app/admin/(dashboard)/account"
click node_order_management "https://github.com/saadullah990123/aura-dial/tree/main/src/app/admin/(dashboard)/orders"
click node_catalog_management "https://github.com/saadullah990123/aura-dial/tree/main/src/app/admin/(dashboard)/products"

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_pages,node_store_ui,node_cart,node_reviews,node_review_actions toneBlue
class node_checkout,node_order_api,node_order_creation,node_tracking_ui,node_tracking_api,node_order_success toneAmber
class node_admin_pages,node_admin_api,node_login,node_reviews_manager,node_admin_actions,node_media_upload,node_content,node_account_settings,node_order_management,node_catalog_management toneMint
class node_catalog_queries,node_sessions,node_admin_queries,node_cloudinary,node_database,node_schema,node_order_validation,node_rate_limit,node_csrf,node_store_settings,node_admin_auth toneRose
class node_customer,node_owner toneIndigo
```

## Components

### Shopping experience

- [Storefront pages](https://github.com/saadullah990123/aura-dial/tree/main/src/app/(store)): `src/app/(store)`
- [Shopping UI](https://github.com/saadullah990123/aura-dial/tree/main/src/components/store): `src/components/store`
- [Cart and wishlist](https://github.com/saadullah990123/aura-dial/tree/main/src/store): `src/store`
- [Product reviews](https://github.com/saadullah990123/aura-dial/blob/main/src/components/store/product-reviews.tsx): `src/components/store/product-reviews.tsx`
- [Review submission](https://github.com/saadullah990123/aura-dial/blob/main/src/app/(store)/products/%5Bslug%5D/review-actions.ts): `src/app/(store)/products/[slug]/review-actions.ts`

### Order lifecycle

- [Checkout form](https://github.com/saadullah990123/aura-dial/blob/main/src/components/store/checkout-form.tsx): `src/components/store/checkout-form.tsx`
- [Order endpoint](https://github.com/saadullah990123/aura-dial/blob/main/src/app/api/orders/route.ts): `src/app/api/orders/route.ts`
- [Order creation](https://github.com/saadullah990123/aura-dial/blob/main/src/lib/orders/create.ts): `src/lib/orders/create.ts`
- [Tracking form](https://github.com/saadullah990123/aura-dial/blob/main/src/components/store/track-order-form.tsx): `src/components/store/track-order-form.tsx`
- [Tracking endpoint](https://github.com/saadullah990123/aura-dial/blob/main/src/app/api/orders/track/route.ts): `src/app/api/orders/track/route.ts`
- [Order confirmation](https://github.com/saadullah990123/aura-dial/blob/main/src/app/(store)/order-success/%5BorderNumber%5D/page.tsx): `src/app/(store)/order-success/[orderNumber]/page.tsx`

### Store administration

- [Admin dashboard](https://github.com/saadullah990123/aura-dial/tree/main/src/app/admin/(dashboard)): `src/app/admin/(dashboard)`
- [Admin APIs](https://github.com/saadullah990123/aura-dial/tree/main/src/app/api/admin): `src/app/api/admin`
- [Admin login](https://github.com/saadullah990123/aura-dial/blob/main/src/app/api/admin/auth/login/route.ts): `src/app/api/admin/auth/login/route.ts`
- [Review moderation](https://github.com/saadullah990123/aura-dial/blob/main/src/components/admin/reviews-manager.tsx): `src/components/admin/reviews-manager.tsx`
- [Review actions](https://github.com/saadullah990123/aura-dial/blob/main/src/app/admin/(dashboard)/reviews/actions.ts): `src/app/admin/(dashboard)/reviews/actions.ts`
- [Media uploads](https://github.com/saadullah990123/aura-dial/blob/main/src/app/api/admin/uploads/sign/route.ts): `src/app/api/admin/uploads/sign/route.ts`
- [Content and policies](https://github.com/saadullah990123/aura-dial/tree/main/src/app/admin/(dashboard)/pages): `src/app/admin/(dashboard)/pages`
- [Account and settings](https://github.com/saadullah990123/aura-dial/tree/main/src/app/admin/(dashboard)/account): `src/app/admin/(dashboard)/account`
- [Order management](https://github.com/saadullah990123/aura-dial/tree/main/src/app/admin/(dashboard)/orders): `src/app/admin/(dashboard)/orders`
- [Catalog management](https://github.com/saadullah990123/aura-dial/tree/main/src/app/admin/(dashboard)/products): `src/app/admin/(dashboard)/products`

### Data and services

- [Catalog queries](https://github.com/saadullah990123/aura-dial/blob/main/src/lib/queries/store.ts): `src/lib/queries/store.ts`
- [Admin sessions](https://github.com/saadullah990123/aura-dial/blob/main/src/lib/auth/session.ts): `src/lib/auth/session.ts`
- [Admin queries](https://github.com/saadullah990123/aura-dial/blob/main/src/lib/queries/admin.ts): `src/lib/queries/admin.ts`
- [Cloudinary](https://github.com/saadullah990123/aura-dial/blob/main/src/lib/cloudinary/server.ts): `src/lib/cloudinary/server.ts`
- [Neon PostgreSQL](https://github.com/saadullah990123/aura-dial/blob/main/src/db/index.ts): `src/db/index.ts`
- [Drizzle schema](https://github.com/saadullah990123/aura-dial/blob/main/src/db/schema/index.ts): `src/db/schema/index.ts`
- [Order validation](https://github.com/saadullah990123/aura-dial/blob/main/src/lib/validations/order.ts): `src/lib/validations/order.ts`
- [Rate limiting](https://github.com/saadullah990123/aura-dial/blob/main/src/lib/security/rate-limit.ts): `src/lib/security/rate-limit.ts`
- [Origin checks](https://github.com/saadullah990123/aura-dial/blob/main/src/lib/security/csrf.ts): `src/lib/security/csrf.ts`
- [Store settings](https://github.com/saadullah990123/aura-dial/blob/main/src/lib/queries/store.ts): `src/lib/queries/store.ts`
- [Admin security](https://github.com/saadullah990123/aura-dial/blob/main/src/lib/auth/require-admin.ts): `src/lib/auth/require-admin.ts`

### Other components

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

## Connections

- Customer → Storefront pages: browses
- Storefront pages → Catalog queries: loads catalog (evidence: `src/app/(store)/page.tsx`)
- Storefront pages → Shopping UI: renders (evidence: `src/app/(store)/page.tsx`)
- Customer → Shopping UI: shops
- Shopping UI → Cart and wishlist: updates cart (evidence: `src/components/store/header-client.tsx`)
- Storefront pages → Product reviews: shows reviews (evidence: `src/components/store/product-reviews.tsx`)
- Product reviews → Catalog queries: loads ratings (evidence: `src/components/store/product-reviews.tsx`)
- Product reviews → Review submission: submits review (evidence: `src/components/store/product-reviews.tsx`)
- Customer → Checkout form: places order
- Checkout form → Order endpoint: submits order
- Order endpoint → Origin checks: checks origin (evidence: `src/app/api/orders/route.ts`)
- Order endpoint → Order validation: validates input (evidence: `src/app/api/orders/route.ts`)
- Order endpoint → Rate limiting: limits requests (evidence: `src/app/api/orders/route.ts`)
- Order endpoint → Store settings: loads settings (evidence: `src/app/api/orders/route.ts`)
- Order endpoint → Order creation: creates order (evidence: `src/app/api/orders/route.ts`)
- Order creation → Neon PostgreSQL: writes order (evidence: `src/lib/orders/create.ts`)
- Customer → Tracking form: requests status
- Tracking form → Tracking endpoint: looks up order
- Tracking endpoint → Origin checks: checks origin (evidence: `src/app/api/orders/track/route.ts`)
- Tracking endpoint → Order validation: validates details (evidence: `src/app/api/orders/track/route.ts`)
- Tracking endpoint → Rate limiting: limits requests (evidence: `src/app/api/orders/track/route.ts`)
- Tracking endpoint → Neon PostgreSQL: reads order (evidence: `src/app/api/orders/track/route.ts`)
- Order endpoint → Order confirmation: returns confirmation
- Store owner → Admin dashboard: manages store
- Admin dashboard → Admin queries: loads dashboard data (evidence: `src/app/admin/(dashboard)/page.tsx`)
- Admin dashboard → Review moderation: manages reviews (evidence: `src/components/admin/reviews-manager.tsx`)
- Review moderation → Review actions: calls moderation (evidence: `src/components/admin/reviews-manager.tsx`)
- Review actions → Neon PostgreSQL: updates reviews (evidence: `src/app/admin/(dashboard)/reviews/actions.ts`)
- Admin dashboard → Content and policies: edits content
- Admin dashboard → Account and settings: changes settings
- Admin dashboard → Order management: updates orders
- Admin dashboard → Catalog management: manages catalog
- Store owner → Admin login: authenticates
- Admin login → Origin checks: checks origin (evidence: `src/app/api/admin/auth/login/route.ts`)
- Admin login → Rate limiting: limits attempts (evidence: `src/app/api/admin/auth/login/route.ts`)
- Admin login → Neon PostgreSQL: checks credentials (evidence: `src/app/api/admin/auth/login/route.ts`)
- Admin login → Admin sessions: creates session (evidence: `src/app/api/admin/auth/login/route.ts`)
- Admin dashboard → Admin security: guards access
- Admin security → Admin sessions: checks session
- Admin dashboard → Media uploads: requests signed upload
- Media uploads → Cloudinary: signs upload (evidence: `src/app/api/admin/uploads/sign/route.ts`)
- Catalog queries → Neon PostgreSQL: reads catalog (evidence: `src/lib/queries/store.ts`)
- Admin queries → Neon PostgreSQL: reads admin data (evidence: `src/lib/queries/admin.ts`)
- Neon PostgreSQL → Drizzle schema: uses schema (evidence: `src/db/index.ts`)
