# aum-songnd/techwiseai architecture

> Architecture diagram of the GitHub repository aum-songnd/techwiseai, 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/aum-songnd/techwiseai
- Repository: https://github.com/aum-songnd/techwiseai

## Overview

TechwiseAI is a Next.js storefront for technology products, with customer shopping, account and order flows plus an administration area. The principal workflow is browsing/searching products, managing a cart, checking out, then viewing orders; authentication supports protected actions. The graph also preserves blog, deals, favorites, AI recommendations and admin capabilities visible in the tree. Several page implementations and backend routes were not sampled, so their internal links are omitted; dashed links mark unverified external service calls.

Main entry points: [`lib/api.ts`](https://github.com/aum-songnd/techwiseai/blob/master/lib/api.ts) (Catalog API client), [`lib/orders-api.ts`](https://github.com/aum-songnd/techwiseai/blob/master/lib/orders-api.ts) (Orders API client), [`app/(admin)/admin/products/page.tsx`](https://github.com/aum-songnd/techwiseai/blob/master/app/(admin)/admin/products/page.tsx) (Product management), [`app/(client)/checkout/page.tsx`](https://github.com/aum-songnd/techwiseai/blob/master/app/(client)/checkout/page.tsx) (Checkout)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_storefront["Storefront &amp; discovery"]
  node_home["Home<br/>[page.tsx]"]
  node_catalog["Shop catalog<br/>[Shop.tsx]"]
  node_product["Product detail<br/>[page.tsx]"]
  node_search["Product search<br/>[SearchBar.tsx]"]
  node_deals["Deals &amp; sale<br/>[page.tsx]"]
  node_blog["Blog<br/>[page.tsx]"]
  node_ai_recommendations["AI recommendations"]
end

subgraph group_commerce["Shopping &amp; orders"]
  node_cart_page["Cart<br/>[page.tsx]"]
  node_cart_state["Cart state<br/>[CartContext.tsx]"]
  node_checkout["Checkout<br/>[page.tsx]"]
  node_orders["Customer orders<br/>[page.tsx]"]
  node_order_detail["Order detail<br/>[page.tsx]"]
  node_payment_result["Payment result<br/>[page.tsx]"]
end

subgraph group_identity["Identity &amp; favorites"]
  node_auth_pages["Sign in / up<br/>[page.tsx]"]
  node_auth_state["Auth state<br/>[AuthContext.tsx]"]
  node_favorites["Favorites"]
  node_wishlist["Wishlist<br/>[page.tsx]"]
end

subgraph group_administration["Administration"]
  node_admin_dashboard["Admin dashboard<br/>[page.tsx]"]
  node_admin_products["Product management<br/>[page.tsx]"]
  node_admin_categories["Category management<br/>[page.tsx]"]
  node_admin_orders["Order management<br/>[page.tsx]"]
  node_admin_users["User management<br/>[page.tsx]"]
end

subgraph group_services["API clients"]
  node_catalog_api["Catalog API client<br/>[api.ts]"]
  node_cart_api["Cart API client<br/>[cart-api.ts]"]
  node_orders_api["Orders API client<br/>[orders-api.ts]"]
  node_admin_products_api["Admin products client<br/>[admin-products.ts]"]
  node_admin_api["Admin API client<br/>[admin-api.ts]"]
  node_admin_orders_api["Admin orders client"]
  node_admin_users_api["Admin users client<br/>[admin-users-api.ts]"]
  node_auth_api["Auth client<br/>[auth.ts]"]
end

node_shopper(("Shopper"))
node_backend{{"Commerce backend"}}

node_shopper -.->|"opens storefront"| node_home
node_shopper -.->|"browses products"| node_catalog
node_shopper -.->|"searches products"| node_search
node_shopper -.->|"manages cart"| node_cart_page
node_shopper -.->|"checks out"| node_checkout
node_shopper -.->|"signs in"| node_auth_pages
node_cart_page -->|"uses cart state"| node_cart_state
node_cart_state -->|"loads and updates"| node_cart_api
node_checkout -->|"reads cart"| node_cart_state
node_checkout -->|"creates orders"| node_orders_api
node_orders -->|"loads orders"| node_orders_api
node_order_detail -->|"loads order"| node_orders_api
node_auth_pages -->|"uses identity state"| node_auth_state
node_auth_state -->|"authenticates"| node_auth_api
node_auth_api -.->|"requests auth"| node_backend
node_wishlist -->|"reads favorites"| node_favorites
node_favorites -->|"checks identity"| node_auth_state
node_favorites -->|"loads favorites"| node_catalog_api
node_search -->|"searches catalog"| node_catalog_api
node_deals -.->|"loads products"| node_catalog_api
node_ai_recommendations -.->|"gets recommendations"| node_catalog_api
node_admin_dashboard -->|"loads products"| node_admin_products_api
node_admin_products -->|"loads categories"| node_catalog_api
node_admin_products -->|"loads products"| node_admin_products_api
node_admin_products -->|"creates or updates"| node_admin_api
node_admin_categories -->|"loads catalog data"| node_catalog_api
node_admin_orders -->|"loads and updates"| node_admin_orders_api
node_admin_users -->|"manages users"| node_admin_users_api
node_catalog_api -.->|"requests catalog"| node_backend
node_orders_api -.->|"requests orders"| node_backend
node_cart_api -.->|"requests cart"| node_backend
node_admin_api -.->|"admin requests"| node_backend
node_admin_orders_api -.->|"admin requests"| node_backend
node_admin_users_api -.->|"admin requests"| node_backend

click node_home "https://github.com/aum-songnd/techwiseai/blob/master/app/(client)/page.tsx"
click node_catalog "https://github.com/aum-songnd/techwiseai/blob/master/components/Shop.tsx"
click node_product "https://github.com/aum-songnd/techwiseai/blob/master/app/(client)/product/%5Bid%5D/page.tsx"
click node_search "https://github.com/aum-songnd/techwiseai/blob/master/components/SearchBar.tsx"
click node_deals "https://github.com/aum-songnd/techwiseai/blob/master/app/(client)/deals/page.tsx"
click node_blog "https://github.com/aum-songnd/techwiseai/blob/master/app/(client)/blog/%5Bslug%5D/page.tsx"
click node_ai_recommendations "https://github.com/aum-songnd/techwiseai/blob/master/components/AiRecommendedCard.tsx"
click node_cart_page "https://github.com/aum-songnd/techwiseai/blob/master/app/(client)/cart/page.tsx"
click node_cart_state "https://github.com/aum-songnd/techwiseai/blob/master/context/CartContext.tsx"
click node_checkout "https://github.com/aum-songnd/techwiseai/blob/master/app/(client)/checkout/page.tsx"
click node_orders "https://github.com/aum-songnd/techwiseai/blob/master/app/(client)/orders/page.tsx"
click node_order_detail "https://github.com/aum-songnd/techwiseai/blob/master/app/(client)/orders/%5BorderId%5D/page.tsx"
click node_payment_result "https://github.com/aum-songnd/techwiseai/blob/master/app/(client)/payment/result/page.tsx"
click node_auth_pages "https://github.com/aum-songnd/techwiseai/blob/master/app/(auth)/sign-in/page.tsx"
click node_auth_state "https://github.com/aum-songnd/techwiseai/blob/master/context/AuthContext.tsx"
click node_favorites "https://github.com/aum-songnd/techwiseai/blob/master/context/FavoriteContext.tsx"
click node_wishlist "https://github.com/aum-songnd/techwiseai/blob/master/app/(client)/wishlist/page.tsx"
click node_admin_dashboard "https://github.com/aum-songnd/techwiseai/blob/master/app/(admin)/admin/page.tsx"
click node_admin_products "https://github.com/aum-songnd/techwiseai/blob/master/app/(admin)/admin/products/page.tsx"
click node_admin_categories "https://github.com/aum-songnd/techwiseai/blob/master/app/(admin)/admin/categories/page.tsx"
click node_admin_orders "https://github.com/aum-songnd/techwiseai/blob/master/app/(admin)/admin/orders/page.tsx"
click node_admin_users "https://github.com/aum-songnd/techwiseai/blob/master/app/(admin)/admin/users/page.tsx"
click node_catalog_api "https://github.com/aum-songnd/techwiseai/blob/master/lib/api.ts"
click node_cart_api "https://github.com/aum-songnd/techwiseai/blob/master/lib/cart-api.ts"
click node_orders_api "https://github.com/aum-songnd/techwiseai/blob/master/lib/orders-api.ts"
click node_admin_products_api "https://github.com/aum-songnd/techwiseai/blob/master/lib/admin-products.ts"
click node_admin_api "https://github.com/aum-songnd/techwiseai/blob/master/lib/admin-api.ts"
click node_admin_orders_api "https://github.com/aum-songnd/techwiseai/blob/master/lib/admin-orders-api.ts"
click node_admin_users_api "https://github.com/aum-songnd/techwiseai/blob/master/lib/admin-users-api.ts"
click node_auth_api "https://github.com/aum-songnd/techwiseai/blob/master/lib/auth.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_catalog,node_product,node_search,node_deals,node_blog,node_ai_recommendations toneBlue
class node_cart_page,node_cart_state,node_checkout,node_orders,node_order_detail,node_payment_result toneAmber
class node_auth_pages,node_auth_state,node_favorites,node_wishlist toneMint
class node_admin_dashboard,node_admin_products,node_admin_categories,node_admin_orders,node_admin_users toneRose
class node_catalog_api,node_cart_api,node_orders_api,node_admin_products_api,node_admin_api,node_admin_orders_api,node_admin_users_api,node_auth_api,node_shopper,node_backend toneIndigo
```

## Components

### Storefront & discovery

- [Home](https://github.com/aum-songnd/techwiseai/blob/master/app/(client)/page.tsx): `app/(client)/page.tsx`
- [Shop catalog](https://github.com/aum-songnd/techwiseai/blob/master/components/Shop.tsx): `components/Shop.tsx`
- [Product detail](https://github.com/aum-songnd/techwiseai/blob/master/app/(client)/product/%5Bid%5D/page.tsx): `app/(client)/product/[id]/page.tsx`
- [Product search](https://github.com/aum-songnd/techwiseai/blob/master/components/SearchBar.tsx): `components/SearchBar.tsx`
- [Deals & sale](https://github.com/aum-songnd/techwiseai/blob/master/app/(client)/deals/page.tsx): `app/(client)/deals/page.tsx`
- [Blog](https://github.com/aum-songnd/techwiseai/blob/master/app/(client)/blog/%5Bslug%5D/page.tsx): `app/(client)/blog/[slug]/page.tsx`
- [AI recommendations](https://github.com/aum-songnd/techwiseai/blob/master/components/AiRecommendedCard.tsx): `components/AiRecommendedCard.tsx`

### Shopping & orders

- [Cart](https://github.com/aum-songnd/techwiseai/blob/master/app/(client)/cart/page.tsx): `app/(client)/cart/page.tsx`
- [Cart state](https://github.com/aum-songnd/techwiseai/blob/master/context/CartContext.tsx): `context/CartContext.tsx`
- [Checkout](https://github.com/aum-songnd/techwiseai/blob/master/app/(client)/checkout/page.tsx): `app/(client)/checkout/page.tsx`
- [Customer orders](https://github.com/aum-songnd/techwiseai/blob/master/app/(client)/orders/page.tsx): `app/(client)/orders/page.tsx`
- [Order detail](https://github.com/aum-songnd/techwiseai/blob/master/app/(client)/orders/%5BorderId%5D/page.tsx): `app/(client)/orders/[orderId]/page.tsx`
- [Payment result](https://github.com/aum-songnd/techwiseai/blob/master/app/(client)/payment/result/page.tsx): `app/(client)/payment/result/page.tsx`

### Identity & favorites

- [Sign in / up](https://github.com/aum-songnd/techwiseai/blob/master/app/(auth)/sign-in/page.tsx): `app/(auth)/sign-in/page.tsx`
- [Auth state](https://github.com/aum-songnd/techwiseai/blob/master/context/AuthContext.tsx): `context/AuthContext.tsx`
- [Favorites](https://github.com/aum-songnd/techwiseai/blob/master/context/FavoriteContext.tsx): `context/FavoriteContext.tsx`
- [Wishlist](https://github.com/aum-songnd/techwiseai/blob/master/app/(client)/wishlist/page.tsx): `app/(client)/wishlist/page.tsx`

### Administration

- [Admin dashboard](https://github.com/aum-songnd/techwiseai/blob/master/app/(admin)/admin/page.tsx): `app/(admin)/admin/page.tsx`
- [Product management](https://github.com/aum-songnd/techwiseai/blob/master/app/(admin)/admin/products/page.tsx): `app/(admin)/admin/products/page.tsx`
- [Category management](https://github.com/aum-songnd/techwiseai/blob/master/app/(admin)/admin/categories/page.tsx): `app/(admin)/admin/categories/page.tsx`
- [Order management](https://github.com/aum-songnd/techwiseai/blob/master/app/(admin)/admin/orders/page.tsx): `app/(admin)/admin/orders/page.tsx`
- [User management](https://github.com/aum-songnd/techwiseai/blob/master/app/(admin)/admin/users/page.tsx): `app/(admin)/admin/users/page.tsx`

### API clients

- [Catalog API client](https://github.com/aum-songnd/techwiseai/blob/master/lib/api.ts): `lib/api.ts`
- [Cart API client](https://github.com/aum-songnd/techwiseai/blob/master/lib/cart-api.ts): `lib/cart-api.ts`
- [Orders API client](https://github.com/aum-songnd/techwiseai/blob/master/lib/orders-api.ts): `lib/orders-api.ts`
- [Admin products client](https://github.com/aum-songnd/techwiseai/blob/master/lib/admin-products.ts): `lib/admin-products.ts`
- [Admin API client](https://github.com/aum-songnd/techwiseai/blob/master/lib/admin-api.ts): `lib/admin-api.ts`
- [Admin orders client](https://github.com/aum-songnd/techwiseai/blob/master/lib/admin-orders-api.ts): `lib/admin-orders-api.ts`
- [Admin users client](https://github.com/aum-songnd/techwiseai/blob/master/lib/admin-users-api.ts): `lib/admin-users-api.ts`
- [Auth client](https://github.com/aum-songnd/techwiseai/blob/master/lib/auth.ts): `lib/auth.ts`

### Other components

- **Shopper**
- **Commerce backend**

## Connections

- Shopper → Home: opens storefront
- Shopper → Shop catalog: browses products
- Shopper → Product search: searches products
- Shopper → Cart: manages cart
- Shopper → Checkout: checks out
- Shopper → Sign in / up: signs in
- Cart → Cart state: uses cart state (evidence: `app/(client)/cart/page.tsx`)
- Cart state → Cart API client: loads and updates (evidence: `context/CartContext.tsx`)
- Checkout → Cart state: reads cart (evidence: `app/(client)/checkout/page.tsx`)
- Checkout → Orders API client: creates orders (evidence: `app/(client)/checkout/page.tsx`)
- Customer orders → Orders API client: loads orders (evidence: `app/(client)/orders/page.tsx`)
- Order detail → Orders API client: loads order (evidence: `app/(client)/orders/[orderId]/page.tsx`)
- Sign in / up → Auth state: uses identity state (evidence: `app/(auth)/sign-in/page.tsx`)
- Auth state → Auth client: authenticates (evidence: `context/AuthContext.tsx`)
- Auth client → Commerce backend: requests auth
- Wishlist → Favorites: reads favorites (evidence: `app/(client)/wishlist/page.tsx`)
- Favorites → Auth state: checks identity (evidence: `context/FavoriteContext.tsx`)
- Favorites → Catalog API client: loads favorites (evidence: `context/FavoriteContext.tsx`)
- Product search → Catalog API client: searches catalog (evidence: `components/SearchBar.tsx`)
- Deals & sale → Catalog API client: loads products
- AI recommendations → Catalog API client: gets recommendations
- Admin dashboard → Admin products client: loads products (evidence: `app/(admin)/admin/page.tsx`)
- Product management → Catalog API client: loads categories (evidence: `app/(admin)/admin/products/page.tsx`)
- Product management → Admin products client: loads products (evidence: `app/(admin)/admin/products/page.tsx`)
- Product management → Admin API client: creates or updates (evidence: `app/(admin)/admin/products/page.tsx`)
- Category management → Catalog API client: loads catalog data (evidence: `app/(admin)/admin/categories/page.tsx`)
- Order management → Admin orders client: loads and updates (evidence: `app/(admin)/admin/orders/page.tsx`)
- User management → Admin users client: manages users (evidence: `app/(admin)/admin/users/page.tsx`)
- Catalog API client → Commerce backend: requests catalog
- Orders API client → Commerce backend: requests orders
- Cart API client → Commerce backend: requests cart
- Admin API client → Commerce backend: admin requests
- Admin orders client → Commerce backend: admin requests
- Admin users client → Commerce backend: admin requests
