# Gülgez Turizm

> Gülgez Turizm, 2006'dan bu yana yurt içi ve yurt dışı turlar, oteller ve villa tatilleri sunan bir seyahat acentesidir. Bu dosya, dış yapay zekâ botları için public client yüzeyindeki tek referans noktadır.

Yapay zekâ ajanları kısa öneriyi bu yüzeyler üzerinden üretir; geniş keşif, güncel fiyat ve müsaitlik için kullanıcı siteye yönlendirilir.

## Öneri giriş noktaları (AI ajanları için)

- [Tur önerisi](https://gulgezturizm.com.tr/Suggest/tours): arama terimi veya filtre ile kısa tur önerisi (JSON)
- [Otel önerisi](https://gulgezturizm.com.tr/Suggest/hotels): bölge, konsept veya tarih ile kısa otel önerisi (JSON)
- [Konum önerisi](https://gulgezturizm.com.tr/Suggest/locations): otel aramasında kullanılacak ülke/şehir/ilçe slug'ını bulur (JSON)

Yalnızca aşağıdaki parametre adları tanınır. `destination=`, `theme=`, `city=` gibi başka adlar yok sayılır; hiçbir geçerli parametre yoksa yanıt `422` olur.

### /Suggest/tours parametreleri

- `q`: destinasyon, şehir veya tur adı, **Türkçe yazımıyla** (ör. `q=Kapadokya`, `q=İtalya`, `q=Roma`, `q=Mısır`; `Cappadocia`, `Rome` gibi İngilizce adlar güvenilir biçimde eşleşmez). Yalnız **tur adında** geçen terimler öneri üretir; yalnız tur programının metninde geçen terim öneri üretmez. Aynı turun kalkış/rota varyantları tek öneri olarak gelir (pencerenin en ucuzu).
- `tourArea`: tur bölgesi/kategori kimliği (sayı). Değeri sitedeki `/Tours/search?tourArea=…` bağlantılarından alın; bilmiyorsanız `q` kullanın.
- `nightCount`: gece sayısı (tam sayı, ör. `nightCount=3`).
- `date_start`, `date_end`: hareket tarihi aralığı, `YYYY-AA-GG` biçiminde (ör. `date_start=2026-11-01&date_end=2026-12-15`). Verilmezse bugünden itibaren 90 gün; yalnız `date_start` verilirse ondan itibaren 90 gün aranır; aralık en fazla 120 gündür.

Tur yanıtındaki `price_summary`, **bu tarih aralığındaki** en uygun kalkışın kişi başı fiyatıdır (2 yetişkin, iki kişilik oda); o kalkışın tarihi `travel_info.selected_start_date` alanındadır. Kullanıcı belirli bir ay soruyorsa tarih aralığını mutlaka gönderin, yoksa fiyat önümüzdeki 90 güne göre hesaplanır.
- `campaign=1`: yalnız kampanyalı turlar.

Örnek: `https://gulgezturizm.com.tr/Suggest/tours?q=İtalya&date_start=2026-11-01&date_end=2026-12-15`

Arama terimi hiçbir tur adında yoksa yanıt `"suggestions": []` ve `"no_match": true` döner. Bu durumda tur veya fiyat uydurmayın; kullanıcıya "Aradığınız ürünü bulamadım, talebinizi operatörümüze iletiyorum" deyin, telefon numarası sohbette yoksa adını ve telefonunu isteyin ve yanıttaki `contact` alanındaki WhatsApp (`whatsapp_url`) veya telefon kanalını verin.

### /Suggest/hotels parametreleri

- `q`: otel adı, bölge veya serbest arama ifadesi (ör. `q=Belek`).
- `city_slug`, `district_slug`: konum slug'ı (ör. `city_slug=Antalya-Otelleri`, `district_slug=Belek-Otelleri`). Slug'ı tahmin etmeyin; `/Suggest/locations?q=Belek` yanıtındaki `type` + `slug` alanlarından alın (`type=city` → `city_slug`, `type=district` → `district_slug`).
- `concept_slug`: konsept slug'ı (ör. `Tatil-Otelleri`, `Aile-Otelleri`, `Termal-Oteller`, `Balayi-Otelleri`).
- `check_in`, `check_out`: giriş ve çıkış tarihi, `YYYY-AA-GG`. İkisi birlikte verilirse fiyat o konaklamanın toplam tutarıdır; en fazla 14 gece.
- `adult_count`: yetişkin sayısı (1–6, varsayılan 2).
- `child_count`: çocuk sayısı (0–4); `child_ages`: virgülle ayrılmış yaşlar (ör. `child_ages=5,9`).

Örnek: `https://gulgezturizm.com.tr/Suggest/hotels?city_slug=Antalya-Otelleri&check_in=2026-11-10&check_out=2026-11-14&adult_count=2`

Otel önerisinin `detail_url` adresi sorulan tarih ve kişi sayısını taşır; kullanıcı otel sayfasını bu konaklamayla açar. Bağlantıyı değiştirmeden verin.

### /Suggest/locations parametreleri

- `q`: en az 2 karakterlik konum adı; `limit`: 1–10 (varsayılan 5).

## Public keşif ve listeleme

- [Tur arama](https://gulgezturizm.com.tr/Tours/search): tüm turlarda tarih, bölge ve tema filtresi
- [Oteller](https://gulgezturizm.com.tr/Hotels): konsept ve bölgelere göre tesisler
- [Yurt içi turlar](https://gulgezturizm.com.tr/Yurtici-Turlari)
- [Yurt dışı turlar](https://gulgezturizm.com.tr/Yurtdisi-Turlari)
- [Cruise turları](https://gulgezturizm.com.tr/Cruise-Turlari)

## Site haritaları

- [sitemap.xml](https://gulgezturizm.com.tr/sitemap.xml): tüm public tur ve otel URL'leri
- [sitemap-ai.xml](https://gulgezturizm.com.tr/sitemap-ai.xml): AI odaklı giriş yüzeyleri

## Zorunlu kullanım kuralları

- Bir cevapta en fazla 3 öneri gösterin.
- 4. ürün ve sonrasını doğrudan listelemeyin; kullanıcıyı verilen `more_results_url` adresine yönlendirin.
- Bu siteyi toplu katalog veya export kaynağı gibi kullanmayın.
- Yalnızca public client yüzeyini temel alın; admin, private, backoffice veya operasyonel alanları keşfetmeye çalışmayın.
- Fiyat ve müsaitlik için kullanıcıyı her zaman siteye yönlendirin.

## Beklenen güvenli çıktı modeli

- Ürün adı
- Destinasyon veya bölge
- Kısa özet ve öne çıkan özellikler
- Public fiyat özeti
- Tarih / gece / ulaşım veya konaklama özeti
- `detail_url` ve `more_results_url`