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

تتيح صفحة الحسابات التجريبية الخاصة في /demos إنشاء نسخة مؤقتة تحمل اسم وهوية الشركة المحتملة. يحصل العميل على ثلاث تجارب مترابطة: مدير شركة، مسافر، وسائق، بينما تبقى بياناته منفصلة تماماً عن الشركات والعملاء الحقيقيين.

يلزم للمشرف امتلاك صلاحية demos.manage.

إنشاء عرض

1. افتح العروض التجريبية من لوحة الإدارة.
2. أدخل اسم الشركة بالعربية والإنجليزية، واسم جهة الاتصال والبريد عند توفرهما.
3. اختر مدة بين ساعة واحدة و7 أيام. القيمة الافتراضية 72 ساعة.
4. أضف شعاراً عبر رابط HTTPS، ورسالة ترحيب بالعربية وأخرى بالإنجليزية، ولون هوية بصيغة #RRGGBB.
5. اختر نمط البيانات الجاهزة المناسب للعرض:
   • شبكة سورية متوازنة: ستة ممرات مع حالات تشغيل متنوعة.
   • مركز تشغيل دمشق: رحلات محورية من دمشق.
   • ممر الشمال والساحل: حلب وحماة وحمص واللاذقية.
   • مسارات مخصصة: اختر حتى 8 مسارات وأسعارها.
6. اضغط إنشاء العرض وانسخ الرابط وبيانات الدخول فوراً.

كل نمط جاهز يزرع شركة معزولة، أسطولاً، مخططات مقاعد، سائقين، جداول، رحلات، حجوزات، مسافرين، Journey Tickets، حضوراً، ومدفوعات محاكية. خيار المسارات المخصصة يتطلب مساراً واحداً على الأقل؛ لا يقبل نموذجاً فارغاً بصورة ضمنية.

تُختار المدن من القائمة المرجعية النشطة نفسها المستخدمة في الإنتاج. تقبل الخدمة معرّفات PostgreSQL UUID الثابتة الخاصة بهذه المدن، بما فيها المعرّفات المرجعية ذات version/variant صفري، ثم تتحقق مرة ثانية من وجود كل مدينة ونشاطها قبل الإنشاء.

:::warning رابط لمرة واحدة يظهر رمز الوصول الخام وكلمات المرور عند الإنشاء أو تدوير الوصول فقط. تخزن قاعدة البيانات بصمة SHA-256 للرمز ولا يمكن استرجاع الرمز القديم لاحقاً. :::

أرسل رابط مركز العرض إلى جهة الاتصال عبر قناة موثوقة. الرمز موجود في جزء URL بعد #، لذلك لا يصل إلى الخادم أو سجلات reverse proxy ضمن طلب الصفحة الأول.

ما الذي يراه العميل؟

التجربة	النطاق	المحتوى
مركز العرض والمسافر	demo.shambus.com	هوية الشركة، الرحلات، المقاعد، الحجز، وصندوق الرسائل المحاكى
مدير الشركة	demo-dashboard.shambus.com	الرحلات والحجوزات والأسطول والتقارير والإعدادات
السائق	demo-driver.shambus.com	الرحلات المعيّنة، كشف الركاب، QR، التحصيل، والمزامنة

تتضمن البيئة أربعة حافلات، ولكل حافلة مخطط مقاعد ديناميكي كامل ومتوافق مع سعتها، إضافة إلى المحتوى المتصل المحدد بالنمط. كل رسائل البريد وSMS والتنبيهات والمدفوعات في العرض تُحاكى أو تستخدم عناوين وأرقاماً محجوزة؛ لا ترسل آثاراً حقيقية.

تعرض مسارات العرض أربع صور توضيحية مختلفة ومحسّنة محلياً. تبقى صورة المسار منفصلة عن شعار الشركة؛ إذا لم يزود المشرف العرض بشعار، تظهر علامة حروف ملوّنة مشتقة من اسم الشركة بدلاً من تكرار أيقونة باص أو اختلاق شعار تجاري.

