📌 1. Giriş ve Amaç

Bu teklif, Stocado platformuna yurtdışı kargo gönderim modülü entegrasyonu için hazırlanmıştır. Amaç, mevcut yurtiçi sistem mimarisini bozmadan, modüler geliştirmelerle yurtdışına özgü kargo işlemlerini destekleyen, kullanıcı dostu ve yönetilebilir bir sistem oluşturmaktır.

📌 2. Proje Kapsamı ve Aşamalar

Genel Kapsam

Mevcut Laravel + MySQL tabanlı sistem üzerine entegrasyon
Yeni yurtdışı taşıyıcı API’leri ile bağlantı
Yeni iş kuralları ve veri modellemeleri
UI/UX güncellemeleri
Bildirim sistemine SMS, Mail, WhatsApp entegrasyonu
Fiyatlama, kampanya ve teklif modüllerinin genişletilmesi
Yönetici ve müşteri ekranlarının geliştirilmesi

📌 3. Teknik Çözüm ve Özellikler (Özet ve Yapılandırma)

3.1. Fiyatlama ve Kampanyalar

Ülke/desi bazlı fiyat sorgulama
API fiyatlarına kar marjı ekleme
Kampanyalı/özel fiyat tanımlama
Desi aralığına göre toplu fiyat güncelleme (+/- yüzde bazlı)
Özel durumlar (ör. 30 desi üzeri kampanyalar)

3.2. Gönderim Süreci

Ülke seçimine göre adres ve posta kodu doğrulama (Google Maps Geocoding)
Posta kodu bazlı fiyat hesaplama
Adres formatlarına göre validasyon
Fiyat seçimi sonrası gönderim ekranına yönlendirme
Kapıda ödeme desteği

3.3. Onay Süreci

Yeni status: “Approving”
Eksik bilgi kontrolü ve SMS ile geri bildirim
Kargonun onaya düşmesi ve geri gönderme

3.4. Müşteri Bakiye Yönetimi

Wallet modeli üzerinden döviz bazlı bakiye
Bakiye kontrolü ve yükleme akışı
Eksik bakiye durumunda yönlendirme

3.5. Ekstra İşlevler

Gerçek desi güncellemesi (API ile otomatik)
Kargo resimleri yükleme (en fazla 2 resim)
Gönderi döküman yönetimi (Dosya/Numune/Mikro ihracat)
Teslimat kanıt belgesi yükleme
Kargo hareketleri ve statü güncellemeleri
Taşıyıcı firmadan gelen bildirimlerin müşteriye iletilmesi

3.6. Bildirimler

SMS / Email / WhatsApp kanal entegrasyonu
Hoş geldiniz mesajı
İade, teslimat bildirimleri
Yeni fiyat tanımı bilgilendirmeleri

3.7. Teklif Sistemi

Hesaplanan fiyatların teklif olarak müşteriye mail atılması
Teklif kayıtlarının cari karta işlenmesi

3.8. Raporlama

Gönderi adetleri
Ülke bazlı dağılımlar
Desi aralıkları
Teslim, iade, gümrükte bekleyen kargolar

3.9. Diğer Özellikler

Ondalıklı desi desteği (1.5, 2.5 gibi)
UPS yakıt ücreti entegrasyonu
Ülke bazlı ekstra ücretlerin ölçülere göre hesaplanması

📌 4. Geliştirme Süreci ve Aşamalar

Aşama 1: Analiz ve Tasarım

İsterlerin kesinleştirilmesi
Veri modeli güncellemeleri
API ihtiyaçlarının belirlenmesi

Aşama 2: Altyapı ve Backend Geliştirme

Mevcut kod tabanına yeni modeller ve servisler
API entegrasyonları (taşıyıcı, yakıt ücretleri, çeviri servisleri)
Bildirim kanalları entegrasyonu

Aşama 3: Frontend Geliştirme

Gönderi oluşturma ekranı güncellemeleri
Teklif ekranı ve raporlar
Yönetim paneli ayarları

Aşama 4: Test Süreci

Unit ve Feature testler
Manuel kullanıcı testleri
Taşıyıcı firmalar ile entegrasyon testleri

Aşama 5: Canlıya Alma ve Eğitim

Demo ve son onay
Canlıya alma
Admin kullanıcı eğitimi

📌 5. Tahmini Zaman Çizelgesi

Analiz ve Tasarım	5 iş günü
Backend Geliştirme	10 iş günü
Frontend Geliştirme	10 iş günü
Test ve Entegrasyon	5 iş günü
Canlıya Alma ve Eğitim	2 iş günü
Toplam	32 iş günü

Not: Bu süreler tahmini olup kapsam netleştikçe güncellenebilir.

📌 6. Tahmini İşçilik ve Fiyatlandırma

✅ Backend geliştirme: ~50-60 saat

✅ Frontend geliştirme: ~50-60 saat

✅ Test ve entegrasyon: ~25-40 saat

✅ Toplam: ~120-160 saat

💰 Saatlik Ücret: 20 USD/saat

🔹 Toplam İşçilik Tahmini:

👉 150 × 20 = 3000 USD (KDV hariç)

Önerilen TL fiyat aralığı: 120.000 – 150.000 TL + KDV
Ödeme planı: %40 Peşinat / %30 Ara Teslim / %30 Canlıya Alma

📌 7. Teslimat ve Destek

✅ Kodlar mevcut sistem yapısına entegre, dokümante ve sürüm kontrollü şekilde teslim edilir.

✅ 1 ay ücretsiz hata düzeltme garantisi.

✅ İsteğe bağlı bakım/destek paketi (aylık 10-15 saat/opsiyonel).

✅ Tüm işlevler test edilmiş ve canlı ortamda çalışır şekilde devredilir.

Özet Teklif

✔ Projenin amacı: Mevcut Stocado altyapısına yurtdışı gönderi modülü geliştirmek.

✔ Süre: Yaklaşık 32 iş günü

✔ İşçilik: ~120-160 saat

✔ Tahmini Fiyat: ~3000 USD veya ~120.000 TL + KDV

İletişim ve Sonraki Adımlar

✔ İsterler dokümanı üzerinden madde madde netleştirme toplantısı

✔ Sözleşme ve ödeme planı onayı

✔ Kick-off ve proje başlangıcı