Yayınlayan: Turkinsoft ürün ekibi · Güncellendi: 21 Temmuz 2026

Renk, beden ve model verisini ayırma

Doğru stok sonucu için “ürün” ile satılabilir “varyant” aynı şey değildir. Bu sayfa, repoda kullanılan alanları operasyonel bir sözlüğe çevirir.

Temel kavramlar

Kavram	Anlam	Örnek yaklaşım
Ürün	Ortak ad, marka, model kodu, kategori, sezon ve fiyat bilgilerini taşıyan ana kayıt.	“Bisiklet yaka tişört”
Model kodu	İşletmenin aynı tasarımı veya koleksiyon öğesini gruplamak için kullandığı kod.	İşletmenizin mevcut kodu; evrensel bir format iddiası yoktur.
Varyant	Ana ürüne bağlı, ayrı stok adedi olan seçenek kaydı.	Beden adı/kodu veya mağaza ayarına göre renk adı/kodu.
Barkod	Ürün veya yapılandırmaya göre varyantı satışta bulmak için kullanılan tanımlayıcı.	Kurulumda mevcut barkod yapınıza göre eşleştirilir.

Repoda doğrulanan ilişki

Her ana ürünün bir global_id değeri vardır.
Her varyant, product_global_id ile ana ürüne bağlanır ve kendi global_id değerini taşır.
Varyant kaydında ad, iki haneli kod ve stok alanları kullanılır; giyim akışında bunlar size, size_code ve stock olarak belgelenmiştir.
Kod ayrıca mağaza ayarına göre renk ad/kod alanlarını kullanan varyant akışına sahiptir. Renk ve bedenin birlikte nasıl modellenmesi gerektiği mevcut mağaza yapılandırmasına göre teyit edilmelidir.

Önemli sınır: Bu doküman tek bir “doğru” renk + beden şeması ilan etmez. Repoda birden fazla barkod/varyant modu bulunduğundan, canlı veriyi değiştirmeden önce mağazanızın stock_variant_mode ve barkod saklama modu destek tarafından doğrulanmalıdır.

Veri kalitesi kuralları

Aynı kavram için tek yazım kullanın: “L”, “Large” ve “Büyük” değerlerini rastgele karıştırmayın.
Görünen adı koddan ayırın. Ad kullanıcı içindir; kod eşleme ve sıralama için kararlı olmalıdır.
Model kodunu ürün adının içine gömmek yerine ayrı alanda tutun.
Varyant stoklarının toplamını ana ürün stoku ile mutabık hale getirin.
Barkodun hangi seviyeyi tanımladığına karar verin: ana ürün mü, her satılabilir varyant mı?

Örnek düşünce modeli

Bir tişörtün marka, model kodu, ad, kategori ve sezonu ortaksa bunlar ana ürün bilgisidir. “S”, “M” ve “L” seçeneklerinin ayrı stokları varsa bunlar varyanttır. Renk de ayrı stok oluşturuyorsa renk–beden kombinasyonu kurulumda veya veri aktarımında tanımlanır.

Metodoloji: Açıklama, docs/SUPABASE_PRODUCT_VARIANTS.md, stok içe aktarma ve etiketleme kodundaki alan ilişkilerine dayanır. Örnekler veri modelini anlatır; desteklenmeyen ürün veya donanım iddiası içermez.