Qando

Ürün Ekleme ve Düzenleme

Manuel olarak yeni ürün oluşturma, temel alanlar, durum yönetimi ve soft delete.

Ürün modeli

Qando'da bir Ürün (Product) üst kavramdır. Her ürün altında birden fazla Varyant (renk/beden gibi) bulunabilir. Stok ve fiyat varyant seviyesinde tutulur — ürün seviyesinde değil. Detay: Varyantlar ve SKU Yönetimi.

Yeni ürün oluşturma

  1. Sol menüden Ürünler açın.
  2. Üst sağda Yeni Ürün butonuna basın.
  3. Form alanlarını doldurun:
    • Başlık (zorunlu)
    • Marka (opsiyonel; mevcut markalardan seç veya yeni gir)
    • Açıklama — zengin metin editörü; pazaryerlerine bu açıklama push edilir
    • Kategori — Kategori Ağacı'ndan seç
    • Taban Fiyat (basePriceMinor) — varyant override etmediyse bu fiyat geçerli
    • Para Birimi — varsayılan TRY
    • Durum — DRAFT (yayında değil), ACTIVE (yayında), ARCHIVED (arşiv)
  4. Kaydet → ürün detay sayfası açılır.

Ürün durumları

DurumAnlam
DRAFTYeni oluşturulan ürünler için varsayılan. Pazaryeri push'unda dahil edilmez.
ACTIVEYayında, push ve sync'lerde aktif
ARCHIVEDArşivlenmiş, listede gri görünür, push yapılmaz

Durumu üst sağdaki dropdown'dan değiştirebilirsiniz.

Detay sayfasının sekmeleri

Ürün detayında 4 sekme vardır:

  1. Genel Bilgi — başlık, açıklama, marka, kategori
  2. Varyantlar — renk/beden kombinasyonları (en az 1 varsayılan varyant otomatik oluşur)
  3. Görseller — varyant başına görseller; AI ile üretim
  4. Pazaryeri Push Geçmişi — bu ürünün hangi pazaryerine ne zaman push edildiği

Varsayılan varyant

Bir ürün oluşturulduğunda otomatik olarak isDefault: true bir varyant açılır. Varyant detayına gidip:

  • SKU ve Barkod doldurun
  • Pazaryeri eşleşmesi için barkod zorunludur
  • Stok ve fiyat ataması yapın

Para birimi ve fiyat

Tüm fiyatlar Minor (kuruş) cinsinden integer olarak saklanır:

  • Panel üzerinde 199.90 TL girerseniz DB'de 19990 olarak kaydedilir
  • Pazaryerine push'ta otomatik bölünür (÷100)
  • BigInt güvenli — milyar TL üzeri ürünler de sorunsuz

Soft delete (silme)

Bir ürünü sildiğinizde fiziksel olarak silinmez, deletedAt timestamp ile işaretlenir. Bu sayede:

  • Geçmiş siparişlerde ürün referansı bozulmaz
  • Geri alma mümkün (destek ile)
  • API'de otomatik filtrelenir (kullanıcıya görünmez)

Filtreleme ve arama

Ürün listesinde:

  • Arama — başlık, SKU, barkod ile
  • Durum filtresi — DRAFT/ACTIVE/ARCHIVED
  • Kategori filtresi — ağaçtan seç
  • Sayfalama — varsayılan 25/sayfa

Yaygın sorunlar

  • Yeni ürün listede görünmüyor → DRAFT olarak oluşturuldu, filtreyi ACTIVE'den DRAFT'a alın
  • Pazaryerine push edemiyorum → Durum DRAFT olabilir; ACTIVE yapın
  • Barkod kullanılıyor hatası → Aynı barkod başka bir varyantta var; tekil olmalı

Sonraki adım