Tavora

دليل

الأعضاء

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

1قائمة الأعضاء

من القائمة الرئيسية للمجتمع ← الأعضاء ترى قائمة بالصفحات لكل الأعضاء مع شارات الأدوار، فلتر بحسب الدور، فلتر بحسب الوسم وبحث متسامح مع الأخطاء بـ@username أو الاسم أو ID.

التحديد والإجراءات السريعة

انقر على رقم العضو لإضافته إلى التحديد (يصبح المربع ✅). يظهر في الأعلى زر 📋 عرض (N):

  • عضو واحد محدّد ← يفتح بطاقته الكاملة.
  • عضوان أو أكثر محدّدون ← يفتح العرض المُجمّع: تأكيد واحد ويُطبَّق الإجراء (ملاحظة، عقوبة، تقدير، وسم، دعوة للمجموعات، إخراج، حظر) على الجميع دفعة واحدة.

الإجراءات المُجمَّعة تعمل على عشرات أو مئات الأعضاء في عملية واحدة، مع throttling تلقائي لاحترام حدود Telegram. لا تعليق للبوت، لا عمليات نصف منجزة.

قائمة الأعضاء مع التحديد، زر عرض (N)، فلاتر الدور والوسم والبحث
قائمة الأعضاء مع التحديد، زر عرض (N)، فلاتر الدور والوسم والبحث

2بطاقة العضو

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

  • 📝 ملاحظات داخلية — مذكرات الطاقم مع مرفقات (صور، فيديو، مستندات). يعدّلها المؤلف، يُحذفها حسب التسلسل الهرمي، تثبيت أهم ملاحظة في الأعلى. فلتر «ملاحظاتي فقط».
  • 🏷 وسوم — تسميات ملوّنة (7 ألوان + بدون) مع إيموجي اختياري (بما فيه premium). حتى 20 وسمًا لكل مجتمع، قابلة للإسناد لأي عضو.
  • 📜 النشاط — جدول زمني لكل ما فعله العضو: اقتراحات أنشأها، تصويتات، مهام مُسندة، تغييرات الدور. فلاتر بحسب التاريخ (24س / 7أ / 30أ / مخصّص) والنوع.
  • ⚠️ العقوبات — قسم مخصّص أدناه.
  • 📦 إدارة المجموعات — القسم التالي.

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

البطاقة الرئيسية لعضو مع العدّادات والشاشات الفرعية والإجراءات المباشرة
البطاقة الرئيسية لعضو مع العدّادات والشاشات الفرعية والإجراءات المباشرة

3إدارة المجموعات

من البطاقة ← إدارة المجموعات تفتح اللوحة الموحّدة بكل مجموعات المجتمع مقسّمة إلى قسمين:

  • عضو في N مجموعة — زر طرد لكل واحدة
  • غير عضو في M مجموعة — تحديد متعدّد بمربعات اختيار؛ النقر على إرسال الدعوات (N) يُولّد روابط ذات استخدام واحد ويرسلها للعضو برسالة خاصة

الطرد: ماذا يحدث تقنيًا

يستخدم Tavora الطرد الناعم: حظر + رفع حظر فوري. يفقد المستخدم الوصول إلى المجموعة لكنه يستطيع العودة إذا أرسلت له دعوة جديدة. لا قائمة سوداء دائمة ل Telegram User ID.

أخطاء Telegram تُعالَج تلقائيًا: البوت بلا صلاحيات في المجموعة، الهدف مشرف/مالك (Telegram لا يسمح بطرد المشرفين)، البوت أُزيل من المجموعة، حد سرعة Telegram، file_id منتهي. toast محدّد لكل حالة، بلا أعطال، بلا عمليات نصف منجزة.

للطرد من عدّة مجموعات يُنفّذ البوت العمليات في الخلفية مع throttling (~0.5ث بين المجموعات) لاحترام حدود Telegram. تتلقى ردًا فوريًا والأثر يتسارع تدريجيًا — البوت لا يتعطّل لأي أحد.

لوحة إدارة المجموعات مع قسمَي عضو/غير عضو وإجراءات دعوة/طرد
لوحة إدارة المجموعات مع قسمَي عضو/غير عضو وإجراءات دعوة/طرد

4العقوبات والحظر التلقائي

