كتالوج المنتجات / الخدمات

كتالوج المنتج / الخدمة في Mewayz

إضافة المنتج / الخدمة هي كتالوج المخزون المشترك المستخدَم من قبل المحاسبة وCRM ونقطة البيع وEcomStore وBookings.

Mewayz- الوحدة الأصلية — لا Mewayz المنبع. التوثيق مؤلف من مصدر الحزمة في packages/mewayz/ProductService/.

رابط العرض التجريبي

مقدمة

إضافة المنتج / الخدمة هي مصدر واحد للحقيقة لكل عنصر قابل للبيع عبر منصة Mewayz. بدلاً من احتفاظ كل وحدة (المبيعات، ونقاط البيع، وEcomStore، والحجوزات) بقائمة المنتجات الخاصة بها، فإن جميعها تقرأ من كتالوج مشترك واحد وتكتب فيه. وهذا يعني أنه عندما يقوم المشغل بإنشاء منتج جديد في المنتج/الخدمة، يكون هذا المنتج قابلاً للاستخدام على الفور على كل سطح مبيعات، مع مزامنة أعداد المخزون والقواعد الضريبية.

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

كيفية تمكين هذه الوحدة

لإعداد إضافة المنتج / الخدمة، يمكنك اتباع هذا الرابط: إضافة الإعداد.

الإضافة مقيّدة بـ PlanModuleCheck:ProductService. تجمع معظم الخطط الموجّهة للمبيعات هذا افتراضيًا — تعتمد جميعها POS و Account و EcomStore و Bookings على كونه نشطًا.

الأصناف

تصفّح العناصر

• انتقل إلى المنتج والخدمة ← العناصر في الشريط الجانبي.
• يعرض عرض القائمة جميع العناصر التي يمكن للمشغّل إدارتها، مع فلاتر لـ الاسم، النوع (منتج أو خدمة)، الفئة، و الحالة النشطة.
• يعرض كل صف رمز SKU، وسعر البيع، وسعر الشراء، وإجمالي المخزون الحالي في المستودع، وأزرار الإجراءات السريعة (عرض، تعديل، حذف).

إنشاء عنصر جديد

• انقر + عنصر جديد في أعلى يمين قائمة العناصر.
• يحتوي النموذج على الحقول التالية:
• الاسم — الاسم المعروض الظاهر في القوائم المنسدلة عبر المنصة
• النوع — منتج (متتبَّع المخزون) أو خدمة (بلا مخزون)
• SKU — وحدة حفظ مخزون اختيارية (فريدة لكل مستأجر)
• الفئة — اختر من الفئات الموجودة، أو أنشئ فئة جديدة مضمّنة
• وحدة — وحدة القياس (كل، كجم، ساعة، متر مربع، إلخ.)
• سعر البيع — السعر الافتراضي عند ظهور هذا العنصر في فاتورة أو طلب
• سعر الشراء — التكلفة الافتراضية عند استلام المخزون
• الضرائب — تحديد متعدد لمعدلات الضرائب التي تنطبق على هذا العنصر
• صورة — صورة المنتج المستخدمة بواسطة EcomStore + POS
• الوصف — وصف طويل؛ تستخدمه صفحات تفاصيل EcomStore
• انقر حفظ لإنشاء العنصر. حدث (CreateProductServiceItem) يُرسَل ليتمكّن المستمعون في وحدات أخرى من التفاعل (مثلًا، إعادة فهرسة فهرس البحث).

تعديل / حذف عنصر

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

إدارة المخزون

• انتقل إلى المنتج والخدمة → المخزون في الشريط الجانبي.
• تجمّع عرض المخزون العناصر حسب المستودع حتى يتمكن المشغّل الذي لديه مواقع فعلية متعددة من رؤية الكميات الدقيقة في كل موقع.
• يعرض كل صف العنصر، والمستودع، والكمية الحالية، وتاريخ آخر حركة.

