١ · البداية بخطوات

لو كانت هذه أوّل مرّة، اتبع هذا الترتيب — كل خطوة تعتمد على ما قبلها:

1. أنشئ العمل (اسم المسرحية، المكان، رابط الخريطة).
2. أضِف الليالي وسعة كل ليلة.
3. وزّع الحصص على الفئات: VIP وGOLD وGUEST.
4. اضبط المظهر — الخلفية والألوان وترتيب عناصر الصفحة.
5. أضِف الأشخاص وحدّد فئة كل واحد.
6. أرسل الدعوات، أو انسخ الروابط وأرسلها يدويًّا.
7. ليلة العرض: افتح بوابة المسح وامسح التذاكر.

٢ · الأعمال

النظام يحمل أكثر من عمل. العمل النشط وحده هو الذي تُدار بياناته وتظهر دعواته. لكل عمل ليالِيه وأشخاصه ومظهره وترتيب صفحاته.

• اسم العمل يظهر في رأس الدعوة وفي معاينة الرابط.
• السطر التعريفي سطرٌ صغير تحته.
• المكان يظهر في الدعوة والتذكرة.
• رابط الخريطة يفعّل زرّ «الموقع على الخريطة».
• ملاحظة الأبواب تظهر أسفل التذكرة (مثل: احضر قبل الموعد بثلاثين دقيقة).

حذف عمل يحذف معه ليالِيه وأشخاصه وحجوزاته. لا تراجع بعد الحذف.

٣ · الليالي والسعة

كل ليلة لها تاريخ ووقت وسعة وحالة (مفتوحة/مغلقة). المدعو يختار ليلته من الليالي المفتوحة غير المكتملة.

• السعة = مجموع حصص الفئات. تُحسب تلقائيًّا حين توزّع الحصص.
• المحجوز والمتبقّي يتحدّثان مع كل تأكيد أو اعتذار.
• إغلاق ليلة يمنع الحجز الجديد ولا يلغي الحجوزات القائمة.
• لا تُحذف ليلةٌ عليها حجوزات — احذف حجوزاتها أوّلًا أو أغلقها.
• لا تُخفَّض السعة تحت المحجوز فعلًا، وإلا صارت مقاعد مؤكَّدة بلا وجود.

٤ · الفئات وأرقام الكراسي

ثلاث فئات: VIP وGOLD وGUEST. لكل ليلة حصّتها من كل فئة.

توزيع الحصص

من جدول الليالي اضغط 🎟️ الفئات في صفّ الليلة. لكل فئة:

• حرف الصفّ — حرف إنجليزي واحد (A أو B أو C…) تُبنى منه أرقام الكراسي.
• عدد المقاعد — حصّة الفئة في تلك الليلة.

الحصص تختلف من ليلة لأخرى: قد تكون ليلة الافتتاح ٢٠ مقعد VIP وبقيّة الليالي ٥ فقط. لا تُخفَّض حصّة تحت المحجوز فيها.

أرقام الكراسي

رقم المقعد = حرف صفّ الفئة + رقم متسلسل داخلها: A1 · A2 · B1 · C12.

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

تغيير فئة شخص

اضغط شارة الفئة في جدول الأشخاص لتتنقّل بين GUEST ← GOLD ← VIP. لو كان قد أكّد حضوره فسيُنقل إلى صفّ الفئة الجديدة برقمٍ جديد، بشرط توفّر مقاعد فيها. ولا تتغيّر فئة من سُجّل دخوله فعلًا.

٥ · الأشخاص

نوعان:

• مدعو — يرى الدعوة المصمَّمة ويختار ليلته.
• حاجز — صفحة تأكيد أبسط، وله سقف مقاعد يحدّده العمل.

اضغط شارة النوع في الجدول لتبديله.

الإضافة

• واحدًا واحدًا — الاسم واللقب والجوال وعدد المقاعد والفئة.
• استيراد من Excel أو CSV أو لصق قائمة — المكرّر يُتجاهل.

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

٦ · الإرسال والرسائل

• حفظ فقط — يحفظ الشخص ويعطيك رابطه لتنسخه.
• حفظ وإرسال — يحفظ ثم يرسل الدعوة على واتساب.
• واتساب في صفّ الشخص — يفتح محادثته بنصّ الدعوة جاهزًا.

نصّ الرسالة — تكتبه بنفسك بالكامل

من الرسائل والتذكيرات تختار القالب من القائمة اليمنى ثم تكتب نصّك في الخانة الكبيرة وتضغط حفظ القالب. ما تكتبه هو نصًّا بنصّ ما يصل الشخص — لا شيء يُضاف ولا يُحذف.

