حقول عنصر القائمة
هذا مرجع كامل لجميع حقول عنصر القائمة. الحقول المطلوبة مُعلَّمة. وجميع الحقول الأخرى اختيارية لكنها موصى بها للحصول على أفضل تجربة للعملاء.
| الحقل | النوع | مطلوب | الوصف |
|---|---|---|---|
name |
String | نعم | اسم الطبق المعروض في القائمة. بحد أقصى 200 حرف. |
description |
String | لا | وصف قصير للطبق. اذكر المكونات الرئيسية وطريقة التحضير. يوصى بجملتين إلى ثلاث جمل. |
price |
Decimal | نعم | السعر المعروض (مثل 14.99). يظهر للعملاء في القائمة. |
priceCents |
Integer | تلقائي | السعر مخزّنًا بالسنتات (مثل 1499). يُحسب تلقائيًا من حقل السعر. ويُستخدم داخليًا لضمان الدقة. |
category |
String | لا | الفئة التي ينتمي إليها هذا العنصر (مثل "المقبلات" أو "الأطباق الرئيسية" أو "الحلويات"). تُستخدم لتجميع العناصر في القائمة العامة. |
photoUrl |
URL | نعم | رابط الصورة المرفوعة. يُضبط تلقائيًا بعد الرفع والمعالجة بالذكاء الاصطناعي. |
isActive |
Boolean | لا | ما إذا كان العنصر ظاهرًا في القائمة العامة. القيمة الافتراضية true. اضبطه على false لإخفائه دون حذفه. |
position |
Integer | لا | ترتيب الفرز داخل فئة العنصر. تظهر الأرقام الأصغر أولًا. وتُرتَّب العناصر التي ليس لها موضع حسب تاريخ الإنشاء. |
restaurantId |
UUID | تلقائي | المطعم الذي ينتمي إليه هذا العنصر. يُضبط تلقائيًا من جلستك. |
createdAt |
DateTime | تلقائي | الطابع الزمني لإنشاء العنصر. يُضبط تلقائيًا. |
updatedAt |
DateTime | تلقائي | الطابع الزمني لآخر تحديث. يُحدَّث تلقائيًا عند كل حفظ. |
حقول نموذج 3D (في 3D Menu Pro فقط)
عند استخدام 3D Menu Pro، قد يكون لكل عنصر في القائمة نموذج 3D مرتبط به مع الحقول الإضافية التالية:
| الحقل | النوع | الوصف |
|---|---|---|
modelUrl |
URL | رابط ملف نموذج GLB المُحسَّن. يُضبط بعد اكتمال المعالجة. |
status |
Enum | حالة المعالجة: PENDING أو GENERATING أو PROCESSING أو READY أو FAILED. |
provider |
String | مزوّد الذكاء الاصطناعي المستخدم لتوليد 3D. |
providerTaskId |
String | معرّف المهمة الخارجي من مزوّد توليد 3D. يُستخدم للاستعلام الدوري عن الحالة. |