# mogutravel/mogu architecture

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

- Interactive diagram: https://gitdiagram.com/mogutravel/mogu
- Repository: https://github.com/mogutravel/mogu

## Overview

MOGU is a multi-tenant digital presence and commerce platform, centered on restaurant storefronts, online ordering, and business management. The customer path runs from a business profile or menu into ordering; the homepage describes QR/NFC ordering and kitchen order display. The product also includes a customer mobile experience, loyalty passes, business analytics, and Mogu Travel. The sampled sources show the mobile page composing its views and the redirect route recording link clicks; connections among unsampled operational stages are left unverified.

Main entry points: [`app/mobile/[slug]/page.jsx`](https://github.com/mogutravel/mogu/blob/main/app/mobile/%5Bslug%5D/page.jsx) (Mobile customer app), [`lib/supabase.ts`](https://github.com/mogutravel/mogu/blob/main/lib/supabase.ts) (Supabase data services), [`app/r/[id]/route.ts`](https://github.com/mogutravel/mogu/blob/main/app/r/%5Bid%5D/route.ts) (Tracked link redirect), [`app/travel/page.tsx`](https://github.com/mogutravel/mogu/blob/main/app/travel/page.tsx) (Travel portal)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_discovery["Discovery &amp; profiles"]
  node_home["MOGU homepage<br/>[page.tsx]"]
  node_profile["Business profile<br/>[page.tsx]"]
  node_catalog["Business catalog<br/>[page.tsx]"]
  node_redirect["Tracked link redirect<br/>[route.ts]"]
end

subgraph group_commerce["Ordering &amp; operations"]
  node_menu["Restaurant menu<br/>[page.tsx]"]
  node_checkout["Checkout<br/>[checkout.ts]"]
  node_kitchen["Kitchen display<br/>[page.tsx]"]
  node_cashier["Cashier operations<br/>[page.tsx]"]
  node_mobile["Mobile customer app<br/>[page.jsx]"]
  node_mobile_home["Mobile home feed<br/>[HomeFeed.jsx]"]
  node_mobile_menu["Mobile menu catalog<br/>[MenuCatalog.jsx]"]
  node_mobile_cart["Mobile cart<br/>[CartView.jsx]"]
  node_mobile_orders["Mobile orders<br/>[OrdersView.jsx]"]
  node_mobile_points["Mobile points<br/>[PointsView.jsx]"]
  node_mobile_profile["Mobile profile<br/>[ProfileView.jsx]"]
  node_mobile_header["Mobile header<br/>[Header.jsx]"]
  node_mobile_nav["Mobile navigation<br/>[BottomNav.jsx]"]
end

subgraph group_studio["Business management"]
  node_studio["Studio dashboard<br/>[page.tsx]"]
  node_business_admin["Business editor<br/>[page.tsx]"]
  node_store_admin["Store manager<br/>[page.tsx]"]
  node_metrics["Menu metrics<br/>[page.tsx]"]
  node_link_editor["Link manager<br/>[LinksManager.tsx]"]
end

subgraph group_loyalty["Loyalty"]
  node_loyalty_setup["Loyalty management<br/>[page.tsx]"]
  node_loyalty_pass["Digital loyalty pass"]
  node_loyalty_page["Business loyalty page<br/>[page.tsx]"]
end

subgraph group_travel["Travel"]
  node_travel["Travel portal<br/>[page.tsx]"]
  node_travel_explore["Travel exploration<br/>[page.tsx]"]
  node_travel_passport["Travel passport<br/>[page.tsx]"]
  node_travel_rewards["Travel rewards<br/>[page.tsx]"]
end

node_visitor(("Customer"))
node_business_owner(("Business owner"))
node_supabase[("Supabase data services<br/>[supabase.ts]")]
node_supabase_admin[("Supabase admin client<br/>[supabase-admin.ts]")]
node_tracking["Click tracking helpers<br/>[track.ts]"]

node_home -.->|"links to"| node_profile
node_home -->|"describes ordering"| node_menu
node_home -->|"describes order display"| node_kitchen
node_visitor -.->|"places orders"| node_menu
node_menu -.->|"submits order"| node_checkout
node_checkout -.->|"dispatches order"| node_kitchen
node_mobile -->|"renders"| node_mobile_home
node_mobile -->|"renders"| node_mobile_menu
node_mobile -->|"renders"| node_mobile_cart
node_mobile -->|"renders"| node_mobile_orders
node_mobile -->|"renders"| node_mobile_points
node_mobile -->|"renders"| node_mobile_profile
node_mobile -->|"renders"| node_mobile_header
node_mobile -->|"renders"| node_mobile_nav
node_mobile -->|"loads store data"| node_supabase
node_menu -->|"uses client"| node_supabase
node_profile -->|"uses client"| node_supabase
node_catalog -->|"uses client"| node_supabase
node_studio -->|"uses client"| node_supabase
node_business_admin -->|"uses client"| node_supabase
node_business_owner -.->|"manages links"| node_studio
node_studio -.->|"reorders links"| node_link_editor
node_visitor -.->|"follows link"| node_redirect
node_redirect -->|"reads link"| node_supabase_admin
node_redirect -->|"records clicks"| node_supabase_admin
node_redirect -->|"filters bots"| node_tracking
node_loyalty_page -.->|"shows pass"| node_loyalty_pass
node_loyalty_pass -->|"uses client"| node_supabase
node_business_owner -.->|"configures rewards"| node_loyalty_setup
node_visitor -.->|"explores travel"| node_travel
node_travel -.->|"offers exploration"| node_travel_explore
node_travel -.->|"offers passport"| node_travel_passport
node_travel -.->|"offers rewards"| node_travel_rewards

click node_home "https://github.com/mogutravel/mogu/blob/main/app/page.tsx"
click node_profile "https://github.com/mogutravel/mogu/blob/main/app/%5Bslug%5D/page.tsx"
click node_catalog "https://github.com/mogutravel/mogu/blob/main/app/catalogo/%5Bslug%5D/page.tsx"
click node_redirect "https://github.com/mogutravel/mogu/blob/main/app/r/%5Bid%5D/route.ts"
click node_menu "https://github.com/mogutravel/mogu/blob/main/app/menu/%5Bslug%5D/page.tsx"
click node_checkout "https://github.com/mogutravel/mogu/blob/main/app/actions/checkout.ts"
click node_kitchen "https://github.com/mogutravel/mogu/blob/main/app/panel/%5Bslug%5D/cocina/page.tsx"
click node_cashier "https://github.com/mogutravel/mogu/blob/main/app/panel/%5Bslug%5D/caja/page.tsx"
click node_mobile "https://github.com/mogutravel/mogu/blob/main/app/mobile/%5Bslug%5D/page.jsx"
click node_mobile_home "https://github.com/mogutravel/mogu/blob/main/app/mobile/%5Bslug%5D/components/HomeFeed.jsx"
click node_mobile_menu "https://github.com/mogutravel/mogu/blob/main/app/mobile/%5Bslug%5D/components/MenuCatalog.jsx"
click node_mobile_cart "https://github.com/mogutravel/mogu/blob/main/app/mobile/%5Bslug%5D/components/CartView.jsx"
click node_mobile_orders "https://github.com/mogutravel/mogu/blob/main/app/mobile/%5Bslug%5D/components/OrdersView.jsx"
click node_mobile_points "https://github.com/mogutravel/mogu/blob/main/app/mobile/%5Bslug%5D/components/PointsView.jsx"
click node_mobile_profile "https://github.com/mogutravel/mogu/blob/main/app/mobile/%5Bslug%5D/components/ProfileView.jsx"
click node_mobile_header "https://github.com/mogutravel/mogu/blob/main/app/mobile/%5Bslug%5D/components/Header.jsx"
click node_mobile_nav "https://github.com/mogutravel/mogu/blob/main/app/mobile/%5Bslug%5D/components/BottomNav.jsx"
click node_studio "https://github.com/mogutravel/mogu/blob/main/app/panel/page.tsx"
click node_business_admin "https://github.com/mogutravel/mogu/blob/main/app/admin/%5Bslug%5D/page.tsx"
click node_store_admin "https://github.com/mogutravel/mogu/blob/main/app/panel/tienda/%5Bslug%5D/page.tsx"
click node_metrics "https://github.com/mogutravel/mogu/blob/main/app/panel/menu/%5Bslug%5D/metricas/page.tsx"
click node_link_editor "https://github.com/mogutravel/mogu/blob/main/components/LinksManager.tsx"
click node_loyalty_setup "https://github.com/mogutravel/mogu/blob/main/app/panel/%5Bslug%5D/fidelizacion/page.tsx"
click node_loyalty_pass "https://github.com/mogutravel/mogu/blob/main/components/loyalty/LoyaltyPassClient.tsx"
click node_loyalty_page "https://github.com/mogutravel/mogu/blob/main/app/%5Bslug%5D/pass/page.tsx"
click node_travel "https://github.com/mogutravel/mogu/blob/main/app/travel/page.tsx"
click node_travel_explore "https://github.com/mogutravel/mogu/blob/main/app/travel/explore/page.tsx"
click node_travel_passport "https://github.com/mogutravel/mogu/blob/main/app/travel/passport/page.tsx"
click node_travel_rewards "https://github.com/mogutravel/mogu/blob/main/app/travel/rewards/page.tsx"
click node_supabase "https://github.com/mogutravel/mogu/blob/main/lib/supabase.ts"
click node_supabase_admin "https://github.com/mogutravel/mogu/blob/main/lib/supabase-admin.ts"
click node_tracking "https://github.com/mogutravel/mogu/blob/main/lib/track.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_profile,node_catalog,node_redirect toneBlue
class node_menu,node_checkout,node_kitchen,node_cashier,node_mobile,node_mobile_home,node_mobile_menu,node_mobile_cart,node_mobile_orders,node_mobile_points,node_mobile_profile,node_mobile_header,node_mobile_nav,node_supabase,node_supabase_admin toneAmber
class node_studio,node_business_admin,node_store_admin,node_metrics,node_link_editor toneMint
class node_loyalty_setup,node_loyalty_pass,node_loyalty_page toneRose
class node_travel,node_travel_explore,node_travel_passport,node_travel_rewards,node_visitor,node_business_owner toneIndigo
class node_tracking toneTeal
```

## Components

### Discovery & profiles

- [MOGU homepage](https://github.com/mogutravel/mogu/blob/main/app/page.tsx): `app/page.tsx`
- [Business profile](https://github.com/mogutravel/mogu/blob/main/app/%5Bslug%5D/page.tsx): `app/[slug]/page.tsx`
- [Business catalog](https://github.com/mogutravel/mogu/blob/main/app/catalogo/%5Bslug%5D/page.tsx): `app/catalogo/[slug]/page.tsx`
- [Tracked link redirect](https://github.com/mogutravel/mogu/blob/main/app/r/%5Bid%5D/route.ts): `app/r/[id]/route.ts`

### Ordering & operations

- [Restaurant menu](https://github.com/mogutravel/mogu/blob/main/app/menu/%5Bslug%5D/page.tsx): `app/menu/[slug]/page.tsx`
- [Checkout](https://github.com/mogutravel/mogu/blob/main/app/actions/checkout.ts): `app/actions/checkout.ts`
- [Kitchen display](https://github.com/mogutravel/mogu/blob/main/app/panel/%5Bslug%5D/cocina/page.tsx): `app/panel/[slug]/cocina/page.tsx`
- [Cashier operations](https://github.com/mogutravel/mogu/blob/main/app/panel/%5Bslug%5D/caja/page.tsx): `app/panel/[slug]/caja/page.tsx`
- [Mobile customer app](https://github.com/mogutravel/mogu/blob/main/app/mobile/%5Bslug%5D/page.jsx): `app/mobile/[slug]/page.jsx`
- [Mobile home feed](https://github.com/mogutravel/mogu/blob/main/app/mobile/%5Bslug%5D/components/HomeFeed.jsx): `app/mobile/[slug]/components/HomeFeed.jsx`
- [Mobile menu catalog](https://github.com/mogutravel/mogu/blob/main/app/mobile/%5Bslug%5D/components/MenuCatalog.jsx): `app/mobile/[slug]/components/MenuCatalog.jsx`
- [Mobile cart](https://github.com/mogutravel/mogu/blob/main/app/mobile/%5Bslug%5D/components/CartView.jsx): `app/mobile/[slug]/components/CartView.jsx`
- [Mobile orders](https://github.com/mogutravel/mogu/blob/main/app/mobile/%5Bslug%5D/components/OrdersView.jsx): `app/mobile/[slug]/components/OrdersView.jsx`
- [Mobile points](https://github.com/mogutravel/mogu/blob/main/app/mobile/%5Bslug%5D/components/PointsView.jsx): `app/mobile/[slug]/components/PointsView.jsx`
- [Mobile profile](https://github.com/mogutravel/mogu/blob/main/app/mobile/%5Bslug%5D/components/ProfileView.jsx): `app/mobile/[slug]/components/ProfileView.jsx`
- [Mobile header](https://github.com/mogutravel/mogu/blob/main/app/mobile/%5Bslug%5D/components/Header.jsx): `app/mobile/[slug]/components/Header.jsx`
- [Mobile navigation](https://github.com/mogutravel/mogu/blob/main/app/mobile/%5Bslug%5D/components/BottomNav.jsx): `app/mobile/[slug]/components/BottomNav.jsx`

### Business management

- [Studio dashboard](https://github.com/mogutravel/mogu/blob/main/app/panel/page.tsx): `app/panel/page.tsx`
- [Business editor](https://github.com/mogutravel/mogu/blob/main/app/admin/%5Bslug%5D/page.tsx): `app/admin/[slug]/page.tsx`
- [Store manager](https://github.com/mogutravel/mogu/blob/main/app/panel/tienda/%5Bslug%5D/page.tsx): `app/panel/tienda/[slug]/page.tsx`
- [Menu metrics](https://github.com/mogutravel/mogu/blob/main/app/panel/menu/%5Bslug%5D/metricas/page.tsx): `app/panel/menu/[slug]/metricas/page.tsx`
- [Link manager](https://github.com/mogutravel/mogu/blob/main/components/LinksManager.tsx): `components/LinksManager.tsx`

### Loyalty

- [Loyalty management](https://github.com/mogutravel/mogu/blob/main/app/panel/%5Bslug%5D/fidelizacion/page.tsx): `app/panel/[slug]/fidelizacion/page.tsx`
- [Digital loyalty pass](https://github.com/mogutravel/mogu/blob/main/components/loyalty/LoyaltyPassClient.tsx): `components/loyalty/LoyaltyPassClient.tsx`
- [Business loyalty page](https://github.com/mogutravel/mogu/blob/main/app/%5Bslug%5D/pass/page.tsx): `app/[slug]/pass/page.tsx`

### Travel

- [Travel portal](https://github.com/mogutravel/mogu/blob/main/app/travel/page.tsx): `app/travel/page.tsx`
- [Travel exploration](https://github.com/mogutravel/mogu/blob/main/app/travel/explore/page.tsx): `app/travel/explore/page.tsx`
- [Travel passport](https://github.com/mogutravel/mogu/blob/main/app/travel/passport/page.tsx): `app/travel/passport/page.tsx`
- [Travel rewards](https://github.com/mogutravel/mogu/blob/main/app/travel/rewards/page.tsx): `app/travel/rewards/page.tsx`

### Other components

- **Customer**
- **Business owner**
- [Supabase data services](https://github.com/mogutravel/mogu/blob/main/lib/supabase.ts): `lib/supabase.ts`
- [Supabase admin client](https://github.com/mogutravel/mogu/blob/main/lib/supabase-admin.ts): `lib/supabase-admin.ts`
- [Click tracking helpers](https://github.com/mogutravel/mogu/blob/main/lib/track.ts): `lib/track.ts`

## Connections

- MOGU homepage → Business profile: links to
- MOGU homepage → Restaurant menu: describes ordering (evidence: `app/page.tsx`)
- MOGU homepage → Kitchen display: describes order display (evidence: `app/page.tsx`)
- Customer → Restaurant menu: places orders
- Restaurant menu → Checkout: submits order
- Checkout → Kitchen display: dispatches order
- Mobile customer app → Mobile home feed: renders (evidence: `app/mobile/[slug]/page.jsx`)
- Mobile customer app → Mobile menu catalog: renders (evidence: `app/mobile/[slug]/page.jsx`)
- Mobile customer app → Mobile cart: renders (evidence: `app/mobile/[slug]/page.jsx`)
- Mobile customer app → Mobile orders: renders (evidence: `app/mobile/[slug]/page.jsx`)
- Mobile customer app → Mobile points: renders (evidence: `app/mobile/[slug]/page.jsx`)
- Mobile customer app → Mobile profile: renders (evidence: `app/mobile/[slug]/page.jsx`)
- Mobile customer app → Mobile header: renders (evidence: `app/mobile/[slug]/page.jsx`)
- Mobile customer app → Mobile navigation: renders (evidence: `app/mobile/[slug]/page.jsx`)
- Mobile customer app → Supabase data services: loads store data (evidence: `app/mobile/[slug]/page.jsx`)
- Restaurant menu → Supabase data services: uses client (evidence: `app/menu/[slug]/page.tsx`)
- Business profile → Supabase data services: uses client (evidence: `app/[slug]/page.tsx`)
- Business catalog → Supabase data services: uses client (evidence: `app/catalogo/[slug]/page.tsx`)
- Studio dashboard → Supabase data services: uses client (evidence: `app/panel/page.tsx`)
- Business editor → Supabase data services: uses client (evidence: `app/admin/[slug]/page.tsx`)
- Business owner → Studio dashboard: manages links
- Studio dashboard → Link manager: reorders links
- Customer → Tracked link redirect: follows link
- Tracked link redirect → Supabase admin client: reads link (evidence: `app/r/[id]/route.ts`)
- Tracked link redirect → Supabase admin client: records clicks (evidence: `app/r/[id]/route.ts`)
- Tracked link redirect → Click tracking helpers: filters bots (evidence: `app/r/[id]/route.ts`)
- Business loyalty page → Digital loyalty pass: shows pass
- Digital loyalty pass → Supabase data services: uses client (evidence: `components/loyalty/LoyaltyPassClient.tsx`)
- Business owner → Loyalty management: configures rewards
- Customer → Travel portal: explores travel
- Travel portal → Travel exploration: offers exploration
- Travel portal → Travel passport: offers passport
- Travel portal → Travel rewards: offers rewards
