StoresAround | iOS Universal Store Finder App Template (Swift)

Açıklama

✨ Temel Özellikler

İnteraktif Harita ve Liste: Harita işaretçileri + mesafe, derecelendirme, açık/kapalı rozeti içeren kart listesi.
Güçlü Arama: Anahtar kelime, kategori, şehir/posta filtreleri ve "yakınımdaki" hızlı işlem.
Mağaza Detay Ekranları: Fotoğraf karuseli, açıklama, olanaklar, açılış saatleri, tıkla ve ara, web sitesi, sosyal bağlantılar.
Yol Tarifi ve Yolculuk Seçenekleri: Apple Haritalar'da açın (arabayla/yürüyerek/toplu taşıma); yüklü uygulamalara geçiş.
Favoriler ve Son Kullanılanlar: Mağazaları kaydedin ve son görünümleri yeniden ziyaret edin.
Çevrimdışı uyumlu Katalog: Seed JSON/Plist verileri; isteğe bağlı uzaktan senkronizasyon.
Yerelleştirmeye hazır: Kolay çeviri için haricileştirilmiş dizeler (RTL dostu).
Tema: Açık/Koyu modu, marka renk belirteci, SF Sembolleri simgeleri.
Gizliliğe duyarlı Konum: Ayrıntılı izin istemleri ve geri dönüş akışları.
İsteğe Bağlı Para Kazanma: AdMob yerleşimleri (banner/geçiş reklamı) ve promosyon kartları.
Analitiklere hazır: Firebase Analytics / Crashlytics için kancalar (isteğe bağlı).

⚙️ Teknik Yığın

Dil: Hızlı 5+
Kullanıcı Arayüzü: UIKit (veya sağlandığı şekilde SwiftUI kabuğu), Otomatik Düzen, Dinamik Tür
Haritalar ve Konum: MapKit, CoreLocation (isteğe bağlı Google Haritalar SDK/Places API'leri)
Veri: Yerel JSON/Plist (basit Depo modeliyle); Uzaktan senkronizasyon için URLSession
Kalıcılık: Favoriler/son kullanılanlar için UserDefaults (Çekirdek Veriler isteğe bağlı)
Reklamlar/Analitikler (isteğe bağlı): Google Mobile Ads SDK'sı, Firebase
Minimum iOS: iOS 13+ (iPhone/iPad); Xcode 15+ önerilir

Sunucu Gereksinimleri: Yerel veri modu için gerekli değildir. Uzak içeriği etkinleştiriyorsanız herhangi bir HTTPS JSON uç noktası veya Firebase/Firestore arka ucu çalışacaktır.

🧩 Kurulum Kılavuzu

Xcode'da aç: Projeyi indirin ve .xcodeproj'u (veya bölmeler kullanılıyorsa .xcworkspace'i) açın.
Paket Kimliğini ve Ekibi Ayarlayın: Hedefler → İmzalama ve Yetenekler → Apple Geliştirici ekibinizi seçin.
Haritaları Yapılandırın: MapKit kutudan çıktığı gibi çalışır. (İsteğe bağlı) Sağlayıcıyı değiştiriyorsanız Info.plist'e Google Haritalar/Yerler anahtarlarını ekleyin.
Tohum Verileri: Stores.json/categories.json'u (ad, coğrafi konum, saatler, bağlantılar, resimler) düzenleyin. Uzaktan güncellemeler istiyorsanız bir JSON yayını barındırın.
Markalama: Uygulama adını, renklerini, uygulama simgesini ve başlatma ekranını güncelleyin; Localizable.strings'i yerelleştirin.
İzinler: Info.plist'te NSLocationWhenInUseUsageDescription'ı net bir gerekçeyle ayarlayın.
İsteğe bağlı SDK'lar: AdMob Uygulama Kimliği ve birim kimliklerini ekleyin; analiz/kilitlenme günlükleri için Firebase GoogleService-Info.plist'i ekleyin.
Oluşturun ve Gönderin: Gerçek bir cihazda test edin, ardından arşivleyin ve Xcode Organizer aracılığıyla App Store Connect'e yükleyin.

📦 Teslimatlar

✅ Tam Swift kaynak kodu (harita, arama, ayrıntı, favoriler, tema)
✅ Çekirdek veri örnekleri (mağazalar, kategoriler) + resim varlıkları
✅ Yapılandırma şablonları (Info.plist, AdMob/Firebase yer tutucuları)
✅ README hızlı başlangıç ve temel belgeler
✅ GPL lisans dosyası

📱 Desteklenen Platformlar

iPhone: iOS 13+ (dikey/yatay duyarlı)
iPad: iPadOS 13+ (bölünmüş görünüm uyumlu)
Apple Haritalar: Yerel MapKit; tercih edilirse isteğe bağlı Google Haritalar SDK'sı

🧠 Notlar

Lisans: GPL kapsamında dağıtılmaktadır; GPL koşullarına göre inceleyebilir, değiştirebilir ve yeniden dağıtabilirsiniz.
Özelleştirme İpuçları:

Listeleri yeniden göndermeden güncellemek için uzaktan yapılandırmayı (JSON/Firestore) etkinleştirin.
UGC dizinleri için yönetici incelemesiyle kullanıcı gönderimlerini ekleyin.
Etkileşimi artırmak için mağaza başına kuponlar veya uygulama içi tanıtımlar uygulayın.

SEO Güvencesi: Açık listeleme meta verileri ("mağaza bulucu", "yakınımdaki" şehir/bölge anahtar kelimeleri) ve şeffaf lisanslama, ürün sayfanızda E-E-A-T'yi destekler.

👨‍💻 Orijinal Geliştirici Kredisi

Lütfen orijinal şablon yazarına ve pazar listesine yapılan atıfları koruyun (ör.
CodeCanyon) uzmanlıklarını ve kodun kaynağını kabul etmek için.

🔒 Sorumluluk reddi beyanı

Bu paket, eğitim, test ve geliştirme amaçlarına yönelik bir GPL yeniden dağıtımıdır. Orijinal satıcı değiliz ve resmi destek veya garanti vermiyoruz. Tüm üçüncü taraf adları (Apple, Google, Firebase, AdMob) ilgili sahiplerinin ticari markalarıdır. Yayınlamadan önce App Store politikalarına, konum gizliliği gerekliliklerine ve bölgesel veri koruma yasalarına uyulduğundan emin olun.