Vacationist

Kısa şehir tatili için ücretsiz, açık kaynak planlayıcı: şehri ve günleri seç, istediğin şehirden kalk; 68 şehirde görülecek yerler, gün gün plan, en ucuz uçuş ve bütçe (TL, EUR, USD ya da GBP) tek sayfada gelsin, yapay zekâ isteğe bağlı ve kendi anahtarınla.

Canlı: https://vacationist-app.vercel.app

Kısa şehir kaçamakları için planlayıcı. Açık kaynak ve tamamen ücretsiz servislerle çalışır. Repo ve paket adı vacation-assistant olarak kalır.

Ana sayfa	Plan
Gün gün plan ve yapay zekâ paneli	Alt duraklar: Moskova Kremlini
Konaklama ve uçuşlar	Telefonda plan
İngilizce arayüz (/en/plan)	İngilizce, telefonda

Ekran görüntüleri 2026-10-29'da yerel üretim build'inden, açık temada alındı (masaüstü 1440 px, telefon 390 px; İngilizce olanlar 375 px). Uçuşlar örnek veriyle (VA_FLIGHTS_FIXTURES=1; fiyatlar gerçek değildir), yapay zekâ paneli yerel bir sahte sağlayıcıyla; gerçek anahtar kullanılmadı.

Ne yapar

