How sean1-git/uc-merced-campus-store works
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: App.tsx App shell · useCampusStore.ts Store coordinator · api.mjs API router · orders.mjs Order service
Components 28
Shopping PWA
- App shell
apps/web/src/app/App.tsx - Storefront
apps/web/src/features/storefront/Storefront.tsx - Store coordinator
apps/web/src/app/useCampusStore.ts - Shopping bag
apps/web/src/features/checkout/ShoppingBag.tsx - Browser state
apps/web/src/shared/state/storage.ts - Inventory refresh
apps/web/src/features/storefront/useInventory.ts - Inventory cache
apps/web/src/shared/state/inventoryCache.ts - API client
apps/web/src/shared/api/api.ts - Order history
apps/web/src/features/orders/OrderHistory.tsx - Order updates
apps/web/src/features/orders/orderUpdates.ts - Delivery map
apps/web/src/features/delivery/DeliveryMap.tsx - Delivery status
apps/web/src/features/delivery/DeliveryStatus.tsx - PWA controls
apps/web/src/shared/pwa/usePwa.ts
Store API
- API router
apps/api/src/api.mjs - Sessions
apps/api/src/auth/auth.mjs - HTTP utilities
apps/api/src/http/http.mjs - Inventory service
apps/api/src/inventory/inventory.mjs - Order service
apps/api/src/orders/orders.mjs - Order events
apps/api/src/orders/order-events.mjs - SQLite database
apps/api/src/database/local-db.mjs
Campus domain
- Store catalog
packages/domain/src/catalog/stores.ts - Campus geometry
packages/domain/src/campus/campusGeo.ts - Campus routing
packages/domain/src/campus/campusRouting.ts - Route playback
packages/domain/src/delivery/deliveryRoute.ts - Data schema
packages/database/schema.ts
Native shells
- Capacitor apps
apps/mobile/android/app/src/main/java/io/github/sean1git/campusstore/MainActivity.java
Other components
- Student
- Google Maps
Connections 36
- Student → App shell: shops in
- App shell → Store coordinator: coordinates
apps/web/src/app/App.tsx - App shell → Storefront: renders
apps/web/src/app/App.tsx - App shell → Shopping bag: renders
apps/web/src/app/App.tsx - App shell → Order history: renders
apps/web/src/app/App.tsx - App shell → Delivery map: renders
apps/web/src/app/App.tsx - App shell → Delivery status: renders
apps/web/src/app/App.tsx - Store coordinator → Browser state: persists bag
apps/web/src/app/useCampusStore.ts - Store coordinator → API client: requests API
apps/web/src/app/useCampusStore.ts - Store coordinator → Inventory refresh: refreshes stock
apps/web/src/app/useCampusStore.ts - Inventory refresh → API client: fetches inventory
apps/web/src/features/storefront/useInventory.ts - Inventory refresh → Inventory cache: reads and writes
apps/web/src/features/storefront/useInventory.ts - Storefront → Store catalog: shows stores
- Shopping bag → Store coordinator: changes cart
apps/web/src/features/checkout/ShoppingBag.tsx - Store coordinator → Order updates: subscribes updates
apps/web/src/app/useCampusStore.ts - Order history → Store coordinator: uses orders
apps/web/src/app/App.tsx - Delivery map → Google Maps: renders map
- Delivery map → Campus geometry: uses geometry
apps/web/src/features/delivery/DeliveryMap.tsx - Delivery status → Route playback: shows timeline
apps/web/src/features/delivery/DeliveryStatus.tsx - App shell → PWA controls: uses controls
apps/web/src/app/App.tsx - API client → API router: calls HTTP API
- API router → HTTP utilities: uses HTTP helpers
apps/api/src/api.mjs - API router → Sessions: uses sessions
apps/api/src/api.mjs - API router → Inventory service: routes inventory
apps/api/src/api.mjs - API router → Order service: routes orders
apps/api/src/api.mjs - Order service → HTTP utilities: uses HTTP helpers
apps/api/src/orders/orders.mjs - Order service → Inventory service: uses stock
apps/api/src/orders/orders.mjs - Order service → Campus geometry: builds delivery route
apps/api/src/orders/orders.mjs - Order service → Route playback: uses route playback
apps/api/src/orders/orders.mjs - Campus geometry → Store catalog: uses store anchors
packages/domain/src/campus/campusGeo.ts - Campus geometry → Route playback: uses distance model
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