• دعوة مدعو — الرسالة الأولى بالرابط.
• تأكيد بعد الاختيار — تصل بعد أن يختار ليلته.
• تغيير الليلة · تذكير قبل العرض · إشعار بعد الاعتذار.

المتغيّرات على اليسار — اضغط أيًّا منها ليُدرَج في مكان المؤشّر، وتُستبدل ببيانات كل شخص عند الإرسال:

{{الاسم}} {{اللقب}} {{اسم_العمل}} {{ليالي_العرض}} {{الليلة_الأولى}} {{الرابط}} {{المكان}} {{اليوم}} {{التاريخ}} {{الوقت}} {{المقاعد}} {{الفئة}} {{رقم_الكرسي}} {{رقم_التذكرة}} {{عدد_الليالي}} {{الجهة_المنظمة}}

{{ليالي_العرض}} يطبع الليالي كلّها سطرًا سطرًا بنقاط — فتضعها حيث تشاء من الرسالة أو تحذفها تمامًا.

• معاينة بأول شخص تريك الرسالة كما ستصل فعلًا.
• إرسال تجريبي لرقمي يرسلها إليك قبل أن ترسلها للناس.
• قالب عام يشمل كل الأعمال · خاص بهذا العمل يحجب العام له وحده.
• متغيّر بغير اسمٍ معروف يُرفض عند الحفظ برسالة تسمّيه — فلا تصل رسالةٌ فيها {{كذا}} ظاهرًا للمدعو.

٧ · ما يراه المدعو

ثلاث صفحات على الرابط نفسه، تتبدّل حسب حالته:

• صفحة الدعوة — يختار ليلته ثم يؤكّد أو يعتذر.
• كرت الموعد — بعد التأكيد: رمز الدخول والفئة ورقم الكرسي والموعد والمكان، وأزرار الخريطة والتقويم وتغيير اليوم والحسابات.
• صفحة الاعتذار — بعد الاعتذار، وفيها زرّ تراجع يعيده للاختيار.

٨ · المظهر والترتيب

الخلفية والألوان

• ارفع صورة خلفية، أو اختر «ألوان فقط» فتُستعمل ألوانها المستخرجة.
• اضبط التعتيم والضباب وموضع الصورة.
• لسطح البطاقة لونٌ أو صورة بشفافية تختارها.

ترتيب عناصر الصفحة

لكل صفحة من الثلاث ترتيبها المستقلّ. لكل عنصر: إظهار/إخفاء · ترتيب بالأسهم · محاذاة · حجم. وللأزرار خانة نصّ الزرّ تكتب فيها ما تشاء.

➕ أضِف نصًّا يضيف فقرةً حرّة ترتّبها وتحذفها، وتقدر تستعمل فيها المتغيّرات نفسها.

٩ · صفحة الحسابات

صفحة عامّة على الرابط /links تجمع حسابات المؤسّسة وموقعها.

• الروابط — رمز واسم ورابط لكل حساب. ترتّبها وتخفيها وتحذفها.
• مظهرها مستقلّ تمامًا عن مظهر العمل — فهي صفحة المؤسّسة.
• شعاراتها مستقلّة عن شعارات العمل.
• لعرضها للمدعوّين فعّل «زر الحسابات» من ترتيب كرت الموعد وصفحة الاعتذار — وهو مطفأ افتراضيًّا.

الروابط تُكمَّل تلقائيًّا: تكتب comma.sa فتُحفظ https://comma.sa.

١٠ · معاينة الرابط عند المشاركة

حين يُلصق الرابط في واتساب أو تويتر أو تيليجرام يظهر مربّع فيه صورة وعنوان ووصف. تضبطه من الخلفية والألوان — خانة لرابط الدعوة وأخرى لصفحة الحسابات. اتركه فارغًا ليُبنى تلقائيًّا من اسم العمل ومكانه.

١١ · البوابة والمسح

افتح بوابة المسح على جوّال أو جهاز عند الباب.

1. اختر تاريخ الليلة أعلى الشاشة.
2. وجّه الكاميرا إلى رمز التذكرة، أو اكتب الرقم يدويًّا.
3. تظهر بيانات الشخص: الاسم والفئة ورقم الكرسي.
4. اضغط «نعم، دخل» ليُسجَّل الدخول — أو «لا» فلا يُسجَّل شيء.

تذكرة استُعملت من قبل

تظهر «✕ مستخدمة» ومعها وقت الدخول السابق، ولا تُفتح البوابة. لو كان لها عذر (خرج ثم عاد) يضغط البوّاب «اطلب إذن المسؤول»:

