How abdelrahmanmostafa33/tourmate-ai works
TourMate AI is a conversational travel-planning product: a traveler describes a trip, receives a personalized itinerary, revises or approves it, then can select flights or hotels and pay. The README documents the six-stage itinerary pipeline, multimodal preference input, behavioral profiling, real-time chat, independent flight and hotel selection, and booking/payment flows. The graph preserves those capabilities; many service implementations were not excerpted, so only documented or source-index-supported relationships are drawn.
Main entry points: graph_builder.py Pipeline graph · orchestrator.py Conversation engine · chat.py Chat API · booking_service.py Booking and payments
Components 27
Conversation
- Chat API
backend/app/api/v1/routes/chat.py - Conversation engine
backend/ai_engine/conversation/orchestrator.py - Message interpreter
backend/ai_engine/conversation/message_interpreter.py - Conversation state
backend/ai_engine/conversation/conversation_state.py - Redis sessions
backend/ai_engine/conversation/redis_memory.py - Image analysis
backend/ai_engine/vision
Itinerary planning
- Pipeline graph
backend/ai_engine/graph/graph_builder.py - Pipeline state
backend/ai_engine/graph/state.py - Profile loader
backend/ai_engine/graph/nodes.py - Place retriever
backend/ai_engine/services/place_retriever.py - Candidate scorer
backend/ai_engine/services/candidate_scorer.py - Planning agent
backend/ai_engine/agents/planning_agent.py - Route optimizer
backend/ai_engine/services/route_optimizer.py - Itinerary validator
backend/ai_engine/services/itinerary_validator.py - OSRM routing
Travel discovery
- Place catalog
backend/app/repositories/place_repo.py - Flight search
backend/app/services/flight_service.py - Hotel selection
backend/ai_engine/agents/hotel_selection_agent.py - Itinerary editing
backend/ai_engine/agents/itinerary_modifier_agent.py - Amadeus
Booking and payment
- Booking and payments
backend/app/services/booking_service.py - Stripe
- Payment webhooks
backend/app/api/v1/routes/webhooks.py
Backend platform
- API application
backend/app/main.py - PostgreSQL
backend/app/core/database.py - Chat persistence
backend/app/services/chat_service.py
Other components
- Traveler
Connections 27
- API application → Chat API: mounts routes
backend/app/main.py - Traveler → Chat API: sends trip requests
- Chat API → Conversation engine: handles conversation
- Conversation engine → Message interpreter: interprets messages
backend/ai_engine/conversation/orchestrator.py - Conversation engine → Conversation state: uses state
backend/ai_engine/conversation/orchestrator.py - Conversation engine → Redis sessions: persists sessions
backend/ai_engine/conversation/orchestrator.py - Conversation engine → Pipeline graph: invokes pipeline
backend/ai_engine/conversation/orchestrator.py - Conversation engine → Image analysis: analyzes images
backend/ai_engine/conversation/orchestrator.py - Pipeline graph → Pipeline state: uses state
backend/ai_engine/graph/graph_builder.py - Pipeline graph → Profile loader: runs stage
backend/ai_engine/graph/graph_builder.py - Pipeline graph → Place retriever: runs stage
- Pipeline graph → Candidate scorer: runs stage
- Pipeline graph → Planning agent: runs stage
- Pipeline graph → Route optimizer: runs stage
- Pipeline graph → Itinerary validator: runs stage
- Place retriever → Place catalog: retrieves places
backend/ai_engine/services/place_retriever.py - Route optimizer → OSRM routing: requests routes
- Conversation engine → Itinerary editing: dispatches edits
backend/ai_engine/conversation/orchestrator.py - Traveler → Flight search: searches flights
- Traveler → Hotel selection: selects hotels
- Flight search → Amadeus: searches offers
- Traveler → Booking and payments: checks out
- Booking and payments → Stripe: creates payment
backend/app/services/booking_service.py - Stripe → Payment webhooks: sends events
backend/app/api/v1/routes/webhooks.py - Payment webhooks → Booking and payments: dispatches events
backend/app/api/v1/routes/webhooks.py - API application → PostgreSQL: initializes tables
backend/app/main.py - Chat persistence → PostgreSQL: stores chat data