إضافة المخزون أو تعديله

• انقر إضافة مخزون لتسجيل حركة الأسهم.
• اختر العنصر، الـ المستودع، الـ الكمية (موجب للوارد، وسالب للتسوية الصادرة)، و ملاحظة.
• يُسجَّل كل حركة؛ ولا يقوم الكتالوج أبداً بمجرد "تحديث رقم" — كل تغيير قابل للتدقيق.

الفئات

• انتقل إلى المنتجات والخدمات ← الفئات.
• الفئات إما مسطحة أو هرمية (الأصل → الفرع). يمكن أن يكون لكل فئة وسم لوني ينعكس ذلك في قائمة العناصر وعلى صفحات قوائم EcomStore.
• تتبع عمليات الإنشاء/التعديل/الحذف نمط CRUD القياسي.

الضرائب

• انتقل إلى المنتج والخدمة ← الضرائب.
• قم بإضافة معدلات الضرائب التي يحتاجها عمل المشغل (مثل ضريبة القيمة المضافة 15%، ضريبة المبيعات 7.25%، وما إلى ذلك).
• كل ضريبة لها الاسم، المعدل (نسبة مئوية)، و الوصف.
• ثم تُرفَق الضرائب بالعناصر عبر الاختيار المتعدد في نموذج العنصر.

الوحدات

• انتقل إلى المنتج والخدمة ← الوحدات.
• الوحدات هي التسميات المعروضة في سطر السلة / الفاتورة — "للوحدة"، "كجم"، "ساعة"، "جلسة"، "م²"، إلخ.
• Mewayz يشحن مجموعة البداية؛ إضافة أو إعادة تسمية لتتناسب مع مفردات الصناعة الخاصة بالمشغل.

السلوك عبر الوحدات

وحدات Mewayz أخرى استهلاك كتالوج المنتجات / الخدمات:

• الحساب الوحدة — تختار فواتير المبيعات وفواتير الشراء بنود الأصناف من هذا الكتالوج.
• CRM / المبيعات — بنود الصفقة والعروض تشير إلى الأصناف.
• نقطة البيع وحدة — تسحب مبيعات نقطة البيع قائمة المنتجات مباشرةً.
• EcomStore وحدة — تُعرض منتجات واجهة المتجر من هذا الكتالوج مع تصفح حسب الفئة.
• الحجوزات وحدة — كتالوج الخدمات للخدمات القابلة للحجز.
• مُولِّد مستندات API الوحدة — توثّق نقاط نهاية واجهة برمجة التطبيقات العامة للوصول البرمجي (/api/products، إلخ.).

الأذونات

تحدّد الحزمة أذونات دقيقة:

• manage-product-service-item — إدارة كاملة
• create-product-service-item — إنشاء عناصر جديدة
• manage-any-product-service-item — تعديل أي عنصر للمستأجر
• manage-own-product-service-item — تعديل العناصر المُنشأة ذاتيًا فقط

عيّن هذه عبر الإعدادات ← الأدوار والأذونات.

الوصول إلى واجهة برمجة التطبيقات

تتيح الحزمة أيضاً GET /api/product-service/items كنقطة نهاية داخلية موثَّقة المصادقة تعرضها الوحدات الأخرى ومولّد وثائق API بصفتها GET /api/products.

ملاحظات المشغّل

• حركات المخزون غير قابلة للتغيير — ”لعكس“ حركة ما، سجّل حركة جديدة في الاتجاه المعاكس بدلاً من تعديل الصف الأصلي.
• عند حذف العناصر التي لديها مخزون متوفر، يحذّر النظام قبل السماح بالإجراء.
• تُخزَّن صور العناصر ضمن storage/app/public/product-service/ وتُقدَّم عبر storage رابط رمزي (symlink). بعد رفع صورة جديدة، تُطبَّع إلى اسم ملف واحد في قاعدة البيانات؛ ويُحتسَب عنوان URL العام وقت العرض.