لوحة المنظّم

ما يفعله المكتب الخلفي للمنظّم: صفحات الشريط الجانبي ومن يراها، والنظرة العامة، والتقارير وتصدير CSV، وإعدادات مساحة العمل، والإشعارات، وتسجيل الدخول.

لحزمة الحزمة الكاملة

الصفحات

كل صفحة موجودة بالإنجليزية تحت /en وبالعربية تحت /ar. تفتح اللوحة على /en/dashboard بعد تسجيل الدخول عند /en/auth/login. ولا يظهر كل عنصر في الشريط الجانبي إلا حين يملك دور العضو المسجَّل دخوله صلاحيته.

عنصر الشريط الجانبي	المسار	الصلاحية	وظيفته
نظرة عامة	`/en/dashboard`	`overview.view`	المبيعات في الفترة المختارة، والباب المباشر، والفعاليات القادمة.
الفعاليات	`/en/dashboard/events`	`events.view`	تبويبات الكل ومنشورة ومسودة وانتهت، والبحث والفلاتر، ومحرر الفعالية، وحضور كل فعالية.
الطلبات	`/en/dashboard/orders`	`orders.view`	الطلبات مع إجماليات الحالات وفلاترها، وتفاصيل كل طلب، والاستردادات، وتصدير CSV.
تسجيل الدخول	`/en/dashboard/check-in`	`checkin.scan`	الباب: بالكاميرا أو برمز يُكتب يدويًا، وآخر عمليات المسح والتنبيهات.
الأماكن	`/en/dashboard/venues`	`venues.view`	الأماكن على الخريطة، ومحرر المكان، ومحرر مخطط المقاعد.
التقارير	`/en/dashboard/reports`	`reports.view`	المبيعات المدفوعة بحسب الفترة والفعالية ومزوّد الدفع والفئة، مع تصدير CSV.
الفريق	`/en/dashboard/team`	`admins.view`	أعضاء مساحة العمل والدعوات والأدوار وجلسات تسجيل الدخول.
المساعد الذكي	`/en/dashboard/ai-assistant`	`ai_chat.use`	يجيب عن أسئلة المبيعات والأبواب، ويرسم المخططات، ويصيغ تذكيرات للموافقة عليها.
استوديو الأماكن	`/en/dashboard/studio`	`studio.use`	يحوّل صورة مكان فارغ إلى مفهوم فعالية بالذكاء الاصطناعي.
الإعدادات	`/en/dashboard/settings`	`settings.view`	عام والدفع والفريق والإشعارات لمساحة العمل؛ والملف الشخصي والأمان لكل عضو.

تُفتح الأدوار من صفحة الفريق، وتُفتح الاستفسارات (/en/dashboard/leads وleads.view) والإشعارات من قائمة الحساب، التي فيها أيضًا الملف الشخصي للعضو و«عرض الموقع» (NEXT_PUBLIC_SITE_URL). وتجد لوحة البحث في الشريط العلوي الصفحات. والصفحة التي تُفتح بعنوانها من دون الصلاحية تعرض أنها ليست ضمن دور العضو، وهو الرفض نفسه الذي تعطيه واجهة API. ويصل كل عضو إلى أول صفحة يفتحها دوره: النظرة العامة لمعظمهم، والباب لدور تسجيل الدخول.

الفريق والأدوار ومساحات العمل

النظرة العامة

إجمالي التذاكر والتذاكر المدفوعة وعمليات الدخول والرسوم لآخر 7 أيام أو آخر 30 يومًا أو هذا الشهر أو كل الأوقات، مع مخطط لمبيعات التذاكر فيه نقطة لكل يوم من الفترة.
الباب المباشر: الجلسة التي أبوابها مفتوحة، وكم دخلوا، وكم يُتوقع، وكم بقي، مع رابط إلى تسجيل الدخول فيها.
الفعاليات الخمس المنشورة القادمة مع المباع من السعة وعمليات الدخول، وكم دخولًا يحتاج إلى انتباه (تنبيهات الباب التي لم يُنظر فيها بعد، مع الطلبات المنتظرة للمراجعة).
الأيام هي أيام مساحة العمل، بمنطقتها الزمنية. تُحتسب الطلبات المدفوعة فقط، في اليوم الذي دُفعت فيه؛ والطلبات المجانية تُحتسب طلبات ولا تضيف شيئًا إلى أي مبلغ.

التقارير والتصدير

تعرض التقارير إجمالي التذاكر والرسوم والمحصَّل والمسترد لفترة (الأربعة نفسها، أو بين تاريخين تختارهما) ولفعالية واحدة أو للكل، ثم المبيعات بحسب الفعالية مع حصة كل منها، وبحسب مزوّد الدفع (Stripe وPayPal والدفع الاختباري والمجاني) وبحسب الفئة.

