# couchbase-examples/edge-server-meal-order-sample-app architecture

> Architecture diagram of the GitHub repository couchbase-examples/edge-server-meal-order-sample-app, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-01). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/couchbase-examples/edge-server-meal-order-sample-app
- Repository: https://github.com/couchbase-examples/edge-server-meal-order-sample-app

## Overview

This is a React airline seatback meal-ordering demo with separate business- and economy-class experiences. The workflow is: a passenger opens a class menu, the app loads meals and inventory from Couchbase Edge Server, selections accumulate in a cart, and confirmation updates inventory for that seat. Edge Server supports offline access and synchronizes with remote Capella App Services when connectivity is available. The graph follows sampled calls and README-documented integrations; unsampled component details and configuration wiring are not inferred.

Main entry points: [`src/components/MealPage.tsx`](https://github.com/couchbase-examples/edge-server-meal-order-sample-app/blob/main/src/components/MealPage.tsx) (Meal browsing), [`src/components/Cart.tsx`](https://github.com/couchbase-examples/edge-server-meal-order-sample-app/blob/main/src/components/Cart.tsx) (Cart and editing), [`src/services/api.ts`](https://github.com/couchbase-examples/edge-server-meal-order-sample-app/blob/main/src/services/api.ts) (REST client), [`src/store/index.ts`](https://github.com/couchbase-examples/edge-server-meal-order-sample-app/blob/main/src/store/index.ts) (Redux state and persistence)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_experience["Ordering experience"]
  node_app["Class app shell<br/>[App.tsx]"]
  node_mealpage["Meal browsing<br/>[MealPage.tsx]"]
  node_mealcard["Meal card<br/>[MealCard.tsx]"]
  node_cart["Cart and editing<br/>[Cart.tsx]"]
  node_orderdialog["Order confirmation"]
  node_confirmed["Confirmed order view<br/>[ConfirmedOrder.tsx]"]
end

subgraph group_state["Order and inventory state"]
  node_businessmeal["Business meals"]
  node_economymeal["Economy meals"]
  node_businessinventory["Business inventory"]
  node_economyinventory["Economy inventory"]
  node_store["Redux state and persistence<br/>[index.ts]"]
  node_inventorychanges["Inventory change feed"]
end

subgraph group_edge["Edge data services"]
  node_api["REST client<br/>[api.ts]"]
  node_edge_server["Couchbase Edge Server"]
  node_capella[("Capella App Services")]
end

node_passenger(("Passenger"))

node_passenger -->|"opens app"| node_app
node_app -->|"renders"| node_mealpage
node_app -->|"renders"| node_cart
node_mealpage -->|"renders"| node_mealcard
node_mealpage -->|"loads or selects"| node_businessmeal
node_mealpage -->|"loads or selects"| node_economymeal
node_mealpage -->|"loads inventory"| node_businessinventory
node_mealpage -->|"loads inventory"| node_economyinventory
node_mealpage -->|"subscribes"| node_inventorychanges
node_cart -->|"updates selection"| node_businessmeal
node_cart -->|"updates selection"| node_economymeal
node_cart -->|"renders"| node_confirmed
node_cart -->|"renders"| node_orderdialog
node_orderdialog -->|"submits order"| node_businessinventory
node_orderdialog -->|"submits order"| node_economyinventory
node_businessinventory -->|"fetches and writes"| node_api
node_economyinventory -->|"fetches and writes"| node_api
node_businessmeal -->|"fetches meals"| node_api
node_economymeal -->|"fetches meals"| node_api
node_api -->|"REST requests"| node_edge_server
node_inventorychanges -->|"streams changes"| node_edge_server
node_edge_server -->|"syncs when online"| node_capella
node_store -->|"configures reducer"| node_businessmeal
node_store -->|"configures reducer"| node_economymeal
node_store -->|"configures reducer"| node_businessinventory
node_store -->|"configures reducer"| node_economyinventory

click node_app "https://github.com/couchbase-examples/edge-server-meal-order-sample-app/blob/main/src/App.tsx"
click node_mealpage "https://github.com/couchbase-examples/edge-server-meal-order-sample-app/blob/main/src/components/MealPage.tsx"
click node_mealcard "https://github.com/couchbase-examples/edge-server-meal-order-sample-app/blob/main/src/components/MealCard.tsx"
click node_cart "https://github.com/couchbase-examples/edge-server-meal-order-sample-app/blob/main/src/components/Cart.tsx"
click node_orderdialog "https://github.com/couchbase-examples/edge-server-meal-order-sample-app/blob/main/src/components/OrderSummaryDialog.tsx"
click node_confirmed "https://github.com/couchbase-examples/edge-server-meal-order-sample-app/blob/main/src/components/ConfirmedOrder.tsx"
click node_businessmeal "https://github.com/couchbase-examples/edge-server-meal-order-sample-app/blob/main/src/store/businessMealSlice.ts"
click node_economymeal "https://github.com/couchbase-examples/edge-server-meal-order-sample-app/blob/main/src/store/economyMealSlice.ts"
click node_businessinventory "https://github.com/couchbase-examples/edge-server-meal-order-sample-app/blob/main/src/store/businessInventorySlice.ts"
click node_economyinventory "https://github.com/couchbase-examples/edge-server-meal-order-sample-app/blob/main/src/store/economyInventorySlice.ts"
click node_store "https://github.com/couchbase-examples/edge-server-meal-order-sample-app/blob/main/src/store/index.ts"
click node_inventorychanges "https://github.com/couchbase-examples/edge-server-meal-order-sample-app/blob/main/src/hooks/useInventoryChanges.ts"
click node_api "https://github.com/couchbase-examples/edge-server-meal-order-sample-app/blob/main/src/services/api.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_app,node_mealpage,node_mealcard,node_cart,node_orderdialog,node_confirmed toneBlue
class node_businessmeal,node_economymeal,node_businessinventory,node_economyinventory,node_store,node_inventorychanges toneAmber
class node_api,node_edge_server,node_capella toneMint
class node_passenger toneIndigo
```

## Components

### Ordering experience

- [Class app shell](https://github.com/couchbase-examples/edge-server-meal-order-sample-app/blob/main/src/App.tsx): `src/App.tsx`
- [Meal browsing](https://github.com/couchbase-examples/edge-server-meal-order-sample-app/blob/main/src/components/MealPage.tsx): `src/components/MealPage.tsx`
- [Meal card](https://github.com/couchbase-examples/edge-server-meal-order-sample-app/blob/main/src/components/MealCard.tsx): `src/components/MealCard.tsx`
- [Cart and editing](https://github.com/couchbase-examples/edge-server-meal-order-sample-app/blob/main/src/components/Cart.tsx): `src/components/Cart.tsx`
- [Order confirmation](https://github.com/couchbase-examples/edge-server-meal-order-sample-app/blob/main/src/components/OrderSummaryDialog.tsx): `src/components/OrderSummaryDialog.tsx`
- [Confirmed order view](https://github.com/couchbase-examples/edge-server-meal-order-sample-app/blob/main/src/components/ConfirmedOrder.tsx): `src/components/ConfirmedOrder.tsx`

### Order and inventory state

- [Business meals](https://github.com/couchbase-examples/edge-server-meal-order-sample-app/blob/main/src/store/businessMealSlice.ts): `src/store/businessMealSlice.ts`
- [Economy meals](https://github.com/couchbase-examples/edge-server-meal-order-sample-app/blob/main/src/store/economyMealSlice.ts): `src/store/economyMealSlice.ts`
- [Business inventory](https://github.com/couchbase-examples/edge-server-meal-order-sample-app/blob/main/src/store/businessInventorySlice.ts): `src/store/businessInventorySlice.ts`
- [Economy inventory](https://github.com/couchbase-examples/edge-server-meal-order-sample-app/blob/main/src/store/economyInventorySlice.ts): `src/store/economyInventorySlice.ts`
- [Redux state and persistence](https://github.com/couchbase-examples/edge-server-meal-order-sample-app/blob/main/src/store/index.ts): `src/store/index.ts`
- [Inventory change feed](https://github.com/couchbase-examples/edge-server-meal-order-sample-app/blob/main/src/hooks/useInventoryChanges.ts): `src/hooks/useInventoryChanges.ts`

### Edge data services

- [REST client](https://github.com/couchbase-examples/edge-server-meal-order-sample-app/blob/main/src/services/api.ts): `src/services/api.ts`
- **Couchbase Edge Server**
- **Capella App Services**

### Other components

- **Passenger**

## Connections

- Passenger → Class app shell: opens app (evidence: `README.md`)
- Class app shell → Meal browsing: renders (evidence: `src/App.tsx`)
- Class app shell → Cart and editing: renders (evidence: `src/App.tsx`)
- Meal browsing → Meal card: renders (evidence: `src/components/MealPage.tsx`)
- Meal browsing → Business meals: loads or selects (evidence: `src/components/MealPage.tsx`)
- Meal browsing → Economy meals: loads or selects (evidence: `src/components/MealPage.tsx`)
- Meal browsing → Business inventory: loads inventory (evidence: `src/components/MealPage.tsx`)
- Meal browsing → Economy inventory: loads inventory (evidence: `src/components/MealPage.tsx`)
- Meal browsing → Inventory change feed: subscribes (evidence: `src/components/MealPage.tsx`)
- Cart and editing → Business meals: updates selection (evidence: `src/components/Cart.tsx`)
- Cart and editing → Economy meals: updates selection (evidence: `src/components/Cart.tsx`)
- Cart and editing → Confirmed order view: renders (evidence: `src/components/Cart.tsx`)
- Cart and editing → Order confirmation: renders (evidence: `src/components/Cart.tsx`)
- Order confirmation → Business inventory: submits order (evidence: `src/components/OrderSummaryDialog.tsx`)
- Order confirmation → Economy inventory: submits order (evidence: `src/components/OrderSummaryDialog.tsx`)
- Business inventory → REST client: fetches and writes (evidence: `src/store/businessInventorySlice.ts`)
- Economy inventory → REST client: fetches and writes (evidence: `src/store/economyInventorySlice.ts`)
- Business meals → REST client: fetches meals (evidence: `src/store/businessMealSlice.ts`)
- Economy meals → REST client: fetches meals (evidence: `src/store/economyMealSlice.ts`)
- REST client → Couchbase Edge Server: REST requests (evidence: `README.md`)
- Inventory change feed → Couchbase Edge Server: streams changes (evidence: `src/hooks/useInventoryChanges.ts`)
- Couchbase Edge Server → Capella App Services: syncs when online (evidence: `README.md`)
- Redux state and persistence → Business meals: configures reducer (evidence: `src/store/index.ts`)
- Redux state and persistence → Economy meals: configures reducer (evidence: `src/store/index.ts`)
- Redux state and persistence → Business inventory: configures reducer (evidence: `src/store/index.ts`)
- Redux state and persistence → Economy inventory: configures reducer (evidence: `src/store/index.ts`)
