Ürüne Genel Bakış ve Mimari — RUTHH COD Form & Upsells

RUTHH COD Form & Upsells uygulamasının temel alt sistemlerini, Shopify Yönetim Paneli’nde kaydettiğiniz değişikliklerin revizyon kilitli metafield anlık görüntüleriyle (snapshot) mağaza ön yüzüne nasıl aktarıldığını ve sunucunun her kapıda ödeme siparişini nasıl doğrulayıp fiyatlandırdığını öğrenmek.

• Online Store 2.0 uyumlu bir tema kullanan Shopify mağazası.
• Shopify Yönetim Paneli’nde uygulamaları, temaları ve siparişleri görüntüleme yetkisine sahip mağaza sahibi veya personel hesabı.

Shopify Yönetim Paneli’nde RUTHH COD Form & Upsells uygulamasını açtığınızda sol menü sekiz çalışma alanından oluşur:

1. Home (/app): Kurulum kontrol listesi, canlı Tema Uygulama Uzantısı (App Embed) durum rozeti ve 24h, 7d, 14d veya 30d tarih filtreli performans özeti (Form Opens, Orders veya Orders / Draft Orders, Conversion Rate, Revenue, AOV).
2. Form Builder (/app/form-builder):
   • Form Designer (/app/form-builder): Form alanları, zorunlu/görünür kuralları, ülke/il/ilçe kademeli seçimi, görsel şablonlar, buton ikon ve animasyonları, RTL/LTR yönü ve özel CSS.
   • Shipping Rates (/app/form-builder/shipping-rates): Koşullu COD kargo kuralları ve tek tıkla Shopify Kargo profili içe aktarma.
   • Thank You Page (/app/form-builder/thank-you): Sipariş sonrası onay penceresi içeriği ve yönlendirme davranışları.
3. Sales Booster (/app/sales-booster):
   • Quantity Offers (/app/sales-booster/quantity-offers): Kademeli adet indirimleri (AKTİF).
   • Bundles (/app/sales-booster/bundles): Çoklu ürün paketleri (YÖNETİM PANELİ VE V2 SNAPSHOT HAZIR).
   • One-Tick Upsells (/app/sales-booster/one-tick-upsells): Tek kutucuklu ürün ek satışları ve bağımsız hizmet ücretleri (YÖNETİM PANELİ VE V2 SNAPSHOT HAZIR).
   • Downsells (/app/sales-booster/downsells): Vazgeçme anı indirim pencereleri (AKTİF).
   • Post-Purchase Upsells (/app/sales-booster/post-purchase-upsells): Sipariş sonrası tek tıkla ek satışlar (POST_PURCHASE_RUNTIME ile PİLOT BAYRAKLI).
4. Fraud Protection (/app/fraud): Kullanıcı Engelleme hız limitleri (velocity), mükerrer sipariş tespiti, maksimum ürün adedi sınırları, telefon/e-posta/IP kara listeleri ve güvenilir IP izin listesi.
5. Integrations (/app/integrations):
   • Google Sheets (/app/integrations/google-sheets): OAuth drive.file ile gerçek zamanlı sipariş ve satır aktarımı.
   • SMS & WhatsApp (/app/integrations/messaging): Telefon OTP ve WhatsApp onay çalışma alanı (canlı gönderimler harici sağlayıcı aktivasyonuna kadar kapalıdır).
6. Analytics (/app/analytics): Huni adımları (cod:form_open, cod:form_submit, cod:order_created) ve gelir kırılımı.
7. Settings (/app/settings):
   • Visibility (/app/settings): Gösterim yüzeyleri, Popup ve Gömülü mod, yerel buton gizleme, ürün/koleksiyon hedefleme ve ara toplam sınırları.
   • General (/app/settings/general): Standart Sipariş veya Taslak Sipariş modu, varsayılan etiketler, UTM aktarımı, Ek COD Ücreti, sipariş sonrası hedefler ve bildirim kişileri.
   • Pixels (/app/settings/pixels): Meta Pixel + CAPI, TikTok Pixel + Events API 2.0, GA4, Google Ads ve Pinterest Tag.
8. Pricing (/app/pricing): Paket kademeleri (Free, Basic, Growth, Unlimited), döngüsel sipariş kullanımı ve 24 saatlik ek süre durumu.

1. Yönetim Panelinde Kaydetme: Form Designer, Visibility, Shipping Rates veya Sales Booster ekranlarında değişiklik yaptığınızda Shopify App Bridge SaveBar çubuğu açılır. Save (Kaydet) butonuna bastığınızda doğrulanmış ayarlar veritabanına yazılır ve revision numarası artırılır.
2. Metafield Snapshot Projeksiyonu: Arka plan yayınlama işçisi (worker), aktif yapılandırmayı AppInstallation metafield alanlarına (120 KiB üst sınırıyla) yazar:
   • cod_form.v2_snapshot (storefront-form/v1 — form alanları, görünüm, görünürlük ve isteğe bağlı additionalCodFee)
   • cod_shipping.v1_snapshot (shipping-config/v1 — koşullu COD kargo ücretleri)
   • cod_offers.v1_snapshot (quantity-offer/v1 — aktif adet indirimi kademeleri)
   • cod_downsell.v1_snapshot (downsell/v1 — vazgeçme anı indirim penceresi)
   • cod_boosters.v1_snapshot (sales-booster/v2 — ürün paketleri ve tek tıkla ek satış/hizmet ücretleri)
   • cod_thank_you.v1_snapshot (thank-you/v1 — form içi teşekkür görünümü)
3. Mağaza Ön Yüzünde Anında Yükleme: Temanız bu metafield verilerini cod-app-embed.liquid uzantısı üzerinden sayfa açılışını yavaşlatmadan doğrudan okur.
4. Sunucu Doğrulamalı Sipariş Kabulü: Alıcı fiyat sorgusu (POST /app-proxy/cart-quote) veya sipariş (POST /app-proxy/order-intents) gönderdiğinde sunucu, submittedFormConfigRevision değerini kontrol eder, ürün/koleksiyon uygunluğunu yeniden doğrular, indirim ve ücretleri mağaza para biriminin alt biriminde (kuruş/cent) hesaplar ve Shopify Siparişini veya Taslak Siparişi oluşturur.

• Kaydedilen değişiklikler mağazada hemen görünmüyor: SaveBar kaydı tamamladıktan sonra mağaza sayfasını yenileyin. Kayıt öncesinde açık kalmış eski bir sekmeden form gönderilirse sunucu FORM_CONFIG_REVISION_MISMATCH yanıtı döndürerek güncel yapılandırmanın yüklenmesini sağlar.
• KPI kartlarında Orders / Draft Orders görünüyor: Bu başlık, Settings → General altında Save as Draft Order modu seçildiğinde veya seçili tarih aralığında taslak sipariş bulunduğunda otomatik olarak gösterilir.

• Kurulum ve Tema Uygulama Uzantısı (App Embed)
• Görünürlük ve Gösterim Kuralları
• Sipariş Oluşturma Modları ve Google E-Tablolar Aktarımı