Çok Kanallı E-ticaret Sistemi
4 pazar yeri entegrasyonu, Nuxt 3 SSR frontend, Laravel 12 backend. 386 API endpoint ile tam kapsamlı e-ticaret altyapısı.
Müşteri İhtiyacı
Ayakkabı perakendecisi birden fazla pazar yerinde satış yapıyordu. Her platformda ayrı stok güncelleme, sipariş takibi ve kargo işlemi yapmak günde 6+ saat alıyordu. React frontend SEO için yetersizdi.
Çözümümüz
Laravel 12 ile 386 API endpoint'li güçlü bir backend, Nuxt 3 ile SEO uyumlu SSR frontend geliştirdik. 4 pazar yeri entegrasyonu, Kargonomi kargo, PayTR ödeme ve Telegram bildirim ekledik.
Teknik Detaylar
Entegrasyonlar
Zorluklar & Çözümler
14 Farklı Pazar Yeri API'si
Trendyol REST, N11 SOAP+REST, Hepsiburada REST - her birinin farklı auth, format ve rate limit'i var.
Her pazar yeri için özel Service sınıfı (1.200+ satır). Unified interface, background job'lar ile async sync, retry mekanizması.
2React'tan Nuxt'a SEO Geçişi
React SPA Google'da düzgün indexlenmiyordu. Ürün sayfaları arama sonuçlarında görünmüyordu.
Nuxt 3 ile full SSR. useSeoMeta(), JSON-LD schema (Product, BreadcrumbList, WebSite), sitemap.xml, 301 redirect'ler.
3Çoklu Sipariş Kaynağı
Website + 4 pazar yerinden gelen siparişlerin tek sistemde yönetilmesi gerekiyor.
Unified order model, source tracking, marketplace_orders tablosu, background job'lar ile otomatik sipariş çekme.
4Stok Senkronizasyonu
Bir ürün satıldığında tüm kanallarda stok güncellenmeli. Gecikmeler çifte satışa yol açıyor.
Queue-based stock sync, UpdateMarketplaceStockJob, event-driven güncellemeler, stock_movements ile izleme.
Perde Arkası
- Backend: 30.579+ satır PHP, 42 controller, 47 model, 24 service
- Frontend: 14.496+ satır TypeScript/Vue, 61 bileşen, 30 sayfa
- 386 API endpoint - public, customer, admin ayrımı
- Trendyol entegrasyonu: 1.246 satır, N11: 1.225 satır, Hepsiburada: 600+ satır
- 45 database migration ile schema yönetimi
- 7 marketplace background job (orders, products, questions, claims, reviews, stock, sync)
- ImageMagick: 45 endpoint ile görsel işleme (resize, crop, watermark)
- ZPL barkod etiket sistemi termal yazıcılar için
- useSeoMeta() 44 farklı yerde kullanılıyor
- JSON-LD: Product, BreadcrumbList, WebSite, LocalBusiness schema'ları
Proje Özellikleri
- Trendyol, N11, Hepsiburada, PTT AVM entegrasyonu
- Nuxt 3 SSR ile tam SEO uyumu
- JSON-LD structured data (Product, BreadcrumbList)
- PayTR ile güvenli ödeme
- Kargonomi ile çoklu kargo desteği
- Telegram sipariş bildirimleri
- POS/mağaza satış modülü
- ImageMagick görsel işleme
- Google OAuth ile giriş
- Barkod ve ZPL etiket sistemi
Elde Edilen Sonuçlar
Günlük operasyon süresi 6 saatten 1 saatin altına düştü. Nuxt 3 ile Google sıralamaları yükseldi. 4 pazar yerinden siparişler tek panelden yönetiliyor.
Proje Bilgileri
Teknoloji Stack
Mimari
Laravel 12 backend + Nuxt 3 frontend ayrık mimari. Backend 386 RESTful API endpoint, Sanctum auth. Frontend full SSR, Pinia state management. 4 pazar yeri için ayrı service sınıfları, background job'lar ile async işlemler.
