الفعاليات والأماكن ومخططات المقاعد

ما تحتويه الفعالية

تُحفظ الأسعار بأصغر وحدة من عملة مساحة العمل (2000 تعني $20.00)، ويسمّي عمود السعر في المحرر تلك العملة: التي سُعّرت بها أنواع تذاكر الفعالية، أو عملة مساحة العمل لفعالية جديدة. تُضاف رسوم الحجز، وهي 3% في البيانات التجريبية، لكل تذكرة عند الدفع ويدفعها الحاضر؛ والتذكرة المجانية لا تحملها.

الحالات وما يعرضه الموقع

تحتوي البيانات التجريبية الجديدة 36 فعالية عبر أربعة منظّمين: 29 منشورة، واثنتان نفدت تذاكرهما، وواحدة أُلغيت، و4 مسودات. ويسرد الموقع 22 منها المتاحة للبيع أو الجارية الآن، 3 منها جارية الآن، و9 انتهت بالفعل.

النشر والإلغاء والإجراءات الأخرى

لا تُحذف الطلبات والتذاكر أبدًا بعد أن يتحرك المال. وكل إجراء يُكتب في سجل التدقيق.

صفحة الفعاليات والمحرر

• تبويبات الكل ومنشورة ومسودة وانتهت، وبحث، وفلاتر للفئة والحالة والتواريخ (الثلاثون يومًا القادمة، والتسعون يومًا القادمة، وهذا العام، والفعاليات السابقة)، بثماني فعاليات في كل صفحة، مع المباع من السعة والإيرادات في كل صف.
• تتيح قائمة كل صف معاينة الفعالية وتعديلها وفتح حضورها ونسخها ونشرها وإلغاء نشرها وأرشفتها وإلغاءها.
• /en/dashboard/events/new ينشئ فعالية و/en/dashboard/events/<id>/edit يعدّل واحدة، في أربعة تبويبات (التفاصيل والتذاكر والجدول والظهور) بجانب معاينة التذكرة وقائمة الجاهزية.
• السعر يُقفل بعد أول بيع، فيبقى ما دفعه المشترون صحيحًا. ويثبت المكان ونمط الدخول بعد بيع التذاكر، ولا يمكن إزالة نوع تذكرة بيع منه، وتُرفض سعة أقل من المباع.
• إذا حفظ شخص آخر الفعالية بعد أن فتحتها، يقول المحرر ذلك ويُبقي ما كتبته غير محفوظ إلى أن تعيد التحميل.
• يسرد /en/dashboard/events/<id>/attendees تذاكر الفعالية: الحامل والمقعد والنوع والحالة ووقت الدخول، مع بحث وفلاتر لمن دخلوا ومن لم يدخلوا والملغاة.

الأماكن

• يحمل المكان اسمًا باللغتين، وعنوانًا ومدينة ومنطقة زمنية وسعة، وملاحظات إمكانية الوصول والمواصلات باللغتين، ونقطة اختيارية على الخريطة.
• تعرض صفحة الأماكن في اللوحة كل مكان على خريطة وفي قائمة مع مقاعده (محجوزة مع إصدار مخططها، أو دخول عام) وفعالياته القادمة. ولمحرر المكان أداة اختيار على الخريطة مع بحث عن الأماكن.
• ترسم الخرائط بلاطات OpenFreeMap ويستخدم البحث عن الأماكن خدمة Photon العامة، كلتاهما من دون مفتاح. وتوجّهها NEXT_PUBLIC_MAP_STYLE_LIGHT وNEXT_PUBLIC_MAP_STYLE_DARK وNEXT_PUBLIC_PLACE_SEARCH_URL في اللوحة إلى مكان آخر.
• للموقع صفحة لكل مكان مع فعالياته، ولمكان بمقاعد مخططه المنشور.
• في البيانات التجريبية 9 أماكن. لكل من Room 3 وMill Street Lecture Hall مخطط منشور من 72 مقعدًا؛ وتبيع الأماكن الأخرى دخولًا عامًا.

مخططات المقاعد

المخطط شبكة من 1 إلى 40 صفًا في كل منها من 1 إلى 60 مقعدًا، مع ما يصل إلى ستة ممرات. تُسمّى المقاعد بحرف الصف ورقمه (A12). ويفتح محرر المقاعد على /en/dashboard/venues/<id>/seating.

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

حجوزات المقاعد المؤقتة

• اختيار المقاعد على الخريطة لا يحجز شيئًا؛ أما الحجز فيفعل. يُبقي المقاعد (أو كمية دخول عام) لمشترٍ واحد طوال مدة حجز مساحة العمل، عشر دقائق في البيانات التجريبية، بحسب ساعة الخادم، ويرى المشتري العدّ التنازلي.
• لا يستطيع مشتريان حجز المقعد نفسه أبدًا. والمقعد الذي أُخذ قبل لحظة يُرفض مع رسالة باختيار غيره.
• يحجز الطلب الواحد 8 تذاكر على الأكثر، ولا يتجاوز أبدًا حد نوع التذكرة نفسه. وللحاضر المسجَّل دخوله حجز حي واحد لكل جلسة: الاختيار الجديد يحل محل القديم.
• حين ينتهي الوقت تصبح المقاعد متاحة للآخرين فورًا، وتنظّف عملية مسح كل 15 ثانية الحجوزات المنتهية. ومبالغ الحجز لقطة ثابتة، فلا يغيّرها تغيّر لاحق في الأسعار.
• مدة الحجز وحد الطلب الواحد قيمتان في مساحة العمل (hold_seconds وهي 600، وmax_per_order وهي 8، في البيانات التجريبية). ولا تعدّلهما اللوحة.

من يستطيع فعل ماذا

يملك دورا المالك والمدير التجريبيان الخمس كلها؛ أما المالية وتسجيل الدخول فلا تملكان شيئًا منها.

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

ما تتحقق منه واجهة API

• يرفض المحرر وواجهة API بـ code مقروء آليًا: VERSION_CONFLICT (حفظ شخص آخر أولًا) وPRICE_LOCKED وHAS_SALES وEVENT_CLOSED وNOT_READY (مع ما ينقص في details.missing) وINVALID_TRANSITION وCONFIRMATION_REQUIRED.
• حفظ مسودة مخطط حفظها شخص آخر بعد تحميلك لها هو 409 VERSION_CONFLICT؛ ونشر مخطط يزيد على سعة المكان هو 400 OVER_CAPACITY.
• يحتاج POST /api/holds إلى Idempotency-Key، ويجيب بالحجز مع رمز يظهر مرة واحدة ويُرسل بعد ذلك باسم X-Hold-Token. المقعد الذي لم يعد متاحًا هو 409 SEAT_UNAVAILABLE، والنوع النافد 409 SOLD_OUT، والحجز المنتهي 410 HOLD_EXPIRED.
• يجيب GET /api/public/sessions/:code/availability بوقت الخادم ومدة الحجز والرسوم، ولجلسة بمقاعد محجوزة بحالة كل مقعد. ويقرؤه الموقع كل 20 ثانية ما دامت الخريطة مفتوحة.

• مرجع واجهة API