HandyCafe Docs
owner cashier

المنتجات

يسرد كتالوج المنتجات السلع التي يبيعها مقهى الإنترنت أو مركز الألعاب. يشمل ذلك الأطعمة والمشروبات والوجبات الخفيفة والإكسسوارات وأي سلع مادية أخرى تُقدّم للعملاء. لكل منتج سعر وفئة ومعدل ضريبة ومستوى مخزون محدد. تتكامل المنتجات مع نظام الطلبات مما يمكّن الكاشيرين من إنشاء الطلبات وتتبع المبيعات وإدارة المخزون.

تُدار المنتجات في علامة تبويب المنتجات في صفحة المخزون ضمن التنقل الرئيسي. تتيح العلامة عرض جدول وعرض شبكة. تعرض بطاقات الشبكة صورة المنتج والسعر وشارة متوفر أو غير متوفر.

حقول المنتج

يتضمّن كل سجل منتج المعلومات التالية:

الحقل الوصف
name اسم المنتج المعروض في واجهة الطلبات. يجب أن يكون فريدًا (غير حساس لحالة الأحرف).
category تسمية نصية لتجميع المنتجات المتشابهة (مثل "مشروبات" أو "وجبات خفيفة" أو "إكسسوارات"). تُستخدم للتصفية والتقارير.
unit وحدة القياس لتتبع المخزون (مثل "قطعة" أو "كغ" أو "لتر" أو "علبة" أو "زجاجة").
barcode قيمة باركود اختيارية لتكامل الماسح الضوئي. يمكن للكاشيرين مسح باركود المنتج لإضافته سريعًا إلى الطلب.
sale_price سعر البيع بوحدات العملة الصغرى (مثل القروش). هذا المبلغ يُفرض على العميل لكل وحدة.
vat_rate نسبة ضريبة القيمة المضافة المطبّقة على هذا المنتج (مثل 18 لـ 18% ضريبة). تُستخدم لحساب عنصر الضريبة لكل عملية بيع.
stock مستوى المخزون الحالي ككمية عشرية. يُحدَّث تلقائيًا عند تقديم الطلبات وعند تسجيل إيصالات المخزون. لا يُعدَّل المخزون على المنتج نفسه. استخدم علامة تبويب حالة المخزون في صفحة المخزون.
min_stock حد إعادة الطلب. عندما ينخفض مستوى المخزون إلى هذه القيمة أو دونها يُوسم المنتج كحرج في علامة تبويب حالة المخزون. الصفر يعني عدم وجود حد.
description وصف نصي اختياري لتفاصيل المنتج الإضافية.
photo صورة منتج اختيارية تظهر في عرض الشبكة وفي قائمة الكافتيريا.

إزالة منتج من البيع

يُزال المنتج الذي لم يعد ينبغي تقديمه عبر إجراء إزالة من البيع في علامة تبويب المنتجات. يوضح التأكيد أن هذا يحذف المنتج من الكتالوج ولا يمكن التراجع عنه. الطلبات السابقة التي تضمنت المنتج تحتفظ بلقطات سطورها لحفظ بيانات المبيعات التاريخية.

تتبع المخزون

يحتفظ HandyCafe بعدد مخزون تراكمي لكل منتج. تُحدَّث هذه القيمة تلقائيًا استجابة لـ:

  • المبيعات: عند بيع منتج من خلال طلب ينخفض المخزون بالكمية المطلوبة.
  • إيصالات المخزون: عند استلام مخزون جديد وتسجيله في علامة تبويب إيصال المخزون في صفحة المخزون يزداد المخزون وفقًا لذلك.
  • التعديلات اليدوية: توفر علامة تبويب حالة المخزون إجراءات تصحيح المخزون والهدر والجرد لمراعاة التلف أو الكسر أو أخطاء العد أو التناقضات الأخرى.

لا يمكن تعديل المخزون في محرر المنتج. تمر جميع تغييرات المخزون عبر علامة تبويب حالة المخزون بحيث يُسجَّل كل تغيير في تاريخ الحركات.

سجل مخزون المنتج

