# jooho-le/oddtrip architecture

> Architecture diagram of the GitHub repository jooho-le/oddtrip, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-18). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/jooho-le/oddtrip
- Repository: https://github.com/jooho-le/oddtrip

## Overview

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: [`src/app/App.tsx`](https://github.com/jooho-le/oddtrip/blob/main/src/app/App.tsx) (OddTrip app), [`backend/app/main.py`](https://github.com/jooho-le/oddtrip/blob/main/backend/app/main.py) (FastAPI application), [`src/pages/trip/TripWorkspacePage.tsx`](https://github.com/jooho-le/oddtrip/blob/main/src/pages/trip/TripWorkspacePage.tsx) (Trip workspace), [`src/pages/matches/MatesPage.tsx`](https://github.com/jooho-le/oddtrip/blob/main/src/pages/matches/MatesPage.tsx) (Match discovery)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_experience["Traveler experience"]
  node_browser["OddTrip app<br/>[App.tsx]"]
  node_assessment["Style assessment<br/>[SurveyFormPage.tsx]"]
  node_matching["Match discovery<br/>[MatesPage.tsx]"]
  node_trip_workspace["Trip workspace"]
  node_community_ui["Community pages<br/>[CommunityPages.tsx]"]
end

subgraph group_frontend["Frontend state and API"]
  node_trip_state["Trip state<br/>[tripStore.ts]"]
  node_trip_api["Trip API service<br/>[oddtripService.ts]"]
  node_http_client["HTTP client<br/>[client.ts]"]
  node_consent_api["Consent API<br/>[consentService.ts]"]
  node_community_api["Community API"]
  node_community_context["Community context"]
end

subgraph group_backend["Backend domain services"]
  node_api_app["FastAPI application<br/>[main.py]"]
  node_tti_routes["Assessment routes<br/>[tti.py]"]
  node_match_routes["Matching routes<br/>[matches.py]"]
  node_trip_routes["Trip routes<br/>[trips.py]"]
  node_attraction_service["Attraction recommendations"]
  node_planner["Itinerary planner"]
  node_database[("PostgreSQL data<br/>[database.py]")]
end

subgraph group_operations["Safety and operations"]
  node_safety["Safety and trust<br/>[safety.py]"]
  node_admin["Admin operations<br/>[admin.py]"]
end

node_traveler(("Traveler"))
node_external_data{{"Travel data APIs"}}
node_openai{{"OpenAI"}}

node_traveler -->|"uses"| node_browser
node_browser -->|"routes to"| node_assessment
node_browser -->|"routes to"| node_matching
node_browser -->|"routes to"| node_trip_workspace
node_browser -->|"routes to"| node_community_ui
node_assessment -.->|"records answers"| node_trip_state
node_matching -.->|"uses match state"| node_trip_state
node_trip_workspace -.->|"uses trip state"| node_trip_state
node_trip_state -->|"requests trip data"| node_trip_api
node_trip_api -->|"sends requests"| node_http_client
node_consent_api -->|"sends requests"| node_http_client
node_community_context -->|"loads community data"| node_community_api
node_community_api -->|"sends requests"| node_http_client
node_http_client -.->|"calls API"| node_api_app
node_api_app -->|"registers routes"| node_tti_routes
node_api_app -->|"registers routes"| node_match_routes
node_api_app -->|"registers routes"| node_trip_routes
node_trip_routes -.->|"serves recommendations"| node_attraction_service
node_trip_routes -.->|"generates schedules"| node_planner
node_external_data -.->|"supplies attractions"| node_attraction_service
node_openai -.->|"assists recommendations"| node_attraction_service
node_traveler -.->|"reports concerns"| node_safety
node_traveler -.->|"administers service"| node_admin
node_api_app -.->|"persists domain data"| node_database
node_traveler -->|"completes assessment"| node_matching
node_matching -->|"continues after match"| node_trip_workspace
node_trip_workspace -->|"creates shared itinerary"| node_planner
node_trip_workspace -.->|"uses trust features"| node_safety

click node_browser "https://github.com/jooho-le/oddtrip/blob/main/src/app/App.tsx"
click node_assessment "https://github.com/jooho-le/oddtrip/blob/main/src/pages/survey/SurveyFormPage.tsx"
click node_matching "https://github.com/jooho-le/oddtrip/blob/main/src/pages/matches/MatesPage.tsx"
click node_trip_workspace "https://github.com/jooho-le/oddtrip/blob/main/src/pages/trip/TripWorkspacePage.tsx"
click node_community_ui "https://github.com/jooho-le/oddtrip/blob/main/src/pages/community/CommunityPages.tsx"
click node_trip_state "https://github.com/jooho-le/oddtrip/blob/main/src/entities/trip/model/tripStore.ts"
click node_trip_api "https://github.com/jooho-le/oddtrip/blob/main/src/entities/trip/api/oddtripService.ts"
click node_http_client "https://github.com/jooho-le/oddtrip/blob/main/src/shared/api/client.ts"
click node_consent_api "https://github.com/jooho-le/oddtrip/blob/main/src/entities/consent/api/consentService.ts"
click node_community_api "https://github.com/jooho-le/oddtrip/blob/main/src/entities/community/api/communityService.ts"
click node_community_context "https://github.com/jooho-le/oddtrip/blob/main/src/pages/community/CommunityContext.tsx"
click node_api_app "https://github.com/jooho-le/oddtrip/blob/main/backend/app/main.py"
click node_tti_routes "https://github.com/jooho-le/oddtrip/blob/main/backend/app/routers/tti.py"
click node_match_routes "https://github.com/jooho-le/oddtrip/blob/main/backend/app/routers/matches.py"
click node_trip_routes "https://github.com/jooho-le/oddtrip/blob/main/backend/app/routers/trips.py"
click node_attraction_service "https://github.com/jooho-le/oddtrip/blob/main/backend/app/services/attraction_service.py"
click node_planner "https://github.com/jooho-le/oddtrip/tree/main/backend/app/planner"
click node_database "https://github.com/jooho-le/oddtrip/blob/main/backend/app/database.py"
click node_safety "https://github.com/jooho-le/oddtrip/blob/main/backend/app/routers/safety.py"
click node_admin "https://github.com/jooho-le/oddtrip/blob/main/backend/app/routers/admin.py"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_browser,node_assessment,node_matching,node_trip_workspace,node_community_ui toneBlue
class node_trip_state,node_trip_api,node_http_client,node_consent_api,node_community_api,node_community_context toneAmber
class node_api_app,node_tti_routes,node_match_routes,node_trip_routes,node_attraction_service,node_planner,node_database,node_external_data toneMint
class node_safety,node_admin toneRose
class node_traveler,node_openai toneIndigo
```

## Components

### Traveler experience

- [OddTrip app](https://github.com/jooho-le/oddtrip/blob/main/src/app/App.tsx): `src/app/App.tsx`
- [Style assessment](https://github.com/jooho-le/oddtrip/blob/main/src/pages/survey/SurveyFormPage.tsx): `src/pages/survey/SurveyFormPage.tsx`
- [Match discovery](https://github.com/jooho-le/oddtrip/blob/main/src/pages/matches/MatesPage.tsx): `src/pages/matches/MatesPage.tsx`
- [Trip workspace](https://github.com/jooho-le/oddtrip/blob/main/src/pages/trip/TripWorkspacePage.tsx): `src/pages/trip/TripWorkspacePage.tsx`
- [Community pages](https://github.com/jooho-le/oddtrip/blob/main/src/pages/community/CommunityPages.tsx): `src/pages/community/CommunityPages.tsx`

### Frontend state and API

- [Trip state](https://github.com/jooho-le/oddtrip/blob/main/src/entities/trip/model/tripStore.ts): `src/entities/trip/model/tripStore.ts`
- [Trip API service](https://github.com/jooho-le/oddtrip/blob/main/src/entities/trip/api/oddtripService.ts): `src/entities/trip/api/oddtripService.ts`
- [HTTP client](https://github.com/jooho-le/oddtrip/blob/main/src/shared/api/client.ts): `src/shared/api/client.ts`
- [Consent API](https://github.com/jooho-le/oddtrip/blob/main/src/entities/consent/api/consentService.ts): `src/entities/consent/api/consentService.ts`
- [Community API](https://github.com/jooho-le/oddtrip/blob/main/src/entities/community/api/communityService.ts): `src/entities/community/api/communityService.ts`
- [Community context](https://github.com/jooho-le/oddtrip/blob/main/src/pages/community/CommunityContext.tsx): `src/pages/community/CommunityContext.tsx`

### Backend domain services

- [FastAPI application](https://github.com/jooho-le/oddtrip/blob/main/backend/app/main.py): `backend/app/main.py`
- [Assessment routes](https://github.com/jooho-le/oddtrip/blob/main/backend/app/routers/tti.py): `backend/app/routers/tti.py`
- [Matching routes](https://github.com/jooho-le/oddtrip/blob/main/backend/app/routers/matches.py): `backend/app/routers/matches.py`
- [Trip routes](https://github.com/jooho-le/oddtrip/blob/main/backend/app/routers/trips.py): `backend/app/routers/trips.py`
- [Attraction recommendations](https://github.com/jooho-le/oddtrip/blob/main/backend/app/services/attraction_service.py): `backend/app/services/attraction_service.py`
- [Itinerary planner](https://github.com/jooho-le/oddtrip/tree/main/backend/app/planner): `backend/app/planner`
- [PostgreSQL data](https://github.com/jooho-le/oddtrip/blob/main/backend/app/database.py): `backend/app/database.py`

### Safety and operations

- [Safety and trust](https://github.com/jooho-le/oddtrip/blob/main/backend/app/routers/safety.py): `backend/app/routers/safety.py`
- [Admin operations](https://github.com/jooho-le/oddtrip/blob/main/backend/app/routers/admin.py): `backend/app/routers/admin.py`

### Other components

- **Traveler**
- **Travel data APIs**
- **OpenAI**

## Connections

- Traveler → OddTrip app: uses
- OddTrip app → Style assessment: routes to (evidence: `src/app/App.tsx`)
- OddTrip app → Match discovery: routes to (evidence: `src/app/App.tsx`)
- OddTrip app → Trip workspace: routes to (evidence: `src/app/App.tsx`)
- OddTrip app → Community pages: routes to (evidence: `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 (evidence: `src/entities/trip/model/tripStore.ts`)
- Trip API service → HTTP client: sends requests (evidence: `src/entities/trip/api/oddtripService.ts`)
- Consent API → HTTP client: sends requests (evidence: `src/entities/consent/api/consentService.ts`)
- Community context → Community API: loads community data (evidence: `src/pages/community/CommunityContext.tsx`)
- Community API → HTTP client: sends requests (evidence: `src/entities/community/api/communityService.ts`)
- HTTP client → FastAPI application: calls API
- FastAPI application → Assessment routes: registers routes (evidence: `backend/app/main.py`)
- FastAPI application → Matching routes: registers routes (evidence: `backend/app/main.py`)
- FastAPI application → Trip routes: registers routes (evidence: `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
