لوحة تحكم المشرف

يتضمن Potato 2.0 لوحة تحكم شاملة للمشرف لمراقبة تقدم التعليق التوضيحي وتتبع أداء المعلّقين وإدارة تهيئة المهام في الوقت الفعلي.

الوصول إلى لوحة التحكم

المصادقة بمفتاح API

قم بتهيئة مفتاح API للمشرف في ملف التهيئة الخاص بك:

admin_api_key: "your-secure-api-key-here"

قم بالوصول إلى لوحة التحكم عبر /admin وأدخل مفتاح API عند المطالبة.

طرق المصادقة

1. التنقل المباشر - انتقل إلى /admin وأدخل مفتاح API
2. المصادقة عبر الترويسة - أضف ترويسة X-API-Key في الطلبات
3. وضع التصحيح - مع debug: true، تفتح الطلبات الآتية من جهاز الخادم نفسه صفحات المشرف دون مفتاح

لا يفتح وضع التصحيح صفحات المشرف دون مفتاح إلا للطلبات الآتية من جهاز الخادم نفسه، أي من عنوان loopback دون ترويسة X-Forwarded-For أو X-Real-IP أو Forwarded. والنفق أو الوكيل العكسي على الجهاز نفسه الذي لا يضيف ترويسة تمرير يجعل كل متصل يبدو محلياً، لذا لا تفعّل debug أبداً على خادم منشور:

# Development only
debug: true  # Admin pages open without a key for requests from this machine

علامات تبويب لوحة التحكم

علامة تبويب النظرة العامة

مقاييس عالية المستوى لمهمة التعليق التوضيحي:

• إجمالي المستخدمين - عدد المعلّقين المسجلين
• إجمالي التعليقات التوضيحية - إجمالي التعليقات التوضيحية المكتملة
• معدل الإنجاز - نسبة البيانات المعلّقة
• الجلسات النشطة - المعلّقون النشطون حالياً
• تهيئة المهمة - ملخص الإعدادات الحالية

علامة تبويب المعلّقين

معلومات تفصيلية عن كل معلّق:

الميزات:

• الفرز حسب أي عمود
• التصفية حسب المرحلة أو النشاط
• تصدير بيانات المعلّقين
• عرض تفاصيل المعلّق الفردي

علامة تبويب الحالات

تصفح وإدارة حالات التعليق التوضيحي:

الميزات:

• ترقيم الصفحات (25 أو 50 أو 100 لكل صفحة)
• الفرز حسب التعليقات التوضيحية والاختلاف وغيرها
• التصفية حسب عدد التعليقات التوضيحية
• عرض تفاصيل الحالة الكاملة

علامة تبويب التهيئة

تعديل الإعدادات في الوقت الفعلي دون إعادة التشغيل:

• الحد الأقصى للتعليقات التوضيحية لكل مستخدم - تحديد عدد العناصر التي يمكن لكل مستخدم تعليقها
• الحد الأقصى للتعليقات التوضيحية لكل عنصر - التعليقات التوضيحية المستهدفة لكل حالة
• استراتيجية التعيين - كيفية تعيين الحالات للمستخدمين

تسري التغييرات فوراً.

استراتيجيات التعيين

قم بتهيئة كيفية تعيين الحالات من لوحة التحكم:

تحليلات التوقيت

تتبع لوحة التحكم بيانات توقيت تفصيلية:

• إجمالي وقت العمل - مجموع جميع جلسات التعليق التوضيحي
• متوسط الوقت لكل تعليق توضيحي - متوسط الوقت لكل عنصر
• التعليقات التوضيحية في الساعة - معدل الإنتاجية
• مدة الجلسة - الوقت لكل جلسة تسجيل دخول

بيانات التوقيت مشتقة من التتبع السلوكي وأحداث التفاعل مع الصفحة.

التهيئة

الإعداد الأساسي

# Enable admin dashboard
admin_api_key: "your-secure-api-key"

التهيئة الكاملة

admin_api_key: "your-secure-api-key"
 
# How long a session may sit idle before the server clears it.
# The clock restarts on every request, so it bounds inactivity,
# not the length of a shift. Default 480.
session_timeout_minutes: 480
 
# Editable from the Configuration tab while the server runs
assignment_strategy: least_annotated
max_annotations_per_user: 100
max_annotations_per_item: 3

نقاط نهاية API

لوحة تحكم المشرف مدعومة بنقاط نهاية REST API:

الإحصائيات

GET /api/admin/stats

تُعيد إحصائيات المهمة الإجمالية.

المعلّقون

GET /api/admin/annotators
GET /api/admin/annotators/{user_id}

