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

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

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 تجمع حسابات المؤسّسة وموقعها.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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