fix(metrics): warm the metrics cache on server startup

Warm the cache on web-server startup (gunicorn/runserver only, single-flight
via a Redis lock) so a mid-week deploy doesn't leave the page on the
short-lived cache until the next Saturday cron. Align the warm window to the
latest Saturday so it targets the same Sat-Fri window the dashboard requests
instead of a rolling 7-day window.

Signed-off-by: Alan Peixinho <alan.peixinho@profusion.mobi>
Co-authored-by: Cursor <cursoragent@cursor.com>

Author: alanpeixinho

backend/kernelCI_app/apps.py

@@ -1,3 +1,7 @@
+import os
+import sys
+import threading
+
 from django.apps import AppConfig
 
 
@@ -6,4 +10,20 @@ class KernelciAppConfig(AppConfig):
     name = "kernelCI_app"
 
     def ready(self) -> None:
-        return super().ready()
+        super().ready()
+        is_server = (
+            os.path.basename(sys.argv[0]) == "gunicorn" or "runserver" in sys.argv
+        )
+        if not is_server:
+            return
+        if "runserver" in sys.argv and os.environ.get("RUN_MAIN") != "true":
+            return
+
+        from django.core.cache import cache
+
+        from kernelCI_app.queries.notifications import warm_metrics_cache
+
+        # Single-flight via atomic Redis add: only one worker warms per deploy.
+        if not cache.add("metrics_startup_warm_lock", 1, timeout=600):
+            return
+        threading.Thread(target=warm_metrics_cache, daemon=True).start()

backend/kernelCI_app/queries/notifications.py

@@ -1,6 +1,6 @@
 import sys
 from concurrent.futures import ThreadPoolExecutor
-from datetime import datetime, time, timedelta, timezone
+from datetime import date, datetime, time, timedelta, timezone
 from typing import Any
 
 from django.db import connection, connections
@@ -749,6 +749,12 @@ def query_fetchall_work(
     return rows
 
 
+def last_saturday(today: date | None = None) -> date:
+    """Most recent Saturday UTC (today when today is Saturday)."""
+    day = today or datetime.now(timezone.utc).date()
+    return day - timedelta(days=(day.weekday() + 2) % 7)
+
+
 def interval_params(start_days_ago: int, end_days_ago: int) -> dict[str, str]:
     """Build [start_date, end_date) bounds from UTC day offsets."""
     today = datetime.now(timezone.utc).date()
@@ -1068,16 +1074,17 @@ def get_metrics_data(
 
 
 def warm_metrics_cache() -> None:
+    today = datetime.now(timezone.utc).date()
+    end_days_ago = (today - last_saturday(today)).days
     for period_days in METRICS_CACHE_WARM_PERIODS:
         out(
-            "Warming metrics cache for "
-            f"{period_days}-day period "
-            f"(start_days_ago={period_days}, end_days_ago=0)"
+            f"Warming metrics cache for {period_days}-day Sat-Fri period "
+            f"(end_days_ago={end_days_ago})"
         )
         try:
             get_metrics_data(
-                start_days_ago=period_days,
-                end_days_ago=0,
+                start_days_ago=end_days_ago + period_days,
+                end_days_ago=end_days_ago,
                 use_cache=False,
                 cache_timeout=METRICS_CACHE_WARM_TIMEOUT,
             )