إرشادات توقيت

هذا الدليل منظّم حسب المهمة: كل قسم يجمع كل ما يخص مهمة واحدة (الأوامر + إعدادات لوحة التحكم معًا). ابدأ من الأعلى إن كنت جديدًا، أو اقفز مباشرة للقسم الذي يهمّك من قائمة الأقسام.

خطوات الإعداد الأولى

1. أضف البوت إلى سيرفرك ومنحه الصلاحيات المطلوبة (إدارة الرتب والقنوات).
2. شغّل /setup configure وحدّد: قناة السجلات، قناة التقارير، رتبة المشرفين، ورتبة الأعضاء.
3. أنشئ لوحة الحضور في قناة مناسبة عبر /attendance.
4. (اختياري) فعّل المنبّه والاستراحة والنقاط من الإعدادات حسب حاجتك.

لوحة الحضور (للأعضاء)

ينشئها المشرف مرة واحدة في قناة يراها الأعضاء. تحتوي أزرارًا يضغطها العضو مباشرةً دون كتابة أي أمر:

• 📝 تسجيل الحضور: يبدأ جلسة جديدة. لا يمكن فتح جلستين في وقت واحد.
• 👋 تسجيل المغادرة: يُنهي الجلسة الحالية ويحتسب مدتها (ويمنح النقاط إن كان النظام مفعّلًا).
• ⏱️ عرض ساعاتي: يعرض للعضو ملخّص ساعاته اليوم ومدة جلسته الحالية إن كانت نشطة.
• 💤 استراحة (AFK): يظهر فقط إذا فعّلت ميزة الاستراحة — يوقف احتساب الوقت مؤقتًا.

متابعة المتواجدين لحظيًّا (للمشرفين)

أمر /activesessions يعرض قائمة محدّثة بكل من سجّل حضوره ولم يغادر بعد، مع مدة تواجد كل شخص وزر تحديث:

التدخّل اليدوي (للمشرفين)

أحيانًا ينسى العضو التسجيل، أو تحتاج لتصحيح جلسة. هذه الأوامر تعطيك تحكّمًا كاملًا:

الاستراحة (AFK) والمنبّه

ميزتان اختياريتان تُفعّلان من الإعداد لجعل احتساب الوقت أكثر عدلًا:

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

من لوحة التحكم

كل ما سبق متاح أيضًا من لوحة التحكم على الويب دون أوامر. من صفحة الإعدادات تقدر تحدّد قناة عرض قائمة الجلسات النشطة المباشرة ونمط رسالتها (نصية أو Embed) — وعندها ينشر البوت رسالة تتحدّث تلقائيًّا بمن هو حاضر الآن:

كيف تُحتسب النقاط

الأساس بسيط: معدّل أساسي لكل ساعة حضور (افتراضيًّا نقطة واحدة لكل ساعة). وفوقه طبقتان اختياريتان:

• الشرائح (Tiers): معدّلات مختلفة حسب إجمالي الساعات — لمكافأة الأكثر حضورًا.
• مضاعف أوقات الذروة (Bonus): مضاعفة النقاط خلال فترة زمنية محددة لتحفيز الحضور فيها.

أوامر الأعضاء

إدارة النقاط (للمشرفين)

من لوحة التحكم

تقدر تدير كل إعدادات النقاط بصريًّا من صفحة الإعدادات: تفعيل النظام، ضبط المعدّل الأساسي، إضافة الشرائح، وتحديد فترة مضاعف الذروة — دون حفظ أي صيغة أمر.

التقارير عند الطلب

كل تقرير يُرسل لقناة التقارير، ويقبل خيار export لتصديره ملف Excel منسّق مع رسم بياني:

التقارير التلقائية

بدل استخراج التقرير يدويًّا كل يوم، اربط رتبةً بقناة فيُرسل تقريرها اليومي تلقائيًّا عند منتصف الليل (بتوقيت سيرفرك):

التحليلات والمقارنة (لوحة التحكم)

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

تعديل الوقت والتصفير

لتصحيح ساعات عضو دون فتح جلسة، أو لتصفير سجلاته:

ونفس العمليتين متاحتان بصريًّا من صفحة تعديل الوقت في لوحة التحكم:

الرتب الإدارية

تحدّد أي الرتب يحق لها استخدام أوامر المشرفين (إضافةً للرتبة الأساسية في الإعداد). أصحاب صلاحية Administrator أو مالك السيرفر لهم وصول كامل دائمًا.

تخصيص البوت

ما الذي يفعله

بدل استخراج تقرير وقراءته يدويًّا، تسأل المساعد سؤالًا مباشرًا فيقرأ بيانات حضور سيرفرك ويجيب: ملخّصات، مقارنات، أوقات الذروة، توقعات، ومن تغيّب أو تأخّر. كل الإجابات مبنية على بياناتك الفعلية.

كيف تستخدمه