كل تغيير في مستوى مخزون المنتج يُسجّل في سجل مخزون المنتج مما يُنشئ مسار تدقيق كامل:

السبب الوصف
sale انخفض المخزون بسبب طلب عميل. يرتبط بسجل الطلب المحدد.
purchase ازداد المخزون بسبب شراء مخزون. يرتبط بإدخال الجرد المحدد.
adjustment تم تعديل المخزون يدويًا من قبل كاشير أو مسؤول.
waste انخفض المخزون بسبب تلف أو كسر أو شطب.
return ازداد المخزون بسبب إرجاع عميل أو إلغاء طلب.

يسجّل كل إدخال تغيير الكمية (موجبة للزيادة وسالبة للنقصان) ومستوى المخزون الجديد بعد التغيير ومن أجرى التغيير وملاحظة اختيارية توضح السبب.

فئات المنتجات

تُجمّع المنتجات حسب الفئة باستخدام حقل نصي حر. الفئات الشائعة تشمل:

  • المشروبات (مشروبات غازية ومياه ومشروبات طاقة)
  • المشروبات الساخنة (قهوة وشاي وشوكولاتة ساخنة)
  • الوجبات الخفيفة (شيبس وحلوى وشوكولاتة)
  • الطعام (ساندويتشات ولفائف ووجبات ساخنة)
  • الإكسسوارات (سماعات وأجهزة USB ولوحات ماوس)

تُستخدم الفئات للتصفية في واجهة الطلبات. يمكن للكاشيرين التبديل بسرعة بين الفئات للعثور على المنتج المناسب. تُستخدم الفئات أيضًا للتجميع في تقارير المبيعات.

لا توجد واجهة منفصلة لإدارة الفئات. تُنشأ الفئات ضمنيًا عند تعيين اسم فئة لمنتج. لإعادة تسمية فئة حدّث حقل الفئة في جميع المنتجات التي تستخدم الاسم القديم.

إنشاء منتج

لإضافة منتج جديد إلى الكتالوج:

  1. افتح صفحة المخزون من الشريط الجانبي وانتقل إلى علامة تبويب المنتجات.
  2. انقر على زر منتج جديد.
  3. أدخل الاسم (يجب أن يكون فريدًا).
  4. اختر أو اكتب فئة.
  5. اختر وحدة القياس.
  6. حدد سعر البيع (المبلغ المفروض على العملاء).
  7. حدد معدل ضريبة القيمة المضافة.
  8. اختياريًا أدخل باركود لدعم الماسح الضوئي وأضف صورة.
  9. انقر على حفظ.

لا يُحدَّد المخزون الأولي هنا. سجّل الكمية الافتتاحية عبر إيصال مخزون أو إجراء الجرد في علامة تبويب حالة المخزون. يمكن أيضًا إنشاء منتج مباشرة من سطر إيصال عندما يحتوي التسليم على صنف غير موجود في الكتالوج بعد.

تعديل منتج

اختر منتجًا من القائمة لفتح محرره. يمكنك تحديث أي حقل بما في ذلك الاسم والسعر والفئة ومعدل الضريبة والباركود والصورة. تسري التغييرات فورًا. إذا حدّثت السعر يُطبّق السعر الجديد على جميع الطلبات المستقبلية. إجراء إزالة من البيع يحذف المنتج من الكتالوج بعد تأكيد.

لا تتأثر الطلبات السابقة بتغييرات الأسعار. يخزّن كل عنصر طلب unit_price وقت البيع كلقطة.

التكامل مع الطلبات

عندما يُنشئ كاشير طلبًا ويضيف منتجًا:

  1. يُنسخ سعر البيع الحالي ومعدل الضريبة للمنتج إلى عنصر الطلب كلقطات.
  2. يُحسب إجمالي السطر كـ سعر_الوحدة * الكمية.
  3. عند إكمال الطلب ينخفض مستوى مخزون المنتج بالكمية المطلوبة.
  4. يُنشأ إدخال سجل مخزون بالسبب sale مرتبط بالطلب.

إذا أُلغي الطلب لاحقًا أو استُرد يمكن استعادة المخزون من خلال إدخال سجل مخزون إرجاع.