هذا دليل مرجعي يصف كيفية عمل تقارير لوحة تحكم المسؤول، والبيانات التي تعرضها، واستعلامات SQL المقابلة في Data Explorer، وأين يمكن العثور على كود Ruby لكل تقرير.
مستوى المستخدم المطلوب: موظف
يحتوي Discourse على عدة تقارير مدمجة في لوحة تحكم المسؤول يمكن أن تكون مفيدة لاستكشاف إحصائيات حول المجتمع. للوصول إلى هذه التقارير، يمكنك زيارة discourse.example.com/admin/dashboard/reports في موقعك (أو النقر على رابط التقارير في أعلى لوحة التحكم). تجدر الإشارة إلى أن فقط المستخدمين من فئة الموظفين سيكون لديهم حق الوصول إلى هذه التقارير.
تتضمن البيانات الواردة في هذه التقارير جميع المستخدمين في الموقع (بما في ذلك نشاط الموظفين مثل زيارة صفحات الإدارة). الشرط الوحيد المفروض على المستخدمين في التقارير هو أن يكونوا مستخدمين “حقيقيين”، وهو ما يُستخدم لاستبعاد مستخدم system من التقارير.
يمكن للإضافات أيضًا إضافة تقارير إلى لوحة التحكم باستخدام add_report(name, &block).
تقع نماذج Ruby لمعظم التقارير في: discourse/app/models/concerns/reports/. تشير بعض التقارير أيضًا إلى: discourse/app/models/report.rb
تحتوي مواضيع dashboard-sql على جميع استعلامات SQL المقابلة التي يمكن استخدامها لتوليد تقارير مطابقة لتقارير لوحة تحكم المسؤول. يمكن استخدام هذه الاستعلامات داخل إضافة Data Explorer ولـ تشغيل استعلامات Data Explorer باستخدام واجهة برمجة تطبيقات Discourse
لإخفاء تقارير محددة من لوحة التحكم، استخدم إعداد الموقع
dashboard_hidden_reports.
الحلول المقبولة
يعرض الإحصاء اليومي للمشاركات التي تم تحديدها كحلول.
كود Ruby: discourse-solved/plugin.rb at main · discourse/discourse-solved · GitHub
استعلام SQL: Dashboard Report - Accepted Solutions
تسجيلات دخول المسؤولين
قائمة بأوقات تسجيل دخول المسؤولين مع مواقعهم.
كود Ruby: discourse/app/models/concerns/reports/staff_logins.rb
استعلام SQL: Dashboard Report - Admin Logins
مجهول
عدد المشاهدات الجديدة للصفحات من زوار غير مسجلين في حساب.
كود Ruby: discourse/app/models/concerns/reports/consolidated_page_views.rb
استعلام SQL: Dashboard Report - Anonymous
الإشارات المرجعية
عدد المواضيع والمشاركات الجديدة التي تم وضع إشارات مرجعية عليها.
كود Ruby: discourse/app/models/concerns/reports/bookmarks.rb
استعلام SQL: Dashboard Report - Bookmarks
طلبات واجهة برمجة التطبيقات المدمجة
إحصائيات استخدام واجهة برمجة التطبيقات حسب التاريخ، وتتبع كل من طلبات واجهة برمجة التطبيقات العادية وطلبات واجهة برمجة التطبيقات الخاصة بالمستخدم.
استعلام SQL: Dashboard Report - Consolidated API Requests
مشاهدات الصفحات المدمجة
مشاهدات الصفحات للمستخدمين المسجلين، والمستخدمين المجهولين، ومحركات الزحف. هذا تقرير قديم تم استبداله بتقرير حركة مرور الموقع.
كود Ruby: discourse/app/models/concerns/reports/consolidated_page_views.rb
استعلام SQL: Dashboard Report - Consolidated Pageviews
مشاهدات الصفحات المدمجة مع كشف المتصفح (مهجور)
مشاهدات الصفحات للمستخدمين المسجلين، والمستخدمين المجهولين، ومحركات الزحف المعروفة، وغيرها. تم إهمال هذا التقرير الآن ويتم تفويضه إلى تقرير حركة مرور الموقع.
كود Ruby: discourse/app/models/concerns/reports/consolidated_page_views_browser_detection.rb
استعلام SQL: Dashboard Report - Consolidated Pageviews with Browser Detection
DAU/MAU
عدد الأعضاء الذين قاموا بتسجيل الدخول في اليوم الأخير مقسومًا على عدد الأعضاء الذين قاموا بتسجيل الدخول في الشهر الأخير – يعيد نسبة مئوية تشير إلى “التشبث” بالمجتمع. استهدف >20%.
كود Ruby: discourse/app/models/concerns/reports/dau_by_mau.rb
استعلام SQL: Dashboard Report - DAU/MAU
المستخدمين النشطين يوميًا
عدد المستخدمين الذين قاموا بالإعجاب أو النشر في اليوم الأخير.
كود Ruby: discourse/app/models/concerns/reports/daily_engaged_users.rb
استعلام SQL: Dashboard Report - Daily Engaged Users
البريد الإلكتروني المُرسل
عدد رسائل البريد الإلكتروني الجديدة المرسلة.
كود Ruby: discourse/app/models/concerns/reports/emails.rb
استعلام SQL: Dashboard Report - Emails Sent
الأعلام
عدد الأعلام الجديدة.
كود Ruby: discourse/app/models/concerns/reports/flags.rb
استعلام SQL: Dashboard Report - Flags
حالة الأعلام
قائمة بحالات الأعلام بما في ذلك نوع العلم، والناشر، والمُعلم، والوقت المستغرق للحل.
كود Ruby: discourse/app/models/concerns/reports/flags_status.rb
استعلام SQL: Dashboard Report - Flags Status
الإعجابات
عدد الإعجابات الجديدة.
كود Ruby: discourse/app/models/concerns/reports/likes.rb
استعلام SQL: Dashboard Report - Likes
تسجيل الدخول
عدد المشاهدات الجديدة للصفحات من المستخدمين المسجلين.
كود Ruby: discourse/app/controllers/admin/reports_controller.rb#L5
استعلام SQL: Dashboard Report - Logged In
نشاط المشرفين
قائمة بنشاط المشرفين بما في ذلك الأعلام التي تم مراجعتها، ووقت القراءة، والمواضيع المنشأة، والمشاركات المنشأة، والرسائل الخاصة المنشأة، والمراجعات.
استعلام SQL: Dashboard Report - Moderator Activity
تحذير المشرفين
عدد التحذيرات المرسلة عبر الرسائل الخاصة من المشرفين.
كود Ruby: discourse/app/models/concerns/reports/moderator_warning_private_messages.rb
استعلام SQL: Dashboard Report - Moderator Warnings
المساهمون الجدد
عدد المستخدمين الذين نشروا مشاركتهم الأولى خلال هذه الفترة.
كود Ruby: discourse/app/models/concerns/reports/new_contributors.rb
استعلام SQL: Dashboard Report - New Contributors
إشعار المشرفين
عدد المرات التي تم فيها إشعار المشرفين بشكل خاص بواسطة علم.
كود Ruby: discourse/app/models/concerns/reports/notify_moderators_private_messages.rb
استعلام SQL: Dashboard Report - Notify Moderators
إشعار المستخدم
عدد المرات التي تم فيها إشعار المستخدمين بشكل خاص بواسطة علم.
كود Ruby: discourse/app/models/concerns/reports/notify_user_private_messages.rb
استعلام SQL: Dashboard Report - Notify User
المشاعر العامة
عدد المشاركات المصنفة إما إيجابية أو سلبية باستخدام الذكاء الاصطناعي “المشاعر”، خلال فترة محددة.
كود Ruby: discourse-ai/lib/sentiment/entry_point.rb at main · discourse/discourse-ai · GitHub
استعلام SQL: تقرير لوحة التحكم - المشاعر العامة
مشاهدات الصفحات
عدد المشاهدات الجديدة للصفحات من جميع الزوار. نفس الإجمالي لمشاهدات الصفحات المدمجة.
يستخدم Discourse الاستعلام التالي لتحديد إجمالي مشاهدات الصفحات:
استعلام SQL: Dashboard Report - Consolidated Pageviews
تعديلات المشاركات
عدد تعديلات المشاركات الجديدة.
كود Ruby: discourse/app/models/concerns/reports/post_edits.rb
استعلام SQL: Dashboard Report - Post Edits
المشاركات
المشاركات الجديدة التي تم إنشاؤها خلال الفترة الزمنية المحددة.
كود Ruby: discourse/app/models/concerns/reports/posts.rb
استعلام SQL: Dashboard Report - Posts
عاطفة المشاركة
عدد المشاركات المصنفة بواسطة الذكاء الاصطناعي بأحد المشاعر التالية: الحزن، المفاجأة، الخوف، الغضب، الفرح، الاشمئزاز - تجميع حسب مستوى ثقة الناشر، خلال فترة محددة.
كود Ruby: discourse-ai/lib/sentiment/entry_point.rb at main · discourse/discourse-ai · GitHub
استعلام SQL: تقرير لوحة التحكم - عاطفة المشاركة
التفاعلات
قائمة أحدث التفاعلات.
كود Ruby: discourse-reactions/plugin.rb at main · discourse/discourse-reactions · GitHub
استعلام SQL: Dashboard Report - Reactions
الاشتراكات
تسجيلات الحسابات الجديدة لهذه الفترة.
كود Ruby: discourse/app/models/concerns/reports/signups.rb
استعلام SQL: Dashboard Report - Signups
حركة مرور الموقع
مشاهدات الصفحات للمتصفحات المسجلة، والمتصفحات المجهولة، ومحركات الزحف، وحركة المرور الأخرى. هذا هو تقرير حركة المرور الأساسي، ويحل محل تقارير مشاهدات الصفحات المدمجة القديمة.
كود Ruby: discourse/app/models/concerns/reports/site_traffic.rb
استعلام SQL: تقرير لوحة التحكم - حركة مرور الموقع
تسجيلات الدخول المشبوهة
تفاصيل تسجيلات الدخول الجديدة التي تختلف بشكل مشبوه عن تسجيلات الدخول السابقة.
كود Ruby: discourse/app/models/concerns/reports/suspicious_logins.rb
استعلام SQL: Dashboard Report - Suspicious Logins
النظام
عدد الرسائل الخاصة المرسلة تلقائيًا بواسطة النظام.
كود Ruby: discourse/app/models/concerns/reports/system_private_messages.rb
استعلام SQL: Dashboard Report - System
الوقت المستغرق للاستجابة الأولى
متوسط الوقت (بالساعات) للاستجابة الأولى للمواضيع الجديدة.
كود Ruby: discourse/app/models/concerns/reports/time_to_first_response.rb + discourse/discourse/blob/main/app/models/topic.rb#L1799-L1844
استعلام SQL: Dashboard Report - Time to First Response
أعلى المستخدمين تجاهلًا / إسكاتًا
المستخدمون الذين تم تجاهلهم و/أو إسكاتهم من قبل العديد من المستخدمين الآخرين.
كود Ruby: discourse/app/models/concerns/reports/top_ignored_users.rb
استعلام SQL: Dashboard Report - Top Ignored / Muted Users
المواضيع الأكثر إحالةً
المواضيع التي تلقت أكبر عدد من النقرات من مصادر خارجية.
كود Ruby: discourse/app/models/concerns/reports/top_referred_topics.rb
استعلام SQL: Dashboard Report - Top Referred Topics
أعلى الموجهين
المستخدمون المدرجون حسب عدد النقرات على الروابط التي شاركوها.
كود Ruby: discourse/app/models/concerns/reports/top_referrers.rb
استعلام SQL: Dashboard Report - Top Referrers
أعلى مصادر حركة المرور
المصادر الخارجية التي ربطت بهذا الموقع أكثر من غيرها.
كود Ruby: discourse/app/models/concerns/reports/top_traffic_sources.rb
استعلام SQL: Dashboard Report - Top Traffic Sources
أعلى الملفات المرفوعة
قائمة بجميع الملفات المرفوعة حسب الامتداد، وحجم الملف، والمؤلف.
كود Ruby: discourse/app/models/concerns/reports/top_uploads.rb
استعلام SQL: Dashboard Report - Top Uploads
أعلى المستخدمين حسب الإعجابات المستلمة
أعلى 10 مستخدمين تلقوا إعجابات.
كود Ruby: discourse/app/models/concerns/reports/top_users_by_likes_received.rb
استعلام SQL: Dashboard Report - Top Users by Likes Received
أعلى المستخدمين حسب الإعجابات المستلمة من مستخدم بمستوى ثقة أقل
أعلى 10 مستخدمين في مستوى ثقة أعلى تم إعجابهم من قبل أشخاص في مستوى ثقة أقل.
كود Ruby: discourse/app/models/concerns/reports/top_users_by_likes_received_from_inferior_trust_level.rb
استعلام SQL: Dashboard Report - Top Users by Likes Received from a User with a Lower Trust Level
أعلى المستخدمين حسب الإعجابات المستلمة من مجموعة متنوعة من الأشخاص
أعلى 10 مستخدمين تلقوا إعجابات من مجموعة واسعة من الأشخاص.
كود Ruby: discourse/app/models/concerns/reports/top_users_by_likes_received_from_a_variety_of_people.rb
استعلام SQL: Dashboard Report - Top Users by Likes Received From a Variety of People
المواضيع
المواضيع الجديدة التي تم إنشاؤها خلال هذه الفترة.
كود Ruby: discourse/app/models/concerns/reports/topics.rb
استعلام SQL: Dashboard Report - Topics
المواضيع بدون استجابة
عدد المواضيع الجديدة التي تم إنشاؤها ولم تتلق استجابة.
كود Ruby: discourse/app/models/concerns/reports/topics_with_no_response.rb
استعلام SQL: Dashboard Report - Topics with No Response
إحصائيات مشاهدة المواضيع
أعلى 100 موضوع حسب المشاهدات مع تفصيل للمستخدمين المجهولين والمسجلين، قابلة للفلترة حسب الفئة.
كود Ruby: discourse/app/models/concerns/reports/topic_view_stats.rb
استعلام SQL: تقرير لوحة التحكم - إحصائيات مشاهدة المواضيع
مصطلحات البحث الرائجة
أكثر مصطلحات البحث شيوعًا مع معدلات النقر إليها.
كود Ruby: discourse/app/models/concerns/reports/trending_search.rb
استعلام SQL: Dashboard Report - Trending Search Terms
نمو مستوى الثقة
عدد المستخدمين الذين زادوا مستوى ثقتهم خلال هذه الفترة.
يستخرج تقرير نمو مستوى الثقة البيانات من جدول user_histories في قاعدة بيانات Discourse. تحديدًا، يقوم هذا التقرير بعد عدد المرات التي تم فيها تسجيل user_histories.action لزيادة مستوى ثقة المستخدم.
كود Ruby: discourse/app/models/concerns/reports/trust_level_growth.rb
استعلام SQL: Dashboard Report - Trust Level Growth
السياسات غير المقبولة
يحدد هذا التقرير في لوحة التحكم المواضيع التي تحتوي على سياسات لم يقبلها مستخدمون معينون.
كود Ruby: discourse-policy/plugin.rb at main · discourse/discourse-policy · GitHub
استعلام SQL: Dashboard Report - Unaccepted Policies
نسبة تصويت المستخدمين
قائمة بالمستخدمين مرتبة حسب نسبة استجابة الموظفين لأعلامهم (خلاف متفق عليه).
كود Ruby: discourse/app/models/concerns/reports/user_flagging_ratio.rb
استعلام SQL: Dashboard Report - User Flagging Ratio
ملاحظات المستخدم
قائمة أحدث ملاحظات المستخدم.
كود Ruby: discourse-user-notes/plugin.rb at main · discourse/discourse-user-notes · GitHub
استعلام SQL: Dashboard Report - User Notes
مشاهدات ملف المستخدم
إجمالي المشاهدات الجديدة لملفات المستخدمين.
كود Ruby: discourse/app/models/concerns/reports/profile_views.rb
استعلام SQL: Dashboard Report - User Profile Views
زيارات المستخدم
إجمالي عدد زيارات المستخدمين المسجلين في المنتدى خلال الفترة الزمنية المحددة (اليوم، أمس، آخر 7 أيام، إلخ).
تُحتسب زيارة المستخدم في أي وقت يزور فيه مستخدم مسجل فريد الموقع، حتى مرة واحدة يوميًا. على سبيل المثال، إذا زار مستخدم موقعًا كل يوم خلال أسبوع، فسيحتسب Discourse ذلك كـ 7 زيارات للمستخدم.
كود Ruby: discourse/app/models/concerns/reports/visits.rb
استعلام SQL: Dashboard Report - User Visits
زيارات المستخدم (على الهاتف المحمول)
عدد المستخدمين المسجلين الفريدين الذين زاروا الموقع باستخدام جهاز محمول.
كود Ruby: discourse/app/models/concerns/reports/mobile_visits.rb
استعلام SQL: Dashboard Report - User Visits
من مستخدم إلى مستخدم (باستثناء الردود)
عدد الرسائل الخاصة الجديدة التي تم initiatingها.
كود Ruby: discourse/app/models/concerns/reports/user_to_user_private_messages.rb
استعلام SQL: Dashboard Report - User-to-User
من مستخدم إلى مستخدم (مع الردود)
عدد جميع الرسائل الخاصة والردود الجديدة.
كود Ruby: discourse/app/models/concerns/reports/user_to_user_private_messages_with_replies.rb
استعلام SQL: Dashboard Report - User-to-User
المستخدمين حسب مستوى الثقة
عدد المستخدمين المصنفين حسب مستوى الثقة.
كود Ruby: discourse/app/models/concerns/reports/users_by_trust_level.rb
استعلام SQL: Dashboard Report - Users Per Trust Level
المستخدمين حسب النوع
عدد المستخدمين المصنفين حسب المسؤول، المشرف، المعلق، والمُصمت.
كود Ruby: discourse/app/models/concerns/reports/users_by_type.rb
استعلام SQL: Dashboard Report - Users Per Type
مشاهدات صفحات محركات الزحف على الويب
إجمالي مشاهدات الصفحات من محركات الزحف على الويب بمرور الوقت.
كود Ruby: discourse/app/models/report.rb
استعلام SQL: Dashboard Report - Web Crawler Pageviews
وكلاء مستخدم محركات الزحف على الويب
قائمة بوكلاء مستخدم محركات الزحف على الويب، مرتبة حسب مشاهدات الصفحات.
كود Ruby: discourse/app/models/concerns/reports/web_crawlers.rb
استعلام SQL: Dashboard Report - Web Crawler User Agents

