Randevu Takvimim

Randevu OLUŞTUR. KULLANICI ONAYI OLMADAN ÇAĞIRMA. Önce `get_available_slots` ile boş saat alınır, kullanıcıya saat + hizmet + ad/telefon GÖSTERİLİR ve ONAYI alınır; ancak ondan sonra bu araç çağrılır. start_at/employee_id: `get_available_slots` çıktısındaki slot'tan AYNEN kopyalanır (YEREL saat, +03:00 sonekli). Kendin saat hesaplama: UTC'ye çevirmek randevuyu 3 saat İLERİ atar (canlıda yaşandı 2026-09-22). service_ids: `get_salon`daki `services[].service_id`. booking_token: bu sürümde kullanılmaz, boş bırakılır (telefon doğrulaması bu uygulama üzerinden yapılmaz). Dönüş: {ok, appointment_id, start_at, end_at, total_price} ya da {ok:false, error} — dolu slot/geçersiz veri mesajı AYNEN iletilir.

create_booking

Bir günün BOŞ randevu saatleri. YALNIZ kayıtlı salonlarda çalışır. slug: get_salon/search_salons sonucundaki slug. date: "YYYY-MM-DD". service_ids: get_salon'daki `services[].service_id` (fiyat/süre buradan). duration_min: hizmet seçilmediyse varsayılan süre. Dönüş `slots[]`: {start_at, end_at, employee_id, employee_name}. Randevu için `create_booking`'e start_at + employee_id geçilir. ⏰ SAATLER İŞLETMENİN YEREL SAATİDİR (Türkiye, +03:00 sonekli). `start_at` damgasını kullanıcıya OLDUĞU GİBİ söyle ve `create_booking`'e AYNEN geçir — UTC'ye çevirme, saat ekleme/çıkarma YAPMA (canlıda 3 saat ileri randevu oluştu, 2026-09-22).

get_available_slots

Bir firmanın müşteri yorumları. HEM kayıtlı salon HEM keşfedilen (rehber) firma slug'ı kabul eder. slug search_salons/get_salon sonucundan gelir. `source`: "platform" = sitede toplanan doğrulanmış yorum; "public" = rehber kaydı — derlenmiş yorum metinleri bu kanalda verilmez, yalnız sayı + `url`.

get_reviews

Bir firmanın tam detayı: adres, koordinat, telefon, çalışma saatleri, hizmet+fiyat, puan, hakkında metni. HEM kayıtlı salon HEM keşfedilen (rehber) firma slug'ı kabul eder. slug search_salons sonucundan gelir.

get_salon

Tüm hizmet kategorileri: key (search_salons'ta kullanılır), etiket, firma sayısı. count = kayıtlı salon + KEŞFEDİLEN (rehber) firma toplamı → AI envanterin GERÇEK büyüklüğünü görür (keşfedilenler firmaların çoğu; yalnız kayıtlı sayılırsa 'berber=0' yanıltır). registered/discovered ayrı da döner. count=0 olan kategoride bu platformda hiç işletme yoktur.

list_categories

Firma barındıran şehirler + ilçeleri + firma sayısı (arama için konum envanteri). count = kayıtlı + KEŞFEDİLEN toplamı (keşfedilen firmalar dahil → gerçek envanter).

list_cities

Salon/işletme ara — HEM kayıtlı (online randevu alınabilir) HEM keşfedilen (rehber, doğrulanmamış) firmaları kapsar. city/district Türkçe ad (İstanbul, Kadıköy); category kanonik key (gelin_kuaforu, kuafor, berber, guzellik_merkezi, spa, tirnak — list_categories'e bak). sort: rating|name|newest. Her sonuçta `verified` (true=kayıtlı, false=keşfedilen rehber) + kaynak URL döner. Kayıtlı firmalar önce listelenir. ONLINE RANDEVU: bu uygulamayla yalnız `online_booking: true` işletmeden randevu alınabilir (`get_available_slots` → `create_booking`); `online_booking: false` kayıtlar rehber bilgisidir, yalnız telefonla ulaşılır. Yanıttaki `summary` hangi sonuçtan online randevu alınabildiğini tek cümlede söyler. Aranan ilçede online randevulu işletme yoksa aynı şehirdekiler `bookable_elsewhere_in_city` içinde AYRI döner; bunlar aranan ilçede DEĞİL, aynı şehrin başka ilçesindedir. DOĞAL DİL: query'ye TEK cümle yazılabilir ("sultanbeyli gelin kuaförü", "kadıköy berber", "ankara tırnak") — şehir/ilçe/kategori otomatik ayrıştırılır (city/district/category açık verilirse O korunur). Böylece ajan ilçe+kategoriyi tek stringde geçebilir. max_price (TL): "1000 TL altı kuaför" gibi sorgular için. YALNIZ kayıtlı (verified=true) firmalara uygulanır — keşfedilen rehber kayıtlarında fiyat bilgisi YOKTUR, o yüzden max_price verildiğinde yalnız kayıtlı firmalar döner (fiyatsız kaydı "ucuz" diye göstermek yanıltıcı olurdu).

search_salons