İletmen

Proje Hakkında

İletmen, küçük ve orta ölçekli kargo/kurye şirketlerinin teslimat operasyonlarını uçtan uca dijitalleştiren bir mobil lojistik yönetim platformudur. Proje, Türkiye'de e-ticaret hacminin 2020-2024 arasında 4x büyümesiyle birlikte artan son mil teslimat (last-mile delivery) sorununa çözüm olarak doğmuştur. Küçük kargo firmalarınin %70'i hala kağıt bazli teslimat listeleri ve telefon koordinasyonuyla çalışmaktaydı — günlük 50+ teslimat yapan bir kuryenin rota planlama, teslim alip fisi imzalatma ve merkeze bildirim süreci operasyonel darboğazlara yol açıyordu. Uygulama iki kullanıcı rolünü destekler: (1) Dispatcher (Görev Atayan) — teslimat görevlerini oluşturur, kuryelere atar, canlı olarak tüm kuryelerin konumunu ve görev durumlarını izler, performans raporlarına erisir. (2) Kurye — kendisine atanan günlük görevleri görür, optimize edilmis rota ile yola çıkar, teslimat noktasında QR kod tarayarak teslimat onayını dijital olarak tamamlar, müşteriden e-imza alir. MapKit ve CoreLocation entegrasyonu ile rota optimizasyonu, trafik durumuna göre dinamik yeniden yönlendirme ve turn-by-turn navigasyon desteği sunar. QR kod sistemi ile kargonun doğru alıcıya teslim edildiginin dijital kaniti oluşturulur — kağıt fis ihtiyacıni ortadan kaldırır. REST API ile merkezi sunucuya gerçek zamanlı veri aktarımı, dispatcher'in web panelinden de operasyonu izlemesini sağlar. 45 dosyalık kompakt ama işlevsel kod tabanı, MVC mimarisi üzerinde hızlı geliştirme odaklı tasarlanmıştır. 4 aylık geliştirme sürecinde 3 kişilik ekiple lojistik sektörüne özel olarak inşa edilen uygulama, 2.000+ aktif kurye ve dispatcher ile 8.000+ indirmeye ulasarak iOS 14.0+ destekleyen tüm iPhone cihazlarda çalışır. Kurye başına günlük teslimat sayısını %50 artıran rota optimizasyonu ve kağıt fis kullanımıni neredeyse sıfıra indiren QR kodlu dijital teslimat kaniti sistemi, uygulamanin en değerli iki özelliği olarak öne çıkıyor.

Özellikler

Süreç

Zorluklar & Çözümler

Teknik Detaylar

Uygulama MVC mimarisi üzerinde Swift 5.6 ve UIKit ile geliştirildi. 45 dosyalık kompakt kod tabanı 4 ana modül içeriyor: Delivery, Routing, Scanner, Tracking. Harita ve Rota Katmani: MapKit üzerinde özelMKAnnotationView'lar ile teslimat noktaları görselleştirildi. Her pin teslimat durumuna göre renk kodlu: mavi (bekleyen), türüncu (yolda), yesil (teslim edildi), kırmızı (başarısız). MKDirections ile iki nokta arası rota hesaplama — ETA gerçek zamanlı trafik verisine göre güncellenir. Çoklu teslimat rotası için MKDirections istekleri sırayla (rate limit: saniyede 1) gönderilir ve sonuclar birleştirilerek tek MKPolyline overlay ile haritada gösterilir. Turn-by-turn navigasyon için Apple Maps deep link (MKMapItem.openMaps ile) kullanilir. Konum Servisleri: CLLocationManager ile uc modlu konum takibi. allowsBackgroundLocationUpdates = true ile arka planda konum güncelleme. CLCircularRegion ile geofencing — teslimat noktasına 200m yaklaşınca didEnterRegion tetiklenir, mod otomatik değişir. significantLocationChangeMonitoring ile bekleme modunda minimum pil kullanımı. Konum verileri her güncellemede REST API'ye POST edilir, dispatcher haritasında canlı güncellenir. QR Kod Tarayıcı: AVCaptureSession + AVCaptureVideoPreviewLayer ile kamera onu izlemesi. AVCaptureMetadataOutput delegate ile .qr tipi metadata okuma. Tarama başarısı için: (1) AutoFocus .continuousAutoFocus, (2) Exposure .continuousAutoExposure, (3) Torch .auto (düşük ışık algılama). Tarama sonucu doğrulama: QR içeriği | ile ayrilmis 3 parça — deliveryId, recipientHash, verificationCode. recipientHash sunucu tarafında doğrulanır, kod eşleşmezse teslimat reddedilir. E-İmza Modülü: UIView subclass olarak SignatureView — UIPanGestureRecognizer ile parmak hareketini UIBezierPath'e çevirir. Cizim sırasında CAShapeLayer ile canlı görüntüleme. Tamamlandiginda UIGraphicsGetImageFromCurrentImageContext ile PNG render. İmza görüntüsü teslimat onayıyla birlikte sunucuya yüklenir (multipart/form-data). Sifirla butonu ile yeniden imza alma, önizleme ile onay. Offline Depolama: SQLite (FMDB wrapper) ile yerel teslimat onay kuyruklama. OfflineDeliveryRecord: deliveryId, qrResult, signatureImagePath (dosya sistemi), timestamp, gpsLat, gpsLng, syncStatus. SyncQueue sınıfı: Reachability ile bağlantı izleme, online olunca kuyruktaki kayıtları sırasıyla POST, başarılı olanları syncStatus = .synced olarak işaretleme. Çatışma kontrolü: sunucu 409 donerse (başka cihazdan güncellenmis) kullanıcıya uyarı gösterilir. Push Notification: APNs ile 4 tip bildirim: (1) Yeni görev atandi — kuryeye anında bildirim, (2) Görev iptal/değişiklik — acil uyarı, (3) Teslimat onaylandi — dispatcher'a bildirim, (4) Günlük özet — aksam görev tamamlanma raporu. Rich notification ile teslimat adres önizlemesi (Notification Service Extension).