تصدير CSV في التقارير وفي الطلبات يضع ملفًا في قائمة الانتظار في الخلفية ويعرض تنزيل الملف متى صار جاهزًا. يحتوي الملف الطلبات التي تعرضها الفلاتر الحالية، مع الرقم المرجعي والتاريخ والحالة والفعالية والعميل والبريد والتذاكر والمجموع الفرعي والرسوم والإجمالي والمسترد والعملة والمزوّد.
رابط التنزيل هو الصلاحية، ويعمل ساعة واحدة وللعضو الذي طلبه فقط. تحتوي الملفات أسماء المشترين وعناوين بريدهم وتُحفظ في EXPORT_DIR (./exports من دون Docker، ووحدة تخزين البيانات مع Docker).
يحتاج التصدير إلى reports.export. تملكها أدوار المالك والمدير والمالية في البيانات التجريبية.

الإعدادات

للإعدادات ستة تبويبات. تحتاج تبويبات مساحة العمل الأربعة إلى settings.view للاطلاع وsettings.edit للحفظ؛ أما الملف الشخصي والأمان فيخصان العضو المسجَّل دخوله، أيًّا كان دوره.

التبويب	ما يضبطه
عام	اسم مساحة العمل وبريد الدعم والعملة (USD أو EUR أو GBP أو SAR أو AED) والمنطقة الزمنية ورسوم الحجز بالنسبة المئوية (من 0 إلى 20، بمنزلتين عشريتين على الأكثر؛ 3 في البيانات التجريبية)، التي يدفعها الحاضر عند الدفع. تُقفل العملة بعد دفع أول تذكرة. أما مدة حجز المقاعد وحد الطلب الواحد فليسا هنا: هما عمودان في مساحة العمل يُملآن من `settings.json` في واجهة API.
المدفوعات	يعرض هل Stripe وPayPal والدفع الاختباري متصلة أو في وضع الاختبار أو غير مضبوطة، مع المتغيرات التي تُضبط في `.env` الخاص بواجهة API وعنوان خطاف الويب لكل مزوّد. ولا تُكتب المفاتيح هنا ولا تُعرض أبدًا.
الفريق	ما يستطيع كل دور فعله مع الفعاليات والاستردادات والمسح والتقارير، مع روابط إلى الفريق والأدوار.
الإشعارات	ثلاثة مفاتيح لجرس إشعارات الفريق: الطلبات المدفوعة، وطلبات الاسترداد، وتنبيهات تسجيل الدخول. تغيّر فقط ما يُخبَر به الفريق: أما التذاكر والإيصالات ورسائل الاسترداد إلى المشترين فتُرسل دائمًا.
الملف الشخصي	صورة العضو واسمه وبريده وهاتفه.
الأمان	كلمة مرور العضو.

من حفظ الإعدادات بعد تحميل الصفحة فهو الذي يُعتمد: تعرض الصفحة حينئذ نسخته وتطلب منك المراجعة والحفظ مرة أخرى. ولا يُرفع شعار العلامة هنا: فهو يأتي من ملفات العلامة في المشروع.

الإشعارات

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

تصل مباشرة، ويسرد الجرس أحدث 30. ويُحتفظ بكل منها 30 يومًا.
يستخدم الاتصال المباشر NEXT_PUBLIC_WEBSOCKET_BASE_URL، وهو عنوان واجهة API من دون /api، ويجب أن يكون FRONTEND_URL في واجهة API هو عنوان اللوحة. وإعادة التحميل تعرض دائمًا أحدث الصفوف؛ والتحديثات المباشرة وحدها تعتمد على الاتصال.

يسجّل أعضاء الفريق الدخول هنا؛ أما الحضور فيسجّلونه في الموقع، وليس هنا أبدًا. وحسابات الموظفين التجريبية مسرودة في دليل التثبيت.
تذكّرني يُبقي الجلسة بعد إغلاق المتصفح، إلى أن ينتهي رمز واجهة API (سبعة أيام افتراضيًا، JWT_EXPIRATION)؛ وإن ألغيت تحديده تنتهي الجلسة بإغلاق المتصفح أو التبويب.
البريد الخاطئ وكلمة المرور الخاطئة يظهران بالنص نفسه، فلا يخبر النموذج أحدًا أي العناوين لها حساب. وبعد عشر محاولات فاشلة خلال خمس عشرة دقيقة من عنوان واحد، ترفض واجهة API لبعض الوقت.
حين ترفض واجهة API جلسة (رمز منتهٍ أو ملغى)، تسجّل اللوحة الخروج وتفتح صفحة تسجيل الدخول. وأي تغيير في أدوار عضو يصل إليه وهو مسجَّل الدخول.

كيف تترابط أجزاء كود لوحة الإدارة

مُضمَّن مع مشترياتك. سجّل الدخول لقراءته، أو افتحه في ملف التنزيل.

بنية الكود، وطريقة إضافة صفحة وترجمة وخدمة API.

سجّل الدخول للقراءة عرض القالب