iOS Uygulaması

Bu kılavuz, LeadHub iOS yardımcı uygulamasını derleyen veya özelleştiren geliştiriciler içindir. Uygulama kaynak kodu Swift ile yazılmıştır ve iPhone ile iPad'i hedeflemektedir.

Gereksinimler

Xcode 15 veya daha yeni (yalnızca macOS)
Swift 5.9 veya daha yeni
iOS dağıtım hedefi: Minimum iOS 15.0
Apple Developer hesabı (TestFlight ve App Store dağıtımı için gereklidir)
Geçerli HTTPS URL'si ve aktif API anahtarı olan bir LeadHub örneği

Proje Kurulumu

Xcode'da LeadHub satın alımınızdaki ios/ klasörünü açın.
CocoaPods veya Swift Package Manager bağımlılıkları varsa .xcodeproj yerine .xcworkspace dosyasını açın.
Projenin Signing & Capabilities ayarlarında geliştirme ekibinizi seçin.
Simülatörde veya cihazda derleyip çalıştırın.

Mimari

Uygulama standart bir iOS mimarisi kullanır:

URLSession ve LeadHub REST API'ye HTTP çağrıları için özel API istemcisi
Asenkron işlemler için Combine veya async/await
Kullanıcı arayüzü için SwiftUI
Oturumlar arasında leadlerin yerel önbelleklenmesi için CoreData
Push bildirimleri için Apple Push Notification Service (APNs)

API anahtarları, Security çerçevesi kullanılarak iOS Keychain'de saklanır.

Kimlik Doğrulama Akışı

Kullanıcı, katılım ekranına LeadHub örnek URL'sini ve API anahtarını girer.
Uygulama, örneğin HTTPS üzerinden erişilebilir olduğunu doğrulamak için GET /api/v1/health isteği gönderir.
Test kimlik doğrulamalı bir istek göndererek API anahtarının geçerliliğini kontrol eder.
URL ve API anahtarı Keychain'e kaydedilir.

Push Bildirimleri

Push bildirimleri Apple Push Notification Service (APNs) kullanır.

Apple Developer hesabınızda, Certificates, Identifiers & Profiles → Keys altında bir APNs anahtarı (.p8 dosyası) oluşturun.
Key ID ve Team ID'nizi not alın.
LeadHub backend yapılandırmasında APNS_KEY, APNS_KEY_ID, APNS_TEAM_ID ve APNS_BUNDLE_ID değerlerini ayarlayın.
Xcode'da Signing & Capabilities altında Push Notifications özelliğini etkinleştirin.

Uygulama ilk açılışta push bildirimlerine kaydolur ve cihaz tokenını API aracılığıyla LeadHub backend'e gönderir.

Dağıtım için Derleme

Xcode'da Product → Archive aracılığıyla uygulamayı arşivleyin.
Organizer penceresinde Distribute App'e tıklayın.
App Store dağıtımı için App Store Connect'i, beta testi için TestFlight'ı seçin.
Yüklemek için Xcode yönergelerini izleyin.

Kullanılan API Uç Noktaları

Uç Nokta	Amaç
`GET /api/v1/health`	Örnek bağlantısını doğrula
`GET /api/v1/leads`	Lead listesini yükle
`GET /api/v1/leads/{id}`	Lead ayrıntılarını yükle
`PATCH /api/v1/leads/{id}`	Lead durumunu veya aşamasını güncelle
`POST /api/v1/leads/{id}/tags`	Leade etiket ekle
`GET /api/v1/pipelines`	Aşama seçici için pipeline listesini yükle

Gereken Minimum API Anahtarı Kapsamları

Kapsam	Neden
`read:leads`	Leadleri görüntüle
`write:leads`	Lead durumunu, aşamasını ve etiketleri güncelle
`read:pipelines`	Pipeline aşama seçiciyi doldur

App Store Gizlilik Bildirimi

App Store'a gönderirken App Privacy bölümünde şu veri kullanımını bildirin:

İletişim Bilgileri (e-posta, telefon) — kullanıcılardan değil, leadlerden toplanır
Tanımlayıcılar (API anahtarı) — kullanıcıyla ilişkilendirilir, kimlik doğrulama için kullanılır
Kullanım Verileri — toplanmaz

Gereksinimler​

Proje Kurulumu​

Mimari​

Kimlik Doğrulama Akışı​

Push Bildirimleri​

Dağıtım için Derleme​

Kullanılan API Uç Noktaları​

Gereken Minimum API Anahtarı Kapsamları​

App Store Gizlilik Bildirimi​