Analyze-Trip Enhancement - Flow Diagram

🔄 Processing Flow

┌─────────────────────────────────────────────────────────────────┐
│                     INPUT: Trip Request                          │
│  { destination, days: [{ date, places: [...] }], travelers }    │
└─────────────────────────────────────────────────────────────────┘
                              ↓
┌─────────────────────────────────────────────────────────────────┐
│              STEP 1: Analyze Trip Metrics                        │
│                                                                  │
│  For each day:                                                   │
│    For each place:                                               │
│      ✓ Calculate distance from previous place (Haversine)       │
│      ✓ Estimate travel time (distance ÷ 40 km/h)               │
│      ✓ Parse visit duration ("2 hours" → 120 min)              │
│                                                                  │
│    Calculate daily totals:                                       │
│      ✓ Total distance (sum of all distances)                    │
│      ✓ Total travel time (sum of all travel times)             │
│      ✓ Total visit time (sum of all visit durations)           │
│      ✓ Total time (travel + visit)                             │
│                                                                  │
│    Calculate density score:                                      │
│      density = (distance_km × 5 + time_hours × 10) ÷ places    │
│                                                                  │
│    Determine density level:                                      │
│      <20: low, 20-35: moderate, 35-50: high, ≥50: very_high    │
└─────────────────────────────────────────────────────────────────┘
                              ↓
┌─────────────────────────────────────────────────────────────────┐
│           STEP 2: Calculate Overall Metrics                      │
│                                                                  │
│  ✓ Total days                                                    │
│  ✓ Total places (across all days)                              │
│  ✓ Total distance (sum of all daily distances)                 │
│  ✓ Total time (sum of all daily times)                         │
│  ✓ Average density score (mean of daily scores)                │
│  ✓ Maximum density score (highest daily score)                 │
└─────────────────────────────────────────────────────────────────┘
                              ↓
┌─────────────────────────────────────────────────────────────────┐
│           STEP 3: Identify Decision Factors                      │
│                                                                  │
│  Analyze and record factors:                                     │
│                                                                  │
│  ✓ Density Level (PRIMARY FACTOR)                              │
│    - Very High (≥50): Strong positive impact                    │
│    - High (35-50): Positive impact                             │
│    - Moderate (20-35): Neutral impact                          │
│    - Low (<20): Negative impact                                │
│                                                                  │
│  ✓ Total Distance                                               │
│    - >100km: Positive impact                                    │
│    - 50-100km: Neutral impact                                   │
│                                                                  │
│  ✓ Time Commitment                                              │
│    - >8h/day: Positive impact                                   │
│                                                                  │
│  ✓ Group Size                                                   │
│    - ≥4 travelers: Positive impact                             │
│    - 1 traveler: Neutral impact                                │
│                                                                  │
│  ✓ Place Count                                                  │
│    - ≥5 places/day: Positive impact                            │
└─────────────────────────────────────────────────────────────────┘
                              ↓
┌─────────────────────────────────────────────────────────────────┐
│              STEP 4: Match Daily Tours                           │
│                                                                  │
│  Query database for active daily tours in region                │
│                                                                  │
│  For each tour:                                                  │
│    ✓ Extract place types from trip                             │
│    ✓ Compare with tour's related_place_types                   │
│    ✓ Calculate overlap score                                    │
│                                                                  │
│  Select best match (highest score ≥0.3)                        │
│                                                                  │
│  If match found:                                                 │
│    → Generate tour-specific reasoning                           │
│    → Boost confidence based on density score                    │
│    → Return recommendation with tour slug                       │
└─────────────────────────────────────────────────────────────────┘
                              ↓
                         Match Found?
                              ↓
                    ┌─────────┴─────────┐
                    │                   │
                   YES                 NO
                    │                   │
                    ↓                   ↓
    ┌───────────────────────┐  ┌──────────────────┐
    │  Return with Tour     │  │  Check Fallback  │
    │  Recommendation       │  │  (4+ travelers)  │
    │  + Debug Info         │  │                  │
    └───────────────────────┘  └──────────────────┘
                                        ↓
                                  ┌─────────┴─────────┐
                                  │                   │
                                 YES                 NO
                                  │                   │
                                  ↓                   ↓
                      ┌──────────────────┐  ┌────────────────┐
                      │ Suggest Private  │  │ Check Minimum  │
                      │ Guide            │  │ Criteria       │
                      │ + Debug Info     │  │                │
                      └──────────────────┘  └────────────────┘
                                                      ↓
                                              ┌───────┴───────┐
                                              │               │
                                            PASS            FAIL
                                              │               │
                                              ↓               ↓
                                    ┌─────────────┐  ┌──────────────┐
                                    │ Call AI for │  │ Return No    │
                                    │ Analysis    │  │ Recommend    │
                                    │             │  │ + Debug Info │
                                    └─────────────┘  └──────────────┘
                                              ↓
                                    ┌─────────────────┐
                                    │ AI analyzes     │
                                    │ with density    │
                                    │ metrics         │
                                    └─────────────────┘
                                              ↓
                                    ┌─────────────────┐
                                    │ Return AI       │
                                    │ Recommendation  │
                                    │ + Debug Info    │
                                    └─────────────────┘

