HandyCafe Docs
owner cashier

Produk

Halaman Produk mengelola katalog item yang dijual warnet atau pusat gaming Anda. Ini termasuk makanan, minuman, makanan ringan, aksesori, dan barang fisik lainnya yang ditawarkan kepada pelanggan. Setiap produk memiliki harga, kategori, tarif pajak, dan tingkat stok yang didefinisikan. Produk terintegrasi dengan sistem pesanan, memungkinkan kasir membuat pesanan, melacak penjualan, dan mengelola inventaris.

Kolom Produk

Setiap catatan produk berisi informasi berikut:

Kolom Deskripsi
name Nama produk yang ditampilkan di antarmuka pesanan. Harus unik (tidak peka huruf besar-kecil).
category Label teks yang mengelompokkan produk terkait (misalnya "Minuman", "Makanan Ringan", "Aksesori"). Digunakan untuk pemfilteran dan pelaporan.
unit Unit pengukuran untuk pelacakan stok (misalnya "buah", "kg", "liter", "kaleng", "botol").
barcode Nilai barcode opsional untuk integrasi pemindai. Kasir dapat memindai barcode produk untuk menambahkannya dengan cepat ke pesanan.
sale_price Harga jual dalam unit minor mata uang (misalnya sen). Ini adalah jumlah yang dibebankan kepada pelanggan per unit.
vat_rate Persentase PPN (Pajak Pertambahan Nilai) yang diterapkan pada produk ini (misalnya 18 untuk PPN 18%). Digunakan untuk menghitung komponen pajak dari setiap penjualan.
stock Tingkat stok saat ini sebagai kuantitas desimal. Diperbarui otomatis saat pesanan dibuat dan saat pembelian inventaris dicatat.
active Tombol yang mengontrol apakah produk muncul di antarmuka pesanan. Produk nonaktif disembunyikan dari kasir tetapi dipertahankan di database untuk pelaporan historis.
description Deskripsi teks opsional untuk detail produk tambahan.

Tombol Aktif / Nonaktif

Produk dapat dialihkan antara status aktif dan nonaktif:

  • Produk aktif muncul di antarmuka pesanan dan dapat ditambahkan ke pesanan baru.
  • Produk nonaktif disembunyikan dari antarmuka pesanan tetapi tetap di database. Pesanan sebelumnya yang menyertakan produk mempertahankan referensinya sehingga data penjualan historis terjaga.

Ini berguna untuk item musiman, produk yang dihentikan, atau item yang sementara habis stok dan tidak boleh ditawarkan kepada pelanggan.

Pelacakan Stok

HandyCafe memelihara hitungan stok berjalan untuk setiap produk. Nilai ini secara otomatis diperbarui oleh sistem sebagai respons terhadap:

  • Penjualan: Saat produk dijual melalui pesanan, stok berkurang sesuai kuantitas yang dipesan.
  • Pembelian inventaris: Saat stok baru diterima dan dicatat di halaman Inventaris, stok meningkat.
  • Penyesuaian manual: Kasir atau administrator dapat menyesuaikan tingkat stok secara manual untuk memperhitungkan kerusakan, pecah, kesalahan hitung, atau perbedaan lainnya.

Log Stok Produk

Setiap perubahan pada tingkat stok produk dicatat dalam log stok produk, membuat jejak audit lengkap:

Alasan Deskripsi
sale Stok berkurang karena pesanan pelanggan. Menautkan ke catatan pesanan spesifik.
purchase Stok meningkat karena pembelian inventaris. Menautkan ke entri inventaris spesifik.
adjustment Stok disesuaikan secara manual oleh kasir atau administrator.
waste Stok berkurang karena kerusakan, pecah, atau penghapusan.
return Stok meningkat karena pengembalian pelanggan atau pembatalan pesanan.

Setiap entri log mencatat perubahan kuantitas (positif untuk peningkatan, negatif untuk penurunan), tingkat stok baru setelah perubahan, siapa yang melakukan perubahan, dan catatan opsional yang menjelaskan alasan.

Kategori Produk

Produk dikelompokkan berdasarkan kategori menggunakan kolom teks bebas. Kategori umum meliputi:

  • Minuman (minuman ringan, air, minuman energi)
  • Minuman Panas (kopi, teh, cokelat panas)
  • Makanan Ringan (keripik, permen, batangan cokelat)
  • Makanan (sandwich, wrap, makanan panas)
  • Aksesori (headset, USB drive, mouse pad)

Kategori digunakan untuk pemfilteran di antarmuka pesanan. Kasir dapat dengan cepat beralih antar kategori untuk menemukan produk yang tepat. Kategori juga berfungsi untuk pengelompokan dalam laporan penjualan.

Tidak ada antarmuka manajemen kategori terpisah. Kategori dibuat secara implisit saat Anda menetapkan nama kategori ke produk. Untuk mengganti nama kategori, perbarui kolom kategori pada semua produk yang menggunakan nama lama.

Membuat Produk

Untuk menambahkan produk baru ke katalog:

  1. Navigasikan ke halaman Produk dari bilah samping.
  2. Klik tombol Tambah Produk di bilah alat.
  3. Masukkan nama (harus unik).
  4. Pilih atau ketik kategori.
  5. Pilih unit pengukuran.
  6. Atur harga jual (jumlah yang dibebankan kepada pelanggan, dalam unit minor mata uang).
  7. Atur tarif PPN (sebagai desimal, misalnya 0,08 untuk 8%).
  8. Secara opsional masukkan barcode untuk dukungan pemindai.
  9. Atur tingkat stok awal jika berlaku.
  10. Klik Simpan.

Mengedit Produk

Pilih produk dari daftar untuk membuka tampilan detailnya. Anda dapat memperbarui kolom apa pun termasuk nama, harga, kategori, tarif PPN, tingkat stok, dan status aktif. Perubahan berlaku segera. Jika Anda memperbarui harga, harga baru berlaku untuk semua pesanan mendatang.

Pesanan sebelumnya tidak terpengaruh oleh perubahan harga. Setiap item pesanan menyimpan unit_price pada saat penjualan sebagai snapshot.

Integrasi dengan Pesanan

Saat kasir membuat pesanan dan menambahkan produk:

  1. Harga jual dan tarif PPN produk saat ini disalin ke item pesanan sebagai snapshot.
  2. Total baris dihitung sebagai unit_price * qty.
  3. Saat pesanan diselesaikan, tingkat stok produk dikurangi sesuai kuantitas yang dipesan.
  4. Entri log stok dibuat dengan reason = 'sale' yang menautkan ke pesanan.

Jika pesanan kemudian dibatalkan atau dikembalikan, stok dapat dipulihkan melalui entri log stok pengembalian.