> ## Documentation Index
> Fetch the complete documentation index at: https://docs.superalts.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# تفاعلات نظام الحضور

> جميع الأوامر، اللوحات، والإجراءات المتوفرة في بوت نظام الحضور — تشمل إعداد الأقسام، تتبع تسجيل الدخول، إدارة حالة الابتعاد، وتقارير المستخدمين.

<div dir="rtl">
  ## 🚀 أوامر السلاش كوماند

  ### `/انشاء_قسم`

  إنشاء قسم حضور جديد.

  **:حقول النموذج**

  * **اسم القسم**
  * **رتب المسؤولين** (معرفات الرتب مفصولة بفواصل `roleid1,roleid2`)
  * **رتب القسم** (معرفات الرتب مفصولة بفواصل `roleid1,roleid2`)
  * **رتب التحذير** (`رتبة تحذير ثالث`, `رتبة تحذير ثاني`, `رتبة تحذير اول` :لتحذيرات حالة الابتعاد — مرتبة حسب المستوى مثل)

  ***

  ### `/تنصيب_لوحة_التحضير`

  إعداد لوحة الحضور التفاعلية لقسم محدد.

  **:خطوات الإعداد**

  1. اختر القسم الذي تريد إعداده
  2. اختر روم السجلات (اختياري — يمكن تخطيها)
  3. اختر روم لوحة المتصدرين (اختياري — يمكن تخطيها)
  4. اختر روم لوحة الابتعاد (اختياري — يمكن تخطيها)

  ***

  ### `/التحقق_من_حضور`

  عرض سجل حضور مستخدم معين.

  **:خيارات**

  * `قسم` — القسم المطلوب
  * `مستخدم` — المستخدم المطلوب

  **:المعلومات المعروضة في الإيمبد**

  * \[#️⃣] أوقات تسجيل الدخول
  * \[⏳] إجمالي وقت الدخول
  * \[⌚] آخر تسجيل دخول
  * \[🔴] آخر تسجيل خروج

  إذا كان المستخدم في حالة ابتعاد حالياً:

  * \[🟡] حالة الأي اف كاي
  * \[⏲️] الوقت المتبقي
  * \[⌛] إجمالي وقت الأي اف كاي

  ***

  ### `/تسجيل_الحضور_الصوتي`

  التحقق من المستخدمين في القسم الذين كانوا في نفس الروم الصوتي مع المسؤول.

  **:خيارات**

  * `القسم`

  سيتم إرسال رسالة لروم السجلات تحتوي على.

  * جميع المستخدمين الذين لديهم رتبة القسم
  * حالة كل مستخدم إذا كان في الروم الصوتي مع المسؤول وقت تنفيذ الأمر

  ***

  ### `/إضافة_وقت`

  تعديل وقت تسجيل دخول المستخدم يدويًا.

  **:خيارات**

  * `القسم`
  * `المستخدم`
  * إما `إضافة` او `إزالة` — `النوع`
  * الوقت بالدقائق — `الوقت`

  ***

  ### `/إزالة_قسم`

  فتح قائمة الأقسام الحالية للاختيار وحذف أحدها.

  ***

  ## 🧷 أزرار لوحة الحضور

  ### ✅ تسجيل الدخول

  يبدأ تتبع وقت جلسة المستخدم.

  ### ❌ تسجيل الخروج

  ينهي الجلسة الحالية ويحدّث إجمالي وقت الدخول.

  ### ❔ معلومات

  يعرض معلومات حضور المستخدم في القسم الحالي بناءً على رتبته.

  **:المعلومات المعروضة**

  * \[#️⃣] أوقات تسجيل الدخول
  * \[⏳] إجمالي وقت الدخول
  * \[⌚] آخر تسجيل دخول
  * \[🔴] آخر تسجيل خروج

  ***

  ## 💤 أزرار لوحة الابتعاد (AFK)

  ### ⏳ بدء الابتعاد

  يطالب المستخدم بإدخال مدة حالة الابتعاد.

  * الحد الأقصى للوقت مُحدد في ملف `config.js`
  * :إذا انتهى الوقت ولم يُنه المستخدم حالة الابتعاد يدويًا
    * يُرسل تحذير مهلة مدته دقيقة واحدة
    * إذا لم يتم الإنهاء، يُعطى المستخدم رتبة التحذير التالية في القائمة

  ### 🔔 إنهاء الابتعاد

  ينهي حالة الابتعاد يدويًا ويلغي أي تحذيرات معلقة.
</div>