Community Health Score Dashboard

documentation/docs/dev/deployment.md

@@ -494,6 +494,18 @@ the day, every day.
 ./manage.py collect_insights
 ```
 
+### Collect CHS Snapshot
+
+Captures per-locale Contributor Health Score metrics - completion, key-project
+enablement, active managers / translators / contributors & new signups into
+`LocaleHealthSnapshot` model. Used via the Insights dashboard and pages for
+month-over-month CHS comparisons and monthly trend charts. The job is designed
+to run once a month on the first of each month.
+
+``` bash
+./manage.py collect_chs_snapshots
+```
+
 ### Warm up cache
 
 We cache data for some of the views (e.g. Contributors) for a day. Some

pontoon/base/forms.py

@@ -333,6 +333,16 @@ class Meta:
         fields = ("locales_order",)
 
 
+class UserInsightsDashboardConfigForm(forms.ModelForm):
+    """
+    Form is responsible for saving custom configurations of the Insights Dashboard.
+    """
+
+    class Meta:
+        model = UserProfile
+        fields = ("dashboard_locales",)
+
+
 class GetEntitiesForm(forms.Form):
     """
     Form for parameters to the `entities` view.

pontoon/base/migrations/0117_userprofile_dashboard_locales.py

@@ -0,0 +1,24 @@
+# Generated by Django 5.2.14 on 2026-06-11 19:42
+
+import django.contrib.postgres.fields
+
+from django.db import migrations, models
+
+
+class Migration(migrations.Migration):
+    dependencies = [
+        ("base", "0116_remove_systran_locale_fields"),
+    ]
+
+    operations = [
+        migrations.AddField(
+            model_name="userprofile",
+            name="dashboard_locales",
+            field=django.contrib.postgres.fields.ArrayField(
+                base_field=models.PositiveIntegerField(),
+                blank=True,
+                default=list,
+                size=None,
+            ),
+        ),
+    ]

pontoon/base/migrations/0118_merge_20260624_0350.py

@@ -0,0 +1,12 @@
+# Generated by Django 5.2.14 on 2026-06-24 03:50
+
+from django.db import migrations
+
+
+class Migration(migrations.Migration):
+    dependencies = [
+        ("base", "0117_userprofile_dashboard_locales"),
+        ("base", "0117_userprofile_editor_theme"),
+    ]
+
+    operations = []

pontoon/base/migrations/0119_merge_20260624_1835.py

@@ -0,0 +1,12 @@
+# Generated by Django 5.2.14 on 2026-06-24 18:35
+
+from django.db import migrations
+
+
+class Migration(migrations.Migration):
+    dependencies = [
+        ("base", "0118_fix_terminology_entity_value"),
+        ("base", "0118_merge_20260624_0350"),
+    ]
+
+    operations = []

pontoon/base/models/user_profile.py

@@ -134,6 +134,13 @@ class EmailFrequencies(models.TextChoices):
     search_match_whole_word = models.BooleanField(default=False)
     search_rejected_translations = models.BooleanField(default=False)
 
+    # Dashboard configurations
+    dashboard_locales = ArrayField(
+        models.PositiveIntegerField(),
+        default=list,
+        blank=True,
+    )
+
     # Used to redirect a user to a custom team page.
     custom_homepage = models.CharField(max_length=20, blank=True, null=True)
 

pontoon/base/static/js/table.js

@@ -190,7 +190,11 @@ var Pontoon = (function (my) {
           }
 
           function getSort(el) {
-            return parseInt($(el).find('[data-sort]').data('sort'), 10) || 0;
+            const cell = $(el).find('td').eq(index);
+            const holder = cell.is('[data-sort]')
+              ? cell
+              : cell.find('[data-sort]').first();
+            return parseFloat(holder.attr('data-sort')) || 0;
           }
 
           function getString(el) {

pontoon/insights/admin.py

@@ -1,6 +1,7 @@
 from django.contrib import admin
 
 from pontoon.insights.models import (
+    LocaleHealthSnapshot,
     LocaleInsightsSnapshot,
     ProjectLocaleInsightsSnapshot,
 )
@@ -39,5 +40,35 @@ class ProjectLocaleInsightsSnapshotAdmin(admin.ModelAdmin):
     readonly_fields = ("project_locale",)
 
 
+class LocaleHealthSnapshotAdmin(admin.ModelAdmin):
+    search_fields = [
+        "pk",
+        "locale__code",
+        "locale__name",
+    ]
+    list_display = (
+        "pk",
+        "locale",
+        "created_at",
+        "completion",
+        "key_projects_enabled",
+        "active_managers",
+        "active_translators",
+        "active_contributors",
+        "all_contributors",
+        "new_signups",
+        "completion_score",
+        "key_projects_enabled_score",
+        "active_managers_score",
+        "active_translators_score",
+        "active_contributors_score",
+        "all_contributors_score",
+        "new_signups_score",
+        "chs",
+    )
+    list_filter = ("created_at",)
+
+
 admin.site.register(LocaleInsightsSnapshot, LocaleInsightsSnapshotAdmin)
 admin.site.register(ProjectLocaleInsightsSnapshot, ProjectLocaleInsightsSnapshotAdmin)
+admin.site.register(LocaleHealthSnapshot, LocaleHealthSnapshotAdmin)