# karulj8/uta-demo-1002 architecture

> Architecture diagram of the GitHub repository karulj8/uta-demo-1002, 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/karulj8/uta-demo-1002
- Repository: https://github.com/karulj8/uta-demo-1002

## Overview

This is a Nuxt-based SCAYLE commerce storefront: shoppers browse and search products, inspect variants and promotions, manage basket and wishlist, authenticate, complete checkout, and review orders. Separate capabilities include account/profile, store location, subscriptions, CMS-driven content from configurable providers, and analytics tracking. The tree and excerpts establish these product areas, but do not expose most page-level calls or commerce SDK wiring; those links are therefore omitted rather than inferred.

Main entry points: [`app/pages/p/[...productName]-[id].vue`](https://github.com/karulj8/uta-demo-1002/blob/main/app/pages/p/%5B...productName%5D-%5Bid%5D.vue) (Product details), [`modules/cms/index.ts`](https://github.com/karulj8/uta-demo-1002/blob/main/modules/cms/index.ts) (CMS integration), [`app/pages/checkout.vue`](https://github.com/karulj8/uta-demo-1002/blob/main/app/pages/checkout.vue) (Checkout), [`app/pages/search.vue`](https://github.com/karulj8/uta-demo-1002/blob/main/app/pages/search.vue) (Search results)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_shop["Shop discovery"]
  node_home["Home page<br/>[index.vue]"]
  node_category["Category browsing<br/>[&#91;...slug&#93;-&#91;id&#93;.vue]"]
  node_search["Search results<br/>[search.vue]"]
  node_search_ui["Search suggestions"]
  node_product["Product details"]
  node_product_media["Product imagery<br/>[SFProductImage.vue]"]
  node_variant["Variant selection"]
  node_stores["Store locator<br/>[location.vue]"]
end

subgraph group_commerce["Purchase journey"]
  node_basket["Basket<br/>[basket.vue]"]
  node_basket_actions["Basket actions"]
  node_gift_selection["Promotion gifts"]
  node_checkout["Checkout<br/>[checkout.vue]"]
  node_checkout_widget["Express checkout"]
  node_success["Order confirmation<br/>[success.vue]"]
  node_wishlist["Wishlist<br/>[wishlist.vue]"]
  node_subscriptions["Subscriptions<br/>[useSubscription.ts]"]
end

subgraph group_account["Customer account"]
  node_signin["Sign in<br/>[index.vue]"]
  node_auth["Authentication"]
  node_account["Account overview<br/>[account.vue]"]
  node_orders["Order history<br/>[index.vue]"]
  node_order_detail["Order details<br/>[&#91;id&#93;.vue]"]
  node_profile["Customer profile<br/>[profile.vue]"]
end

subgraph group_content["Content and extensions"]
  node_cms["CMS integration<br/>[index.ts]"]
  node_cms_config["CMS configuration<br/>[config.ts]"]
  node_cms_providers["CMS providers"]
end

subgraph group_platform["Shared platform"]
  node_tracking["Analytics tracking<br/>[useTracking.ts]"]
  node_tracking_context["Tracking context"]
  node_tracking_state["Page tracking state"]
  node_storage[("Session and cache storage<br/>[storageConfig.ts]")]
end

node_shopper(("Shopper"))
node_external_store{{"SCAYLE Commerce Engine"}}
node_analytics_service{{"Analytics service"}}

node_shopper -->|"opens"| node_home
node_shopper -.->|"browses"| node_category
node_shopper -->|"searches"| node_search
node_search -.->|"renders"| node_search_ui
node_shopper -.->|"views"| node_product
node_product -.->|"displays"| node_product_media
node_product -->|"selects variant"| node_variant
node_shopper -.->|"manages"| node_basket
node_basket -.->|"uses actions"| node_basket_actions
node_product -.->|"offers gifts"| node_gift_selection
node_shopper -.->|"checks out"| node_checkout
node_checkout -.->|"uses widget"| node_checkout_widget
node_shopper -.->|"manages"| node_wishlist
node_shopper -.->|"signs in"| node_signin
node_signin -.->|"authenticates"| node_auth
node_shopper -.->|"opens account"| node_account
node_account -.->|"views orders"| node_orders
node_orders -.->|"opens order"| node_order_detail
node_shopper -.->|"updates profile"| node_profile
node_shopper -.->|"finds stores"| node_stores
node_product -.->|"configures subscription"| node_subscriptions
node_checkout -.->|"confirms order"| node_success
node_cms -->|"reads provider config"| node_cms_config
node_cms -->|"dispatches setup"| node_cms_providers
node_cms -.->|"configures provider"| node_external_store
node_tracking_context -->|"uses state"| node_tracking_state
node_tracking -.->|"emits events"| node_analytics_service
node_shopper -.->|"generates activity"| node_tracking
node_storage -->|"mounts KV driver"| node_external_store

click node_home "https://github.com/karulj8/uta-demo-1002/blob/main/app/pages/index.vue"
click node_category "https://github.com/karulj8/uta-demo-1002/blob/main/app/pages/c/%5B...categories%5D/%5B...slug%5D-%5Bid%5D.vue"
click node_search "https://github.com/karulj8/uta-demo-1002/blob/main/app/pages/search.vue"
click node_search_ui "https://github.com/karulj8/uta-demo-1002/blob/main/app/components/search/SFSearchResults.vue"
click node_product "https://github.com/karulj8/uta-demo-1002/blob/main/app/pages/p/%5B...productName%5D-%5Bid%5D.vue"
click node_product_media "https://github.com/karulj8/uta-demo-1002/blob/main/app/components/product/SFProductImage.vue"
click node_variant "https://github.com/karulj8/uta-demo-1002/blob/main/app/components/product/SFVariantPicker.vue"
click node_basket "https://github.com/karulj8/uta-demo-1002/blob/main/app/pages/basket.vue"
click node_basket_actions "https://github.com/karulj8/uta-demo-1002/blob/main/app/composables/useBasketActions.ts"
click node_gift_selection "https://github.com/karulj8/uta-demo-1002/blob/main/app/components/product/promotion/SFProductPromotionSelectionModal.client.vue"
click node_checkout "https://github.com/karulj8/uta-demo-1002/blob/main/app/pages/checkout.vue"
click node_checkout_widget "https://github.com/karulj8/uta-demo-1002/blob/main/app/components/basket/SFExpressCheckout.client.vue"
click node_success "https://github.com/karulj8/uta-demo-1002/blob/main/app/pages/success.vue"
click node_wishlist "https://github.com/karulj8/uta-demo-1002/blob/main/app/pages/wishlist.vue"
click node_signin "https://github.com/karulj8/uta-demo-1002/blob/main/app/pages/signin/index.vue"
click node_auth "https://github.com/karulj8/uta-demo-1002/blob/main/app/composables/useAuthentication.ts"
click node_account "https://github.com/karulj8/uta-demo-1002/blob/main/app/pages/account.vue"
click node_orders "https://github.com/karulj8/uta-demo-1002/blob/main/app/pages/account/orders/index.vue"
click node_order_detail "https://github.com/karulj8/uta-demo-1002/blob/main/app/pages/account/orders/%5Bid%5D.vue"
click node_profile "https://github.com/karulj8/uta-demo-1002/blob/main/app/pages/account/profile.vue"
click node_stores "https://github.com/karulj8/uta-demo-1002/blob/main/app/pages/location.vue"
click node_subscriptions "https://github.com/karulj8/uta-demo-1002/blob/main/modules/subscription/composables/useSubscription.ts"
click node_cms "https://github.com/karulj8/uta-demo-1002/blob/main/modules/cms/index.ts"
click node_cms_config "https://github.com/karulj8/uta-demo-1002/blob/main/modules/cms/utils/config.ts"
click node_cms_providers "https://github.com/karulj8/uta-demo-1002/tree/main/modules/cms/providers"
click node_tracking "https://github.com/karulj8/uta-demo-1002/blob/main/modules/tracking/runtime/composables/useTracking.ts"
click node_tracking_context "https://github.com/karulj8/uta-demo-1002/blob/main/modules/tracking/runtime/composables/useTrackingContext.ts"
click node_tracking_state "https://github.com/karulj8/uta-demo-1002/blob/main/modules/tracking/runtime/composables/useTrackingContextState.ts"
click node_storage "https://github.com/karulj8/uta-demo-1002/blob/main/server/plugins/storageConfig.ts"

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_home,node_category,node_search,node_search_ui,node_product,node_product_media,node_variant,node_stores toneBlue
class node_basket,node_basket_actions,node_gift_selection,node_checkout,node_checkout_widget,node_success,node_wishlist,node_subscriptions toneAmber
class node_signin,node_auth,node_account,node_orders,node_order_detail,node_profile toneMint
class node_cms,node_cms_config,node_cms_providers toneRose
class node_tracking,node_tracking_context,node_tracking_state,node_storage,node_shopper,node_external_store,node_analytics_service toneIndigo
```

## Components

### Shop discovery

- [Home page](https://github.com/karulj8/uta-demo-1002/blob/main/app/pages/index.vue): `app/pages/index.vue`
- [Category browsing](https://github.com/karulj8/uta-demo-1002/blob/main/app/pages/c/%5B...categories%5D/%5B...slug%5D-%5Bid%5D.vue): `app/pages/c/[...categories]/[...slug]-[id].vue`
- [Search results](https://github.com/karulj8/uta-demo-1002/blob/main/app/pages/search.vue): `app/pages/search.vue`
- [Search suggestions](https://github.com/karulj8/uta-demo-1002/blob/main/app/components/search/SFSearchResults.vue): `app/components/search/SFSearchResults.vue`
- [Product details](https://github.com/karulj8/uta-demo-1002/blob/main/app/pages/p/%5B...productName%5D-%5Bid%5D.vue): `app/pages/p/[...productName]-[id].vue`
- [Product imagery](https://github.com/karulj8/uta-demo-1002/blob/main/app/components/product/SFProductImage.vue): `app/components/product/SFProductImage.vue`
- [Variant selection](https://github.com/karulj8/uta-demo-1002/blob/main/app/components/product/SFVariantPicker.vue): `app/components/product/SFVariantPicker.vue`
- [Store locator](https://github.com/karulj8/uta-demo-1002/blob/main/app/pages/location.vue): `app/pages/location.vue`

### Purchase journey

- [Basket](https://github.com/karulj8/uta-demo-1002/blob/main/app/pages/basket.vue): `app/pages/basket.vue`
- [Basket actions](https://github.com/karulj8/uta-demo-1002/blob/main/app/composables/useBasketActions.ts): `app/composables/useBasketActions.ts`
- [Promotion gifts](https://github.com/karulj8/uta-demo-1002/blob/main/app/components/product/promotion/SFProductPromotionSelectionModal.client.vue): `app/components/product/promotion/SFProductPromotionSelectionModal.client.vue`
- [Checkout](https://github.com/karulj8/uta-demo-1002/blob/main/app/pages/checkout.vue): `app/pages/checkout.vue`
- [Express checkout](https://github.com/karulj8/uta-demo-1002/blob/main/app/components/basket/SFExpressCheckout.client.vue): `app/components/basket/SFExpressCheckout.client.vue`
- [Order confirmation](https://github.com/karulj8/uta-demo-1002/blob/main/app/pages/success.vue): `app/pages/success.vue`
- [Wishlist](https://github.com/karulj8/uta-demo-1002/blob/main/app/pages/wishlist.vue): `app/pages/wishlist.vue`
- [Subscriptions](https://github.com/karulj8/uta-demo-1002/blob/main/modules/subscription/composables/useSubscription.ts): `modules/subscription/composables/useSubscription.ts`

### Customer account

- [Sign in](https://github.com/karulj8/uta-demo-1002/blob/main/app/pages/signin/index.vue): `app/pages/signin/index.vue`
- [Authentication](https://github.com/karulj8/uta-demo-1002/blob/main/app/composables/useAuthentication.ts): `app/composables/useAuthentication.ts`
- [Account overview](https://github.com/karulj8/uta-demo-1002/blob/main/app/pages/account.vue): `app/pages/account.vue`
- [Order history](https://github.com/karulj8/uta-demo-1002/blob/main/app/pages/account/orders/index.vue): `app/pages/account/orders/index.vue`
- [Order details](https://github.com/karulj8/uta-demo-1002/blob/main/app/pages/account/orders/%5Bid%5D.vue): `app/pages/account/orders/[id].vue`
- [Customer profile](https://github.com/karulj8/uta-demo-1002/blob/main/app/pages/account/profile.vue): `app/pages/account/profile.vue`

### Content and extensions

- [CMS integration](https://github.com/karulj8/uta-demo-1002/blob/main/modules/cms/index.ts): `modules/cms/index.ts`
- [CMS configuration](https://github.com/karulj8/uta-demo-1002/blob/main/modules/cms/utils/config.ts): `modules/cms/utils/config.ts`
- [CMS providers](https://github.com/karulj8/uta-demo-1002/tree/main/modules/cms/providers): `modules/cms/providers`

### Shared platform

- [Analytics tracking](https://github.com/karulj8/uta-demo-1002/blob/main/modules/tracking/runtime/composables/useTracking.ts): `modules/tracking/runtime/composables/useTracking.ts`
- [Tracking context](https://github.com/karulj8/uta-demo-1002/blob/main/modules/tracking/runtime/composables/useTrackingContext.ts): `modules/tracking/runtime/composables/useTrackingContext.ts`
- [Page tracking state](https://github.com/karulj8/uta-demo-1002/blob/main/modules/tracking/runtime/composables/useTrackingContextState.ts): `modules/tracking/runtime/composables/useTrackingContextState.ts`
- [Session and cache storage](https://github.com/karulj8/uta-demo-1002/blob/main/server/plugins/storageConfig.ts): `server/plugins/storageConfig.ts`

### Other components

- **Shopper**
- **SCAYLE Commerce Engine**
- **Analytics service**

## Connections

- Shopper → Home page: opens (evidence: `app/pages/index.vue`)
- Shopper → Category browsing: browses
- Shopper → Search results: searches
- Search results → Search suggestions: renders
- Shopper → Product details: views
- Product details → Product imagery: displays
- Product details → Variant selection: selects variant
- Shopper → Basket: manages
- Basket → Basket actions: uses actions
- Product details → Promotion gifts: offers gifts
- Shopper → Checkout: checks out
- Checkout → Express checkout: uses widget
- Shopper → Wishlist: manages
- Shopper → Sign in: signs in
- Sign in → Authentication: authenticates
- Shopper → Account overview: opens account
- Account overview → Order history: views orders
- Order history → Order details: opens order
- Shopper → Customer profile: updates profile
- Shopper → Store locator: finds stores
- Product details → Subscriptions: configures subscription
- Checkout → Order confirmation: confirms order
- CMS integration → CMS configuration: reads provider config (evidence: `modules/cms/index.ts`)
- CMS integration → CMS providers: dispatches setup (evidence: `modules/cms/index.ts`)
- CMS integration → SCAYLE Commerce Engine: configures provider
- Tracking context → Page tracking state: uses state (evidence: `modules/tracking/runtime/composables/useTrackingContext.ts`)
- Analytics tracking → Analytics service: emits events
- Shopper → Analytics tracking: generates activity
- Session and cache storage → SCAYLE Commerce Engine: mounts KV driver (evidence: `server/plugins/storageConfig.ts`)