Araştırma Notları

Piyasa Araştırması ve Bulgular: Türkiye Son Mil Teslimat Pazarı: * Türkiye e-ticaret hacmi: $30B+ (2024), %25 yıllık büyüme * Son mil teslimat (last-mile) pazarı: $4.2B (2024), e-ticaretin %14'u * Türkiye'de kayıtli kargo şirketi: 1.200+ (PTT, Yurtiçi, Aras, MNG + 800+ bölgesel) * Küçük/bölgesel kargo şirketlerinin dijitalleşme oranı: %30 (büyük firmalarda %85+) * Son mil teslimat maliyeti toplam lojistik maliyetinin %53'unu oluştürüyor — en pahali segment * Kurye başına günlük ortalama teslimat: 28 (dijital olmayan), 40-50 (dijital çözümlu) — %50-80 verimlilik farki * E-ticaret iade oranı: %18 — hatali teslimat temel sebeplerden biri Rakip Analizi: Global: Route4Me (rota optimizasyonu, $10M+ ARR), Onfleet (teslimat yönetimi, $200M+ funding), Circuit (rota planlama). Türkiye: Büyük kargo şirketlerinin proprietary sistemleri var (Yurtiçi, Aras), ancak küçük/bölgesel firmalar için uygün fiyatli mobil çözüm yok. İletmen bu segmenti hedefliyor. Kiyaslama: Onfleet raporlarına göre dijital teslimat yönetimi ile: teslimat verimi %40-60 artış, yakıt maliyeti %20-30 azalis, müşteri şikayet oranı %50 düşüş. İletmen benzer sonuçları Türkiye pazarında doğruladi. Hedef Kitle Segmentasyonu: 1. Bölgesel Kargo Şirketleri (10-50 kurye, %45): Şehir içi dağıtım, e-ticaret kargosu — en büyük segment 2. Restoran/Yemek Dağıtımı (5-20 kurye, %25): Hızlı teslimat, GPS takip önceliği 3. Kurumsal Dağıtım (20-100 kurye, %20): Dokuman, numune, medikal malzeme dağıtımı 4. Freelance Kuryeler (bireysel, %10): Getir/Trendyol Go tarzıi gig economy kuryeleri Kullanıcı Araştırması Bulguları (20 Görüşme — 10 kurye, 5 dispatcher, 5 şirket sahibi): * Kuryeler: %85'i rota planlamayi 'deneyimle' yapıyor, optimizasyon araci kullanmiyor * Dispatcher'lar: %72'si telefon ile kurye koordinasyonundan şikayetçi — WhatsApp grubu ile yönetim * Şirket sahipleri: %68'i teslimat kaniti (proof of delivery) eksikliğinden dolayi müşteri itirazlarla karşılaşıyor * En çok talep edilen: rota optimizasyonu (%91), canlı takip (%84), dijital teslimat kaniti (%79) * Pil tüketimi kaygısı: %76'si 'telefon aksama kadar dayansin' istiyor

Tasarım Süreci

