موقع الطلبات
ما يقدّمه الموقع للعملاء: صفحاته، والقائمة وأداة «صمّم وجبتك»، والسلة وإتمام الطلب، والمطابخ ومناطق التوصيل، وتتبّع الطلبات، والحسابات والمكافآت، ووسوم التحليلات، ومحركات البحث.
لحزمة الحزمة الكاملة
الصفحات
كل صفحة موجودة بالإنجليزية تحت /en وبالعربية تحت /ar. المسار الذي لا يتضمن لغة يذهب إلى /en.
| المسار | ما تعرضه |
|---|---|
/en | الصفحة الرئيسية: تسعة أقسام تُبنى في محرر الصفحة الرئيسية في لوحة التحكم، من البانر الرئيسي والفئات إلى الأطباق الأكثر طلبًا، والكومبو، و«صمّم وجبتك»، والتوصيل، والمكافآت، والأسئلة. |
/en/shop | القائمة، مع أدوات البحث والفئة والنظام الغذائي والترتيب المحفوظة في العنوان، حتى يمكن مشاركة كل عرض. الطبق الذي لا يمكن طلبه الآن يبقى ظاهرًا ويوضح ذلك. |
/en/categories | فئات القائمة. |
/en/products/<slug> | الطبق: معرض الصور، والحجم والإضافات مع السعر على الزر، وحقل للتعليمات، والكمية من 1 إلى 10، والمكونات، ومسببات الحساسية، والتقييمات، والأطباق المرتبطة. للكومبو صفحته الخاصة على العنوان نفسه، مع خياراته ورسومها الإضافية. |
/en/cart | السلة، مع رمز خصم، والتوصيل أو الاستلام، وعنوان التوصيل، وصف لاقتراحات إضافية، وإجمالي تحسبه واجهة API. |
/en/checkout | التواصل والتوصيل والدفع في صفحة واحدة بجوار ملخص الطلب. متاحة للزوار. |
/en/order-confirmation/<number> | الطلب الذي أُرسل للتو، مع متابعته من المطبخ إلى الباب. |
/en/track-order | تتبّع الطلب برقم الطلب والبريد الإلكتروني، دون حساب. |
/en/locations | المطابخ: فحص الرمز البريدي للتوصيل أو الاستلام، وحالة الفتح والساعات، ومناطق التوصيل، وخريطة. |
/en/about, /en/contact, /en/faq, /en/privacy, /en/terms | صفحات الدعم والصفحات القانونية. تصل الرسالة من نموذج التواصل إلى إشعارات لوحة التحكم، للمالك والمديرين. |
/en/auth/login, /en/auth/register, /en/auth/forgot-password, /en/auth/reset-password | تسجيل الدخول، وإنشاء الحساب، وإعادة تعيين كلمة المرور للعملاء. |
/en/account | المنطقة الخاصة بالمستخدم المسجّل: نظرة عامة مع نقاط المكافآت، والطلبات وتفاصيلها مع إعادة الطلب، والعناوين المحفوظة، والملف الشخصي، وتتبّع الطلبات، والأطباق المحفوظة. |
القائمة، والكومبو، و«صمّم وجبتك»
- تضم القائمة التجريبية 64 طبقًا في ثماني فئات، لكل منها نصوص بالإنجليزية والعربية، وصور، وخيارات، ومسببات حساسية، ووسوم للنظام الغذائي. يعدّل الفريق كل ذلك في لوحة التحكم.
- خيارات الطبق مجموعات من الاختيارات، مثل الحجم أو الإضافات، ولكل منها تغيير في السعر. يتبع السعر على الزر الاختيارات.
- الكومبو طبق رئيسي وطبق جانبي ومشروب بسعر واحد،
$19.99في النسخة التجريبية، مع رسوم إضافية لبعض الاستبدالات. تختار أداة «صمّم وجبتك» في الصفحة الرئيسية الثلاثة وتفتح الكومبو بذلك الاختيار. - الطبق الذي يجعله الفريق غير متوفر، أو الذي نفد مخزونه المتتبَّع، يبقى في القائمة ولا يمكن إضافته.
المطابخ، والتوصيل، والاستلام
- كل طلب يطهوه مطبخ واحد. في النسخة التجريبية أربعة: Central و Riverside و Uptown و Harbor، لكل منها ساعات عملها ومنطقتها الزمنية ومدة تحضيرها ورموز التوصيل البريدية الخاصة بها.
- لا يصل التوصيل إلا إلى الرموز البريدية التي يحددها المطبخ؛ والاستلام من عنوان المطبخ نفسه. يُدخل العميل رمزًا بريديًا، فيختار الموقع مطبخًا يخدمه ومفتوحًا، أو يعرض البدائل.
- لا يستقبل المطبخ الطلبات إلا وهو مفتوح. تبدأ تعبئة البيانات المطعم على ساعة تجريبية تُثبّت كل المطابخ عند 20:55، حتى يمكن الطلب في النسخة التجريبية في أي ساعة؛ ويحوّلها الفريق إلى الساعة الحقيقية من «الإعدادات»، ثم «المطعم».
- الوقت المتوقع هو مدة تحضير المطبخ مضافًا إليها 5 إلى 15 دقيقة للتوصيل، و0 إلى 10 للاستلام.
- الخريطة في صفحة الفروع مرسومة بالكود من نقطة الخريطة لكل مطبخ، ولا تحتاج إلى أي خدمة خرائط.
السلة وإتمام الطلب
- سلة الزائر محفوظة في المتصفح. أما سلة العميل المسجّل فمحفوظة على الخادم، وتُدمج سلة الزائر فيها عند تسجيل الدخول.
- كل إجمالي، في السلة وعند إتمام الطلب، تحسبه واجهة API من قائمتها وإعداداتها، لذلك ما يراه العميل هو ما يُحصَّل منه. إذا تغيّر سعر أو أصبح طبق غير متوفر منذ ملء السلة، تعرض صفحة إتمام الطلب التغيير وتطلب من العميل قبوله.
- الرسوم في النسخة التجريبية: التوصيل
$2.99، والاستلام مجاني، وحد أدنى للتوصيل قدره$10.00. يغيّرها الفريق من «الإعدادات»، ثم «المطعم». - يخصم رمز الخصم
TASTE10نسبة 10% من أصناف القائمة. لا تُجمع الرموز مع النقاط المستبدلة إلا إذا سمح الفريق بذلك لهذا الرمز. - يُتم الزائر الطلب باسم وبريد إلكتروني ورقم هاتف؛ أما العميل المسجّل فتملأ بياناته وعنوانه الافتراضي النموذج.
- يتم الدفع على صفحة Stripe أو PayPal نفسها، أو بالدفع التجريبي عندما لا يكون هناك مزوّد مضبوط. بعد الدفع، يعود العميل إلى صفحة الطلب.
تتبّع الطلبات
ينتقل الطلب عبر قيد الانتظار، ثم مؤكد، ثم قيد التحضير، ثم جاهز، ثم في الطريق، ثم تم التوصيل، أو مباشرة إلى تم التوصيل عند الاستلام. يتتبّعه الزائر على /en/track-order برقم الطلب والبريد الإلكتروني الذي أُرسل به؛ ويراه العميل في حسابه. يتحدث الجدول الزمني تلقائيًا أثناء عمل المطبخ. الرقم غير المعروف والبريد الخاطئ يحصلان على الإجابة نفسها، لذلك لا يمكن استخدام التتبّع للعثور على طلبات الآخرين.
حسابات العملاء والمكافآت
- يسجّل العملاء باسم وبريد إلكتروني وكلمة مرور لا تقل عن 8 أحرف. ويسجّلون الدخول على الموقع فقط: لا يستطيع حساب العميل فتح لوحة التحكم.
- المكافآت. يكسب الطلب المدفوع نقطة واحدة عن كل دولار من الطعام بعد الخصومات، بمجرد توصيله. كل 100 نقطة تخصم
$5.00من الطلب عند الدفع. يعرض الحساب الرصيد والسجل. يغيّر الفريق الرقمين من «الإعدادات»، ثم «المطعم». - الأطباق المحفوظة تتبع العميل من جهاز إلى آخر، ويمكن إعادة طلب طلب سابق بنقرة واحدة.
- إعادة تعيين كلمة المرور ترسل بالبريد رابطًا إلى صفحة إعادة التعيين في الموقع عندما يكون لدى واجهة API مزوّد بريد مضبوط. يعمل الرابط مرة واحدة، خلال ساعة.
- التقييمات. تعرض صفحة الطبق تقييماته، والمتوسط، وعدد التقييمات، وتوزيعها حسب النجوم. لا يحتوي الموقع على نموذج لكتابة تقييم: تستقبل واجهة API تقييم العميل المسجّل على
POST /api/reviews، وتأتي تقييمات النسخة التجريبية من تعبئة البيانات.
التحليلات وبكسلات التتبّع
ست شبكات جاهزة للربط. فعّل إحداها بوضع معرّفها في ملف .env الخاص بالموقع وإعادة البناء:
| المتغير | الشبكة |
|---|---|
NEXT_PUBLIC_GTM_ID | Google Tag Manager |
NEXT_PUBLIC_GA4_MEASUREMENT_ID | Google Analytics 4 |
NEXT_PUBLIC_META_PIXEL_ID | Facebook و Instagram |
NEXT_PUBLIC_TIKTOK_PIXEL_ID | TikTok |
NEXT_PUBLIC_SNAPCHAT_PIXEL_ID | Snapchat |
NEXT_PUBLIC_PINTEREST_TAG_ID |
- المعرّف الفارغ لا يحمّل أي سكربت. إذا ضبطت معرّفًا واحدًا فقط، فاضبط
NEXT_PUBLIC_GTM_ID: يستطيع Tag Manager تحميل الباقي. إذا كان GA4 يعمل داخل Tag Manager، فاترك معرّف GA4 فارغًا وإلا ستُحسب كل جلسة مرتين. - يُبلغ الموقع عن
page_viewوview_itemوadd_to_cartوremove_from_cartوadd_to_wishlistوview_cartوbegin_checkoutوpurchaseوsearchوsign_upوlogin، مع الأطباق والقيمة والعملة (NEXT_PUBLIC_ANALYTICS_CURRENCY، وقيمتها الافتراضيةUSD). - تُحمَّل الوسوم بمجرد تحميل الصفحة. إذا كنت تبيع في الاتحاد الأوروبي أو المملكة المتحدة، فضع أمامها أولًا شريط موافقة على ملفات تعريف الارتباط.
محركات البحث
تضبط كل صفحة عنوانها ووصفها وعنوانها الأساسي (canonical)، مع اللغة الأخرى كبديل. صفحات السلة وإتمام الطلب والحسابات والتتبّع وتسجيل الدخول معلَّمة بـ noindex. يسرد /sitemap.xml كل صفحة عامة باللغتين وكل طبق منشور، ويشير إليه /robots.txt. اضبط domain.url في src/config/brand.config.ts على عنوانك الحقيقي حتى يستخدمه كلاهما.
بناء النسخة التجريبية العامة
مُضمَّن مع مشترياتك. سجّل الدخول لقراءته، أو افتحه في ملف التنزيل.
كيف يتصرف الموقع في بناء النسخة التجريبية العامة، وكيف تزيل هذا الكود.
كيف يترابط كود الموقع
مُضمَّن مع مشترياتك. سجّل الدخول لقراءته، أو افتحه في ملف التنزيل.
بنية الكود والأعراف التي يجب الحفاظ عليها عند تغييره.