فتح مساحة المُشغِّل Access Gateway

الـ AccessGateway هو وحدة الـ Gateway كما يراها فريق الإنتاج. مساحة عمل ذات تبويبات مُضمَّنة في الـ Studio تُعطيك مكانًا واحدًا لمراقبة القاعة، وضبط المقاعد، وإطلاق تومبولا، وقيادة استطلاعات حيّة. ترافقك هذه الصفحة في فتحها والاستقرار فيها في أقل من دقيقتين.

المتطلبات

• غرفة Timers Studio منشأة سلفًا (لديك controller_id في جدول controllers)
• الـ Studio مفتوح على timers.studio/id/<غرفتك>
• وجود مشاهد واحد على الأقل يُساعد على رؤية العدادات تتحرّك، لكنه ليس شرطًا لفتح المساحة

الخطوات

1. افتح الـ Studio على غرفتك

اذهب إلى timers.studio/id/<غرفتك>. يُحمَّل الـ Studio ويحلّ غرفتك مقابل جدول controllers. إذا كان الـ slug خاطئًا، ستقع على صفحة 404 قبل أن يحاول الـ Gateway التركيب حتى.

2. افتح مساحة Gateway

من الشريط الجانبي الأيسر في الـ Studio، انقر على Gateway (يُسمَّى Access في بعض الغرف). يُركَّب AccessGateway على اليمين. التبويب LIVE محدد افتراضيًا، فترى LiveMonitor أولًا.

يُفتح الـ Gateway داخل الـ Studio؛ لا ينقلك إلى عنوان مختلف. لن يرى المشاهدون هذه الواجهة — هم لا يرون سوى timers.studio/ask/<غرفتك>.

3. اقرأ العدادات الحيّة

يعرض رأس المساحة عدّادَين مأخوذَين من Supabase:

• المشاهدون المتصلون — صفوف جدول spectators المُرشَّحة بـ controller_id، مع علامة online تضعها صفحة المشاهد.
• الأسئلة المعلّقة — صفوف spatial_questions حيث status = 'pending'، بالترشيح نفسه.

العدّادان مُشتركان في قناتَي Realtime. يتحركان وحدهما مع تدفق الجمهور، دون تحديث.

4. انتقل بين التبويبات

التبويبات الأربعة تُغطّي أربع أدوات قريبة من الـ Gateway:

• LIVE ← LiveMonitor. خريطة حيّة للمقاعد المتصلة مع تدفق الأسئلة الواردة. ابدأ هنا لقياس نبض القاعة.
• STAGE ← StageConfigurator. خريطة الإخراج لتعريف المناطق ومعايرة المقاعد. افتحها قبل العرض لا أثناءه.
• RAFFLE ← RaffleControl، مُعاد استخدامه من وحدة المُشرف. اختر منطقة، أطلق سحبًا، أعلن الفائز.
• POLLS ← PollManager، مُعاد استخدامه من وحدة المُشرف. أنشئ استطلاعات وافتحها وأغلقها، سيراها الجمهور عبر SpectatorPollVote.

التنقل بين التبويبات زهيد الكلفة — تبقى مُشتركة في الخلفية، فلا تتصفّر العدادات ولا البيانات.

5. أطلق تومبولا أو استطلاعًا

من RAFFLE، اختر النطاق (القاعة كلها أو منطقة) وانقر اسحب. يُختار الفائز من صفوف spectators الحالية ويُعرض على الشاشة.

من POLLS، انقر استطلاع جديد، أضف الخيارات، ثم افتح. يظهر SpectatorPollVote منزلقًا على كل الهواتف الموجودة الآن على timers.studio/ask/<غرفة>. تصل الأصوات إلى poll_votes مع تدفقها، ولك عند الإغلاق أن تعرض النتيجة على الـ Player عبر PollWidget.

النتيجة المتوقَّعة

AccessGateway مفتوح داخل الـ Studio مع تبويب LIVE محددًا. الرأس يعرض عدادات حقيقية. الانتقال إلى RAFFLE أو POLLS يمنحك ضوابط المُشرف دون مغادرة الـ Studio. يبقى المشاهدون على /ask/<غرفة> برؤيتهم الخاصة سليمة.

حلّ المشكلات

العدادات تبقى صفرًا رغم وجود أناس على /ask/<غرفة>. تحقق أن عنوان الـ Studio وعنوان المشاهد يحملان نفس room ID تمامًا. خطأ طفيف في أي من الـ slug يكسر الربط على controller_id ولا يطابق أي صفّ.

تبويب RAFFLE أو POLLS فارغ. يُعيدان استخدام مكونات المُشرف. إذا كانت خطتك لا تتضمن وحدة المُشرف، يعرض التبويب حالة معطّلة. انتقل إلى خطة تُفعِّل الوحدة.

فتحتُ استطلاعًا ولا شيء يظهر على هاتفي. يجب أن يكون هاتف المشاهد على timers.studio/ask/<غرفة> بنفس room ID، لا على عنوان الـ Player. لا يظهر SpectatorPollVote إلا على سطح المشاهد في الـ Gateway.

قراءات تالية

• تطبيق المشاهد — تدفق الجمهور من الطرف إلى الطرف.
• التصويت في استطلاع حيّ (رؤية المشاهد) — ما يراه الجمهور حين تفتح استطلاعًا هنا.
• إطلاق استطلاع حيّ — تفاصيل الإعداد خلف تبويب POLLS.