🏠 دليل بوابة العميل

🏠 نظرة عامة

بوابة العميل (Member Portal) هي واجهة العميل الشخصية لإدارة اشتراكه في برنامج الولاء. يمكن للعميل من خلالها عرض رصيده، استعراض المكافآت، إيجاد فروع المتجر، ومشاركة رمز الإحالة مع أصدقائه.

المميزات

• 📊 عرض الرصيد: النقاط والطوابع الحالية مع شريط التقدم
• 🎁 المكافآت: استعراض واستبدال المكافآت المتاحة
• 📍 الفروع: مواقع الفروع مع خرائط Google
• 📋 الشروط: عرض شروط وأحكام برنامج الولاء
• 👥 الإحالة: مشاركة رمز الإحالة مع الأصدقاء
• 📱 QR للمسح: رمز QR كبير يمكن مسحه من الكاشير
• 🍎 رابط المحفظة: إعادة إضافة البطاقة إلى Apple/Google Wallet

🔐 الدخول إلى بوابة العميل

هناك عدة طرق يمكن للعميل من خلالها الوصول إلى بوابته الشخصية:

١. رابط التسجيل

بعد إتمام التسجيل، يحصل العميل على رابط مباشر لبوابته الشخصية (مثال: http://localhost:3001/m/{serial}?t={token}).

٢. من بطاقة المحفظة

يمكن تضمين رابط بوابة العميل في ظهر بطاقة Apple Wallet أو Google Wallet (حقل "خلف البطاقة").

٣. رمز QR

رمز QR الموجود على البطاقة يمكن مسحه للوصول إلى البوابة.

٤. كتطبيق PWA مثبت

بعد تثبيت البوابة كتطبيق على الشاشة الرئيسية، يمكن الوصول إليها بنقرة واحدة.

تجربة سطح المكتب

بوابة العميل (ديسكتوب) — التبويبة الرئيسية مع البطاقة والرصيد ورمز QR

تجربة الجوال

بوابة العميل (جوال) — تجربة متجاوبة مع الجوال

💰 الرصيد والنقاط

هذه هي الصفحة الرئيسية في بوابة العميل. تحتوي على:

بطاقة الرصيد

• اسم العميل ورقم العضوية (Serial)
• الرصيد الحالي: عدد النقاط أو الطوابع
• شريط التقدم: إذا كان برنامج الطوابع، يظهر التقدم نحو المكافأة التالية
• المستوى: المستوى الحالي (فضي، ذهبي، بلاتيني)

رمز QR

رمز QR كبير يمكن مسحه بسهولة من قبل الكاشير. هذا الرمز هو هوية العميل في النظام.

النشاطات الأخيرة

• آخر معاملات الكسب والاستبدال
• تاريخ ومبلغ كل معاملة
• حالة المعاملة (مكتملة، ملغاة)

روابط سريعة

• إضافة إلى المحفظة: رابط لإعادة إضافة البطاقة إلى Apple/Google Wallet
• مشاركة: مشاركة برنامج الولاء مع الأصدقاء
• مكافأة عيد الميلاد: إذا تم تفعيلها، تظهر حالة مكافأة عيد الميلاد

🎁 تبويبة المكافآت

تبويبة المكافآت تعرض جميع المكافآت التي يمكن للعميل استبدالها بنقاطه أو طوابع:

تبويبة المكافآت — قائمة المكافآت المتاحة مع تكلفتها بالنقاط

• اسم المكافأة: اسم المكافأة (مثلاً: "قهوة مجانية"، "خصم ١٠٪")
• تكلفة المكافأة: عدد النقاط أو الطوابع المطلوبة
• المخزون: الكمية المتبقية من المكافأة (إذا كان محدوداً)
• تاريخ الصلاحية: تاريخ انتهاء صلاحية المكافأة
• زر الاستبدال: استبدال النقاط/الطوابع بالمكافأة (يتم عند الكاشير)

📍 تبويبة الفروع

تبويبة الفروع تعرض جميع فروع المتجر مع معلومات التواصل:

تبويبة الفروع — قائمة الفروع مع العنوان وساعات العمل وخرائط Google

• اسم الفرع: اسم الفرع (مثلاً: "الفرع الرئيسي - الرياض")
• العنوان: العنوان الكامل للفرع
• ساعات العمل: أوقات الدوام
• رقم الهاتف: رقم الاتصال بالفرع
• خرائط Google: رابط لفتح الموقع في خرائط Google

📱 تثبيت البوابة كتطبيق (PWA)

يمكن للعميل تثبيت بوابة العميل على الشاشة الرئيسية لجواله لتجربة تطبيق أصلي كاملة:

على iPhone (Safari)

1. افتح بوابة العميل في متصفح Safari
2. اضغط على زر مشاركة (مربع مع سهم لأعلى)
3. اختر إلى الشاشة الرئيسية (Add to Home Screen)
4. أدخل اسم التطبيق (مثلاً: "يمامة - يمامة للقهوة")
5. اضغط إضافة

على Android (Chrome)

1. افتح بوابة العميل في متصفح Chrome
2. سيظهر شريط سفلي مع رسالة "تثبيت التطبيق" أو "Install App"
3. اضغط على تثبيت (أو من القائمة ⋮ ← تثبيت التطبيق)
4. يظهر التطبيق على الشاشة الرئيسية مع أيقونة خاصة

👥 الإحالة والمشاركة

يمكن للعميل مشاركة برنامج الولاء مع أصدقائه والحصول على مكافآت:

• رمز الإحالة: كل عميل لديه رمز إحالة فريد
• مشاركة: مشاركة الرابط عبر واتساب، تويتر، أو أي تطبيق تواصل
• مكافأة الإحالة: يحصل العميل على نقاط إضافية عندما يسجل صديق عبر رمزه

❓ الأسئلة الشائعة للعملاء