📊 Density Score Calculation Detail

┌─────────────────────────────────────────────────────────────────┐
│                  DENSITY SCORE CALCULATION                       │
└─────────────────────────────────────────────────────────────────┘

Input:
  - totalDistanceKm: 85.0
  - totalTimeMinutes: 518
  - placeCount: 5

Step 1: Convert time to hours
  totalTimeHours = 518 ÷ 60 = 8.63

Step 2: Apply formula
  density = (distance × 5 + time × 10) ÷ places
  density = (85.0 × 5 + 8.63 × 10) ÷ 5
  density = (425 + 86.3) ÷ 5
  density = 511.3 ÷ 5
  density = 102.26

Step 3: Determine level
  102.26 ≥ 50 → VERY HIGH

Step 4: Calculate confidence
  confidence = 0.85 + (102.26 - 50) ÷ 100
  confidence = 0.85 + 0.52
  confidence = 1.37 → capped at 1.0
  confidence = 1.0

Result:
  ✓ Density Score: 102.26
  ✓ Density Level: VERY HIGH
  ✓ Recommendation: HIGHLY RECOMMEND
  ✓ Confidence: 1.0 (100%)

🎯 Decision Tree

                        Start Analysis
                              │
                              ↓
                    Calculate Density Score
                              │
                              ↓
                    ┌─────────┴─────────┐
                    │                   │
              Score ≥ 50           Score < 50
                    │                   │
                    ↓                   ↓
            ┌───────────────┐   ┌──────┴──────┐
            │ VERY HIGH     │   │             │
            │ Confidence:   │   │   Score ≥ 35│
            │ 0.85-1.0      │   │             │
            │               │   ↓             ↓
            │ Highly        │ ┌─────┐   ┌─────────┐
            │ Recommend     │ │HIGH │   │Score≥20 │
            │ Tour          │ │0.70-│   │         │
            └───────────────┘ │0.85 │   ↓         ↓
                              │     │ ┌────┐  ┌──────┐
                              │Rec  │ │MOD │  │ LOW  │
                              │Tour │ │0.50│  │<0.50 │
                              └─────┘ │-   │  │      │
                                      │0.70│  │Don't │
                                      │    │  │Rec   │
                                      │Opt │  └──────┘
                                      │Tour│
                                      └────┘

Legend:
  ■ VERY HIGH (≥50): 🔥 Highly Recommend (0.85-1.0)
  ■ HIGH (35-50):    ⭐ Recommend (0.70-0.85)
  ■ MODERATE (20-35): ⚠️ Optional (0.50-0.70)
  ■ LOW (<20):       ❌ Don't Recommend (<0.50)

🔍 Debug Info Structure

debug_info
├── dailyMetrics[]
│   ├── dayNumber
│   ├── date
│   ├── totalPlaces
│   ├── totalDistanceKm
│   ├── totalTravelTimeMinutes
│   ├── totalVisitTimeMinutes
│   ├── totalTimeMinutes
│   ├── densityScore
│   ├── densityLevel
│   └── places[]
│       ├── name
│       ├── type
│       ├── lat, lng
│       ├── distanceFromPreviousKm
│       ├── travelTimeFromPreviousMinutes
│       └── visitDurationMinutes
│
├── overallMetrics
│   ├── totalDays
│   ├── totalPlaces
│   ├── totalDistanceKm
│   ├── totalTimeHours
│   ├── averageDensityScore
│   └── maxDensityScore
│
├── decisionFactors[]
│   ├── factor (name)
│   ├── value (numeric or string)
│   ├── impact (positive/negative/neutral)
│   └── reasoning (explanation)
│
└── recommendation_reasoning (summary)