Tasarım süreci 4 ana fazda yürütüldü ve saha koşulları on planda tutuldu: Faz 1 — Keşif ve Saha Gözlemi (2 hafta): 10 kurye ile günlük teslimat rutinine eslik edildi (gözlemsel araştırma). 5 dispatcher ile yüz yüze görüşme yapıldı. 5 şirket sahibiyle is hedefleri ve aci noktaları teşhis edildi. En kritik bulgu: kuryelerin %85'i rota planini 'başımda yaparim' diyor ama gps navigasyonu aktif kullanıyor — yani optimizasyon ihtiyacı var ama farkında değiller. Dispatcher'larin en büyük sorunu: 'kuryem nerede, ne zaman gelecek?' sorusuna cevap verememek. Şirket sahiplerinin önceliği: teslimat kaniti ve maliyet kontrolü. Bu 3 farklı perspektif uygulamanin 3 temel modülunu şekillendirdi. Faz 2 — Bilgi Mimarisi ve Rol Bazli Akis (1 hafta): Iki kullanıcı rolu için ayri navigasyon akişi tasarlandı. Kurye akişi: minimalist, tek elle kullanilabilir (sürerken tek dokunuşla bir sonraki teslimat). Dispatcher akişi: bilgi yoğun, harita-öncelikli (tum kuryelerin canlı konumu). Tab bar — Kurye: Görevlerim, Harita, Tarama, Profil. Dispatcher: Dashboard, Harita, Görev Ata, Raporlar. Kurye ekranında en önemli bilgi: sıradaki teslimat adresi ve tahmini varis süresi — her sey bunun etrafinda. Faz 3 — Wireframe ve Prototip (1.5 hafta): Figma'da kurye ve dispatcher için ayri prototipler hazırlandı. Kurye arayüzu için 2 konsept test edildi: (A) Liste-öncelikli (sıradaki görevler liste halinde), (B) Harita-öncelikli (tum görevler haritada, aktif görev vurgulanmis). 8 kurye ile guerilla test: Konsept B tercih edildi (%65) — kuryeler görsel olarak nerede olduğu ve sonraki noktanin yönünü haritada görmek istiyor. Ancak liste görünümüne geçiş butonu da eklendi (detaylı bilgi için). QR tarama ekrani için kamera onu izleme alanınin ekranin %80'ini kaplaması uygün bulundu — hedef almayi kolaylastiriyor. Faz 4 — Prototip Testi ve Iterasyon (1.5 hafta): 15 katılımcı ile saha testi (10 kurye, 5 dispatcher). Testler gerçek teslimat senaryolarında yapıldı (ofis ortaminda değil). Kritik bulgular ve çözümleri: (1) Kurye tek elle telefonu tutarken QR tarama butonu alt tarafta olmalı — thumb zone'a taşındı, (2) Harita görünümünde teslimat sıralaması net değil — numaralanmis pin'ler ile sıralama görselleştirildi, (3) Teslimat başarısız olduğunda (müşteriye ulasilamadi) seçenekler yetersiz — 'Kapida birak', 'Komsuya teslim', 'Ertesi gün tekrar' gibi 5 secenek eklendi, (4) Dispatcher haritasında 20+ kurye olunca karışıklık — cluster'lama ve filtre (sadece aktif/geciken) eklendi, (5) QR okuma sırasında telefon titremesi — haptic feedback ile başarılı okuma anında bildirim. Son iterasyon sonrası kurye görev tamamlama süresi %30 kısaldı, QR tarama başarısı ilk denemede %95'e çıktı.

Sonuçlar & Etki

İletmen, küçük ve orta ölçekli kargo şirketlerinde operasyonel verimlilik artışı sağladı: Kullanıcı Metrikleri: * 2.000+ aylık aktif kullanıcı (kurye + dispatcher) * 8.000+ kümülatif indirme — B2B satış+ sektörel referans * App Store'da 4.5 puan (30+ değerlendirme) * Aktif kargo şirketi sayısı: 35+ firma * Ortalama günlük teslimat/kurye: 42 (önceki kağıt bazli sistem: 28) * Kurye başına ortalama oturum: 45 dakika/gün (tum gün boyunca aktif) İş Etkisi: * Teslimat verimilik artışı: kurye başına günlük teslimat sayısı %50 artti (28'den 42'ye) * Rota optimizasyonu ile günlük ortalama 18km tasarruf/kurye (%22 mesafe azalması) * Yakıt maliyeti düşüşu: kurye başına aylık ~600 TL tasarruf * Kagit fis kullanımı: %100'den %5'e düştü (QR kod sistemi sayesinde) * Teslimat kanit süresi: 45 saniyeden (kağıt imza) 8 saniyeye (QR + e-imza) * Hatali teslimat oranı: %4.2'den %0.8'e düştü (QR doğrulama ile) * Dispatcher görev atama süresi: günlük 1.5 saatten 20 dakikaya azaldı Teknik Performans: * Crash-free oranı: %99.4 (production ilk 6 ay) * App boyutu: 18MB (kompakt, hızlı indirme) * QR kod tarama başarı oranı: %97.5 (ilk denemede) * Ortalama QR tarama süresi: 1.2 saniye * GPS konum hassasiyeti: ortalama 12m (şehir içi) * Pil tüketimi: tam gün kullanımda %45 (uc modlu strateji sayesinde) * API yanıt süresi: p95 < 250ms * Offline senkronizasyon başarı oranı: %99.1 App Store İncelemeleri: * "Kagit fislerden kurtulduk, QR kod sistemi çok pratik. Müşteriler de memnun." — 5 yıldız * "Rota optimizasyonu gerçekten çalışıyor, günlük 15-20 km daha az yol yapıyorum." — 5 yıldız * "Dispatcher olarak tüm kuryeleri canlı takip edebilmek operasyonu çok kolaylaştırdı." — 4 yıldız

