How yneq/travel-crm-ai works
VoyageOps AI is a staff-facing travel CRM and operations platform. Staff authenticate, manage members and travel requests, build versioned trips and quote snapshots, then progress approved quotes into orders and payment attempts. AI planning and CRM-agent features support that work but keep plans and write proposals under human review. Reminders, communications, audit, and background jobs cover ongoing operations. The map combines sampled calls and imports with explicitly documented capabilities; unsampled subsystems are represented by their existing controller paths, so some links are documented rather than source-verified.
Main entry points: app.py FastAPI application · ai_controller.py AI plan review · reminder_controller.py Reminders and follow-up · background_worker.py Background worker
Components 27
API and identity
- Operations dashboard
admin/admin.js - FastAPI application
app.py - Staff identity
controllers/user_controller.py - Auth and DB access
dependencies.py
Travel CRM
- Members and requests
controllers/crm_controller.py - CRM records and tasks
repositories/crm_repository.py - Trips and quotes
controllers/trip_controller.py - Trip and quote storage
repositories/trip_repository.py - Quote PDF
services/quote_pdf.py - Orders and payments
controllers/payment_controller.py - Payment records
repositories/payment_repository.py
AI assistance
- AI plan review
controllers/ai_controller.py - Travel planning provider
services/planning_provider.py - Agent proposals
controllers/operations_agent_controller.py - CRM operations agent
services/operations_agent_graph.py - Proposal review state
repositories/operations_agent_repository.py
Operations governance
- Reminders and follow-up
controllers/reminder_controller.py - Communication drafts
repositories/communication_repository.py - Audit log
controllers/audit_controller.py - Reminder records
repositories/reminder_repository.py
Runtime services
- Background worker
services/background_worker.py - Job queue
services/job_queue.py - Job records
repositories/job_repository.py
Other components
- Staff user
- MySQL
- Redis
- Traveler
Connections 37
- Staff user → Operations dashboard: uses
README.md - Operations dashboard → FastAPI application: calls API
README.md - Staff user → FastAPI application: submits requests
README.md - FastAPI application → Staff identity: routes to
app.py - FastAPI application → Members and requests: routes to
app.py - FastAPI application → Trips and quotes: routes to
app.py - FastAPI application → Orders and payments: routes to
app.py - FastAPI application → AI plan review: routes to
app.py - FastAPI application → Reminders and follow-up: routes to
app.py - Staff identity → Auth and DB access: uses auth
controllers/user_controller.py - Staff identity → MySQL: reads and writes
controllers/user_controller.py - Members and requests → CRM records and tasks: reads and writes
controllers/crm_controller.py - Members and requests → Auth and DB access: checks access
controllers/crm_controller.py - CRM records and tasks → MySQL: persists records
README.md - Trips and quotes → Trip and quote storage: reads and writes
controllers/trip_controller.py - Trips and quotes → Quote PDF: generates PDF
controllers/trip_controller.py - Trip and quote storage → MySQL: persists trips
README.md - Orders and payments → Payment records: handles orders
controllers/payment_controller.py - Payment records → MySQL: persists payments
README.md - AI plan review → Travel planning provider: generates drafts
controllers/ai_controller.py - AI plan review → CRM records and tasks: loads CRM context
README.md - AI plan review → Trip and quote storage: reviewed plan to itinerary
README.md - Agent proposals → CRM operations agent: runs agent
controllers/operations_agent_controller.py - Agent proposals → Proposal review state: reviews proposals
controllers/operations_agent_controller.py - CRM operations agent → Proposal review state: uses tools
services/operations_agent_graph.py - Proposal review state → MySQL: stores proposals
README.md - Reminders and follow-up → Reminder records: scans and updates
controllers/reminder_controller.py - Reminders and follow-up → Travel planning provider: drafts follow-up
controllers/reminder_controller.py - Reminders and follow-up → Communication drafts: manages drafts
README.md - Traveler → Communication drafts: receives approved message
README.md - Communication drafts → MySQL: stores drafts
README.md - FastAPI application → Audit log: routes to
app.py - Background worker → Job records: recovers and updates
services/background_worker.py - Background worker → Reminder records: scans reminders
services/background_worker.py - Background worker → Job queue: schedules jobs
README.md - Job queue → Redis: queues scheduled jobs
README.md - Job records → MySQL: stores job state
README.md