عرض جميع المعلّقين أو الحصول على تفاصيل مستخدم محدد.

الحالات

GET /api/admin/instances
GET /api/admin/instances/{instance_id}

عرض الحالات مع ترقيم الصفحات والتصفية.

التهيئة

GET /api/admin/config
POST /api/admin/config

الحصول على تهيئة المهمة أو تحديثها.

تقدم التدريب

GET /api/admin/training/stats
GET /api/admin/training/user/{user_id}

إحصائيات مرحلة التدريب وتقدم كل مستخدم.

التعلم النشط

GET /api/admin/active-learning/status
GET /api/admin/active-learning/metrics

حالة نموذج التعلم النشط ومقاييس الأداء.

ميزات المراقبة

كشف النشاط المشبوه

يمكن للوحة التحكم الإشارة إلى السلوك الذي قد يكون مشكلاً:

• سرعات تعليق توضيحي سريعة جداً
• أنماط جلسات غير عادية
• أنماط إجابات متسقة
• تعليقات توضيحية مفقودة

مقاييس الجودة

تتبع مؤشرات جودة التعليق التوضيحي:

• الاتفاق بين المعلّقين
• توزيع الوقت لكل تعليق توضيحي
• توازن توزيع التصنيفات
• أداء مرحلة التدريب

أفضل ممارسات الأمان

إدارة مفتاح API

# Use environment variables
admin_api_key: ${ADMIN_API_KEY}

export ADMIN_API_KEY="your-secure-key"

التحكم في الوصول

• استخدم مفاتيح API قوية وفريدة
• قم بتدوير المفاتيح دورياً
• لا تكشف نقاط نهاية المشرف علناً
• استخدم HTTPS في الإنتاج

سجل التدقيق

تتبع لوحة التحكم إجراءات المشرف:

• تغييرات التهيئة
• إجراءات إدارة المستخدمين
• تصدير البيانات
• محاولات الوصول

مثال على التهيئة

annotation_task_name: "Sentiment Analysis"
task_dir: "."
port: 8000
 
# Admin dashboard
admin_api_key: ${ADMIN_API_KEY}
session_timeout_minutes: 480
 
# Data and annotation configuration
data_files:
  - "data/reviews.json"
 
item_properties:
  id_key: id
  text_key: text
 
annotation_schemes:
  - annotation_type: radio
    name: sentiment
    description: "How does this review read?"
    labels:
      - Positive
      - Negative
      - Neutral
 
# Assignment settings (editable from the Configuration tab)
assignment_strategy: least_annotated
max_annotations_per_user: 100
max_annotations_per_item: 3
 
output_annotation_dir: "output/"
export_annotation_format: jsonl
 
user_config:
  allow_all_users: true

اعتبارات الأداء

مجموعات البيانات الكبيرة

لمجموعات البيانات التي تحتوي على آلاف الحالات:

• استخدم ترقيم الصفحات (علامة تبويب الحالات)
• فعّل التحميل الكسول
• فكّر في واجهة قاعدة بيانات خلفية لأداء أفضل

عدد كبير من المعلّقين

للمهام التي تتضمن عدداً كبيراً من المعلّقين المتزامنين:

• حدد فترات تحديث مناسبة
• راقب موارد الخادم
• استخدم واجهة قاعدة بيانات خلفية لقابلية التوسع

# For large-scale deployments
database:
  type: mysql
  host: localhost
  database: potato_db
  username: ${DB_USER}
  password: ${DB_PASSWORD}

استكشاف الأخطاء وإصلاحها

لا يمكن الوصول إلى لوحة التحكم

• تحقق من تعيين مفتاح API في التهيئة
• تحقق من أن عنوان URL هو /admin
• تأكد من تطابق مفتاح API تماماً
• تحقق من الأخطاء المطبعية في التهيئة

بطء تحميل لوحة التحكم

• قلّل حجم الصفحة
• زِد فترة التحديث
• فكّر في واجهة قاعدة بيانات خلفية
• تحقق من موارد الخادم

الإحصائيات لا تتحدث

• تحقق من تفعيل التحديث التلقائي
• تحقق من إعداد فترة التحديث
• قم بتحديث الصفحة يدوياً
• تحقق من أخطاء JavaScript

قراءات إضافية

• التتبع السلوكي - تتبع التفاعل التفصيلي
• مراقبة الجودة - فحوصات الانتباه والمعايير الذهبية
• نظرة عامة على API - نقاط نهاية API للمشرف

للاطلاع على تفاصيل التنفيذ، راجع الوثائق المصدرية.