• يظهر الطلب في اللوحة تحت «طلبات إعادة الدخول» بشارةٍ حمراء.
• المسؤول يضغط «اسمح بالدخول» أو «ارفض».
• النتيجة تصل شاشة البوّاب خلال ثوانٍ بلا أن يترك بابه.
• الإذن يفتح الباب مرّة واحدة ثم يُستهلك.

«تراجع عن التسجيل» يلغي دخولًا سُجّل بالخطأ (يحتاج صلاحية).

العدّاد الحيّ يعرض: المحجوز · من دخل · من لم يصل بعد.

١٢ · انتهاء التذكرة

التذكرة تنتهي بعد ٢٤ ساعة من موعد ليلتها. بعدها:

• لا يظهر رمز الدخول في صفحة المدعو، وتُكتب «انتهت الصلاحية».
• البوابة تردّها بـ «✕ منتهية» ولا تقبلها بأي حال.
• لا يمكن حجز ليلةٍ مضى موعدها.

الحساب بتوقيت الرياض لا بتوقيت الخادم — فالاستضافة قد تعمل على توقيت آخر والفرق يبطل تذكرةً صالحة أو يُبقي منتهية.

زرّ الحسابات يبقى ظاهرًا في التذكرة حتى بعد انتهائها.

١٣ · المستخدمون والصلاحيات

الصلاحيات ذرّية: تمنح كل مستخدم ما يحتاجه فقط.

• المالك — كل شيء، ولا يُحذف.
• مدير — إدارة كاملة عدا إدارة المستخدمين.
• منظّم — الأشخاص والإرسال والتقارير.
• بوّاب — المسح فقط.

صلاحية «التراجع عن التسجيل» هي نفسها التي تبتّ في طلبات إعادة الدخول — امنحها لمن تثق بقراره عند الباب.

غيّر كلمة مرور المالك الافتراضية فور أوّل دخول.

١٤ · التقارير والتصدير

• اللوحة — أرقام المدعوّين والمؤكَّدين والمعتذرين والحضور.
• سجلّ الردود — كل تأكيد واعتذار وتغيير بوقته.
• الصادر — كل رسالة أُرسلت أو فشلت وسببها.
• تصدير Excel — قائمة كاملة بالأسماء والحالات والفئات والمقاعد.
• كشف الليلة — قائمة الحضور لليلة بعينها للطباعة.

١٥ · النشر والنسخ الاحتياطي

اضبط متغيّر البيئة DB_FILE إلى مسارٍ ثابت مثل ~/comma_data/invitations.db. النظام يكتشف الاستضافات التي تُنشئ مجلّدًا جديدًا لكل نشر ويحوّل القاعدة تلقائيًّا إلى مسارٍ آمن، ويحاول إنقاذ بيانات النشر السابق — لكن الضبط اليدوي أضمن.

• صحّة النشر في الإعدادات تريك مسار القاعدة الفعلي وهل هو آمن.
• نسخة احتياطية تنزّل ملف القاعدة كاملًا — خذها قبل كل نشر.
• اضبط عنوان الموقع إلى نطاقك العام، وإلا خرجت الروابط بـ localhost.

بعد كل تحديث اعمل تحديثًا قسريًّا مرّة واحدة (Ctrl+Shift+R أو Cmd+Shift+R).

١٦ · مشكلات شائعة

عدّلت شيئًا ولا يظهر

تحديث قسري مرّة واحدة. الملفّات تحمل بصمة إصدار تتغيّر مع كل تعديل.

الروابط تخرج بـ localhost

اضبط عنوان الموقع من الإعدادات إلى نطاقك.

«اكتملت مقاعد فئة VIP» والليلة فيها متّسع

المكتمل حصّة الفئة لا الليلة. زد حصّة الفئة، أو غيّر فئة الشخص.

التذكرة مرفوضة عند الباب

• «يوم آخر» — تاريخ البوابة لا يطابق ليلة التذكرة.
• «مستخدمة» — سُجّل دخوله. اطلب إذن المسؤول.
• «منتهية» — مضى أكثر من ٢٤ ساعة على العرض.
• «غير صالحة» — الرمز غير مسجَّل أصلًا.

الرسائل لا تصل

راجع الصادر — كل رسالة فيها حالتها وسبب فشلها. الوضع التجريبي يسجّل ولا يرسل. استعمل زرّ «واتساب» للإرسال اليدوي.

ضاعت البيانات بعد النشر

راجع النشر والنسخ الاحتياطي — قاعدتك داخل مجلّد التطبيق.