من البطاقة ← العقوبات تفتح قائمة عقوبات العضو (نشطة + مؤرشفة). من هنا تنشئ عقوبة جديدة بسبب (حد أقصى 1000 حرف، التنسيق وإيموجي premium مدعومة).

عند الحفظ يرسل البوت رسالة خاصة للعضو مع السبب الكامل. إذا حظر البوت أو لم يُجرِ /start أبدًا، تتلقى toast إعلامي: العقوبة تُحفظ على أي حال.

حد الحظر التلقائي

من إعدادات المجتمع يمكن للمؤسِّس (founder) ضبط حد للحظر التلقائي: عند تراكم N عقوبة نشطة على العضو يتم حظره تلقائيًا. قيم سريعة (2, 3, 5, 10) أو مخصّص. يمكن تعطيله في أي وقت.

الحذف بحسب التسلسل: يستطيع المؤسِّس حذف أي عقوبة، ويستطيع المشرف حذف عقوباته وعقوبات الطاقم الأدنى، ويستطيع الطاقم حذف عقوباته فقط. العقوبات المحذوفة تبقى في soft-delete (قابلة للاسترجاع) ومسجَّلة في audit log.

يستطيع العضو رؤية عقوباته النشطة من الصفحة الرئيسية للمجتمع ← ملفيعقوباتي. يرى السبب والمؤلف والتاريخ فقط — لا الملاحظات الداخلية للطاقم.

قائمة عقوبات عضو مع رسالة خاصة تلقائية للمستلم
قائمة عقوبات عضو مع رسالة خاصة تلقائية للمستلم

5التقديرات

التقديرات هي الوجه الآخر للعقوبات: طريقة لمنح شهادة عامة لمن يعمل من أجل المنظمة.

كيف يُكتب

من البطاقة ← 🌟 التقديرات تفتح المطالبة وترسل رسالة بنص التقدير. مدعومان الغامق والمائل وإيموجي premium.

ما يحدث للعضو

يُرسل البوت للعضو رسالة خاصة مباشرة بالعنوان والنص واسم المنظمة، بالإضافة إلى زر اعرض في ملفي لفتح قائمة التقديرات المستلَمة. يبقى التقدير مرئيًا في بطاقة العضو لأي شخص يفتحها.

تقدير منشور في ملف العضو بعنوان ونص منسّقين
تقدير منشور في ملف العضو بعنوان ونص منسّقين

6تنظيف الملف

تنظيف الملف يحذف دفعة واحدة كل الملاحظات والعقوبات والوسوم والدعوات المعلّقة والتقديرات الخاصة بالعضو. مفيد عندما يبدأ شخص من جديد.

للمؤسِّس والمشرف فقط. حتى عضو من الطاقم بصلاحيات الإدارة لا يستطيع استخدام هذا الزر — إنه محجوز لأدوار النظام.

ما لا يُحذف

  • 📜 سجل النشاط — فعل التنظيف نفسه يُسجَّل، مع عدد كل ما تم حذفه.
  • 🚪 سجل الدخول/الخروج — أحداث الانضمام والمغادرة والحظر من المنظمة تبقى.
  • 👤 هوية العضو — يبقى الشخص في المنظمة بدوره. يُنظَّف فقط «الملف التأديبي».

قبل التطبيق ترى معاينة مع العدّادات: «ستُحذف: 12 ملاحظة، 3 عقوبات، 5 وسوم، دعوتان». لا ينطلق الإجراء إلا بعد تأكيد صريح.

7إحصائيات المنظمة

من قائمة الإدارة📊 الإحصائيات تفتح اللوحة المجمَّعة للمنظمة. لمحة عن الحالة العامة. مرئية فقط للمؤسس وadmin.

أقسام اللوحة الخمسة

  • 👥 Membership — إجمالي الأعضاء، توزيع حسب الدور، الدخول/الخروج/الحظر في آخر 30 يومًا.
  • ⚡ Engagement — كم شخصًا مختلفًا فعل شيئًا في آخر 7 و30 يومًا.
  • 🏆 أكثر المساهمين — من أنشأ أكثر اقتراحات، أعطى أكثر أصوات، أكمل أكثر مهام في آخر 30 يومًا.
  • ⚠️ الإدارة — العقوبات الكلية/النشطة/المؤرشفة، الحظر والحظر التلقائي الناتج عن العتبة.
  • 📈 المشاركة — نسبة الاقتراحات المُوافَق عليها والمهام المُكتمَلة.
