How sigallage/ceylonroam works
CeylonRoam combines a web/mobile travel-planning experience with separate itinerary-generation, route-optimization, voice-translation, and account services. The main journey runs from trip preferences to a generated itinerary, route ordering, and saved plans; translation supports travelers during the trip. The README establishes these product stages, while sampled source confirms routing, selected API and persistence behavior. Some frontend-to-service calls and unsampled service internals are documented only at product level, so those links are dashed.
Main entry points: router.jsx Web App Router · main.py Optimizer API · LoginPage.jsx Sign-in and Profile · server.js Account API
Components 23
Traveler Experience
- Web App Router
frontend/src/pages/routes/router.jsx
Itinerary Planning
- Trip Preferences
frontend/src/pages/itineraryGenerator/itineraryGenerator.jsx - Itinerary Generator
backend/itineraryGenerator/main.py - Plan Results
frontend/src/pages/Main/Main.jsx
Route Optimization
- Route Planner
frontend/src/pages/routeOptimizer/routeOptimizer.jsx - Optimizer API
backend/routeOptimizer/main.py - Route Ordering
backend/routeOptimizer/optimizer.py - Traffic Routes
backend/routeOptimizer/google_routes.py - Google Routes API
Language Assistance
- Voice Translation UI
frontend/src/pages/VoiceTranslation/VoiceTranslationPage.jsx - Voice Translation Service
backend/voiceTranslation/main.py
Accounts and Plans
- Sign-in and Profile
frontend/src/pages/Login/LoginPage.jsx - Account API
backend/authService/server.js - Account Routes
backend/authService/src/routes/auth.js - Account Workflows
backend/authService/controllers/authController.js - Token Verification
backend/authService/middleware/authMiddleware.js - User Records
backend/authService/src/models/User.js - OTP Email
backend/authService/utils/emailService.js - Saved Plan History
frontend/src/pages/ItineraryHistory/ItineraryHistory.jsx - Itinerary Routes
backend/authService/src/routes/itinerary.js - Plan Persistence
backend/authService/controllers/itineraryController.js - Saved Itineraries
backend/authService/src/models/Itinerary.js
Other components
- Traveler
Connections 23
- Traveler → Web App Router: uses
- Web App Router → Trip Preferences: routes to
frontend/src/pages/routes/router.jsx - Trip Preferences → Itinerary Generator: requests plan
- Itinerary Generator → Plan Results: returns itinerary
- Traveler → Route Planner: selects destinations
- Route Planner → Optimizer API: requests ordering
- Optimizer API → Route Ordering: optimizes order
backend/routeOptimizer/main.py - Optimizer API → Traffic Routes: requests traffic route
backend/routeOptimizer/main.py - Traffic Routes → Google Routes API: calls
backend/routeOptimizer/google_routes.py - Traveler → Voice Translation UI: requests translation
- Voice Translation UI → Voice Translation Service: sends speech or text
- Web App Router → Sign-in and Profile: routes to
frontend/src/pages/routes/router.jsx - Sign-in and Profile → Account API: sends account requests
- Account API → Account Routes: mounts routes
backend/authService/server.js - Account Routes → Account Workflows: dispatches to
backend/authService/src/routes/auth.js - Account Workflows → User Records: reads and writes
backend/authService/controllers/authController.js - Account Workflows → OTP Email: sends OTP
backend/authService/controllers/authController.js - Sign-in and Profile → Saved Plan History: opens saved plans
- Saved Plan History → Itinerary Routes: requests saved plans
- Account API → Itinerary Routes: mounts routes
backend/authService/server.js - Itinerary Routes → Plan Persistence: dispatches to
backend/authService/src/routes/itinerary.js - Plan Persistence → User Records: looks up owner
backend/authService/controllers/itineraryController.js - Plan Persistence → Saved Itineraries: reads and writes
backend/authService/controllers/itineraryController.js