# ankan-kd/bodybuddy-v2 architecture

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

- Interactive diagram: https://gitdiagram.com/ankan-kd/bodybuddy-v2
- Repository: https://github.com/ankan-kd/bodybuddy-v2

## Overview

BodyBuddy combines a nutrition and fitness tracker with BB Store in one authenticated app. Health users set goals, log food and weight, review progress, and can request AI coaching or reports; store users browse products, manage a cart and wishlist, check out, and track orders. Store operations also include an admin panel. The graph groups routes and supporting business logic by product area. Several page implementations were not sampled, so their documented capabilities are shown without guessing detailed internal call chains.

Main entry points: [`src/app`](https://github.com/ankan-kd/bodybuddy-v2/tree/main/src/app) (Health App), [`src/app/store`](https://github.com/ankan-kd/bodybuddy-v2/tree/main/src/app/store) (Storefront), [`src/app/api/store/checkout`](https://github.com/ankan-kd/bodybuddy-v2/tree/main/src/app/api/store/checkout) (Checkout Routes), [`src/app/api/store/webhook/route.ts`](https://github.com/ankan-kd/bodybuddy-v2/blob/main/src/app/api/store/webhook/route.ts) (Payment Webhook)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_health["BB Health"]
  node_health_ui["Health App"]
  node_food_logging["Food Logging<br/>[page.tsx]"]
  node_health_progress["Health Progress<br/>[page.tsx]"]
  node_weight_tracking["Weight Tracking<br/>[page.tsx]"]
end

subgraph group_health_services["Health Services"]
  node_health_data["Health State<br/>[store.tsx]"]
  node_health_auth["User Auth<br/>[auth.tsx]"]
  node_food_chat["Food Chat<br/>[route.ts]"]
  node_food_lookup["Food Lookup<br/>[route.ts]"]
  node_nutrition_coach["Nutrition Coach<br/>[route.ts]"]
  node_health_report["Health Report<br/>[route.ts]"]
end

subgraph group_storefront["BB Store"]
  node_store_ui["Storefront"]
  node_store_data["Store Data Access<br/>[storeApi.ts]"]
  node_cart["Cart<br/>[cartContext.tsx]"]
  node_wishlist["Wishlist"]
  node_delivery_profile["Saved Addresses"]
end

subgraph group_commerce["Commerce Services"]
  node_checkout["Checkout Routes"]
  node_orders["Order Services"]
  node_webhook["Payment Webhook<br/>[route.ts]"]
  node_order_email["Order Email"]
end

subgraph group_admin["Store Admin"]
  node_admin_ui["Admin Panel"]
  node_catalog_admin["Catalog Management"]
  node_store_admin_api["Admin Store API<br/>[storeAdminApi.ts]"]
  node_order_status["Order Status API<br/>[route.ts]"]
end

node_user(("User"))
node_gemini["Google Gemini"]
node_razorpay["Razorpay"]
node_email_service["Resend"]
node_supabase[("Supabase")]

node_user -->|"signs in"| node_health_auth
node_health_auth -->|"authenticates with"| node_supabase
node_user -->|"uses"| node_health_ui
node_health_ui -->|"logs meals"| node_food_logging
node_health_ui -->|"reviews progress"| node_health_progress
node_health_ui -->|"tracks weight"| node_weight_tracking
node_health_ui -.->|"updates"| node_health_data
node_health_data -->|"syncs data"| node_supabase
node_food_logging -->|"requests coaching"| node_food_chat
node_food_logging -.->|"requests estimate"| node_food_lookup
node_food_chat -->|"requests AI"| node_gemini
node_food_lookup -->|"requests AI"| node_gemini
node_nutrition_coach -->|"requests AI"| node_gemini
node_health_report -.->|"requests AI"| node_gemini
node_user -->|"shops"| node_store_ui
node_store_ui -->|"loads catalog"| node_store_data
node_store_data -->|"reads catalog"| node_supabase
node_store_ui -->|"manages cart"| node_cart
node_store_ui -->|"manages wishlist"| node_wishlist
node_wishlist -->|"persists wishlist"| node_supabase
node_store_ui -->|"uses addresses"| node_delivery_profile
node_user -->|"places order"| node_checkout
node_checkout -->|"creates order"| node_orders
node_checkout -->|"creates payment"| node_razorpay
node_checkout -->|"verifies payment"| node_razorpay
node_razorpay -->|"sends event"| node_webhook
node_webhook -->|"verifies signature"| node_razorpay
node_webhook -->|"updates order"| node_supabase
node_webhook -->|"schedules confirmation"| node_order_email
node_order_email -->|"sends email"| node_email_service
node_user -->|"manages store"| node_admin_ui
node_admin_ui -.->|"manages catalog"| node_catalog_admin
node_admin_ui -.->|"manages store data"| node_store_admin_api
node_admin_ui -->|"updates order status"| node_order_status
node_order_status -->|"updates order"| node_supabase

click node_health_ui "https://github.com/ankan-kd/bodybuddy-v2/tree/main/src/app"
click node_food_logging "https://github.com/ankan-kd/bodybuddy-v2/blob/main/src/app/foods/page.tsx"
click node_health_progress "https://github.com/ankan-kd/bodybuddy-v2/blob/main/src/app/dashboard/page.tsx"
click node_weight_tracking "https://github.com/ankan-kd/bodybuddy-v2/blob/main/src/app/weight/page.tsx"
click node_health_data "https://github.com/ankan-kd/bodybuddy-v2/blob/main/src/lib/store.tsx"
click node_health_auth "https://github.com/ankan-kd/bodybuddy-v2/blob/main/src/lib/auth.tsx"
click node_food_chat "https://github.com/ankan-kd/bodybuddy-v2/blob/main/src/app/api/food-chat/route.ts"
click node_food_lookup "https://github.com/ankan-kd/bodybuddy-v2/blob/main/src/app/api/food-lookup/route.ts"
click node_nutrition_coach "https://github.com/ankan-kd/bodybuddy-v2/blob/main/src/app/api/nutrition-coach/route.ts"
click node_health_report "https://github.com/ankan-kd/bodybuddy-v2/blob/main/src/app/api/health-report/route.ts"
click node_store_ui "https://github.com/ankan-kd/bodybuddy-v2/tree/main/src/app/store"
click node_store_data "https://github.com/ankan-kd/bodybuddy-v2/blob/main/src/lib/storeApi.ts"
click node_cart "https://github.com/ankan-kd/bodybuddy-v2/blob/main/src/lib/cartContext.tsx"
click node_wishlist "https://github.com/ankan-kd/bodybuddy-v2/blob/main/src/lib/wishlistContext.tsx"
click node_delivery_profile "https://github.com/ankan-kd/bodybuddy-v2/blob/main/src/lib/deliveryProfileApi.ts"
click node_checkout "https://github.com/ankan-kd/bodybuddy-v2/tree/main/src/app/api/store/checkout"
click node_orders "https://github.com/ankan-kd/bodybuddy-v2/blob/main/src/lib/storeOrderServer.ts"
click node_webhook "https://github.com/ankan-kd/bodybuddy-v2/blob/main/src/app/api/store/webhook/route.ts"
click node_order_email "https://github.com/ankan-kd/bodybuddy-v2/blob/main/src/lib/orderConfirmationEmail.ts"
click node_admin_ui "https://github.com/ankan-kd/bodybuddy-v2/tree/main/src/app/admin"
click node_catalog_admin "https://github.com/ankan-kd/bodybuddy-v2/blob/main/src/lib/catalogueAdminApi.ts"
click node_store_admin_api "https://github.com/ankan-kd/bodybuddy-v2/blob/main/src/lib/storeAdminApi.ts"
click node_order_status "https://github.com/ankan-kd/bodybuddy-v2/blob/main/src/app/api/store/admin/update-order-status/route.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_health_ui,node_food_logging,node_health_progress,node_weight_tracking,node_user toneBlue
class node_health_data,node_health_auth,node_food_chat,node_food_lookup,node_nutrition_coach,node_health_report,node_supabase toneAmber
class node_store_ui,node_store_data,node_cart,node_wishlist,node_delivery_profile toneMint
class node_checkout,node_orders,node_webhook,node_order_email toneRose
class node_admin_ui,node_catalog_admin,node_store_admin_api,node_order_status,node_gemini,node_razorpay,node_email_service toneIndigo
```

## Components

### BB Health

- [Health App](https://github.com/ankan-kd/bodybuddy-v2/tree/main/src/app): `src/app`
- [Food Logging](https://github.com/ankan-kd/bodybuddy-v2/blob/main/src/app/foods/page.tsx): `src/app/foods/page.tsx`
- [Health Progress](https://github.com/ankan-kd/bodybuddy-v2/blob/main/src/app/dashboard/page.tsx): `src/app/dashboard/page.tsx`
- [Weight Tracking](https://github.com/ankan-kd/bodybuddy-v2/blob/main/src/app/weight/page.tsx): `src/app/weight/page.tsx`

### Health Services

- [Health State](https://github.com/ankan-kd/bodybuddy-v2/blob/main/src/lib/store.tsx): `src/lib/store.tsx`
- [User Auth](https://github.com/ankan-kd/bodybuddy-v2/blob/main/src/lib/auth.tsx): `src/lib/auth.tsx`
- [Food Chat](https://github.com/ankan-kd/bodybuddy-v2/blob/main/src/app/api/food-chat/route.ts): `src/app/api/food-chat/route.ts`
- [Food Lookup](https://github.com/ankan-kd/bodybuddy-v2/blob/main/src/app/api/food-lookup/route.ts): `src/app/api/food-lookup/route.ts`
- [Nutrition Coach](https://github.com/ankan-kd/bodybuddy-v2/blob/main/src/app/api/nutrition-coach/route.ts): `src/app/api/nutrition-coach/route.ts`
- [Health Report](https://github.com/ankan-kd/bodybuddy-v2/blob/main/src/app/api/health-report/route.ts): `src/app/api/health-report/route.ts`

### BB Store

- [Storefront](https://github.com/ankan-kd/bodybuddy-v2/tree/main/src/app/store): `src/app/store`
- [Store Data Access](https://github.com/ankan-kd/bodybuddy-v2/blob/main/src/lib/storeApi.ts): `src/lib/storeApi.ts`
- [Cart](https://github.com/ankan-kd/bodybuddy-v2/blob/main/src/lib/cartContext.tsx): `src/lib/cartContext.tsx`
- [Wishlist](https://github.com/ankan-kd/bodybuddy-v2/blob/main/src/lib/wishlistContext.tsx): `src/lib/wishlistContext.tsx`
- [Saved Addresses](https://github.com/ankan-kd/bodybuddy-v2/blob/main/src/lib/deliveryProfileApi.ts): `src/lib/deliveryProfileApi.ts`

### Commerce Services

- [Checkout Routes](https://github.com/ankan-kd/bodybuddy-v2/tree/main/src/app/api/store/checkout): `src/app/api/store/checkout`
- [Order Services](https://github.com/ankan-kd/bodybuddy-v2/blob/main/src/lib/storeOrderServer.ts): `src/lib/storeOrderServer.ts`
- [Payment Webhook](https://github.com/ankan-kd/bodybuddy-v2/blob/main/src/app/api/store/webhook/route.ts): `src/app/api/store/webhook/route.ts`
- [Order Email](https://github.com/ankan-kd/bodybuddy-v2/blob/main/src/lib/orderConfirmationEmail.ts): `src/lib/orderConfirmationEmail.ts`

### Store Admin

- [Admin Panel](https://github.com/ankan-kd/bodybuddy-v2/tree/main/src/app/admin): `src/app/admin`
- [Catalog Management](https://github.com/ankan-kd/bodybuddy-v2/blob/main/src/lib/catalogueAdminApi.ts): `src/lib/catalogueAdminApi.ts`
- [Admin Store API](https://github.com/ankan-kd/bodybuddy-v2/blob/main/src/lib/storeAdminApi.ts): `src/lib/storeAdminApi.ts`
- [Order Status API](https://github.com/ankan-kd/bodybuddy-v2/blob/main/src/app/api/store/admin/update-order-status/route.ts): `src/app/api/store/admin/update-order-status/route.ts`

### Other components

- **User**
- **Google Gemini**
- **Razorpay**
- **Resend**
- **Supabase**

## Connections

- User → User Auth: signs in
- User Auth → Supabase: authenticates with
- User → Health App: uses
- Health App → Food Logging: logs meals
- Health App → Health Progress: reviews progress
- Health App → Weight Tracking: tracks weight
- Health App → Health State: updates
- Health State → Supabase: syncs data
- Food Logging → Food Chat: requests coaching
- Food Logging → Food Lookup: requests estimate
- Food Chat → Google Gemini: requests AI (evidence: `src/app/api/food-chat/route.ts`)
- Food Lookup → Google Gemini: requests AI (evidence: `src/app/api/food-lookup/route.ts`)
- Nutrition Coach → Google Gemini: requests AI (evidence: `src/app/api/nutrition-coach/route.ts`)
- Health Report → Google Gemini: requests AI
- User → Storefront: shops
- Storefront → Store Data Access: loads catalog
- Store Data Access → Supabase: reads catalog (evidence: `src/lib/storeApi.ts`)
- Storefront → Cart: manages cart
- Storefront → Wishlist: manages wishlist
- Wishlist → Supabase: persists wishlist
- Storefront → Saved Addresses: uses addresses
- User → Checkout Routes: places order
- Checkout Routes → Order Services: creates order (evidence: `src/app/api/store/checkout/create-order/route.ts`)
- Checkout Routes → Razorpay: creates payment (evidence: `src/app/api/store/checkout/create-order/route.ts`)
- Checkout Routes → Razorpay: verifies payment (evidence: `src/app/api/store/checkout/verify-payment/route.ts`)
- Razorpay → Payment Webhook: sends event
- Payment Webhook → Razorpay: verifies signature (evidence: `src/app/api/store/webhook/route.ts`)
- Payment Webhook → Supabase: updates order (evidence: `src/app/api/store/webhook/route.ts`)
- Payment Webhook → Order Email: schedules confirmation (evidence: `src/app/api/store/webhook/route.ts`)
- Order Email → Resend: sends email (evidence: `src/lib/orderConfirmationEmail.ts`)
- User → Admin Panel: manages store
- Admin Panel → Catalog Management: manages catalog
- Admin Panel → Admin Store API: manages store data
- Admin Panel → Order Status API: updates order status
- Order Status API → Supabase: updates order (evidence: `src/app/api/store/admin/update-order-status/route.ts`)