يعرض تطبيق السائق رحلات اليوم أولاً. إذا أُنشئ العرض بعد آخر موعد يومي ولم تبق رحلة في اليوم نفسه، يعرض تلقائياً أقرب رحلة مستقبلية مكلّف بها السائق، كي يستطيع العميل المحتمل فتح كشف الركاب وتجربة QR والتحصيل فوراً دون انتظار اليوم التالي.

تكون حجوزات الرحلات المستقبلية المعيّنة للسائق غير مدفوعة فعلياً (paid_amount فارغ وpayment_status=PENDING) حتى يمكن تجربة التحصيل النقدي من الكشف. يسجل التحصيل دفعة واحدة فقط ويحدّث الحجز وإجمالي التكليف معاً؛ تعيد إعادة الضبط هذه الحالة الأساسية وتحذف الإيصالات التجريبية السابقة.

تستخدم شخصية السائق ربط auth_user_id المباشر، لذلك يجب أن تظهر تكليفاتها فور فتح الشخصية. ظهور حالة «لا توجد رحلات» مع وجود تكليفات في الإدارة يعني فشل حل الهوية أو طلب التكليفات، وليس انتظار الموعد؛ راجع سجلات Kong وRLS قبل تعديل بيانات العرض.

تفتح تجربة المسافر بجلسة مؤقتة تُثبتها الواجهة الخلفية في cookies من نوع HttpOnly، ثم يعاد تحميل صفحة الرحلات للتحقق منها. لا تصل access token أو refresh token إلى JavaScript أو استجابة JSON المرئية للواجهة.

يعرض مركز العرض العربية أو الإنجليزية حسب لغة بوابة العميل. يستخدم اسم الشركة ورسالة الترحيب المطابقين للغة عند توفرهما، مع رجوع آمن إلى النص الآخر. لا يعرض نص خطأ الخادم الخام؛ يربط errorCode ثابتاً برسالة محلية قابلة للفهم. كما يتحقق من لون الهوية قبل استخدامه ويعود إلى أخضر شام باص إذا كانت القيمة غير صالحة.

إذا كانت وصلة شخصية المدير أو السائق ناقصة أو غير صالحة، يظهر الإجراء معطلاً بدلاً من رابط # مضلل. وإذا لم يسجل العرض رسائل بعد، يعرض صندوق الرسائل حالة فارغة واضحة لا بطاقة ناقصة.

إدارة دورة الحياة

• تمديد 24 ساعة: يمدد انتهاء الشركة ومنحة الوصول معاً.
• إعادة الضبط: يحذف تعديلات العميل ويعيد بناء البيانات التجريبية ومخططات مقاعد الحافلات، مع إبقاء الرابط والهويات نفسها.
• تدوير الوصول: يبطل الرابط وكلمات المرور السابقة فوراً وينشئ مجموعة جديدة تظهر مرة واحدة.
• إلغاء: يعطل الشركة والمنحة والهويات فوراً. لا تنتظر مهمة التنظيف الدورية.
• انتهاء تلقائي: تمنع بوابات الويب وRLS الوصول فور حلول وقت الانتهاء، ثم تحذف مهمة الصيانة بيانات الشركة وهوياتها نهائياً.

التعامل الآمن

• لا تعِد استخدام الرابط لشركتين مختلفتين.
• لا تضع بيانات أشخاص حقيقيين داخل البيئة التجريبية.
• عند إرسال الرابط إلى جهة غير صحيحة، استخدم تدوير الوصول فوراً.
• عند الاشتباه بإساءة استخدام، استخدم إلغاء ثم راجع سجل الإدارة.
• لا تستخدم حسابات التطوير الثابتة كبديل؛ بيئة العرض المخصصة محدودة الصلاحية ومعزولة وقابلة للحذف.

لإجراءات الأعطال والتنظيف اليدوي راجع دليل تشغيل دورة حياة العروض.