38980-vm/app-9w9pd00g5j41/DEVELOPER_QUICK_REFERENCE.md

LetsGoCappadocia - Geliştirici Hızlı Referans

🎯 Platform Özeti

LetsGoCappadocia, Kapadokya destinasyonuna özel bir seyahat planlama platformudur.

🔑 Temel Özellikler

1. Sabit Destinasyon

// Destinasyon her zaman Kapadokya'dır
const FIXED_DESTINATION = 'Kapadokya, Türkiye';
const FIXED_COORDINATES = {
  lat: 38.6431,
  lng: 34.8289
};

2. Kapadokya Kuralları

Dosya: src/config/cappadocia-rules.ts

// Balon uçuşu kuralları
TRIP_RULES.balloon = {
  max_per_trip: 1,        // Seyahat başına 1 kez
  time_block: 'sunrise',  // Sadece gün doğumunda
  preferred_day: 2        // Tercihen 2. gün
}

// Otel kuralları
TRIP_RULES.hotel = {
  max_per_trip: 1,           // Tek otel
  role: 'base_location',     // Başlangıç noktası
  show_in_timeline: false    // Timeline'da gösterilmez
}

// Günlük limitler
DAY_RULES = {
  max_places: 5,           // Günde max 5 yer
  min_places: 3,           // Günde min 3 yer
  time_blocks: ['morning', 'afternoon', 'evening'],
  min_gap_minutes: 30      // Yerler arası min 30 dk
}

📁 Değiştirilen Dosyalar

1. Marka Referansları

# HTML başlık
index.html
  → <title>LetsGoCappadocia - Kapadokya Seyahat Planlama</title>

# Footer
src/components/common/Footer.tsx
  → © 2026 LetsGoCappadocia. Tüm hakları saklıdır.

# Ana sayfa
src/pages/Home.tsx
  → Hero: "Kapadokya seyahatinizi mükemmel şekilde planlayın"
  → Testimonials: "Binlerce gezgin LetsGoCappadocia kullanarak..."

# İşletme paneli
src/pages/business/BusinessDashboard.tsx
  → "LetsGoCappadocia'da işletmenizi tanıtarak..."

src/pages/business/BusinessRegister.tsx
  → "LetsGoCappadocia'ya katılın..."

2. Destinasyon Kilidi

// src/pages/CreateTrip.tsx
<Input 
  id="destination" 
  value="Kapadokya, Türkiye"
  className="pl-10 h-12 bg-muted cursor-not-allowed"
  disabled
  readOnly
/>

🛠️ Geliştirme Komutları

# Projeyi çalıştır
npm run dev

# Lint kontrolü
npm run lint

# Build
npm run build

# Test
npm run test

📋 Yeni Özellik Eklerken Dikkat Edilecekler

1. Destinasyon Kontrolü

// ❌ YANLIŞ - Kullanıcıdan destinasyon alma
const destination = userInput.destination;

// ✅ DOĞRU - Sabit destinasyon kullan
const destination = 'Kapadokya, Türkiye';

2. Yer Ekleme Kuralları

// Balon uçuşu eklerken
if (placeType === 'hot_air_balloon') {
  // Trip'te zaten balon var mı kontrol et
  if (tripHasBalloon) {
    throw new Error('Seyahatte zaten balon uçuşu var');
  }
  // Sadece 2. güne ekle (veya 1 günlük seyahatte 1. güne)
  if (dayIndex !== 1 && totalDays > 1) {
    throw new Error('Balon uçuşu sadece 2. güne eklenebilir');
  }
}

// Günlük yer limiti kontrolü
if (dayPlaces.length >= DAY_RULES.max_places) {
  throw new Error(`Günde maksimum ${DAY_RULES.max_places} yer eklenebilir`);
}

3. Marka Tutarlılığı

// ❌ YANLIŞ
const appName = 'Wanderlog';

// ✅ DOĞRU
const appName = 'LetsGoCappadocia';

🎨 UI/UX Kuralları

1. Destinasyon Alanı

• Her zaman disabled ve readOnly
• Arka plan: bg-muted (gri)
• İmleç: cursor-not-allowed
• Bilgilendirme mesajı göster

2. Kapadokya Teması

• Kapadokya görselleri kullan
• Peribacaları, balon, kaya kiliseleri vb.
• Renk paleti: Toprak tonları, turuncu, kırmızı

3. İçerik Tonu

• Kapadokya odaklı
• Yerel deneyimler vurgusu
• "Keşfet", "Deneyimle", "Yaşa" gibi kelimeler

🔍 Hata Ayıklama

Destinasyon Değişmiyor

// CreateTrip.tsx'te kontrol et
const destination = 'Kapadokya, Türkiye'; // Sabit olmalı

// Input disabled mi?
<Input disabled readOnly value="Kapadokya, Türkiye" />

Balon Uçuşu Eklenemiyor

// cappadocia-rules.ts'yi kontrol et
console.log(TRIP_RULES.balloon.max_per_trip); // 1 olmalı
console.log(tripHasBalloon); // false olmalı

// Gün kontrolü
console.log(dayIndex); // 1 olmalı (2. gün)

Günde 5'ten Fazla Yer Ekleniyor

// DAY_RULES kontrolü
console.log(DAY_RULES.max_places); // 5 olmalı
console.log(dayPlaces.length); // 5'ten az olmalı

📚 İlgili Dosyalar

Konfigürasyon

• src/config/cappadocia-rules.ts - Kapadokya kuralları
• src/types/index.ts - TypeScript tipleri

Sayfalar

• src/pages/CreateTrip.tsx - Seyahat oluşturma
• src/pages/Home.tsx - Ana sayfa
• src/pages/TripPlanner.tsx - Seyahat planlayıcı

Bileşenler

• src/components/common/Footer.tsx - Footer
• src/components/common/Header.tsx - Header

API

• src/db/api.ts - Supabase API fonksiyonları

🚀 Deployment Kontrol Listesi

• Tüm "Wanderlog" referansları "LetsGoCappadocia" ile değiştirildi
• Destinasyon "Kapadokya, Türkiye" olarak sabitlendi
• Kapadokya kuralları aktif
• Görseller Kapadokya temalı
• Meta tags güncellendi
• SEO ayarları Kapadokya odaklı
• Lint hataları giderildi
• Build başarılı
• Test senaryoları geçti

📞 Destek

Sorularınız için:

• Dokümantasyon: docs/prd.md
• Değişiklik özeti: BRAND_TRANSFORMATION_SUMMARY.md
• Kontrol listesi: TRANSFORMATION_CHECKLIST.md
• Karşılaştırma: BEFORE_AFTER_BRAND_COMPARISON.md

---

Platform: LetsGoCappadocia
Versiyon: 1.0.0
Tarih: 2026-02-10
Durum: ✅ Aktif