تخطي إلى المحتوى الرئيسي

المرجع

حقول عنصر القائمة

حقول عنصر القائمة

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

الحقل النوع مطلوب الوصف
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. يُستخدم للاستعلام الدوري عن الحالة.