🚀 Genel Bakış

Android Tek Otel Uygulaması, bağımsız oteller, butik resortlar, villalar ve misafirhaneler için tasarlanmış, üretime hazır bir mobil uygulamadır.
Konuklar oda ve süitleri keşfedebilir, bir medya galerisine göz atabilir, tesisi Google Haritalar'da görüntüleyebilir ve kuponlar ve özel isteklerle güvenli bir rezervasyon akışını tamamlayabilir.
OTA komisyonlarını azaltmak ve misafir ilişkilerini geliştirmek amacıyla doğrudan rezervasyon için optimize edilmiştir.

Deneyim (E): Keşiften onaya kadar sürtüşmeleri en aza indirmek ve iptal edilen rezervasyonları azaltmak için gerçek ön büro iş akışlarından (fiyat planları, doluluk kuralları, indirim dışı tarihler ve eklentiler (ör. kahvaltı, havaalanında karşılama)) oluşturulmuştur.

✨ Temel Özellikler

• 🛏️ Oda Kataloğu: Fotoğraflı oda tipleri, olanaklar, doluluk, yatak tipleri, iade edilebilir/geri ödemesiz fiyatlar.
• 📅 Rezervasyon Motoru: Takvimin kullanılabilirliği, minimum/maks gece sayısı, misafirler/çocuklar, promosyon kodları ve eklentiler.
• 💳 Ödemeler: Şerit / PayPal / Razorpay / Varışta Nakit; isteğe bağlı ön kimlik doğrulama veya para yatırma kuralları.
• 🖼️ Galeri ve Medya: Odalar, tesisler, yemek, spa ve etkinlikler için resim/video karuselleri.
• 🗺️ Harita ve Yol Tarifleri: Navigasyon için işaretçiler, mesafe ve "Haritalarda Aç" özelliğine sahip Google Haritalar.
• 📝 Koşullar ve Ev Kuralları: Giriş/çıkış, iptal, çocuk/ilave yatak, evcil hayvan koşulları.
• 🌐 Çoklu Dil ve Para Birimi: Yerelleştirme + para birimi biçimlendirmesi; RTL desteği.
• 🔔 Bildirimler: Rezervasyon onayları, hatırlatıcılar, teklifler ve sezonluk paketler için FCM push.
• 📈 Analytics: Dönüşüm, dönüşüm hunisi adımları ve kampanya ilişkilendirme kancaları.
• 🧾 Makbuzlar ve Faturalar: Markalı e-posta/SMS onayı ve indirilebilir PDF kuponları.
• 🛡️ Güvenlik: PCI uyumlu istemci akışları, HTTPS, belirtilmiş istekler ve API uç noktalarında hız sınırlaması.
• 🎨 Markalama: Tek bir gerçek kaynaktan yapılandırılabilen tema renkleri, tipografi ve ikonografi.

⚙️ Teknik Yığın (Uzmanlık)

• Mobil: Flutter 3.x (Dart 3, Material 3) veya Native Android (Kotlin) derleme çeşidi.
• Arka Uç Seçenekleri: JWT/REST ile Laravel 10 (PHP 8.1+) REST API veya WordPress (Woo/Özel CPT).
• Veritabanı: MySQL 8 / MariaDB 10.6+; isteğe bağlı Redis önbelleği ve kuyrukları.
• Haritalar ve Coğrafya: Google Haritalar SDK'sı + Coğrafi Kodlama/Yerler API'leri.
• Ödemeler: Stripe, PayPal, Razorpay, Flutterwave (takılabilir ağ geçidi katmanı).
• Bildirimler: Firebase Cloud Messaging (FCM) + Crashlytics/Analytics (isteğe bağlı).
• Sunucu Gereksinimleri: Nginx/Apache, HTTPS/TLS 1.2+, PHP uzantıları (pdo_mysql, curl, mbstring, json, openssl).
• Araçlar: Android Studio, Gradle 8+, Node 18+ (varlıklar), Composer 2.x, Docker'a hazır.

🧩 Kurulum Kılavuzu

1. Arka uç: Laravel/WordPress'i dağıtın, .env'yi (DB, posta, ödeme anahtarları) ayarlayın, ardından php artisan merge --seed (Laravel) komutunu çalıştırın veya gerekli WP eklentilerini etkinleştirin.
2. Katalog: Yönetici panelinde oda türleri, fiyat planları, indirim dışı tarihler, eklentiler, vergiler/ücretler oluşturun.
3. Mobil: Flutter projesini açın → lib/config.dart'ı güncelleyin (API_BASE_URL, anahtarlar) → flutter pub get.
4. Haritalar ve Ödemeler: AndroidManifest.xml dosyasına Google Haritalar anahtarını ve sunucu ortamına ağ geçidi kimlik bilgilerini ekleyin.
5. Markalama: Simgeleri/sıçramayı değiştirin ve theme.dart'ı (renkler/tipografi) düzenleyin. Yöneticiden logo yükleyin.
6. Derleme: flutter build apk --release (Android) veya flutter build ios (isteğe bağlı iOS derlemesi).

📦 Teslimatlar

• ✅ Flutter/Yerel Android kaynak kodu (odalar, galeri, harita, rezervasyon).
• ✅ Oda/ücret yönetimi ile arka uç API'si (Laravel/WordPress).
• ✅ SQL geçişleri/tohum (Laravel) veya WP CPT/alanlar (WordPress) ön ayarları.
• ✅ Ödeme ve Haritalar entegrasyon şablonları.
• ✅ Onaylar için e-posta/SMS şablonları.
• ✅ Belgeler ve GPL v3 lisans dosyası.

📱 Desteklenen Platformlar

• Android: 8.0 (API 26)+ telefonlar ve tabletler.
• iOS: 13+ (Xcode 15+ ile isteğe bağlı Flutter derlemesi).
• Sunucu: Ubuntu 22.04 LTS / cPanel / Docker; Ödemeler için HTTPS gereklidir.

👨‍💻 Orijinal Geliştirici Kredisi (Yetkililik)

Bu paket orijinal ticari yazara atıfta bulunur. Onları pazar profillerinde destekleyin:
CodeCanyon – Orijinal Yazar.

🔒 Sorumluluk reddi beyanı (Güvenilirlik)

Eğitim amaçlı ve yasal ticari kullanım için GPL v3 lisansı altında yeniden dağıtılmaktadır. Herhangi bir otel markasına bağlı değiliz.
Yerel vergi/turist ücreti kurallarına, para yatırma/iptal düzenlemelerine ve ödeme ağ geçidi koşullarına uyulduğundan emin olun. Her zaman HTTPS'yi etkinleştirin,
API anahtarlarını döndürün ve yayına geçmeden önce kullanılabilirlik/fazladan rezervasyon mantığını doğrulayın.