How srinivas-gowda31/restaurant_app works
This repository implements a multi-hotel guest concierge: guests identify their hotel and room, then use voice or text to get help, place orders, and request services; hotel staff manage catalogs and fulfill requests. The graph follows the guest-to-backend path and preserves the voice, travel/service, and staff-management branches. Source excerpts and the index establish some internal calls, but the README is empty and several routes and integrations were not sampled, so uncertain connections are omitted or marked dashed.
Main entry points: server.js HTTP server · tools.js Concierge tools · db.js Hotel database · call.js Voice call runtime
Components 26
Guest experience
- Guest interface
frontend/src/pages/GuestPage.jsx - Room identity
frontend/src/hooks/useGuestContext.js - API client
frontend/src/services/api.js
Concierge backend
- Session routes
backend/src/routes/session.js - HTTP server
backend/src/server.js - Chat routes
backend/src/routes/chat.js - Menu routes
backend/src/routes/menu.js - Cart routes
backend/src/routes/cart.js - Order routes
backend/src/routes/orders.js - Concierge tools
backend/src/tools.js - Service requests
backend/src/serviceFlows.js - Travel bookings
backend/src/travel.js - Order tracking
backend/src/orderTracking.js
Hotel operations
- Staff console
frontend/src/pages/AdminPage.jsx - Upload review
frontend/src/components/ReviewModal.jsx - Admin routes
backend/src/routes/admin.js - Travel admin
backend/src/routes/adminTravel.js
Session and data
- Hotel database
backend/src/db.js - Lookup cache
backend/src/cache.js - Session context
backend/src/sessionContext.js - Browser session ID
frontend/src/hooks/useSessionId.js
Voice interaction
- Live voice hook
frontend/src/hooks/useRealtimeVoice.js - Voice call runtime
backend/src/voice/call.js - Voice tool runner
backend/src/voice/toolRunner.js - Realtime proxy
backend/src/realtime.js
Other components
- Guest
Connections 37
- Guest → Guest interface: uses
- Guest interface → Room identity: loads identity
frontend/src/pages/GuestPage.jsx - Room identity → API client: checks room
frontend/src/hooks/useGuestContext.js - Room identity → Browser session ID: resets session
frontend/src/hooks/useGuestContext.js - Guest interface → API client: requests data
frontend/src/pages/GuestPage.jsx - API client → HTTP server: HTTP requests
- HTTP server → Session routes: routes requests
backend/src/server.js - HTTP server → Chat routes: routes requests
backend/src/server.js - HTTP server → Menu routes: routes requests
backend/src/server.js - HTTP server → Cart routes: routes requests
backend/src/server.js - HTTP server → Order routes: routes requests
backend/src/server.js - HTTP server → Admin routes: routes requests
backend/src/server.js - HTTP server → Travel admin: routes requests
backend/src/server.js - Session routes → Hotel database: reads and writes
backend/src/routes/session.js - Session routes → Order tracking: builds tracking
backend/src/routes/session.js - Hotel database → Lookup cache: caches lookups
backend/src/db.js - Chat routes → Concierge tools: dispatches tools
- Cart routes → Concierge tools: uses tools
- Order routes → Order tracking: serves tracking
- Concierge tools → Hotel database: queries catalog
backend/src/tools.js - Concierge tools → Travel bookings: handles bookings
backend/src/tools.js - Concierge tools → Service requests: handles requests
backend/src/tools.js - Service requests → Hotel database: reads and writes
backend/src/serviceFlows.js - Service requests → Session context: updates context
backend/src/serviceFlows.js - Travel admin → Travel bookings: manages travel
backend/src/routes/adminTravel.js - Travel admin → Hotel database: reads and writes
backend/src/routes/adminTravel.js - Staff console → Upload review: reviews uploads
frontend/src/pages/AdminPage.jsx - Upload review → API client: approves uploads
frontend/src/components/ReviewModal.jsx - Staff console → Admin routes: admin requests
- Live voice hook → Realtime proxy: opens socket
- HTTP server → Realtime proxy: attaches proxy
backend/src/server.js - Realtime proxy → Voice call runtime: forwards voice
- Voice call runtime → Concierge tools: invokes tools
backend/src/voice/call.js - Voice call runtime → Voice tool runner: delegates tools
backend/src/voice/call.js - Voice tool runner → Concierge tools: executes tools
backend/src/voice/toolRunner.js - Voice call runtime → Hotel database: reads and writes
backend/src/voice/call.js - Voice call runtime → Session context: uses context
backend/src/voice/call.js