📈 Confidence Calculation Flow

┌─────────────────────────────────────────────────────────────────┐
│              CONFIDENCE CALCULATION ALGORITHM                    │
└─────────────────────────────────────────────────────────────────┘

Input: maxDensityScore

┌─────────────────────────────────────────────────────────────────┐
│ IF maxDensityScore ≥ 50                                         │
│   confidence = 0.85 + (maxDensityScore - 50) / 100             │
│   range: [0.85, 1.0]                                            │
│   recommendation: HIGHLY RECOMMEND                              │
└─────────────────────────────────────────────────────────────────┘
                              ↓
┌─────────────────────────────────────────────────────────────────┐
│ ELSE IF maxDensityScore ≥ 35                                    │
│   confidence = 0.70 + (maxDensityScore - 35) / 100             │
│   range: [0.70, 0.85)                                           │
│   recommendation: RECOMMEND                                     │
└─────────────────────────────────────────────────────────────────┘
                              ↓
┌─────────────────────────────────────────────────────────────────┐
│ ELSE IF maxDensityScore ≥ 20                                    │
│   confidence = 0.50 + (maxDensityScore - 20) / 100             │
│   range: [0.50, 0.70)                                           │
│   recommendation: OPTIONAL                                      │
└─────────────────────────────────────────────────────────────────┘
                              ↓
┌─────────────────────────────────────────────────────────────────┐
│ ELSE (maxDensityScore < 20)                                     │
│   confidence = maxDensityScore / 40                             │
│   range: [0.0, 0.50)                                            │
│   recommendation: DON'T RECOMMEND                               │
└─────────────────────────────────────────────────────────────────┘
                              ↓
┌─────────────────────────────────────────────────────────────────┐
│ IF confidence < 0.6                                             │
│   recommend = false                                             │
│   (Override any previous recommendation)                        │
└─────────────────────────────────────────────────────────────────┘

Examples:
  Score 102.26 → confidence = 0.85 + 52.26/100 = 1.37 → capped at 1.0
  Score 42.8   → confidence = 0.70 + 7.8/100 = 0.778
  Score 28.5   → confidence = 0.50 + 8.5/100 = 0.585
  Score 15.2   → confidence = 15.2/40 = 0.38 → recommend = false

🎨 Visual Density Scale

DENSITY SCORE VISUALIZATION

0 ────────── 20 ────────── 35 ────────── 50 ────────── 100+
│            │             │             │              │
│   LOW      │  MODERATE   │    HIGH     │  VERY HIGH   │
│            │             │             │              │
│ ✅ Self    │ ⚠️ Optional │ ⭐ Recommend│ 🔥 Highly   │
│   Plan     │    Tour     │    Tour     │   Recommend  │
│            │             │             │              │
│ Confidence │ Confidence  │ Confidence  │ Confidence   │
│ 0.0-0.48   │ 0.50-0.70   │ 0.70-0.85   │ 0.85-1.0     │
│            │             │             │              │
│ Examples:  │ Examples:   │ Examples:   │ Examples:    │
│ • 2 nearby │ • 4 places  │ • 5 places  │ • 4 places   │
│   places   │   45km      │   85km      │   90km       │
│ • 15km     │ • 6 hours   │ • 8.5 hours │ • 9+ hours   │
│ • 4 hours  │             │             │              │
└────────────┴─────────────┴─────────────┴──────────────┘

Status: ✅ Deployed and Active Version: 2.0 (Enhanced) Date: February 7, 2024

20 KiB Raw Permalink Blame History Unescape Escape

Analyze-Trip Enhancement - Flow Diagram

🔄 Processing Flow

📊 Density Score Calculation Detail

🎯 Decision Tree

🔍 Debug Info Structure

📈 Confidence Calculation Flow

🎨 Visual Density Scale

20 KiB

Raw Permalink Blame History