How nguyentribaothang/localexplorerai works
Local Explorer AI is a Ho Chi Minh City experience-discovery and trip-planning platform. Travelers explore verified experiences, express trip constraints in chat or the planner, receive slot-aware itineraries with routes, and can book and pay; providers manage availability and booking decisions, while administrators oversee operations and integrations. The graph also preserves the documented local search/ranking, dynamic replanning, 3D map, evidence, and payment capabilities. Several backend route implementations were not sampled, so those feature links are based on README documentation rather than inspected calls.
Main entry points: main.py FastAPI application · router.tsx Role-based routes · ExplorePage.tsx Explore and chat · client.ts API client
Components 29
Traveler Interface
- Web application
apps/web/src/main.tsx - Role-based routes
apps/web/src/router.tsx - Explore and chat
apps/web/src/pages/ExplorePage.tsx - Itinerary view
apps/web/src/pages/ItineraryPage.tsx - Provider portal
apps/web/src/pages/ProviderPortalPage.tsx - Admin tools
apps/web/src/pages/AdminPage.tsx - API client
apps/web/src/api/client.ts
Experience Discovery
- Experience catalog
apps/api/app/api/routes/catalog.py - Semantic search
apps/api/app/services/e5_search_service.py - Evidence verification
apps/api/app/services/evidence_service.py
Planning and AI
- Concierge chat
apps/api/app/api/routes/chat.py - Planner API
apps/api/app/api/routes/planner.py - Itinerary planning
apps/api/app/services/planner_service.py - Heuristic solver
apps/api/app/services/planner_engine.py - ML ranker
apps/api/app/services/ml_ranker_service.py - Dynamic replanning
apps/api/app/services/replanning_service.py - Goong routing
apps/api/app/services/routing_service.py
Bookings and Operations
- Booking and payment API
apps/api/app/api/routes/bookings.py - Provider management API
apps/api/app/api/routes/provider.py - Admin API
apps/api/app/api/routes/admin.py
API and Data
- Authentication API
apps/api/app/api/routes/auth.py - FastAPI application
apps/api/app/main.py - PostgreSQL and PostGIS
apps/api/app/models/entities.py - LLM provider
apps/api/app/adapters/llm/provider.py
Other components
- Traveler
- Experience provider
- Administrator
- Goong Maps
- VNPay or MoMo
Connections 38
- Traveler → Web application: uses
README.md - Web application → Role-based routes: loads routes
apps/web/src/main.tsx - Role-based routes → Explore and chat: routes to
apps/web/src/router.tsx - Role-based routes → Itinerary view: routes to
apps/web/src/router.tsx - Role-based routes → Provider portal: routes to
apps/web/src/router.tsx - Role-based routes → Admin tools: routes to
apps/web/src/router.tsx - Explore and chat → API client: requests data
- Itinerary view → API client: requests data
apps/web/src/pages/ItineraryPage.tsx - Provider portal → API client: manages bookings
apps/web/src/api/client.ts - Admin tools → API client: requests tools
- API client → FastAPI application: calls API
apps/web/src/api/client.ts - FastAPI application → Experience catalog: registers routes
apps/api/app/main.py - FastAPI application → Concierge chat: registers routes
apps/api/app/main.py - FastAPI application → Planner API: registers routes
apps/api/app/main.py - FastAPI application → Booking and payment API: registers routes
apps/api/app/main.py - FastAPI application → Provider management API: registers routes
apps/api/app/main.py - FastAPI application → Admin API: registers routes
apps/api/app/main.py - FastAPI application → Authentication API: registers routes
apps/api/app/main.py - Explore and chat → Experience catalog: browses experiences
README.md - Explore and chat → Semantic search: searches semantically
README.md - Experience catalog → Evidence verification: verifies provenance
README.md - Explore and chat → Concierge chat: sends constraints
README.md - Concierge chat → LLM provider: parses intent
README.md - Concierge chat → Planner API: transfers constraints
README.md - Planner API → Itinerary planning: requests plan
apps/api/app/services/planner_service.py - Itinerary planning → Heuristic solver: selects schedule
apps/api/app/services/planner_service.py - Itinerary planning → ML ranker: ranks candidates
apps/api/app/services/planner_service.py - Itinerary planning → Goong routing: computes routes
apps/api/app/services/planner_service.py - Goong routing → Goong Maps: requests directions
apps/api/app/services/routing_service.py - Itinerary view → Dynamic replanning: requests replanning
README.md - Booking and payment API → VNPay or MoMo: initiates payment
README.md - Traveler → Booking and payment API: books experience
README.md - Experience provider → Provider portal: manages availability
README.md - Administrator → Admin tools: oversees platform
README.md - Booking and payment API → PostgreSQL and PostGIS: holds seats
README.md - Provider management API → PostgreSQL and PostGIS: updates offerings
README.md - Experience catalog → PostgreSQL and PostGIS: reads catalog
- Authentication API → PostgreSQL and PostGIS: loads accounts
apps/api/app/api/routes/auth.py