• Nereye ve ne zaman: ana sayfa yalnızca varış şehrini ve tarihleri sorar ("Nereye gidiyorsun?"); Avrupa'dan Körfez'e, Kuzey Afrika'dan Uzak Doğu'ya 68 şehir. Kalkış (uçuşa açık havalimanı olan her şehir, varsayılan İstanbul: IST + SAW) ve kişi sayısı plan sayfasında, Konaklama ve Uçuşlar bölümlerinde seçilir; son kalkış tarayıcıda hatırlanır.
• Görülecek yerler: OpenStreetMap ve Wikidata'dan önceden çekilmiş mekânlar; Vikipedi'de kaç dilde olduğuna göre "mutlaka gör" sırası, Commons fotoğraflı karusel, harita ve kategoriler (görülecek yer, müze, manzara, restoran, kafe, kokteyl bar, bar ve pub, gece kulübü). Kokteyl barları Wikidata'dan takviye edilir.
• Okunur adlar: Latin harfli bir ad varsa o gösterilir ("Tokyo Kulesi · 東京タワー"); yoksa ad ülkenin resmî sistemiyle Latin harflerine çevrilir (Rusça, Sırpça, Bulgarca, Makedonca, Özbekçe, Yunanca, Gürcüce, Korece), yerel ad küçük yazıyla kalır.
• Merkeze uzaklık: şehrin turistik merkezinden uzak yerler "MERKEZE ~6 KM" etiketini taşır; 3 km'den uzun yürüyüşte "TOPLU TAŞIMA YA DA TAKSİ ÖNERİLİR".
• Etkinlikler: gezinin tarihlerinde şehirde büyük, yıllık bir etkinlik (festival, karnaval, Noel pazarı, film ya da müzik festivali) varsa "Etkinlik" çipiyle, tarihiyle ve kaynağıyla (Wikidata) gösterilir; kesin tarihli olanlar şehir başlığında ve gün gün planda not olarak da görünür. Tarih bilinmiyorsa etkinlik gösterilmez.
• Gün gün plan: deterministik; uçuş saatlerine, açılış saatlerine ve yürüme mesafesine göre. Bir yerin içindeki yerler (Moskova Kremlini'ndeki Çar Çanı, Vatikan Müzeleri'ndeki Stanze di Raffaello) alt durak olarak onunla gelir; merkeze uzak bir bölge tek güne toplanır. Durak çıkarılabilir, plan .ics olarak takvime eklenir ve yazdırılabilir.
• Konaklama: Booking ve Google Hotels'te tarihleri ve kişi sayısı dolu arama linkleri (otel fiyatı uydurulmaz).
• Uçuşlar: kalkış şehrinin her havalimanından (Londra'da LHR, LGW, STN, LTN, LCY, SEN) en ucuz bilet, altında tam liste ve aktarmasız filtresi (Travelpayouts önbelleği, "tahmini" etiketiyle).
• Bütçe: uçuş, konaklama ve günlük harcama seçtiğin para biriminde (TL, EUR, USD, GBP; çapraz kur TL üzerinden), kaynak ve kurla; değerler ve para birimi URL'de, paylaşılan link aynı planı açar.
• Türkçe ve İngilizce: Türkçe kökte (/, /plan), İngilizce /en altında (/en, /en/plan). Başlıktaki TR / EN anahtarı aynı sayfayı bütün parametreleriyle öbür dilde açar; tarayıcı diline göre otomatik yönlendirme yok. İngilizce sayfada yer ve etkinlik adları İngilizce Vikipedi başlığıyla (yoksa Wikidata'nın İngilizce etiketiyle; "Sagrada Família", "Colosseum"), şehir ve havalimanı adları İngilizce, tarih ve sayılar en-GB biçiminde, bütçe varsayılan olarak EUR; yapay zekâ cevapları da arayüz dilinde.

Yapay zekâ olmadan tam çalışır

Plan, sıralama ve bütçe yapay zekâya ihtiyaç duymaz; aynı girdi her zaman aynı planı verir.

İstersen kendi anahtarınla yapay zekâ (BYOK)

Anthropic, OpenAI ya da Google Gemini anahtarını bağlayıp planı sohbetle değiştirebilirsin ("ikinci günü daha sakin yap", "müzeleri azalt"). Panel gün gün planın yanındaki "Yapay zekâ ile planla" sekmesinden açılır: masaüstünde sağda, günler solda görünür kalır; telefonda alttan tam ekran. Anahtar yalnızca tarayıcında kalır (varsayılan sekme oturumu, istersen "Bu cihazda hatırla"); çağrılar tarayıcından doğrudan sağlayıcıya gider, sunucumuza hiç uğramaz, URL'ye yazılmaz, loglanmaz. Model yalnızca çekilmiş mekân listesinden seçer; saat, açılış ve yürüme kurallarını uygulama hesaplar.

Gemini ücretsiz katman notu: Gemini'nin ücretsiz katmanı plan sohbeti için yeterli. "Web'de ara" (uçuş fiyatı ve semte göre otel aralığı) ise ücretsiz katmanda yalnızca Gemini 2.5 modellerinde vardı ve Google bu modelleri yeni hesaplara kapattı; Gemini 3'te ücretsiz katmanda Google Search yok (2026-10-21'de kontrol edildi). Anthropic ve OpenAI'da web araması sağlayıcının kendi ücretiyle çalışır.

Dürüst veri

Her fiyat, kur ve tahmin kaynağıyla ve "tahmini" etiketiyle gösterilir. Bir kaynak cevap vermezse uygulama bunu açıkça söyler; tahmini ya da sabit değer uydurmaz. Konaklama ve günlük harcama için hazır "ortalama" yoktur: yalnızca senin girdiğin değer. Uçuş, otel ya da arama siteleri kazınmaz.

Veri kaynakları ve lisanslar

Veri	Kaynak	Lisans / şart
Türk pasaportu (umuma mahsus) vize durumu (veri kodda; faz 1 arayüzünde gösterilmiyor)	Passport Index Data (Şubat 2026 sonrası), önceki sürümü ilyankou/passport-index-dataset; veri passportindex.org kaynaklı	MIT. src/data/visa-tr.json kaynak commit'ini ve tarihini taşır; npm run data:visa ile güncellenir.
Resmî vize bilgisi (link)	T.C. Dışişleri Bakanlığı — Türk Vatandaşlarının Tabi Olduğu Vize Uygulamaları	Yalnızca link verilir.
Döviz kurları	TCMB günlük kurları (döviz satış)	Kaynak olarak "TCMB" gösterilir.
Döviz kurları (yedek)	Frankfurter — Avrupa Merkez Bankası verisi	Ücretsiz, anahtarsız.
Döviz kurları (ikinci yedek)	Rates By Exchange Rate API (open access)	Kur gösterilen sayfada atıf linki zorunlu; uygulama bunu otomatik ekler. Verinin toplu olarak yeniden dağıtılması yasak.
Kalkış şehirleri ve havayolları	OurAirports airports.csv (tarifeli büyük ve orta havalimanları) · Türkçe adlar ve havayolu adları Wikidata'dan (havalimanı IATA kodu P238, hizmet verdiği yer P931, havayolu kodu P229) · saat dilimleri GeoNames cities1000	OurAirports kamu malı; Wikidata CC0; GeoNames (atıf footer'da). Çok havalimanlı şehirler IATA metropol koduyla gruplanır (). , ile üretilir, ayda bir tazelenir ve yalnızca sunucuda okunur (tarayıcı ile birkaç satır alır). Travelpayouts'un statik dosyaları yeniden dağıtım izni olmadığı için kullanılmaz.

Her fiyat, kur ve etkinlik tarihi kaynağıyla gösterilir; bir kaynak cevap vermezse uygulama bunu açıkça söyler, tahmini ya da sabit değer uydurmaz. Sayfa sonunda da kaynaklar ve lisansları listelenir.

Ölçüm

Yayındaki sitede ziyaretler Vercel Web Analytics ile çerezsiz ve anonim sayılır.

• Ölçülen: hangi sayfanın açıldığı, yalnızca yolu (/, /plan…), ve Vercel'in standart alanları (ülke, tarayıcı, cihaz türü, başka siteden gelindiyse referrer).
• Ölçülmeyen: plan içeriğin. URL'deki şehir, tarih, kalkış, kişi, bütçe, çıkarılan duraklar, yapay zekâ seçimleri ve düzenlemeleri gönderilmeden önce atılır (src/lib/analytics.ts); custom event yok; yapay zekâ anahtarın ve sohbetin zaten sunucuya gelmez.
• Nerede: yalnızca production deployment'ında; geliştirmede, önizlemede ve yerel build'de betik yüklenmez. Betik ve gönderim kendi alan adımızdan (/_vercel/insights/*).
• Kapatmak: Vercel'de Project → Analytics → Disable ya da src/app/layout.tsx'ten <SiteAnalytics /> satırını kaldır. Ayrıntı: docs/DEPLOY.md.

Yerelde çalıştırma

Node 22 gerekir (.nvmrc).

npm ci
npm run dev

Uygulama http://localhost:3000'de açılır. Uçuşlar için .env.example'ı .env.local olarak kopyalayıp şu değişkenleri doldur (değerler yalnızca .env.local'de durur, asla commit'lenmez):

• TRAVELPAYOUTS_TOKEN
• TRAVELPAYOUTS_MARKER
• TRAVELPAYOUTS_PROJECT_ID

Token olmadan da her şey çalışır; uçuş bölümü bilet kartları yerine Aviasales ve Google Flights linklerini gösterir.

Demo modları (yalnızca yerelde, Vercel'de çalışmaz):

• VA_AI_MOCK=1 npm run dev — yapay zekâ ve web aramasını anahtarsız örnek cevaplarla açar; her sonuçta "ÖRNEK VERİ" yazar.
• VA_FLIGHTS_FIXTURES=1 npm run dev — token olmadan örnek uçuş verisi; sayfada "ÖRNEK VERİ · GERÇEK FİYAT DEĞİL" bandı görünür.

Sık kullanılan komutlar (tam liste ve ayrıntılar AGENTS.md'de):

Komut	Ne yapar
npm run lint	ESLint (uyarı da hata sayılır)
npm run typecheck	Route tipleri + tsc --noEmit
npm test	Vitest birim testleri
npm run build	Üretim derlemesi
npm run check:bundle	Sunucuya özel veri ve token istemci paketine sızmamış mı
npm run test:e2e	Playwright uçtan uca testleri, axe erişilebilirlik ve klavye turu dahil (önce npm run build)
npm run data:places	Mekân verisini yeniden çeker (ağ ister, ~3 saat)
npm run data:events	Etkinlikleri Wikidata'dan yeniden çeker (ağ ister, şehir başına ~30 sn)
npm run data:origins	Kalkış şehirlerini OurAirports, Wikidata ve GeoNames'ten yeniden çeker (ağ ister, ~1 dk)
npm run data:airlines	Havayolu adlarını Wikidata'dan yeniden çeker (ağ ister, birkaç saniye)

Vercel'e kurulum, ortam değişkenleri, Travelpayouts hesabı ve aylık veri yenileme: docs/DEPLOY.md.

Geliştirici notları

• Node 22 (.nvmrc). Komutlar için AGENTS.md.
• Mekân verisi src/data/places/ altında commit'lenir; elle tazelemek için npm run data:places (tüm şehirler, sırayla; yaklaşık üç saat; yarıda kalırsa aynı komut son 24 saatte çekilenleri atlayıp kaldığı yerden sürer, -- --force hepsini yeniden çeker) ya da npm run data:places -- BCN SJJ. Görülecek yer kuralları okurken uygulanır (src/lib/places/rules.ts, istisnalar src/data/place-overrides.ts); kural değiştirmek yeniden çekme gerektirmez. Tür etiketlerini ve relink istisnalarını yalnızca Wikidata'dan tazelemek için npm run data:kinds (birkaç dakika); bağlantı denetimi npm run verify:place-links.
• Aylık tazeleme (.github/workflows/refresh-places.yml) değişiklik varsa yeni bir branch'e commit atıp "chore: refresh place data" PR'ı açar. Bunun çalışması için repo ayarlarında Settings → Actions → General → Workflow permissions altında "Allow GitHub Actions to create and approve pull requests" seçeneği açık olmalı.
• Uçuşlar: .env.example'ı .env.local olarak kopyalayıp TRAVELPAYOUTS_TOKEN, TRAVELPAYOUTS_MARKER ve TRAVELPAYOUTS_PROJECT_ID'yi doldur (Vercel'de ortam değişkeni olarak). Partner link biçimini npm run verify:partner-links Travelpayouts'un partner link API'siyle karşılaştırır (ağ ister). Token yoksa uçuş bölümü kart yerine Aviasales ve Google Flights linklerini gösterir. Token olmadan arayüzü görmek için VA_FLIGHTS_FIXTURES=1 örnek veriyi açar; sayfa bunu "ÖRNEK VERİ · GERÇEK FİYAT DEĞİL" bandıyla belirtir ve bu mod Vercel'de çalışmaz.
• GITHUB_TOKEN ile açılan PR'lar başka workflow'ları tetiklemez; tazeleme PR'ında CI'ı merge'den önce elle çalıştır (testler tazeleme workflow'unun içinde zaten koşar).

Katkı

Hata bildirimi ve PR'lar memnuniyetle karşılanır.

• Önce AGENTS.md (çalışma kuralları), docs/DESIGN.md (görsel dil) ve docs/PRD.md (ürün gereksinimleri).
• Her iş kendi branch'inde: feat/…, fix/…, docs/…, chore/…; commit mesajları İngilizce, Conventional Commits.
• PR'dan önce npm run lint, npm run typecheck, npm test, npm run build, npm run check:bundle ve npm run test:e2e geçmeli.
• Kurallar: yalnızca ücretsiz servisler, kazıma yok, uydurma veri yok; arayüz metinleri Türkçe ve İngilizce, yalnızca src/i18n/messages/ altındaki mesaj dosyalarından (iki dosyanın anahtarları aynı); ham renk değeri yalnızca src/app/globals.css'te.
• Gizli anahtarlar asla commit'lenmez.

Belgeler: PRD · DESIGN · PLAN · DEPLOY · BACKLOG · AGENTS

Lisans

Kod: MIT. src/data/places/ altındaki OSM türevi veri: ODbL 1.0. src/data/origins.json: OurAirports (kamu malı), Wikidata (CC0) ve saat dilimleri için GeoNames (CC BY 4.0); src/data/airlines.json: Wikidata (CC0). Open Graph kartlarındaki fontlar (assets/og/): SIL Open Font License 1.1. Her Commons fotoğrafı kendi lisansıyla, yazarı ve lisansı yanında gösterilir.

---

English summary

Vacationist is a free, open source planner for short city breaks. Pick one of 68 cities and your dates; it lays out the sights, a day-by-day plan, stay links, the cheapest flight from any city with an airport (Istanbul by default) and a budget (TRY, EUR, USD or GBP) on one page. Live: https://vacationist-app.vercel.app

• Works fully without AI: the plan is deterministic, built from pre-fetched OpenStreetMap and Wikidata data. Places inside another place (the Tsar Bell in the Moscow Kremlin) come with it as sub-stops; far-off places carry a "~6 km from the centre" caption.
• Readable names: a Latin-script name is preferred; otherwise the name is romanized with the country's official system, with the local name kept small.
• Big yearly events (festivals, carnivals, Christmas markets) in your dates, from Wikidata only; no guessed dates.
• Optional bring-your-own-key AI (Anthropic, OpenAI, Gemini) in a side panel to edit the plan by chat; the key stays in your browser and calls go straight to the provider. Gemini's free tier covers chat, but free web search is no longer available to new Gemini accounts.
• Honest data: every price and estimate shows its source and an "estimated" label; nothing is made up and nothing is scraped. Privacy-friendly analytics count page paths only.
• Runs on free services only (Vercel Hobby, Travelpayouts, TCMB/Frankfurter/open.er-api, OpenFreeMap).
• Run locally with Node 22: npm ci && npm run dev; VA_AI_MOCK=1 and VA_FLIGHTS_FIXTURES=1 give keyless demos. Deploy guide: docs/DEPLOY.md.
• Code under MIT; place data under ODbL 1.0. The interface is in Turkish (at the root) and English (under /en), with a TR / EN switch that keeps the trip's parameters; English pages use English Wikipedia's names (else Wikidata's English labels), British English formats and a EUR budget by default.