# sean1-git/uc-merced-campus-store architecture

> Architecture diagram of the GitHub repository sean1-git/uc-merced-campus-store, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-03). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/sean1-git/uc-merced-campus-store
- Repository: https://github.com/sean1-git/uc-merced-campus-store

## Overview

UC Merced Campus Store is a shopping PWA with a Node API and a simulated campus-delivery experience. Students browse two stores, build a shared bag, choose and confirm a meeting-point pin, reserve stock, confirm a demo-wallet order, then follow the simulated pickup-and-delivery stages and view order history. The graph preserves storefront, checkout, inventory, routing, and PWA capabilities. API internals are only partly evidenced by the index and README; edges are limited to explicit references or documented behavior, and mobile shells are not expanded into separate runtime workflows.

Main entry points: [`apps/web/src/app/App.tsx`](https://github.com/sean1-git/uc-merced-campus-store/blob/main/apps/web/src/app/App.tsx) (App shell), [`apps/web/src/app/useCampusStore.ts`](https://github.com/sean1-git/uc-merced-campus-store/blob/main/apps/web/src/app/useCampusStore.ts) (Store coordinator), [`apps/api/src/api.mjs`](https://github.com/sean1-git/uc-merced-campus-store/blob/main/apps/api/src/api.mjs) (API router), [`apps/api/src/orders/orders.mjs`](https://github.com/sean1-git/uc-merced-campus-store/blob/main/apps/api/src/orders/orders.mjs) (Order service)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Shopping PWA"]
  node_webapp["App shell<br/>[App.tsx]"]
  node_storefront["Storefront<br/>[Storefront.tsx]"]
  node_storehook["Store coordinator<br/>[useCampusStore.ts]"]
  node_bag["Shopping bag<br/>[ShoppingBag.tsx]"]
  node_browserstate["Browser state<br/>[storage.ts]"]
  node_inventoryhook["Inventory refresh<br/>[useInventory.ts]"]
  node_inventorycache["Inventory cache<br/>[inventoryCache.ts]"]
  node_api_client["API client<br/>[api.ts]"]
  node_orderhistory["Order history<br/>[OrderHistory.tsx]"]
  node_orderupdates["Order updates<br/>[orderUpdates.ts]"]
  node_deliverymap["Delivery map<br/>[DeliveryMap.tsx]"]
  node_deliverystatus["Delivery status<br/>[DeliveryStatus.tsx]"]
  node_pwa["PWA controls<br/>[usePwa.ts]"]
end

subgraph group_api["Store API"]
  node_api_entry["API router<br/>[api.mjs]"]
  node_auth["Sessions<br/>[auth.mjs]"]
  node_http["HTTP utilities<br/>[http.mjs]"]
  node_inventory["Inventory service<br/>[inventory.mjs]"]
  node_orders["Order service<br/>[orders.mjs]"]
  node_events["Order events<br/>[order-events.mjs]"]
  node_database[("SQLite database<br/>[local-db.mjs]")]
end

subgraph group_domain["Campus domain"]
  node_catalog["Store catalog<br/>[stores.ts]"]
  node_campusgeo["Campus geometry<br/>[campusGeo.ts]"]
  node_campusrouting["Campus routing<br/>[campusRouting.ts]"]
  node_deliveryroute["Route playback<br/>[deliveryRoute.ts]"]
  node_schema["Data schema<br/>[schema.ts]"]
end

subgraph group_mobile["Native shells"]
  node_native["Capacitor apps<br/>[MainActivity.java]"]
end

node_student(("Student"))
node_maps["Google Maps"]

node_student -->|"shops in"| node_webapp
node_webapp -->|"coordinates"| node_storehook
node_webapp -->|"renders"| node_storefront
node_webapp -->|"renders"| node_bag
node_webapp -->|"renders"| node_orderhistory
node_webapp -->|"renders"| node_deliverymap
node_webapp -->|"renders"| node_deliverystatus
node_storehook -->|"persists bag"| node_browserstate
node_storehook -->|"requests API"| node_api_client
node_storehook -->|"refreshes stock"| node_inventoryhook
node_inventoryhook -->|"fetches inventory"| node_api_client
node_inventoryhook -->|"reads and writes"| node_inventorycache
node_storefront -->|"shows stores"| node_catalog
node_bag -->|"changes cart"| node_storehook
node_storehook -->|"subscribes updates"| node_orderupdates
node_orderhistory -->|"uses orders"| node_storehook
node_deliverymap -.->|"renders map"| node_maps
node_deliverymap -->|"uses geometry"| node_campusgeo
node_deliverystatus -->|"shows timeline"| node_deliveryroute
node_webapp -->|"uses controls"| node_pwa
node_api_client -.->|"calls HTTP API"| node_api_entry
node_api_entry -->|"uses HTTP helpers"| node_http
node_api_entry -->|"uses sessions"| node_auth
node_api_entry -->|"routes inventory"| node_inventory
node_api_entry -->|"routes orders"| node_orders
node_orders -->|"uses HTTP helpers"| node_http
node_orders -->|"uses stock"| node_inventory
node_orders -->|"builds delivery route"| node_campusgeo
node_orders -->|"uses route playback"| node_deliveryroute
node_campusgeo -->|"uses store anchors"| node_catalog
node_campusgeo -->|"uses distance model"| node_deliveryroute
node_campusrouting -.->|"models meeting points"| node_student
node_native -.->|"hosts PWA"| node_webapp
node_api_entry -.->|"uses database"| node_database
node_events -.->|"notifies clients"| node_orderupdates
node_schema -.->|"defines tables"| node_database

click node_webapp "https://github.com/sean1-git/uc-merced-campus-store/blob/main/apps/web/src/app/App.tsx"
click node_storefront "https://github.com/sean1-git/uc-merced-campus-store/blob/main/apps/web/src/features/storefront/Storefront.tsx"
click node_storehook "https://github.com/sean1-git/uc-merced-campus-store/blob/main/apps/web/src/app/useCampusStore.ts"
click node_bag "https://github.com/sean1-git/uc-merced-campus-store/blob/main/apps/web/src/features/checkout/ShoppingBag.tsx"
click node_browserstate "https://github.com/sean1-git/uc-merced-campus-store/blob/main/apps/web/src/shared/state/storage.ts"
click node_inventoryhook "https://github.com/sean1-git/uc-merced-campus-store/blob/main/apps/web/src/features/storefront/useInventory.ts"
click node_inventorycache "https://github.com/sean1-git/uc-merced-campus-store/blob/main/apps/web/src/shared/state/inventoryCache.ts"
click node_api_client "https://github.com/sean1-git/uc-merced-campus-store/blob/main/apps/web/src/shared/api/api.ts"
click node_orderhistory "https://github.com/sean1-git/uc-merced-campus-store/blob/main/apps/web/src/features/orders/OrderHistory.tsx"
click node_orderupdates "https://github.com/sean1-git/uc-merced-campus-store/blob/main/apps/web/src/features/orders/orderUpdates.ts"
click node_deliverymap "https://github.com/sean1-git/uc-merced-campus-store/blob/main/apps/web/src/features/delivery/DeliveryMap.tsx"
click node_deliverystatus "https://github.com/sean1-git/uc-merced-campus-store/blob/main/apps/web/src/features/delivery/DeliveryStatus.tsx"
click node_pwa "https://github.com/sean1-git/uc-merced-campus-store/blob/main/apps/web/src/shared/pwa/usePwa.ts"
click node_api_entry "https://github.com/sean1-git/uc-merced-campus-store/blob/main/apps/api/src/api.mjs"
click node_auth "https://github.com/sean1-git/uc-merced-campus-store/blob/main/apps/api/src/auth/auth.mjs"
click node_http "https://github.com/sean1-git/uc-merced-campus-store/blob/main/apps/api/src/http/http.mjs"
click node_inventory "https://github.com/sean1-git/uc-merced-campus-store/blob/main/apps/api/src/inventory/inventory.mjs"
click node_orders "https://github.com/sean1-git/uc-merced-campus-store/blob/main/apps/api/src/orders/orders.mjs"
click node_events "https://github.com/sean1-git/uc-merced-campus-store/blob/main/apps/api/src/orders/order-events.mjs"
click node_database "https://github.com/sean1-git/uc-merced-campus-store/blob/main/apps/api/src/database/local-db.mjs"
click node_catalog "https://github.com/sean1-git/uc-merced-campus-store/blob/main/packages/domain/src/catalog/stores.ts"
click node_campusgeo "https://github.com/sean1-git/uc-merced-campus-store/blob/main/packages/domain/src/campus/campusGeo.ts"
click node_campusrouting "https://github.com/sean1-git/uc-merced-campus-store/blob/main/packages/domain/src/campus/campusRouting.ts"
click node_deliveryroute "https://github.com/sean1-git/uc-merced-campus-store/blob/main/packages/domain/src/delivery/deliveryRoute.ts"
click node_schema "https://github.com/sean1-git/uc-merced-campus-store/blob/main/packages/database/schema.ts"
click node_native "https://github.com/sean1-git/uc-merced-campus-store/blob/main/apps/mobile/android/app/src/main/java/io/github/sean1git/campusstore/MainActivity.java"

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_webapp,node_storefront,node_storehook,node_bag,node_browserstate,node_inventoryhook,node_inventorycache,node_api_client,node_orderhistory,node_orderupdates,node_deliverymap,node_deliverystatus,node_pwa toneBlue
class node_api_entry,node_auth,node_http,node_inventory,node_orders,node_events,node_database toneAmber
class node_catalog,node_campusgeo,node_campusrouting,node_deliveryroute,node_schema toneMint
class node_native toneRose
class node_student,node_maps toneIndigo
```

## Components

### Shopping PWA

- [App shell](https://github.com/sean1-git/uc-merced-campus-store/blob/main/apps/web/src/app/App.tsx): `apps/web/src/app/App.tsx`
- [Storefront](https://github.com/sean1-git/uc-merced-campus-store/blob/main/apps/web/src/features/storefront/Storefront.tsx): `apps/web/src/features/storefront/Storefront.tsx`
- [Store coordinator](https://github.com/sean1-git/uc-merced-campus-store/blob/main/apps/web/src/app/useCampusStore.ts): `apps/web/src/app/useCampusStore.ts`
- [Shopping bag](https://github.com/sean1-git/uc-merced-campus-store/blob/main/apps/web/src/features/checkout/ShoppingBag.tsx): `apps/web/src/features/checkout/ShoppingBag.tsx`
- [Browser state](https://github.com/sean1-git/uc-merced-campus-store/blob/main/apps/web/src/shared/state/storage.ts): `apps/web/src/shared/state/storage.ts`
- [Inventory refresh](https://github.com/sean1-git/uc-merced-campus-store/blob/main/apps/web/src/features/storefront/useInventory.ts): `apps/web/src/features/storefront/useInventory.ts`
- [Inventory cache](https://github.com/sean1-git/uc-merced-campus-store/blob/main/apps/web/src/shared/state/inventoryCache.ts): `apps/web/src/shared/state/inventoryCache.ts`
- [API client](https://github.com/sean1-git/uc-merced-campus-store/blob/main/apps/web/src/shared/api/api.ts): `apps/web/src/shared/api/api.ts`
- [Order history](https://github.com/sean1-git/uc-merced-campus-store/blob/main/apps/web/src/features/orders/OrderHistory.tsx): `apps/web/src/features/orders/OrderHistory.tsx`
- [Order updates](https://github.com/sean1-git/uc-merced-campus-store/blob/main/apps/web/src/features/orders/orderUpdates.ts): `apps/web/src/features/orders/orderUpdates.ts`
- [Delivery map](https://github.com/sean1-git/uc-merced-campus-store/blob/main/apps/web/src/features/delivery/DeliveryMap.tsx): `apps/web/src/features/delivery/DeliveryMap.tsx`
- [Delivery status](https://github.com/sean1-git/uc-merced-campus-store/blob/main/apps/web/src/features/delivery/DeliveryStatus.tsx): `apps/web/src/features/delivery/DeliveryStatus.tsx`
- [PWA controls](https://github.com/sean1-git/uc-merced-campus-store/blob/main/apps/web/src/shared/pwa/usePwa.ts): `apps/web/src/shared/pwa/usePwa.ts`

### Store API

- [API router](https://github.com/sean1-git/uc-merced-campus-store/blob/main/apps/api/src/api.mjs): `apps/api/src/api.mjs`
- [Sessions](https://github.com/sean1-git/uc-merced-campus-store/blob/main/apps/api/src/auth/auth.mjs): `apps/api/src/auth/auth.mjs`
- [HTTP utilities](https://github.com/sean1-git/uc-merced-campus-store/blob/main/apps/api/src/http/http.mjs): `apps/api/src/http/http.mjs`
- [Inventory service](https://github.com/sean1-git/uc-merced-campus-store/blob/main/apps/api/src/inventory/inventory.mjs): `apps/api/src/inventory/inventory.mjs`
- [Order service](https://github.com/sean1-git/uc-merced-campus-store/blob/main/apps/api/src/orders/orders.mjs): `apps/api/src/orders/orders.mjs`
- [Order events](https://github.com/sean1-git/uc-merced-campus-store/blob/main/apps/api/src/orders/order-events.mjs): `apps/api/src/orders/order-events.mjs`
- [SQLite database](https://github.com/sean1-git/uc-merced-campus-store/blob/main/apps/api/src/database/local-db.mjs): `apps/api/src/database/local-db.mjs`

### Campus domain

- [Store catalog](https://github.com/sean1-git/uc-merced-campus-store/blob/main/packages/domain/src/catalog/stores.ts): `packages/domain/src/catalog/stores.ts`
- [Campus geometry](https://github.com/sean1-git/uc-merced-campus-store/blob/main/packages/domain/src/campus/campusGeo.ts): `packages/domain/src/campus/campusGeo.ts`
- [Campus routing](https://github.com/sean1-git/uc-merced-campus-store/blob/main/packages/domain/src/campus/campusRouting.ts): `packages/domain/src/campus/campusRouting.ts`
- [Route playback](https://github.com/sean1-git/uc-merced-campus-store/blob/main/packages/domain/src/delivery/deliveryRoute.ts): `packages/domain/src/delivery/deliveryRoute.ts`
- [Data schema](https://github.com/sean1-git/uc-merced-campus-store/blob/main/packages/database/schema.ts): `packages/database/schema.ts`

### Native shells

- [Capacitor apps](https://github.com/sean1-git/uc-merced-campus-store/blob/main/apps/mobile/android/app/src/main/java/io/github/sean1git/campusstore/MainActivity.java): `apps/mobile/android/app/src/main/java/io/github/sean1git/campusstore/MainActivity.java`

### Other components

- **Student**
- **Google Maps**

## Connections

- Student → App shell: shops in
- App shell → Store coordinator: coordinates (evidence: `apps/web/src/app/App.tsx`)
- App shell → Storefront: renders (evidence: `apps/web/src/app/App.tsx`)
- App shell → Shopping bag: renders (evidence: `apps/web/src/app/App.tsx`)
- App shell → Order history: renders (evidence: `apps/web/src/app/App.tsx`)
- App shell → Delivery map: renders (evidence: `apps/web/src/app/App.tsx`)
- App shell → Delivery status: renders (evidence: `apps/web/src/app/App.tsx`)
- Store coordinator → Browser state: persists bag (evidence: `apps/web/src/app/useCampusStore.ts`)
- Store coordinator → API client: requests API (evidence: `apps/web/src/app/useCampusStore.ts`)
- Store coordinator → Inventory refresh: refreshes stock (evidence: `apps/web/src/app/useCampusStore.ts`)
- Inventory refresh → API client: fetches inventory (evidence: `apps/web/src/features/storefront/useInventory.ts`)
- Inventory refresh → Inventory cache: reads and writes (evidence: `apps/web/src/features/storefront/useInventory.ts`)
- Storefront → Store catalog: shows stores
- Shopping bag → Store coordinator: changes cart (evidence: `apps/web/src/features/checkout/ShoppingBag.tsx`)
- Store coordinator → Order updates: subscribes updates (evidence: `apps/web/src/app/useCampusStore.ts`)
- Order history → Store coordinator: uses orders (evidence: `apps/web/src/app/App.tsx`)
- Delivery map → Google Maps: renders map
- Delivery map → Campus geometry: uses geometry (evidence: `apps/web/src/features/delivery/DeliveryMap.tsx`)
- Delivery status → Route playback: shows timeline (evidence: `apps/web/src/features/delivery/DeliveryStatus.tsx`)
- App shell → PWA controls: uses controls (evidence: `apps/web/src/app/App.tsx`)
- API client → API router: calls HTTP API
- API router → HTTP utilities: uses HTTP helpers (evidence: `apps/api/src/api.mjs`)
- API router → Sessions: uses sessions (evidence: `apps/api/src/api.mjs`)
- API router → Inventory service: routes inventory (evidence: `apps/api/src/api.mjs`)
- API router → Order service: routes orders (evidence: `apps/api/src/api.mjs`)
- Order service → HTTP utilities: uses HTTP helpers (evidence: `apps/api/src/orders/orders.mjs`)
- Order service → Inventory service: uses stock (evidence: `apps/api/src/orders/orders.mjs`)
- Order service → Campus geometry: builds delivery route (evidence: `apps/api/src/orders/orders.mjs`)
- Order service → Route playback: uses route playback (evidence: `apps/api/src/orders/orders.mjs`)
- Campus geometry → Store catalog: uses store anchors (evidence: `packages/domain/src/campus/campusGeo.ts`)
- Campus geometry → Route playback: uses distance model (evidence: `packages/domain/src/campus/campusGeo.ts`)
- Campus routing → Student: models meeting points
- Capacitor apps → App shell: hosts PWA
- API router → SQLite database: uses database
- Order events → Order updates: notifies clients
- Data schema → SQLite database: defines tables
