هذا دليل مرجعي يصف كيفية عمل تقارير لوحة التحكم، والبيانات التي تعرضها، واستعلامات SQL المقابلة في مستكشف البيانات، وأين يمكن العثور على كود Ruby لكل تقرير.
مستوى المستخدم المطلوب: فريق العمل (Staff)
تحتوي Discourse على عدة تقارير مدمجة في لوحة التحكم يمكن أن تكون مفيدة لاستكشاف إحصائيات المجتمع. للوصول إلى هذه التقارير، يمكنك زيارة discourse.example.com/admin/dashboard/reports على موقعك (أو النقر على رابط التقارير في الشريط الجانبي). يرجى ملاحظة أن مستخدمي فريق العمل فقط سيكون لديهم وصول إلى هذه التقارير.
تتضمن البيانات من جميع المستخدمين على الموقع في هذه التقارير (بما في ذلك نشاط فريق العمل مثل زيارة صفحات الإدارة). الشرط الوحيد المفروض على المستخدمين في التقارير هو أنهم مستخدمون “حقيقيون”، وهو ما يُستخدم لاستبعاد مستخدم system من التقارير.
يمكن أيضًا للإضافات (Plugins) إضافة تقارير إلى لوحة التحكم باستخدام 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
طلبات API الموحدة
إحصائيات استخدام API حسب التاريخ، وتتتبع كلًا من طلبات API العادية وطلبات API الخاصة بالمستخدمين.
استعلام SQL: Dashboard Report - Consolidated API Requests
مشاهدات الصفحات الموحدة
مشاهدات الصفحات للمستخدمين المسجلين، والمستخدمين المجهولين، والزواحف (Crawlers). هذا تقرير قديم تم استبداله بتقرير زوار الموقع.
كود 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: https://github.com/discourse/discourse-ai/blob/main/lib/sentiment/entry_point.rb
استعلام 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: https://github.com/discourse/discourse-ai/blob/main/lib/sentiment/entry_point.rb
استعلام 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
من مستخدم إلى مستخدم (باستثناء الردود)
عدد الرسائل الشخصية الجديدة التي تم البدء بها.
كود 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

