How shub1504/waypoint- works
Waypoint is a travel-disruption concierge: travellers register trips and preferences, then disruptions trigger replacement searches, budget checks and either automated or human-approved decisions, payment handling and notifications. The graph includes the documented live-data, chat, journey-booking and planning capabilities. The sampled backend entry point and frontend establish key API/UI relationships; several domain modules were not sampled, so their internal call paths are omitted where the evidence does not establish them.
Main entry points: main.py REST API · App.jsx Waypoint interface · agent.py Disruption agent · chat.py Chat services
Components 28
Traveller experience
- Waypoint interface
frontend/App.jsx - Trips and home
frontend/components/Home.jsx - Explore alternatives
frontend/components/Explore.jsx - Concierge chat
frontend/components/Chat.jsx - Profile and payments
frontend/components/Profile.jsx - Start journey
frontend/src/components/StartJourney.jsx
Disruption operations
- REST API
backend/app/main.py - Disruption agent
backend/app/agent.py - Budget guardrail
backend/app/guardrail.py - Alternative search
backend/app/explore.py - Journey booking
backend/app/journey.py - Cancel and refund
backend/app/cancel.py - Chat services
backend/app/chat.py - Intent router
backend/app/router.py
Persistence and integrations
- Live travel data
backend/app/live_providers.py - Disruption event bus
backend/app/bus.py - Waypoint database
backend/app/models.py - PayPal payments
backend/app/payments.py
AI travel planning
- Planning workflow
backend/travel_agent_langgraph_complete/app/graph.py - Travel research
backend/travel_agent_langgraph_complete/app/nodes/research.py - Human approval
backend/travel_agent_langgraph_complete/app/nodes/approval.py - Travel search tools
backend/travel_agent_langgraph_complete/app/tools
Other components
- Traveller
- PayPal sandbox
- RailRadar
- HasData
- Gemini
- Push, SMS, email
Connections 29
- Traveller → Waypoint interface: uses
README.md - Waypoint interface → Trips and home: renders
frontend/App.jsx - Waypoint interface → Explore alternatives: renders
frontend/App.jsx - Waypoint interface → Concierge chat: renders
frontend/App.jsx - Waypoint interface → Profile and payments: renders
frontend/App.jsx - Start journey → REST API: requests
- Waypoint interface → REST API: calls
README.md - REST API → Disruption agent: dispatches
backend/app/main.py - REST API → Alternative search: routes
backend/app/main.py - REST API → Journey booking: routes
backend/app/main.py - REST API → Cancel and refund: calls
backend/app/main.py - REST API → Chat services: routes
backend/app/main.py - Chat services → Intent router: classifies
backend/app/router.py - Disruption agent → Budget guardrail: checks ceiling
README.md - Disruption agent → Alternative search: finds options
README.md - Disruption agent → PayPal payments: charges
README.md - Disruption agent → Push, SMS, email: notifies
README.md - REST API → Disruption event bus: consumes events
backend/app/main.py - Disruption event bus → Disruption agent: delivers events
README.md - REST API → Waypoint database: reads and writes
backend/app/main.py - PayPal payments → PayPal sandbox: uses
README.md - Live travel data → RailRadar: fetches schedules
README.md - Live travel data → HasData: fetches flights
README.md - Chat services → Live travel data: searches travel data
README.md - REST API → Planning workflow: mounts routes
backend/app/main.py - Planning workflow → Travel research: runs node
backend/travel_agent_langgraph_complete/app/graph.py - Travel research → Travel search tools: searches options
backend/travel_agent_langgraph_complete/app/nodes/research.py - Travel research → Gemini: plans research
backend/travel_agent_langgraph_complete/app/nodes/research.py - Planning workflow → Human approval: awaits approval
backend/travel_agent_langgraph_complete/app/graph.py