خاص بـ: الحزمة الكاملة · لوحة الوكالة · الواجهة البرمجية

وضع العرض التجريبي

تشغيل عرض عام للوحة التحكم للقراءة فقط.

اضبط في .env:

DEMO_MODE="true"
DEMO_HINT="1"      # اختياري: يعرض بيانات دخول المالك في صفحة الدخول

ثم أعد التشغيل.

ما الذي يتغير

  • كل طلب في اللوحة يغيّر شيئاً يُرد عليه بـ 403 ومعه {"error": {"code": "demo_mode"}}: إنشاء العقارات وتعديلها وحذفها، ورفع الصور، وتغييرات الاستفسارات والمعاينات، والملاحظات، والمناطق، والفريق، والإعدادات، والملف الشخصي، وأدوات الذكاء الاصطناعي (حتى لا يستهلك العرض العام رصيدك).
  • يظهر شريط في أعلى اللوحة يوضح أن التعديلات متوقفة، وتظهر الرسالة نفسها مع كل إجراء مرفوض.
  • القراءة لا تتأثر، فيستطيع زوار العرض فتح كل صفحات اللوحة.
  • الدخول والخروج يعملان كالمعتاد.
  • الموقع العام لا يتأثر: يستطيع الزوار إرسال الاستفسارات وطلبات المعاينة (وتصل إلى صندوق العرض). لإيقاف ذلك أيضاً احذف النقطتين العامتين POST، أو أعد ضبط العرض دورياً.

كيف يعمل

تُطلق الدالة requireStaff({ write: true }) في src/lib/api.ts الخطأ ApiError(403, "demo_mode") حين تكون قيمة DEMO_MODE هي true أو 1 أو yes أو on. تمرّر كل نقطة تعديل الخيار write: true، ويتحقق scripts/e2e_api.py من ذلك حين يعمل على عرض تجريبي.

إعادة ضبط العرض كل ليلة

npm run db:reset   # يمسح قاعدة البيانات ويعيد تعبئتها

شغّله من cron، مثلاً في الثالثة فجراً. ولا تستخدم DEMO_MODE أو DEMO_HINT في وكالة حقيقية أبداً.