Community Health Score Dashboard

documentation/docs/dev/deployment.md

@@ -494,6 +494,19 @@ the day, every day.
 ./manage.py collect_insights
 ```
 
+### Collect Community Health Score Snapshots
+
+Captures per-locale Community Health Score (CHS) metrics—including completion, 
+enabled key projects, active managers, translators, contributors, and new signups—
+and stores them in the `LocaleHealthSnapshot` model. 
+These metrics are used by the Insights dashboard and related pages 
+to provide month-over-month CHS comparisons and monthly trend charts. 
+The job is designed to run once a month, on the first day 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/migrations/0119_userprofile_community_health_locales.py

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

pontoon/base/models/user_profile.py

@@ -134,6 +134,12 @@ class EmailFrequencies(models.TextChoices):
     search_match_whole_word = models.BooleanField(default=False)
     search_rejected_translations = models.BooleanField(default=False)
 
+    community_health_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/base/utils.py

@@ -85,11 +85,20 @@ def aware_datetime(*args, **kwargs):
     return make_aware(datetime(*args, **kwargs))
 
 
-def convert_to_unix_time(my_datetime):
+def convert_to_unix_time(my_datetime, anchor_noon=False):
     """
-    Convert datetime object to UNIX time
+    Convert datetime object to UNIX time (milliseconds).
+
+    anchor_noon=True is needed for datetimes that are plotted on charts
+    rendered in user's timezone. That's because times that are set on
+    the 1st of each month leak into the previous month for viewers
+    behind UTC. Anchoring at 12:00 UTC keeps data point inside the
+    correct calendar month for every timezone.
     """
-    return int(time.mktime(my_datetime.timetuple()) * 1000)
+    seconds = time.mktime(my_datetime.timetuple())
+    if anchor_noon:
+        seconds += 12 * 60 * 60
+    return int(seconds * 1000)
 
 
 def sanitize_xml_input_string(string):

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)