Calendar Docs

Zakres

Dokument opisuje pola używane w finalnych eventach merged calendar.

Publiczne strony dokumentacji:

• /calendar/docs/json-fields.php
• /calendar/docs/weekly-llm-payload.php
• /calendar/docs/weekly-context-api.php

Źródła Markdown nadal są w repo, ale publiczne linki powinny prowadzić przez te strony.

Normalization And Merge

• _normalized_name: znormalizowana nazwa
• _name_fingerprint: uproszczony fingerprint
• _canonical_holiday_key: semantyczny klucz używany do merge i blokowania over-merge
• sources: lista użytych źródeł
• source_count: ile źródeł weszło do finalnego eventu
• is_day_off_holiday: czy event jest traktowany jako realny dzień wolny

calendar_features

• day_of_week_start, day_of_week_end
• days_until_weekend
• adjacent_to_weekend
• adjacent_public_holiday_before, adjacent_public_holiday_after
• adjacent_off_days_before, adjacent_off_days_after
• bridge_day_potential
• long_weekend_potential: none, medium, high, natural

time_off_features

• daysOffInRow: pełne praktyczne okno wolnych dni
• workingDaysLost: dni robocze objęte samym eventem
• official_working_days_lost: oficjalnie utracone dni robocze dla day-off holidays
• bridgePotential: none, medium, high
• bridge_days_used
• off_day_pattern: np. single_midweek, bridge_candidate, monday_holiday, friday_holiday, natural_long_weekend, school_break
• travelWindow: from, to, type

travel_features

• travel_segment_tags: segmenty travel, np. leisure, city_break, family, vfr, school_break
• market_coverage: nationwide, multi_region, single_region
• travel_intensity_band: low, medium, high, peak
• travel_relevance_score: score 0-1
• vfr_relevance, family_travel_relevance
• business_travel_impact, leisure_travel_impact

travel_product_impact

Dwa główne produkty:

• flights
• holiday_packages

Każdy zawiera:

• direction: np. positive, neutral, neutral_to_positive, mixed
• strength: low, medium, high
• drivers: lista driverów wpływu

timing_effects

Model wpływu eventu na travel w trzech oknach:

• previous_week
• event_week
• next_week

Każde okno ma:

• direction
• strength
• effect_types

To jest odpowiedź na wpływ tydzień przed, w tygodniu święta i tydzień po święcie.

summary_inputs

To jest gotowy kontrakt wejściowy pod przyszły generator summary.

• event_identity
• time_off
• calendar_context
• travel_signal
• product_impact
• timing_effects
• llm_summary_ready

Następny krok może generować summary przez LLM bez ponownego liczenia feature engineering.