# Magostore Marketplace — Yol Haritası Mevcut durum: Laravel 12.48.1 tabanlı, çok satıcılı e-ticaret çekirdeği. 169 tablo, veri boş (temiz kurulum). Tema: Farmart. Aktif ödeme: iyzico eklentisi mevcut. Dil: TR. Hedef listeye (Trendyol seviyesi, 27 bölüm) göre kapsama: **~%40 hazır, ~%35 yapılandırma/eklenti, ~%25 sıfırdan mühendislik.** --- ## FAZ 0 — Temizlik ve Marka Değişimi ⏱ 1 gün ✅ BU PAKETTE Sistemin adı her görünür yerde "Magostore Marketplace" olur, çöp dosyalar temizlenir. | İş | Dosya/Yer | |---|---| | Debugbar çöpü sil (~650 MB) | `storage/debugbar/*` | | Debugbar'ı kapat | `.env` + `config/app.php` | | Marka string'leri | 7 blade dosyası (`magostore-rebrand.sh` yapıyor) | | Session cookie adı | `botble_session` → `magostore_session` | | Cookie-consent JS değişkeni | `window.botbleCookieConsent` → `window.magostoreCookieConsent` | | Tema meta bilgisi | `platform/themes/farmart/theme.json` | | Admin başlığı + logo | Panel → Ayarlar → Genel | **Dokunulmayanlar (kasıtlı):** `Botble\` PHP namespace'leri, `theme.json` içindeki `id` ve `namespace` alanları, `core/base/src/Supports/Core.php` ve `MembershipAuthorization.php`. İlk ikisi teknik olarak kırılır; son ikisi lisans doğrulama yolun — kendi lisansınla aktive etmen gerekiyor, oynanacak yer değil. --- ## FAZ 1 — cPanel'e Kurulum ve Sağlamlaştırma ⏱ 1–2 gün ✅ BU PAKETTE Detaylar: `01-FAZ1-cpanel-kurulum.md` Kritik düzeltmeler: - `APP_DEBUG=true` + `APP_ENV=production` birlikteydi → canlıda DB kullanıcı adına kadar sızdırır - `QUEUE_CONNECTION=sync` → her sipariş e-postası müşteriyi checkout'ta bekletiyor - `SESSION_SECURE_COOKIE=false` → HTTPS'te true olmalı - `ADMIN_DIR=panel` → tahmin edilebilir, değiştir --- ## FAZ 2 — Türkçeleştirme ve Temel İş Kuralları ⏱ 3–5 gün ✅ PAKETLENDİ Detaylar: `02-FAZ2-is-kurallari.md` + `komisyon-ve-kesintiler.xlsx` Kod yazmadan önce **kararların netleşmesi** gereken faz. Listenin 27. bölümü tam olarak bu. Karar seti önerilen değerlerle dolu halde hazır; onay bekleyen 11 ticari karar var. Bu fazda çıkan **mevzuat kaynaklı zorunluluklar** (A1–A11) yazılım mimarisini değiştirdi: - **Hakediş: teslimat + en fazla 5 iş günü, eksiksiz.** 6563 s. Kanun Ek m.1/2-a. "Her durumda haksız ticari uygulama" — istisnası yok. Uzun bloke süresi kurulamaz. - **%1 stopaj** pazaryeri tarafından kesilip beyan edilir; matrah KDV hariç brüt satış. - **Her kesinti kalemi sözleşmede oran/tutar olarak yazılı** olmak zorunda. - **Sözleşme geçmişe dönük değiştirilemez** → sipariş komisyon oranını snapshot'lamalı. - **Satıcıyı kampanyaya zorlamak yasak** → davet/onay akışı gerekli. - **Askıya alma bir süreç** (3 iş günü açıklama + 7 iş günü karar), buton değil. - **Dâhili iletişim sistemi**, yıllık satıcı bilgi doğrulaması, marka ihlali kaldırma akışı. > Bu maddeler avukat ve mali müşavir teyidinden geçmeli. Ben avukat değilim. --- ## FAZ 3 — Türkiye Entegrasyon Paketi + Hakediş Çekirdeği ⏱ 4–5 hafta ⚠ KAPSAM GENİŞLEDİ Bu olmadan sistem Türkiye'de çalışmaz. Sıralama önem sırasına göre: **3a. iyzico Pazaryeri / alt üye işyeri (submerchant)** — en kritik Mevcut `fob-iyzipay` eklentisi tek üye işyeri modeli için yazılmış olabilir; submerchant desteği kontrol edilip yoksa eklenecek. Neden önemli: alt üye işyeri modelinde para hiç sana uğramaz, doğrudan satıcıya bloke edilip serbest bırakılır. Parayı sen tutup dağıtırsan **ödeme kuruluşu lisansı** sorusu doğar. Bu teknik değil hukuki bir tercih. **3b. Hakediş çekirdeği — Faz 5'ten buraya taşındı** 5 iş günü kuralı, iade rezervini ödeme *sonrasına* taşıyor: parayı tutamadığın için iadeyi mahsupla çözmek zorundasın. Yani ilk gerçek ödemeyi yaptığın gün şunlar çalışıyor olmak zorunda: - `mp_customer_revenues`'a `stopaj_matrahi` + `stopaj_tutari` alanları - Satıcı borç bakiyesi ve negatif bakiye yönetimi - Mahsup hareketleri (iade → borç → sonraki hakedişten düşme) - Her iş günü çalışan hakediş işi (haftalık batch yasal sınırı aşar) - Sipariş üzerinde komisyon oranı snapshot'ı **3c. Kargo entegrasyonları** — mevcut `shippo` eklentisi TR'de işe yaramaz, kaldırılacak Yurtiçi, Aras, MNG, Sürat, PTT. Her biri için: fiyat sorgulama, gönderi oluşturma, barkod/etiket PDF, durum webhook'u, iade kodu. **3d. e-Arşiv / e-Fatura** — özel entegratör (Paraşüt, Logo, Uyumsoft, Nilvera vb.) Çok satıcılı yapıda faturayı **satıcı keser**, pazaryeri sadece taşır ve arşivler. Pazaryeri kendi komisyon faturasını satıcıya keser. İki ayrı akış. **3e. Mevzuat uyum modülü** — A3–A9'un yazılım karşılıkları Sözleşme versiyonlama, dâhili iletişim sistemi, yaptırım süreç motoru, yıllık doğrulama kampanyası, marka ihlali kuyruğu. **3f. Taksit tablosu** — BIN bazlı banka taksit sorgusu (iyzico API'si veriyor) **3g. Kapıda ödeme** — kapıda ödeme hizmet bedeli + satıcıya risk devri kuralı **3h. Muhtasar + BTRANS raporlaması** — aylık stopaj beyanı için dışa aktarma **3i. ETBİS kaydı** — teknik değil idari, ama canlıya çıkmadan yapılmalı --- ## FAZ 4 — Ortak Ürün Kataloğu + Buybox ⏱ 6–10 hafta ⚠ EN BÜYÜK İŞ Sistemin şu anki mantığı: her satıcı kendi ürününü sıfırdan açar. Aynı telefonu 40 satıcı satıyorsa 40 ayrı ürün sayfası olur. Trendyol mantığı: **tek ürün sayfası, satıcılar teklif verir, kazanan buybox'ı alır.** Bunu sonradan eklemek ürün listeleme, arama, ürün detay, sepet ve komisyon akışının yeniden yazılması demek. **Bu yüzden Faz 4'te değil, Faz 3 ile paralel başlaması gereken bir karar var: katalog mimarisini şimdi mi kuracağız, yoksa "her satıcı kendi ürünü" ile mi canlıya çıkıp sonra göç edeceğiz?** Yeni yapı taslağı: ``` ec_catalog_items → kanonik ürün (GTIN/barkod, marka, model, özellikler, görseller) ec_product_offers → satıcı teklifi (store_id, catalog_item_id, fiyat, stok, kargo süresi) ec_buybox_winners → hesaplanmış kazanan (cache, cron ile güncellenir) ec_catalog_matches → eşleştirme kuyruğu + moderasyon durumu ``` Buybox skoru: fiyat + kargo ücreti + teslimat süresi + satıcı puanı + stok + iptal oranı. Ağırlıklar admin'den ayarlanabilir olmalı. --- ## FAZ 5 — Hakediş Motoru v2 ⏱ 2–3 hafta (kapsam daraldı) Çekirdek (borç bakiyesi, mahsup, stopaj) Faz 3'e taşındı. Burada kalanlar: mutabakat raporu, otomatik banka ödeme dosyası, satıcı hesap ekstresi, ceza kesintisi otomasyonu, hakediş faturası üretimi, çoklu para birimi hakedişi. --- ## FAZ 6 — Reklam ve Sponsorlu Ürün ⏱ 4–6 hafta Mevcut `ads` eklentisi sadece banner. Teklif sistemi, CPC/CPM/CPA, bütçe, anahtar kelime hedefleme, ROAS raporu — hepsi sıfırdan. ## FAZ 7 — Fraud/Risk + Uyuşmazlık + SLA Destek ⏱ 4–6 hafta Risk skorlama, kara/beyaz liste, manuel inceleme kuyruğu, admin hakemliği, ticket SLA. ## FAZ 8 — Yapay Zekâ Katmanı ⏱ 4–8 hafta Öneri motoru, semantik arama, görselden ürün bulma, otomatik açıklama/kategori eşleştirme, sahte yorum tespiti, talep ve stok tahmini. --- ## Altyapı gerçeği Paylaşımlı cPanel: demo ve ilk ~100 satıcı için yeter. Ciddi trafik: VPS/dedicated + Redis + ayrı queue worker + object storage (görseller) şart. Faz 4'e girmeden önce taşınmış olmak en verimlisi.