Ürünler

Ürünler sayfası internet kafenizin veya oyun merkezinizin sattığı kalemlerin kataloğunu yönetir. Yiyecek, içecek, atıştırmalık, aksesuar ve müşterilere sunulan diğer fiziksel malları kapsar. Her ürünün tanımlı bir fiyatı, kategorisi, vergi oranı ve stok seviyesi vardır. Ürünler sipariş sistemiyle entegre çalışır. Kasiyerlerin sipariş oluşturmasını, satışları takip etmesini ve envanteri yönetmesini sağlar.

Ürün Alanları

Her ürün kaydı aşağıdaki bilgileri içerir:

Alan	Açıklama
`name`	Sipariş arayüzünde görünen ürün adı. Benzersiz olmalıdır (büyük/küçük harf duyarsız).
`category`	İlgili ürünleri gruplayan metin etiketi (örneğin "İçecekler", "Atıştırmalıklar", "Aksesuarlar"). Filtreleme ve raporlama için kullanılır.
`unit`	Stok takibi için ölçüm birimi (örneğin "adet", "kg", "litre", "kutu", "şişe").
`barcode`	Tarayıcı entegrasyonu için isteğe bağlı barkod değeri. Kasiyerler bir ürünün barkodunu tarayarak siparişe hızla ekleyebilir.
`sale_price`	Küçük para birimi cinsinden satış fiyatı (örneğin kuruş). Müşteriden birim başına alınan tutardır.
`vat_rate`	Bu ürüne uygulanan KDV yüzdesi (örneğin %18 için 18). Her satıştaki vergi bileşenini hesaplamak için kullanılır.
`stock`	Ondalık miktar olarak mevcut stok seviyesi. Sipariş verildiğinde ve envanter alımları kaydedildiğinde otomatik güncellenir.
`active`	Ürünün sipariş arayüzünde görünüp görünmediğini kontrol eden değiştirici. Pasif ürünler kasiyerlerden gizlenir ancak geçmiş raporlama için veritabanında tutulur.
`description`	Ek ürün detayları için isteğe bağlı metin açıklaması.

Aktif / Pasif Değiştirme

Ürünler aktif ve pasif durumlar arasında değiştirilebilir:

Aktif ürünler sipariş arayüzünde görünür ve yeni siparişlere eklenebilir.
Pasif ürünler sipariş arayüzünden gizlenir ancak veritabanında kalır. Ürünü içeren geçmiş siparişler başvurularını korur. Geçmiş satış verileri korunur.

Sezonluk ürünler, üretimi durdurulan ürünler veya geçici olarak stokta olmayan ve müşterilere sunulmaması gereken ürünler için kullanışlıdır.

Stok Takibi

HandyCafe her ürün için cari stok sayımı tutar. Bu değer şu durumlarda sistem tarafından otomatik olarak güncellenir:

Satışlar: Bir ürün sipariş yoluyla satıldığında stok sipariş edilen miktar kadar azalır.
Envanter alımları: Yeni stok alınıp Envanter sayfasında kaydedildiğinde stok buna göre artar.
Elle ayarlamalar: Kasiyerler veya yöneticiler bozulma, kırılma, sayım hataları veya diğer uyuşmazlıkları hesaba katmak için stok seviyesini elle ayarlayabilir.

Ürün Stok Kaydı

Bir ürünün stok seviyesindeki her değişiklik eksiksiz bir denetim izi oluşturan ürün stok kaydında tutulur:

Neden	Açıklama
`sale`	Müşteri siparişi nedeniyle stok azaldı. Belirli sipariş kaydına bağlanır.
`purchase`	Envanter alışı nedeniyle stok arttı. Belirli envanter girişine bağlanır.
`adjustment`	Stok bir kasiyer veya yönetici tarafından elle ayarlandı.
`waste`	Bozulma, kırılma veya zayi nedeniyle stok azaldı.
`return`	Müşteri iadesi veya sipariş iptali nedeniyle stok arttı.

Her kayıt girişi miktar değişikliğini (artışlar için pozitif, düşüşler için negatif), değişiklikten sonraki yeni stok seviyesini, değişikliği kimin yaptığını ve nedeni açıklayan isteğe bağlı bir notu kaydeder.

Ürün Kategorileri

Ürünler serbest metin alanı kullanılarak kategoriye göre gruplanır. Yaygın kategoriler:

İçecekler (gazlı içecekler, su, enerji içecekleri)
Sıcak İçecekler (kahve, çay, sıcak çikolata)
Atıştırmalıklar (cips, şeker, çikolata)
Yiyecekler (sandviçler, dürüm, sıcak yemekler)
Aksesuarlar (kulaklıklar, USB bellekler, fare altlıkları)

Kategoriler sipariş arayüzünde filtreleme için kullanılır. Kasiyerler doğru ürünü bulmak için kategoriler arasında hızla geçiş yapabilir. Kategoriler ayrıca satış raporlarında gruplama için de kullanılır.

Ayrı bir kategori yönetim arayüzü yoktur. Kategoriler bir ürüne kategori adı atadığınızda örtük olarak oluşturulur. Bir kategoriyi yeniden adlandırmak için eski adı kullanan tüm ürünlerde kategori alanını güncelleyin.

Ürün Oluşturma

Kataloğa yeni bir ürün eklemek için:

Kenar çubuğundan Ürünler sayfasına gidin.
Araç çubuğundaki Ürün Ekle düğmesine tıklayın.
Ad girin (benzersiz olmalı).
Bir kategori seçin veya yazın.
Ölçüm birimini seçin.
Satış fiyatını belirleyin (müşteriden alınan tutar, küçük para birimi cinsinden).
KDV oranını ayarlayın (ondalık olarak, örneğin %8 için 0.08).
Tarayıcı desteği için isteğe bağlı bir barkod girin.
Varsa başlangıç stok seviyesini belirleyin.
Kaydet'e tıklayın.

Ürün Düzenleme

Detay görünümünü açmak için listeden bir ürün seçin. Ad, fiyat, kategori, KDV oranı, stok seviyesi ve aktif durumu dahil herhangi bir alanı güncelleyebilirsiniz. Değişiklikler hemen geçerli olur. Fiyatı güncellerseniz yeni fiyat tüm gelecek siparişlere uygulanır.

Geçmiş siparişler fiyat değişikliklerinden etkilenmez. Her sipariş kalemi satış anındaki unit_price değerini anlık görüntü olarak saklar.

Siparişlerle Entegrasyon

Bir kasiyer sipariş oluşturup ürün eklediğinde:

Ürünün mevcut satış fiyatı ve KDV oranı sipariş kalemine anlık görüntü olarak kopyalanır.
Satır toplamı birim_fiyat * miktar olarak hesaplanır.
Sipariş tamamlandığında ürünün stok seviyesi sipariş edilen miktar kadar düşürülür.
Siparişe bağlanan reason = 'sale' ile bir stok kaydı girişi oluşturulur.

Sipariş daha sonra iptal edilir veya iade yapılırsa stok bir iade stok kaydı girişi aracılığıyla geri yüklenebilir.