Sıfırdan bir e-ticaret arka uç geliştirmek aylar alabilir. Kimlik doğrulama, ödemeler, envanter, kargo, yönetim paneli, testler… liste hiç bitmiyor.
Onu bir kez, doğru bir şekilde inşa etmeye ve diğer geliştiriciler için paketlemeye karar verdim. Sonuç, Laravel 12 ile inşa edilmiş eksiksiz, üretime hazır bir e-ticaret arka ucu olan LaraCommerce API oldu.
NE YAPTIM
Tüm e-ticaret kullanım durumlarını kapsayan, bir yönetim paneli, tam Stripe entegrasyonu ve %100 test kapsamı ile birlikte tam özellikli bir REST API.
NUMARALAR
API Endpoint’leri: 325+, 25+ modül
Veritabanı: 88 Eloquent modeli, 72 migration
Yönetim Paneli: Filament v3 ile 46 ekran
Testler: 2,452 test / %100 kapsama
Docker: 12 hizmet, tek komutla kurulum
Diller: 3 (İNG, FR, AR)
Para Birimleri: 7 (USD, EUR, GBP, MAD, CAD, CHF, AED)
TEKNOLOJİ YAPISI
Framework: Laravel 12 (PHP 8.5+)
Kimlik Doğrulama: Laravel Sanctum (erişim + yenileme token’ları)
Roller: Spatie Permissions (3 rol, 57 izin)
Yönetim: Filament v3
Ödemeler: Stripe PHP SDK
Arama: Meilisearch + Laravel Scout
Depolama: MinIO / AWS S3
Kuyruk: Redis + Laravel Horizon
Veritabanı: MySQL 8.4
Altyapı: Docker Compose + Nginx SSL
MODÜL ANALİZİ
Kimlik Doğrulama & Güvenlik
Sadece temel giriş/kayıt değil. API şunları destekler:
Sanctum çift token sistemi (erişim + yenileme)
Sosyal OAuth (Google, Facebook, Apple)
E-posta doğrulama ile yeniden gönderim
Şifre sıfırlama akışı
3 seviyeli hız sınırlama (standart, kimlik doğrulama, katı)
Güvenlik başlıkları middleware
Rol bazlı erişim kontrolü (müşteri, yönetici, admin)
Ürün Kataloğu
Sınırsız varyantlı ürünler (beden, renk, özel nitelikler)
İç içe kategoriler, markalar, etiketler, koleksiyonlar
Ürün resimleri MinIO/S3 üzerinden
Çeviriler (İNG, FR, AR ile RTL desteği)
Geri sayım ile flaş satışlar
İndirimli ürün grupları
Hacim bazlı fiyat seviyeleri
Sepet & Ödeme
Kupon uygulaması olan kalıcı sepet
Kupon türleri: yüzde, sabit, BOGO, ücretsiz kargo
Akıllı kargo ücreti hesaplama (düz, ağırlık bazlı, fiyat bazlı, ücretsiz)
Vergi hesaplama
Ödeme sırasında stok kesimi
Stripe Ödeme
Bunu doğru bir şekilde almak en karmaşık kısımlardan biriydi:
PaymentIntents API ile 3D Secure / SCA
Müşteri başına kaydedilmiş ödeme yöntemleri
Webhook olay yöneticileri
İade işlemleri ile doğrulama ve takip
Dahili cüzdan sistemi
Kapıda ödeme desteği
Siparişler & İade
Tam sipariş yaşam döngüsü (bekliyor → onaylandı → gönderildi → teslim edildi)
Durum geçmişi takibi
Otomatik fatura oluşturma
İptal akışı
İade talepleri işleme
Çoklu Depo Envanteri
Stok, her varyant için her depo üzerinde takip edilir
Önceki/sonraki miktarlarla hareket günlükleri
Negatif stok önleme
Düşük stok uyarıları
Otomatik yeniden sipariş bildirimleri
Pazarlama Paketi
Kuponlar & promosyon motoru
Geri sayımlı flaş satışlar
Ürün grupları
Afiş yönetimi
Haber bülteni kampanyaları
Terkettiğiniz sepet takibi
Sadakat & Müşteri Koruma
Puan sistemi (kazan & harca)
Dijital hediye kartları
Dönüşüm takibi yapan ortaklık programı
Müşteri grup segmentasyonu
Arama
Meilisearch tam metin arama
Yazım hatası toleransı
Özelleştirilmiş filtreleme
Fiyat aralığı filtreleri
Otomatik tamamlama önerileri
Birden fazla sıralama seçeneği
Bildirimler
E-posta bildirim şablonları
Uygulama içi bildirimler
Push bildirimleri (Firebase FCM)
Teslimat günlükleri ile özelleştirilmiş webhook uç noktaları
YÖNETİM PANELİ
46 tamamen yapılandırılmış Filament v3 ekranı:
Canlı satış istatistikleriyle panel
İade entegrasyonu ile sipariş yönetimi
Varyantlar, resimler, çeviriler ile ürün yönetimi
Stok ayarlamaları ile envanter
Sipariş geçmişi ile müşteri yönetimi
Kupon & promosyon yönetimi
Kargo yapılandırma
Blog & içerik yönetimi
Tam etkinlik denetim kaydı
TESTLER: %100 KAPSAM
Her denetleyici, hizmet, model, middleware ve politika test edildi.
2,452 test ile 4,808 doğrulama.
Güvenilir olmak için inşa edildi – tahmine yer yok.
DOCKER: BİR KOMUT
docker compose up -d
Hepsi bu. Tüm gerekli hizmetlerle anında çalışır.
BUNU KİMLER KULLANMALI?
Mobil uygulama geliştiren geliştiriciler
Web ön yüzleri (React, Vue, Next.js…) geliştiren geliştiriciler
Yeniden kullanılabilir bir e-ticaret temeline ihtiyaç duyan ajanslar
Aynı arka uç mantığını tekrar tekrar inşa etmekten bıkan herkes
EDİNİZ
LaraCommerce API şu adreste mevcuttur:
https://amazscript.com/products/laracommerce-api-complete-e-commerce-backend-laravel-12-x9jkbo
Kaynak: Orijinal Makale
