HandyCafe Docs
owner cashier

المنتجات

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

حقول المنتج

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

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

مفتاح النشط / غير النشط

يمكن تبديل المنتجات بين الحالتين النشطة وغير النشطة:

  • المنتجات النشطة تظهر في واجهة الطلبات ويمكن إضافتها لطلبات جديدة.
  • المنتجات غير النشطة مخفية عن واجهة الطلبات لكنها تبقى في قاعدة البيانات. الطلبات السابقة التي تضمنت المنتج تحتفظ بمراجعها لحفظ بيانات المبيعات التاريخية.

مفيد للسلع الموسمية أو المنتجات المتوقفة أو السلع غير المتوفرة مؤقتًا التي لا ينبغي عرضها للعملاء.

تتبع المخزون

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

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

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

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

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

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

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

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

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

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

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

إنشاء منتج

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

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

تعديل منتج

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

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

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

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

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

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