لوحة إحصائيات المنظمة مع membership وengagement وأكثر المساهمين والإدارة والمشاركة
لوحة إحصائيات المنظمة مع membership وengagement وأكثر المساهمين والإدارة والمشاركة

8سجل الدخول/الخروج

من قائمة الأعضاء📋 سجل الدخول/الخروج تفتح اليوميات الكاملة لحالات الانضمام والمغادرة والحظر (يدوي وتلقائي وقديم) منذ وجود المنظمة. عرض زمني واحد، مختلف عن سجل البطاقة الفردية.

الفلاتر

  • نوع الحدث: الكل، 🟢 دخول، 🚪 خروج، 👢 طُرد، 🚫 حظر، ⚙️ حظر تلقائي.
  • الفترة: دائمًا، 24 ساعة، 7 أيام، 30 يومًا، أو نطاق مخصّص (يُفسَّر بمنطقتك الزمنية).

ما تراه لكل حدث

  • التاريخ والوقت.
  • العضو المعني، برابط مباشر إلى ملفه على Telegram.
  • من قام بالإجراء («نظام» للحظر التلقائي والانضمام التلقائي).
  • سبب اختياري.
  • نطاق الحظر (المنظمة فقط، أو المنظمة + المجموعات).

9إضافة أعضاء

طريقتان لإدخال أشخاص جدد في المنظمة.

  • رابط الدعوة — من القائمة الرئيسية ← دعوة. تشاركه أينما تريد: من يفتحه ينضمّ (أو يدخل قائمة انتظار الموافقة إذا كانت مفعّلة).
  • الأمر /add @user1 @user2 — من مجموعة مرتبطة (والبوت مشرف فيها): يضيف فورًا إلى المنظمة الأعضاء الموجودين بالفعل في تلك المجموعة، حتى أكثر من واحد دفعة واحدة.

الدعوات عبر الرابط تنتهي إلى لوحة «الدعوات المعلّقة» في بطاقة العضو: إذا لم تُستخدم خلال 24 ساعة يُلغى الرابط تلقائيًا. أما الأمر /add فيضيف فورًا دون إنشاء دعوة معلّقة.

لإضافة أعضاء مسجّلين بالفعل إلى مجموعات Telegram محدّدة، راجع قسم إدارة المجموعات: من قائمة الأعضاء يمكنك تحديد N شخصًا واختيار المجموعات، ويُرسل البوت روابط الدعوة في الخاص لكلٍّ منهم.
طريقتان لإضافة أعضاء إلى المنظمة: رابط الدعوة و/add @username
طريقتان لإضافة أعضاء إلى المنظمة: رابط الدعوة و/add @username

10طلبات الانضمام

حين تكون الموافقة اليدوية مفعَّلة (إعدادات المجتمع)، لا يدخل المستخدمون الجدد عبر رابط الدعوة فورًا بل ينتقلون إلى قائمة. من الإدارة ← الطلبات:

  • قبول طلبات فردية أو رفض
  • قبول الكل — زر واحد لإفراغ القائمة دفعة واحدة

على زر الإدارة في الصفحة الرئيسية للمجتمع تظهر شارة 📬N خضراء عند وجود طلبات معلّقة، و🎟N عند وجود دعوات للمجموعات لم تُستخدَم بعد. تذكيرات push كل ساعتَين إذا بقيت القائمة ممتلئة — يمكن كتمها من الإعدادات.

طلبات الانضمام المعلّقة مع إجراءات قبول/رفض
طلبات الانضمام المعلّقة مع إجراءات قبول/رفض

11نقل الملكية

لتسليم المجتمع لعضو آخر: الإدارة ← الإعدادات ← نقل الملكية. أدخل المعرّف الرقمي للمستلم (يستطيع الحصول عليه بالأمر /myid).

يجب على المستلم قبول النقل من البوت قبل أن تتغيّر الملكية. تبقى أنت Founder حتى يقبل. إذا رفض، ينتهي الطلب بعد بضعة أيام.