← العودة للفهرس

المنتجات

سجل SKU في المخزون: الكفالة، QR، الأسعار الديناميكية، المواصفات الفنية. ليس صفحة الموقع — للنشر على المتجر أنشئ Storefront Product.

المجموعة: Products & Categories اسم القائمة: Products الرابط: /admin/products الأيقونة: صندوق أرشيف الخطوة 6 في ترتيب الإنشاء

الغرض ومنطق العمل

كل Product = وحدة مخزون واحدة (UAN/SKU). يُربط بفئة ونوع منتج. المواصفات تُملأ من Category Specs تلقائياً. السعر الفعلي يأتي من Product Prices (مجموعة Pricing) وليس من حقول Legacy في التبويب.

Visible (inventory) ≠ نشر الموقع. ظهور المنتج على الموقع يتطلب Storefront Product مع is_visible = on.

راجع خريطة إنشاء المنتج للترتيب الكامل.

الارتباطات

المورد	الحقل	الأثر
Categories	`category_id` — مطلوب	يُملأ Product Type من default الفئة. يُحمّل تبويب Specifications.
Product Types	`product_type_id` — مطلوب	يظهر كشارة. يتحكم بظهور تبويب Battery Specs.
Suppliers	`supplier_id` — اختياري	المورد/المصنع. عند حذف المورد يُفرَّغ الرابط.
Category Specs	→ ProductSpecValue	قيم المواصفات تُحفظ عند Create/Edit عبر حقول `spec_{id}`.
Product Prices	RelationManager Prices	شريحة + نوع + قيمة. المصدر الأساسي للسعر في التطبيق.
Storefront Products	Variants → `product_id`	SKU يُربط بصفحة المتجر عبر Variants أو رابط مباشر.
الكفالة	`warranty_months`، UAN	تسجيل الكفالة من التطبيق يعتمد على UAN والسيريال.
التطبيق (V1)	API /api/items	قائمة المنتجات والبحث والفلاتر.

صورة تقريبية — القائمة

Products+ New

UAN	Name EN	Type	Category	Price	In Stock
ML-PL-18W	Panel Light 18W	Lighting	Panel Lights	45,000	✓	Edit · QR · Delete

أوامر الصف: Edit، View QR (نافذة SVG)، Download QR، Delete، Restore. Bulk: Delete، Restore، Export QR ZIP (صلاحية manage products).

تبويبات النموذج

1 — General

Create Product — General

Category *

Panel Lights

Product Type *

← من الفئة

Super Category

Lighting (placeholder)

Product domain

Lighting / إنارة

Supplier / Factory

—

UAN / SKU

ML-PL-18W

Name EN *

Panel Light 18W

Name AR

لوح إنارة 18 واط

Slug

panel-light-18w

Main image

products/images

الحقل	التقني	ملاحظات
Category	`category_id`	مطلوب، live — يملأ Type وSpecs.
Product Type	`product_type_id`	مطلوب. يُملأ من default الفئة.
UAN / SKU	`uan`	للمخزون وQR والكفالة.
Descriptions / Features	`description_*`, `features_en`	Features EN للمنتجات غير البطارية.
Images	`main_image`, `secondary_image`	JPG/PNG/WebP — 5MB.

2 — Pricing & Stock

القسم	الحقول	ملاحظات
Dynamic Pricing	Placeholder	الأسعار الفعلية في RelationManager Prices أو Product Prices.
Legacy Pricing (مطوي)	`price_retail`, wholesale, half_wholesale, vip	للتوافق القديم فقط. المنتجات الجديدة لا تعتمد عليها.
Stock & Availability	`warranty_months`, `stock_quantity`, `is_in_stock`, `is_visible`, `index_number`	is_visible = ظهور في المخزون/التطبيق وليس الموقع.

3 — Battery Specs (شرطي)

يظهر فقط إذا: نوع المنتج يحتوي «battery»، أو الفئة بطاريات، أو المنتج له حقول بطارية مملوءة.

الحقول: Capacity (Ah)، Weight، Terminals، Cycles، Cell Type/Brand، Made In، Shipper، Size Package.

4 — Links & Files

روابط Google Play / App Store، User Manual، Datasheet، Test Report، Cell Datasheet، Bluetooth App (APK)، PC App، Tags.

5 — Specifications (ديناميكي)

يُبنى من Category Specs النشطة للفئة المختارة. كل مواصفة = حقل spec_{id} حسب input_type (text/number/select/textarea/boolean). عند الحفظ يُنشأ/يُحدَّث ProductSpecValue.

إن لم تُختر Category أو لا توجد specs نشطة: رسالة «Select a category» أو «No specifications defined».

Relation Managers (صفحة التعديل)

التبويب	الغرض	صلاحية
Images	صور إضافية + is_primary	manage products
Files	ملفات حسب file_type	manage products
Prices	segment_id + pricing_type_id + value. لا تكرار لنفس الثلاثي.	manage products
Storefront Products	قراءة فقط — روابط لصفحات المتجر المرتبطة.	—

خطوات إنشاء منتج جديد

تأكد من: Product Type، Super Category، Category، Category Specs (إن لزم).
Products → + New.
تبويب General: اختر Category → تحقق من Type → UAN → Name EN/AR → صورة.
تبويب Specifications: املأ المواصفات المطلوبة (is_required).
تبويب Pricing & Stock: warranty، stock، In Stock.
Save.
من التعديل: تبويب Prices → أضف أسعاراً (أو من Product Prices).
أنشئ Storefront Product + Variants لنشر الموقع.

أين يظهر؟

الواجهة	متى يظهر
تطبيق الجوال (V1)	عند is_visible ووجود أسعار. API /api/items.
موقع المتجر (V2)	فقط عبر Storefront Product/Variant مرتبط بهذا SKU.
QR / الكفالة	UAN يولّد QR. التسجيل يعتمد على المنتج والسيريال.

أخطاء شائعة

المشكلة	السبب	الحل
لا يظهر سعر في الجدول	لا Product Prices	أضف سعراً في Prices أو Product Prices.
المنتج غير ظاهر على الموقع	لا Storefront أو is_visible off	أنشئ Storefront Product وفعّل Visible.
لا تبويب Specifications	الفئة بلا specs نشطة	أضف Category Specs.
Legacy price لا يعمل	النظام يستخدم Product Prices	لا تعتمد على price_retail.
QR فارغ	لا UAN	املأ UAN / SKU.