Öğrenilen Dersler

Bu proje boyunca lojistik ve teslimat alanına özgü birçok değerli teknik ve ürün dersi çıkardım: Rota Optimizasyonu Gerçek Dunyada Farklı: Akademik TSP algoritmaları gerçek teslimat senaryolarında yeterli değil. Nearest Neighbor + 2-opt kombinasyonu teoride iyi sonuc veriyor ancak gerçek hayatta: (a) tek yönlü sokaklar hesap dışında kalıyor, (b) park yeri bulma süresi değişken, (c) apartman girişi ve kat cikma süresi eklenmeli, (d) mola zamanlaması kritik. Çözüm: Kuryelerden toplanan gerçek teslimat süresi verileriyle (ortalama 3.5 dk/teslimat) buffer eklendi ve rota planina mola noktaları dahil edildi. Ders: Rota optimizasyonunda harita mesafesi değil, 'gerçek teslimat süresi' optimize edilmeli. Pil Tüketimi Kurye Icin Kritik: Ilk sürümde continuous GPS kullanıyorduk — kuryeler öğleden sonra telefonu sarj etmek zorunda kalıyordu. Uc modlu konum stratejisi (aktif/transit/bekleme) ile pil tüketimini %60 azalttık. Ancak mod geçişleri arasındaki gecikme (5-10 saniye) dispatcher haritasında 'ziplama' etkisi oluştürüyordu. Çözüm: geçiş sırasında son bilinen konum ile tahmini yönü interpolate ederek yuumusak geçiş animasyonu. Ders: Konum tabanlı uygulamalarda pil optimizasyonu MVP'de değil, v1.0'da olmalı — kullanıcı kaybınin birinci nedeni. QR Kod Tasarımi Önemli: Başlangıçta standart QR kod kullanıyorduk — günes altında, yirtik etiketlerde okuma başarısızlığı %15'e çıkıyordu. Iyılestirmeler: (1) QR boyutunu 2x2cm'den 4x4cm'ye çıkarma, (2) Error correction level'i L'den H'ye yükseltme (hasar toleransi %30), (3) Koyu zemin üzerine beyaz QR (kontrast artışı), (4) QR etrafinda 4 modül quiet zone bırakma. Bu değişiklikler okuma başarısızlığıni %15'ten %2.5'e düşürdü. Ders: QR kod tasarımı yazılım kadar fiziksel koşullara bağlı — etiketti bastiranla koordinasyon sart. E-İmza UX'i Beklenenden Zor: Müşteriden e-imza almak teoride basit — ekrana imza at, kaydet. Ancak gerçekte: (a) Yaşlı müşteriler küçük ekranda imza atamiyor, (b) Soguk havada eldiven ile dokunmatik çalışmıyor, (c) İmza alanı çok küçük bulunuyor, (d) Bazi müşteriler imza yerine 'X' işareti koyuyor. Çözüm: İmza alanıni tam ekran yapma seçeneği, 'İmza yerine onay butonu' alternatifi ve eldiven modu (hassasiyet ayarı). Ders: Saha uygulamalarında ofis UX standartları geçerli değil — fiziksel koşullar tasarımı belirlemeli. Kompakt Kod Tabaninin Avantaji: 45 dosya ile teslim edilen uygulama, geliştirme hızi ve bakım kolayligi açısından ideal boyutta. MVC mimarisi bu ölçekte fazlasiyla yeterli — MVVM veya VIPER overhead oluşturabilirdi. Her dosya tek sorumluluklu, her modül bağımsız test edilebilir. 4 ayda 3 kişilik ekiple teslim, sıfır teknik borc ile lansman. Ders: Küçük projelerde mimari over-engineering yapmak yerine MVC ile hızlı teslim, büyüdükçe refactor stratejisi daha pragmatik.