How jooho-le/oddtrip works
OddTrip is a travel-style assessment and complementary-traveler matching platform that continues through preference coordination and shared itinerary creation. The browser app routes users through these stages and uses API services to reach a FastAPI backend, whose routers expose matching, trips, attractions, coordination, safety, and community capabilities. The README documents the domain workflow and major features; sampled source confirms selected routing, API calls, and service dependencies. Many backend and frontend implementation files were not sampled, so unverified runtime connections are omitted or marked dashed.
Main entry points: App.tsx OddTrip app · main.py FastAPI application · TripWorkspacePage.tsx Trip workspace · MatesPage.tsx Match discovery
Components 23
Traveler experience
- OddTrip app
src/app/App.tsx - Style assessment
src/pages/survey/SurveyFormPage.tsx - Match discovery
src/pages/matches/MatesPage.tsx - Trip workspace
src/pages/trip/TripWorkspacePage.tsx - Community pages
src/pages/community/CommunityPages.tsx
Frontend state and API
- Trip state
src/entities/trip/model/tripStore.ts - Trip API service
src/entities/trip/api/oddtripService.ts - HTTP client
src/shared/api/client.ts - Consent API
src/entities/consent/api/consentService.ts - Community API
src/entities/community/api/communityService.ts - Community context
src/pages/community/CommunityContext.tsx
Backend domain services
- FastAPI application
backend/app/main.py - Assessment routes
backend/app/routers/tti.py - Matching routes
backend/app/routers/matches.py - Trip routes
backend/app/routers/trips.py - Attraction recommendations
backend/app/services/attraction_service.py - Itinerary planner
backend/app/planner - PostgreSQL data
backend/app/database.py
Safety and operations
- Safety and trust
backend/app/routers/safety.py - Admin operations
backend/app/routers/admin.py
Other components
- Traveler
- Travel data APIs
- OpenAI
Connections 28
- Traveler → OddTrip app: uses
- OddTrip app → Style assessment: routes to
src/app/App.tsx - OddTrip app → Match discovery: routes to
src/app/App.tsx - OddTrip app → Trip workspace: routes to
src/app/App.tsx - OddTrip app → Community pages: routes to
src/app/App.tsx - Style assessment → Trip state: records answers
- Match discovery → Trip state: uses match state
- Trip workspace → Trip state: uses trip state
- Trip state → Trip API service: requests trip data
src/entities/trip/model/tripStore.ts - Trip API service → HTTP client: sends requests
src/entities/trip/api/oddtripService.ts - Consent API → HTTP client: sends requests
src/entities/consent/api/consentService.ts - Community context → Community API: loads community data
src/pages/community/CommunityContext.tsx - Community API → HTTP client: sends requests
src/entities/community/api/communityService.ts - HTTP client → FastAPI application: calls API
- FastAPI application → Assessment routes: registers routes
backend/app/main.py - FastAPI application → Matching routes: registers routes
backend/app/main.py - FastAPI application → Trip routes: registers routes
backend/app/main.py - Trip routes → Attraction recommendations: serves recommendations
- Trip routes → Itinerary planner: generates schedules
- Travel data APIs → Attraction recommendations: supplies attractions
- OpenAI → Attraction recommendations: assists recommendations
- Traveler → Safety and trust: reports concerns
- Traveler → Admin operations: administers service
- FastAPI application → PostgreSQL data: persists domain data
- Traveler → Match discovery: completes assessment
- Match discovery → Trip workspace: continues after match
- Trip workspace → Itinerary planner: creates shared itinerary
- Trip workspace → Safety and trust: uses trust features