How bhavithra0304/smarttrip works
PlanNgo is an AI travel-planning application. Users sign in, submit a trip request or chat query, and receive a coordinated itinerary with budget, weather, recommendations, events, safety, crowd, and route information; trips and favorites can be saved and revisited. The frontend also exposes dashboards, analytics, profile, and settings capabilities. The graph follows documented imports and calls where available; several API, agent, and page implementations are unsampled, so their links rely on SOURCE INDEX references rather than inspected call details.
Main entry points: master_agent.py Trip coordinator · main.py FastAPI app · trips.py Trips API · retriever.py Knowledge retrieval
Components 33
Travel frontend
- App and routes
frontend/src/App.jsx - Trip pages
frontend/src/pages - Chat widget
frontend/src/components/ChatWidget.jsx - Trip context
frontend/src/context/TripContext.jsx - Trip API client
frontend/src/services/tripService.js - Auth context
frontend/src/context/AuthContext.jsx - Auth API client
frontend/src/services/authService.js
API and identity
- FastAPI app
backend/main.py - Authentication API
backend/api/auth.py - Trips API
backend/api/trips.py - Chat API
backend/api/chat.py - User API
backend/api/user.py - Settings API
backend/api/settings.py
Trip intelligence
- Trip coordinator
backend/agents/master_agent.py - Itinerary planner
backend/agents/planner_agent.py - Budget optimizer
backend/agents/budget_agent.py - Weather agent
backend/agents/weather_agent.py - Recommendations
backend/agents/recommendation_agent.py - Local events
backend/agents/local_events_agent.py - Safety analysis
backend/agents/safety_agent.py - Crowd analysis
backend/agents/crowd_agent.py - Route planning
backend/agents/navigation_agent.py - Booking agent
backend/agents/booking_agent.py
Travel knowledge
- Knowledge retrieval
backend/rag/retriever.py - Knowledge ingestion
backend/rag/ingest.py - Text embeddings
backend/rag/embeddings.py
User and trip data
- SQL database
backend/database/connection.py - User records
backend/models/user.py - Trips and favorites
backend/models/trip.py
External services
- Groq language model
- Open-Meteo
- Travel data APIs
Other components
- Traveler
Connections 43
- Traveler → App and routes: uses
frontend/src/App.jsx - App and routes → Trip pages: routes to
frontend/src/App.jsx - Trip pages → Trip context: uses
- Trip context → Trip API client: calls
frontend/src/context/TripContext.jsx - Trip pages → Trip API client: requests trips
- Chat widget → Trip API client: sends queries
frontend/src/components/ChatWidget.jsx - App and routes → Auth context: provides auth
frontend/src/App.jsx - Auth context → Auth API client: calls
frontend/src/context/AuthContext.jsx - Trip API client → FastAPI app: HTTP requests
frontend/src/services/tripService.js - Auth API client → FastAPI app: HTTP requests
- FastAPI app → Authentication API: registers router
backend/main.py - FastAPI app → Trips API: registers router
backend/main.py - FastAPI app → Chat API: registers router
backend/main.py - FastAPI app → User API: registers router
backend/main.py - FastAPI app → Settings API: registers router
backend/main.py - Authentication API → SQL database: gets sessions
backend/api/auth.py - Authentication API → User records: reads and updates
backend/api/auth.py - Trips API → Trip coordinator: generates trips
backend/api/trips.py - Trips API → SQL database: uses sessions
backend/api/trips.py - Trips API → Trips and favorites: stores trip data
backend/api/trips.py - Chat API → Trip coordinator: coordinates planning
backend/api/chat.py - Chat API → Knowledge retrieval: queries knowledge
backend/api/chat.py - User API → SQL database: uses sessions
backend/api/user.py - User API → User records: reads user data
backend/api/user.py - Trip coordinator → Itinerary planner: dispatches
backend/agents/master_agent.py - Trip coordinator → Budget optimizer: dispatches
backend/agents/master_agent.py - Trip coordinator → Weather agent: dispatches
backend/agents/master_agent.py - Trip coordinator → Recommendations: dispatches
backend/agents/master_agent.py - Trip coordinator → Local events: dispatches
backend/agents/master_agent.py - Trip coordinator → Safety analysis: dispatches
backend/agents/master_agent.py - Trip coordinator → Crowd analysis: dispatches
backend/agents/master_agent.py - Trip coordinator → Route planning: dispatches
backend/agents/master_agent.py - Recommendations → Knowledge retrieval: retrieves guides
backend/agents/recommendation_agent.py - Knowledge retrieval → Knowledge ingestion: initializes collection
backend/rag/retriever.py - Knowledge ingestion → Text embeddings: embeds documents
backend/rag/ingest.py - Knowledge retrieval → Text embeddings: embeds queries
backend/rag/retriever.py - Trip coordinator → Groq language model: parses requests
- Trip coordinator → Open-Meteo: coordinates forecasts
- Itinerary planner → Travel data APIs: searches places
- Route planning → Travel data APIs: computes routes
- Budget optimizer → Travel data APIs: converts currency
- Local events → Travel data APIs: finds events
- Weather agent → Open-Meteo: fetches forecasts