Add /stats/ page with activity charts over time + track user-action metrics (aggregate only, no per-user tracking.) (#391)

Author: C4ptainCrunch

CHANGELOG.md

@@ -4,6 +4,8 @@ This page tries to contain all use facing changes made on DocHub.
 
 # Unreleased
 
+ * Add a /stats/ page with charts of DocHub activity over time
+ * Track more activity on /stats/ (views, downloads, searches, follows, pages traffic, feature usage, ...)
  * Add document moderation history view showing all actions taken on a document
  * Fix login errors when ULB changes your email or netid
  * Log CAS authentication failures in the admin for easier debugging

catalog/views.py

@@ -11,6 +11,7 @@
 from catalog.models import Category, Course, CourseUserView
 from catalog.slug import normalize_slug
 from documents.models import Vote
+from stats.models import DailyStat, Metric
 
 
 def slug_redirect(view):
@@ -60,6 +61,7 @@ def show_course(request, slug: str):
     if request.user.is_authenticated:
         template = "catalog/course.html"
         CourseUserView.visit(request.user, course)
+        DailyStat.track(Metric.COURSE_PAGE_VIEW)
     else:
         template = "catalog/noauth/course.html"
 
@@ -73,8 +75,10 @@ def set_follow_course(request, slug: str, action: str) -> HttpResponse:
     course = get_object_or_404(Course, slug=slug)
     if action == "follow":
         course.followed_by.add(request.user)
+        DailyStat.track(Metric.COURSE_FOLLOW)
     else:
         course.followed_by.remove(request.user)
+        DailyStat.track(Metric.COURSE_UNFOLLOW)
     course.save()
     nextpage = request.GET.get("next", reverse("catalog:course_show", args=[slug]))
     return HttpResponseRedirect(nextpage)
@@ -97,6 +101,7 @@ def leave_course(request: HttpRequest, slug: str):
 @login_required
 def my_courses(request):
     # "suggestions": suggest(request.user),
+    DailyStat.track(Metric.MY_COURSES_VIEW)
     return render(
         request,
         "catalog/my_courses.html",
@@ -125,6 +130,11 @@ class Column:
 
 def finder(request, slugs: str = ""):
     slug_list = slugs.split("/")
+
+    DailyStat.track(Metric.FINDER_VIEW)
+    if len(slug_list) >= 3:
+        DailyStat.track(Metric.FINDER_VIEW_DEEP)
+
     categories = [get_object_or_404(Category, slug=x) for x in slug_list]
 
     for i in range(len(categories) - 1, 0, -1):

documents/views.py

@@ -25,6 +25,7 @@
 )
 from documents.models import BulkDocuments, Document, Vote
 from moderation.models import ModerationLog
+from stats.models import DailyStat, Metric
 
 
 def _document_form_for_user(user, document, *args, **kwargs):
@@ -43,6 +44,8 @@ def upload_file(request, slug):
         if settings.READ_ONLY:
             return HttpResponse("Upload is disabled for a few hours", status=401)
 
+        DailyStat.track(Metric.UPLOAD_SUBMIT)
+
         form = UploadFileForm(request.POST, request.FILES)
 
         if form.is_valid():
@@ -101,6 +104,8 @@ def document_edit(request, pk):
         if settings.READ_ONLY:
             return HttpResponse("Upload is disabled for a few hours", status=401)
 
+        DailyStat.track(Metric.DOCUMENT_EDIT)
+
         if "hide" in request.POST:
             if request.user != doc.user:
                 ModerationLog.track(
@@ -208,6 +213,8 @@ def document_reupload(request, pk):
         if settings.READ_ONLY:
             return HttpResponse("Upload is disabled for a few hours", status=401)
 
+        DailyStat.track(Metric.DOCUMENT_REUPLOAD)
+
         form = ReUploadForm(request.POST, request.FILES)
 
         if form.is_valid():
@@ -254,6 +261,7 @@ def document_show(request, pk):
     if document.state == Document.DocumentState.DONE:
         document.views = F("views") + 1
         document.save(update_fields=["views"])
+        DailyStat.track(Metric.DOCUMENT_VIEW)
 
     context = {
         "document": document,
@@ -304,6 +312,7 @@ def document_original_file(request, pk):
 
     document.downloads = F("downloads") + 1
     document.save(update_fields=["downloads"])
+    DailyStat.track(Metric.DOCUMENT_DOWNLOAD)
     return response
 
 
@@ -327,6 +336,7 @@ def document_pdf_file(request, pk):
 
     document.downloads = F("views") + 1
     document.save(update_fields=["views"])
+    DailyStat.track(Metric.DOCUMENT_DOWNLOAD)
     return response
 
 

moderation/views.py

@@ -19,6 +19,7 @@
     RepresentativeRequestForm,
 )
 from moderation.models import ModerationLog, RepresentativeRequest
+from stats.models import DailyStat, Metric
 
 User = get_user_model()
 
@@ -127,6 +128,7 @@ def process_representative_request(request, request_id):
 @moderator_required
 def manage_moderators(request):
     """Display moderator requests and direct promotion controls."""
+    DailyStat.track(Metric.MODERATION_MANAGE_VIEW)
     pending_requests = (
         RepresentativeRequest.objects.filter(processed=False)
         .select_related("user")
@@ -256,6 +258,8 @@ def representative_request(request):
 def public_logs(request):
     """Public ledger of moderation actions for accountability (accessible to all logged users)."""
 
+    DailyStat.track(Metric.MODERATION_LOG_VIEW)
+
     # Fetch all relevant moderation logs
     log_list = (
         ModerationLog.objects.select_related("user", "content_type")
@@ -278,6 +282,7 @@ def public_logs(request):
 @login_required
 def moderation_tree(request):
     """Public page showing who promoted whom as moderator."""
+    DailyStat.track(Metric.MODERATION_TREE_VIEW)
     moderators = (
         User.objects.filter(Q(is_staff=True) | Q(is_moderator=True))
         .select_related("promoted_by")
@@ -316,6 +321,8 @@ def moderation_profile(request, netid):
     ):
         raise PermissionDenied("Ce profil n'a pas d'activité de modération publique.")
 
+    DailyStat.track(Metric.MODERATION_PROFILE_VIEW)
+
     logs = (
         ModerationLog.objects.filter(user=profile_user)
         .select_related("content_type")
@@ -332,12 +339,17 @@ def moderation_profile(request, netid):
 @login_required
 def moderation_about(request):
     """Public page explaining the moderation system."""
+    if is_moderator(request.user):
+        DailyStat.track(Metric.MODERATION_ABOUT_VIEW_MOD)
+    else:
+        DailyStat.track(Metric.MODERATION_ABOUT_VIEW)
     return render(request, "moderation/about.html")
 
 
 @login_required
 def document_history(request, pk):
     """Moderation history for a single document — all actions by all moderators."""
+    DailyStat.track(Metric.DOCUMENT_HISTORY_VIEW)
     document = get_object_or_404(Document, pk=pk)
     content_type = ContentType.objects.get_for_model(Document)
     logs = (

search/views.py

@@ -4,6 +4,7 @@
 
 import search.logic
 from catalog.models import Course
+from stats.models import DailyStat, Metric
 
 
 class CourseSearchView(ListView):
@@ -13,6 +14,8 @@ class CourseSearchView(ListView):
 
     def get_queryset(self):
         query = self.request.GET.get("q", "")
+        if query:
+            DailyStat.track(Metric.SEARCH_QUERY)
         return search.logic.search_course(query)
 
     def get_context_data(self, **kwargs):

static/main.js

@@ -320,6 +320,55 @@ class ModalTrigger extends Controller {
     }
 }
 
+class Chart extends Controller {
+    static values = {
+        data: Array,
+        label: String,
+        labelsId: String,
+    }
+
+    async connect() {
+        const ChartJS = (await import('https://cdn.jsdelivr.net/npm/chart.js@4.4.4/auto/+esm')).default;
+
+        const labels = JSON.parse(document.getElementById(this.labelsIdValue).textContent);
+
+        this.chart = new ChartJS(this.element, {
+            type: "line",
+            data: {
+                labels,
+                datasets: [{
+                    label: this.labelValue,
+                    data: this.dataValue,
+                    borderColor: "#0d6efd",
+                    backgroundColor: "rgba(13, 110, 253, 0.1)",
+                    fill: true,
+                    tension: 0,
+                    pointRadius: 0,
+                    borderWidth: 1.5,
+                }],
+            },
+            options: {
+                responsive: true,
+                maintainAspectRatio: true,
+                aspectRatio: 2.5,
+                animation: false,
+                interaction: {mode: "index", intersect: false},
+                plugins: {legend: {display: false}},
+                scales: {
+                    y: {beginAtZero: true, ticks: {precision: 0}},
+                    x: {ticks: {maxTicksLimit: 8, maxRotation: 0}},
+                },
+            },
+        });
+    }
+
+    disconnect() {
+        if (this.chart) {
+            this.chart.destroy();
+        }
+    }
+}
+
 const application = Application.start()
 
 application.register("course-filter", CourseFilter);
@@ -331,5 +380,6 @@ application.register('tom-select', TomSelect);
 application.register('share', Share);
 application.register('modal', Modal);
 application.register('modal-trigger', ModalTrigger);
+application.register('chart', Chart);
 
 application.debug = true;

stats/__init__.py

@@ -0,0 +1,8 @@
+from django.apps import AppConfig
+
+
+class StatsConfig(AppConfig):
+    name = "stats"
+
+    def ready(self):
+        from stats import signals  # noqa: F401, PLC0415

stats/apps.py

@@ -0,0 +1,82 @@
+# Generated by Django 6.0.5 on 2026-05-17 19:38
+
+from django.db import migrations, models
+
+
+class Migration(migrations.Migration):
+
+    initial = True
+
+    dependencies = []
+
+    operations = [
+        migrations.CreateModel(
+            name="DailyStat",
+            fields=[
+                (
+                    "id",
+                    models.BigAutoField(
+                        auto_created=True,
+                        primary_key=True,
+                        serialize=False,
+                        verbose_name="ID",
+                    ),
+                ),
+                ("date", models.DateField()),
+                (
+                    "name",
+                    models.CharField(
+                        choices=[
+                            ("document_view", "Vues de documents"),
+                            ("document_download", "Téléchargements"),
+                            ("search_query", "Recherches"),
+                            ("course_page_view", "Vues de cours"),
+                            ("login_success", "Connexions"),
+                            ("course_follow", "Cours suivis"),
+                            ("course_unfollow", "Cours dé-suivis"),
+                            ("document_edit", "Éditions de documents"),
+                            ("stats_view", "Vues de la page stats"),
+                            ("moderation_log_view", "Vues du log de modération"),
+                            ("moderation_tree_view", "Vues de l'arbre de modération"),
+                            ("upload_submit", "Soumissions d'upload"),
+                            ("document_reupload", "Réuploads de documents"),
+                            ("my_courses_view", 'Vues de "Mes cours"'),
+                            (
+                                "moderation_profile_view",
+                                "Vues de profils de modérateur·trices",
+                            ),
+                            ("document_history_view", "Vues d'historique de documents"),
+                            (
+                                "moderation_about_view",
+                                "Vues de la page modération (utilisateurs)",
+                            ),
+                            (
+                                "moderation_about_view_mod",
+                                "Vues de la page modération (modérateur·trices)",
+                            ),
+                            ("finder_view", "Vues du finder"),
+                            ("finder_view_deep", "Vues du finder (profondeur ≥ 3)"),
+                            (
+                                "moderation_manage_view",
+                                "Vues de la gestion des modérateur·trices",
+                            ),
+                        ],
+                        max_length=64,
+                    ),
+                ),
+                ("value", models.PositiveIntegerField(default=0)),
+            ],
+            options={
+                "indexes": [
+                    models.Index(
+                        fields=["name", "date"], name="stats_daily_name_85da59_idx"
+                    )
+                ],
+                "constraints": [
+                    models.UniqueConstraint(
+                        fields=("date", "name"), name="unique_dailystat"
+                    )
+                ],
+            },
+        ),
+    ]