Update file __init__.py

# Conflicts:
#   allianceauth/project_template/project_name/settings/base.py

allianceauth/analytics/admin.py

@@ -1,15 +1,16 @@
 from django.contrib import admin
 
 from .models import AnalyticsIdentifier, AnalyticsTokens
+from solo.admin import SingletonModelAdmin
 
 
 @admin.register(AnalyticsIdentifier)
-class AnalyticsIdentifierAdmin(admin.ModelAdmin):
+class AnalyticsIdentifierAdmin(SingletonModelAdmin):
     search_fields = ['identifier', ]
-    list_display = ('identifier',)
+    list_display = ['identifier', ]
 
 
 @admin.register(AnalyticsTokens)
 class AnalyticsTokensAdmin(admin.ModelAdmin):
     search_fields = ['name', ]
-    list_display = ('name', 'type',)
+    list_display = ['name', 'type', ]

allianceauth/analytics/migrations/0010_alter_analyticsidentifier_options.py

@@ -0,0 +1,17 @@
+# Generated by Django 4.2.16 on 2024-12-11 02:17
+
+from django.db import migrations
+
+
+class Migration(migrations.Migration):
+
+    dependencies = [
+        ('analytics', '0009_remove_analyticstokens_ignore_paths_and_more'),
+    ]
+
+    operations = [
+        migrations.AlterModelOptions(
+            name='analyticsidentifier',
+            options={'verbose_name': 'Analytics Identifier'},
+        ),
+    ]

allianceauth/analytics/models.py

@@ -1,23 +1,19 @@
+from typing import Literal
 from django.db import models
-from django.core.exceptions import ValidationError
 from django.utils.translation import gettext_lazy as _
-
+from solo.models import SingletonModel
 from uuid import uuid4
 
 
-class AnalyticsIdentifier(models.Model):
+class AnalyticsIdentifier(SingletonModel):
 
-    identifier = models.UUIDField(
-        default=uuid4,
-        editable=False)
+    identifier = models.UUIDField(default=uuid4, editable=False)
 
-    def save(self, *args, **kwargs):
-        if not self.pk and AnalyticsIdentifier.objects.exists():
-            # Force a single object
-            raise ValidationError('There is can be only one \
-                                    AnalyticsIdentifier instance')
-        self.pk = self.id = 1  # If this happens to be deleted and recreated, force it to be 1
-        return super().save(*args, **kwargs)
+    def __str__(self) -> Literal['Analytics Identifier']:
+        return "Analytics Identifier"
+
+    class Meta:
+        verbose_name = "Analytics Identifier"
 
 
 class AnalyticsTokens(models.Model):

allianceauth/analytics/tasks.py

@@ -5,6 +5,7 @@ from django.apps import apps
 from celery import shared_task
 from .models import AnalyticsTokens, AnalyticsIdentifier
 from .utils import (
+    existence_baremetal_or_docker,
     install_stat_addons,
     install_stat_tokens,
     install_stat_users)
@@ -67,8 +68,8 @@ def analytics_event(namespace: str,
                 value=value).apply_async(priority=9)
 
 
-@shared_task()
-def analytics_daily_stats():
+@shared_task
+def analytics_daily_stats() -> None:
     """Celery Task: Do not call directly
 
     Gathers a series of daily statistics
@@ -77,6 +78,7 @@ def analytics_daily_stats():
     users = install_stat_users()
     tokens = install_stat_tokens()
     addons = install_stat_addons()
+    existence_type = existence_baremetal_or_docker()
     logger.debug("Running Daily Analytics Upload")
 
     analytics_event(namespace='allianceauth.analytics',
@@ -84,6 +86,11 @@ def analytics_daily_stats():
                     label='existence',
                     value=1,
                     event_type='Stats')
+    analytics_event(namespace='allianceauth.analytics',
+                    task='send_install_stats',
+                    label=existence_type,
+                    value=1,
+                    event_type='Stats')
     analytics_event(namespace='allianceauth.analytics',
                     task='send_install_stats',
                     label='users',
@@ -99,7 +106,6 @@ def analytics_daily_stats():
                     label='addons',
                     value=addons,
                     event_type='Stats')
-
     for appconfig in apps.get_app_configs():
         if appconfig.label in [
             "django_celery_beat",
@@ -135,7 +141,7 @@ def analytics_daily_stats():
                             event_type='Stats')
 
 
-@shared_task()
+@shared_task
 def send_ga_tracking_celery_event(
         measurement_id: str,
         secret: str,
@@ -165,7 +171,7 @@ def send_ga_tracking_celery_event(
     }
 
     payload = {
-        'client_id': AnalyticsIdentifier.objects.get(id=1).identifier.hex,
+        'client_id': AnalyticsIdentifier.get_solo().identifier.hex,
         "user_properties": {
             "allianceauth_version": {
                 "value": __version__

allianceauth/analytics/tests/test_models.py

@@ -1,9 +1,8 @@
 from allianceauth.analytics.models import AnalyticsIdentifier
-from django.core.exceptions import ValidationError
 
 from django.test.testcases import TestCase
 
-from uuid import UUID, uuid4
+from uuid import uuid4
 
 
 # Identifiers
@@ -14,14 +13,4 @@ uuid_2 = "7aa6bd70701f44729af5e3095ff4b55c"
 class TestAnalyticsIdentifier(TestCase):
 
     def test_identifier_random(self):
-        self.assertNotEqual(AnalyticsIdentifier.objects.get(), uuid4)
-
-    def test_identifier_singular(self):
-        AnalyticsIdentifier.objects.all().delete()
-        AnalyticsIdentifier.objects.create(identifier=uuid_1)
-        # Yeah i have multiple asserts here, they all do the same thing
-        with self.assertRaises(ValidationError):
-            AnalyticsIdentifier.objects.create(identifier=uuid_2)
-        self.assertEqual(AnalyticsIdentifier.objects.count(), 1)
-        self.assertEqual(AnalyticsIdentifier.objects.get(
-            pk=1).identifier, UUID(uuid_1))
+        self.assertNotEqual(AnalyticsIdentifier.get_solo(), uuid4)

allianceauth/analytics/utils.py

@@ -1,3 +1,4 @@
+import os
 from django.apps import apps
 from allianceauth.authentication.models import User
 from esi.models import Token
@@ -34,3 +35,16 @@ def install_stat_addons() -> int:
         The Number of Installed Apps"""
     addons = len(list(apps.get_app_configs()))
     return addons
+
+
+def existence_baremetal_or_docker() -> str:
+    """Checks the Installation Type of an install
+
+    Returns
+    -------
+    str
+        existence_baremetal or existence_docker"""
+    docker_tag = os.getenv('AA_DOCKER_TAG')
+    if docker_tag:
+        return "existence_docker"
+    return "existence_baremetal"

allianceauth/apps.py

@@ -1,5 +1,4 @@
 from django.apps import AppConfig
-from django.core.checks import Warning, Error, register
 
 
 class AllianceAuthConfig(AppConfig):

allianceauth/crontab/__init__.py

@@ -0,0 +1,3 @@
+"""
+Alliance Auth Crontab Utilities
+"""

allianceauth/crontab/apps.py

@@ -0,0 +1,14 @@
+"""
+Crontab App Config
+"""
+
+from django.apps import AppConfig
+
+
+class CrontabConfig(AppConfig):
+    """
+    Crontab App Config
+    """
+
+    name = "allianceauth.crontab"
+    label = "crontab"

allianceauth/crontab/models.py

@@ -0,0 +1,23 @@
+from random import random
+from django.db import models
+from django.utils.translation import gettext_lazy as _
+from solo.models import SingletonModel
+
+
+def random_default() -> float:
+    return random()
+
+
+class CronOffset(SingletonModel):
+
+    minute = models.FloatField(_("Minute Offset"), default=random_default)
+    hour = models.FloatField(_("Hour Offset"), default=random_default)
+    day_of_month = models.FloatField(_("Day of Month Offset"), default=random_default)
+    month_of_year = models.FloatField(_("Month of Year Offset"), default=random_default)
+    day_of_week = models.FloatField(_("Day of Week Offset"), default=random_default)
+
+    def __str__(self) -> str:
+        return "Cron Offsets"
+
+    class Meta:
+        verbose_name = "Cron Offsets"

allianceauth/crontab/schedulers.py

@@ -0,0 +1,63 @@
+from django.core.exceptions import ObjectDoesNotExist
+from django_celery_beat.schedulers import (
+    DatabaseScheduler
+)
+from django_celery_beat.models import CrontabSchedule
+from django.db.utils import OperationalError, ProgrammingError
+
+from celery import schedules
+from celery.utils.log import get_logger
+
+from allianceauth.crontab.models import CronOffset
+from allianceauth.crontab.utils import offset_cron
+
+logger = get_logger(__name__)
+
+
+class OffsetDatabaseScheduler(DatabaseScheduler):
+    """
+    Customization of Django Celery Beat, Database Scheduler
+    Takes the Celery Schedule from local.py and applies our AA Framework Cron Offset, if apply_offset is true
+    Otherwise it passes it through as normal
+    """
+    def update_from_dict(self, mapping):
+        s = {}
+
+        try:
+            cron_offset = CronOffset.get_solo()
+        except (OperationalError, ProgrammingError, ObjectDoesNotExist) as exc:
+            # This is just incase we haven't migrated yet or something
+            logger.warning(
+                "OffsetDatabaseScheduler: Could not fetch CronOffset (%r). "
+                "Defering to DatabaseScheduler",
+                exc
+            )
+            return super().update_from_dict(mapping)
+
+        for name, entry_fields in mapping.items():
+            try:
+                apply_offset = entry_fields.pop("apply_offset", False)
+                entry = self.Entry.from_entry(name, app=self.app, **entry_fields)
+
+                if entry.model.enabled and apply_offset:
+                    schedule_obj = entry.schedule
+                    if isinstance(schedule_obj, schedules.crontab):
+                        offset_cs = CrontabSchedule.from_schedule(offset_cron(schedule_obj))
+                        offset_cs, created = CrontabSchedule.objects.get_or_create(
+                            minute=offset_cs.minute,
+                            hour=offset_cs.hour,
+                            day_of_month=offset_cs.day_of_month,
+                            month_of_year=offset_cs.month_of_year,
+                            day_of_week=offset_cs.day_of_week,
+                            timezone=offset_cs.timezone,
+                        )
+                        entry.model.crontab = offset_cs
+                        entry.model.save()
+                        logger.debug(f"Offset applied for '{name}' due to 'apply_offset' = True.")
+
+                s[name] = entry
+
+            except Exception as e:
+                logger.exception("Error updating schedule for %s: %r", name, e)
+
+        self.schedule.update(s)

allianceauth/crontab/tests/test_models.py

@@ -0,0 +1,63 @@
+from unittest.mock import patch
+from django.test import TestCase
+
+from allianceauth.crontab.models import CronOffset
+
+
+class CronOffsetModelTest(TestCase):
+    def test_cron_offset_is_singleton(self):
+        """
+        Test that CronOffset is indeed a singleton and that
+        multiple calls to get_solo() return the same instance.
+        """
+        offset1 = CronOffset.get_solo()
+        offset2 = CronOffset.get_solo()
+
+        # They should be the exact same object in memory
+        self.assertEqual(offset1.pk, offset2.pk)
+
+    def test_default_values_random(self):
+        """
+        Test that the default values are set via random_default() when
+        no explicit value is provided. We'll patch 'random.random' to
+        produce predictable output.
+        """
+        with patch('allianceauth.crontab.models.random', return_value=0.1234):
+            # Force creation of a new CronOffset by clearing the existing one
+            CronOffset.objects.all().delete()
+
+            offset = CronOffset.get_solo()  # This triggers creation
+
+            # All fields should be 0.1234, because we patched random()
+            self.assertAlmostEqual(offset.minute, 0.1234)
+            self.assertAlmostEqual(offset.hour, 0.1234)
+            self.assertAlmostEqual(offset.day_of_month, 0.1234)
+            self.assertAlmostEqual(offset.month_of_year, 0.1234)
+            self.assertAlmostEqual(offset.day_of_week, 0.1234)
+
+    def test_update_offset_values(self):
+        """
+        Test that we can update the offsets and retrieve them.
+        """
+        offset = CronOffset.get_solo()
+        offset.minute = 0.5
+        offset.hour = 0.25
+        offset.day_of_month = 0.75
+        offset.month_of_year = 0.99
+        offset.day_of_week = 0.33
+        offset.save()
+
+        # Retrieve again to ensure changes persist
+        saved_offset = CronOffset.get_solo()
+        self.assertEqual(saved_offset.minute, 0.5)
+        self.assertEqual(saved_offset.hour, 0.25)
+        self.assertEqual(saved_offset.day_of_month, 0.75)
+        self.assertEqual(saved_offset.month_of_year, 0.99)
+        self.assertEqual(saved_offset.day_of_week, 0.33)
+
+    def test_str_representation(self):
+        """
+        Verify the __str__ method returns 'Cron Offsets'.
+        """
+        offset = CronOffset.get_solo()
+        self.assertEqual(str(offset), "Cron Offsets")

allianceauth/crontab/tests/test_utils.py

@@ -0,0 +1,80 @@
+# myapp/tests/test_tasks.py
+
+import logging
+from unittest.mock import patch
+from django.test import TestCase
+from django.db import ProgrammingError
+from celery.schedules import crontab
+
+from allianceauth.crontab.utils import offset_cron
+from allianceauth.crontab.models import CronOffset
+
+logger = logging.getLogger(__name__)
+
+
+class TestOffsetCron(TestCase):
+
+    def test_offset_cron_normal(self):
+        """
+        Test that offset_cron modifies the minute/hour fields
+        based on the CronOffset values when everything is normal.
+        """
+        # We'll create a mock CronOffset instance
+        mock_offset = CronOffset(minute=0.5, hour=0.5)
+
+        # Our initial crontab schedule
+        original_schedule = crontab(
+            minute=[0, 5, 55],
+            hour=[0, 3, 23],
+            day_of_month='*',
+            month_of_year='*',
+            day_of_week='*'
+        )
+
+        # Patch CronOffset.get_solo to return our mock offset
+        with patch('allianceauth.crontab.models.CronOffset.get_solo', return_value=mock_offset):
+            new_schedule = offset_cron(original_schedule)
+
+        # Check the new minute/hour
+        # minute 0 -> 0 + round(60 * 0.5) = 30 % 60 = 30
+        # minute 5 -> 5 + 30 = 35 % 60 = 35
+        # minute 55 -> 55 + 30 = 85 % 60 = 25  --> sorted => 25,30,35
+        self.assertEqual(new_schedule._orig_minute, '25,30,35')
+
+        # hour 0 -> 0 + round(24 * 0.5) = 12 % 24 = 12
+        # hour 3 -> 3 + 12 = 15 % 24 = 15
+        # hour 23 -> 23 + 12 = 35 % 24 = 11 --> sorted => 11,12,15
+        self.assertEqual(new_schedule._orig_hour, '11,12,15')
+
+        # Check that other fields are unchanged
+        self.assertEqual(new_schedule._orig_day_of_month, '*')
+        self.assertEqual(new_schedule._orig_month_of_year, '*')
+        self.assertEqual(new_schedule._orig_day_of_week, '*')
+
+    def test_offset_cron_programming_error(self):
+        """
+        Test that if a ProgrammingError is raised (e.g. before migrations),
+        offset_cron just returns the original schedule.
+        """
+        original_schedule = crontab(minute=[0, 15, 30], hour=[1, 2, 3])
+
+        # Force get_solo to raise ProgrammingError
+        with patch('allianceauth.crontab.models.CronOffset.get_solo', side_effect=ProgrammingError()):
+            new_schedule = offset_cron(original_schedule)
+
+        # Should return the original schedule unchanged
+        self.assertEqual(new_schedule, original_schedule)
+
+    def test_offset_cron_unexpected_exception(self):
+        """
+        Test that if any other exception is raised, offset_cron
+        also returns the original schedule, and logs the error.
+        """
+        original_schedule = crontab(minute='0', hour='0')
+
+        # Force get_solo to raise a generic Exception
+        with patch('allianceauth.crontab.models.CronOffset.get_solo', side_effect=Exception("Something bad")):
+            new_schedule = offset_cron(original_schedule)
+
+        # Should return the original schedule unchanged
+        self.assertEqual(new_schedule, original_schedule)

allianceauth/crontab/utils.py

@@ -0,0 +1,41 @@
+from celery.schedules import crontab
+import logging
+from allianceauth.crontab.models import CronOffset
+from django.db import ProgrammingError
+
+
+logger = logging.getLogger(__name__)
+
+
+def offset_cron(schedule: crontab) -> crontab:
+    """Take a crontab and apply a series of precalculated offsets to spread out tasks execution on remote resources
+
+    Args:
+        schedule (crontab): celery.schedules.crontab()
+
+    Returns:
+        crontab: A crontab with offsetted Minute and Hour fields
+    """
+
+    try:
+        cron_offset = CronOffset.get_solo()
+        new_minute = [(m + (round(60 * cron_offset.minute))) % 60 for m in schedule.minute]
+        new_hour = [(m + (round(24 * cron_offset.hour))) % 24 for m in schedule.hour]
+
+        return crontab(
+            minute=",".join(str(m) for m in sorted(new_minute)),
+            hour=",".join(str(h) for h in sorted(new_hour)),
+            day_of_month=schedule._orig_day_of_month,
+            month_of_year=schedule._orig_month_of_year,
+            day_of_week=schedule._orig_day_of_week)
+
+    except ProgrammingError as e:
+        # If this is called before migrations are run hand back the default schedule
+        # These offsets are stored in a Singleton Model,
+        logger.error(e)
+        return schedule
+
+    except Exception as e:
+        # We absolutely cant fail to hand back a schedule
+        logger.error(e)
+        return schedule

allianceauth/project_template/project_name/settings/base.py

@@ -43,13 +43,16 @@ INSTALLED_APPS = [
     'allianceauth.theme.flatly',
     'allianceauth.theme.materia',
     "allianceauth.custom_css",
+    'allianceauth.crontab',
+    'sri',
 ]
 
+SRI_ALGORITHM = "sha512"
 SECRET_KEY = "wow I'm a really bad default secret key"
 
 # Celery configuration
 BROKER_URL = 'redis://localhost:6379/0'
-CELERYBEAT_SCHEDULER = "django_celery_beat.schedulers.DatabaseScheduler"
+CELERYBEAT_SCHEDULER = "allianceauth.crontab.schedulers.OffsetDatabaseScheduler"
 CELERYBEAT_SCHEDULE = {
     'esi_cleanup_callbackredirect': {
         'task': 'esi.tasks.cleanup_callbackredirect',
@@ -62,10 +65,12 @@ CELERYBEAT_SCHEDULE = {
     'run_model_update': {
         'task': 'allianceauth.eveonline.tasks.run_model_update',
         'schedule': crontab(minute='0', hour="*/6"),
+        'apply_offset': True
     },
     'check_all_character_ownership': {
         'task': 'allianceauth.authentication.tasks.check_all_character_ownership',
         'schedule': crontab(minute='0', hour='*/4'),
+        'apply_offset': True
     },
     'analytics_daily_stats': {
         'task': 'allianceauth.analytics.tasks.analytics_daily_stats',
@@ -73,6 +78,7 @@ CELERYBEAT_SCHEDULE = {
     }
 }
 
+
 # Build paths inside the project like this: os.path.join(BASE_DIR, ...)
 PROJECT_DIR = os.path.dirname(os.path.dirname(os.path.abspath(__file__)))
 BASE_DIR = os.path.dirname(PROJECT_DIR)

allianceauth/templates/bundles/auth-base-css.html

@@ -1,3 +1,3 @@
-{% load static %}
+{% load sri %}
 
-<link href="{% static 'allianceauth/css/auth-base.css' %}" rel="stylesheet">
+{% sri_static 'allianceauth/css/auth-base.css' %}

allianceauth/templates/bundles/auth-framework-css.html

@@ -1,3 +1,3 @@
-{% load static %}
+{% load sri %}
 
-<link href="{% static 'allianceauth/framework/css/auth-framework.css' %}" rel="stylesheet">
+{% sri_static 'allianceauth/framework/css/auth-framework.css' %}

allianceauth/templates/bundles/bootstrap-css.html

@@ -1,4 +1,6 @@
 {% load static %}
+{% load sri %}
+
 <!-- Bootstrap CSS -->
 {% if NIGHT_MODE %}
     {% if debug %}
@@ -6,7 +8,7 @@
         <link rel="stylesheet/less" href="{% static 'allianceauth/css/themes/darkly/darkly.less' %}">
         <script src='https://cdnjs.cloudflare.com/ajax/libs/less.js/4.1.3/less.min.js' integrity='sha512-6gUGqd/zBCrEKbJqPI7iINc61jlOfH5A+SluY15IkNO1o4qP1DEYjQBewTB4l0U4ihXZdupg8Mb77VxqE+37dg==' crossorigin='anonymous' referrerpolicy="no-referrer"></script>
     {% else %}
-        <link rel="stylesheet" href="{% static 'allianceauth/css/themes/darkly/darkly.min.css' %}">
+        {% sri_static 'allianceauth/css/themes/darkly/darkly.min.css' %}
     {% endif %}
 {% else %}
     {% if debug %}
@@ -14,7 +16,7 @@
         <link rel="stylesheet/less" href="{% static 'allianceauth/css/themes/flatly/flatly.less' %}">
         <script src='https://cdnjs.cloudflare.com/ajax/libs/less.js/4.1.3/less.min.js' integrity='sha512-6gUGqd/zBCrEKbJqPI7iINc61jlOfH5A+SluY15IkNO1o4qP1DEYjQBewTB4l0U4ihXZdupg8Mb77VxqE+37dg==' crossorigin='anonymous' referrerpolicy="no-referrer"></script>
     {% else %}
-        <link rel="stylesheet" href="{% static 'allianceauth/css/themes/flatly/flatly.min.css' %}">
+        {% sri_static 'allianceauth/css/themes/flatly/flatly.min.css' %}
     {% endif %}
 {% endif %}
 <!-- End Bootstrap CSS -->

allianceauth/templates/bundles/checkbox-css.html

@@ -1,3 +1,3 @@
-{% load static %}
+{% load sri %}
 
-<link href="{% static 'allianceauth/css/checkbox.css' %}" rel="stylesheet">
+{% sri_static 'allianceauth/css/checkbox.css' %}

allianceauth/templates/bundles/evetime-js.html

@@ -1,3 +1,3 @@
-{% load static %}
+{% load sri %}
 
-<script src="{% static 'allianceauth/js/eve-time.js' %}"></script>
+{% sri_static 'allianceauth/js/eve-time.js' %}

allianceauth/templates/bundles/filterdropdown-js.html

@@ -1,3 +1,3 @@
-{% load static %}
+{% load sri %}
 
-<script src="{% static 'allianceauth/js/filterDropDown/filterDropDown.min.js' %}"></script>
+{% sri_static 'allianceauth/js/filterDropDown/filterDropDown.min.js' %}

allianceauth/templates/bundles/jquery-ui-css.html

@@ -1,5 +1,6 @@
-{% load static %}
 <!-- Start jQuery UI CSS from Alliance Auth -->
-<!-- CDNs all contain theme.css, which is not supposed to be in the base CSS, Which is why this is uniquely bundled in not using a CDN -->
-<link rel="stylesheet" href="{% static 'allianceauth/js/jquery-ui/1.13.2/css/jquery-ui.min.css' %}" integrity="VEqAhOZvZrx/WaxlpMoLvZDSLeLNYhkL5LU2R4/ihPJb/+qkGoMrA15SqEGtI+PCLgKwCDiby7tgdvdiAZkJGg==" crossorigin="anonymous" referrerpolicy="no-referrer">
+<!-- CDNs all contain theme.css, which is not supposed to be in the base CSS, which is why this is uniquely bundled in not using a CDN -->
+{% load sri %}
+
+{% sri_static 'allianceauth/js/jquery-ui/1.13.2/css/jquery-ui.min.css' %}
 <!-- End jQuery UI CSS from aa-gdpr -->

allianceauth/templates/bundles/moment-js.html

@@ -1,7 +1,19 @@
+{% load i18n %}
+
 <!-- Start Moment.js from cdnjs -->
 <script src="https://cdnjs.cloudflare.com/ajax/libs/moment.js/2.29.4/moment.min.js" integrity="sha512-+H4iLjY3JsKiF2V6N366in5IQHj2uEsGV7Pp/GRcm0fn76aPAk5V8xB6n8fQhhSonTqTXs/klFz4D0GIn6Br9g==" crossorigin="anonymous" referrerpolicy="no-referrer"></script>
+
 {% if locale and LANGUAGE_CODE != 'en' %}
     <!-- Moment.JS Not EN-en -->
-    <script src="https://cdnjs.cloudflare.com/ajax/libs/moment.js/2.29.4/locale/{{ LANGUAGE_CODE }}.js" crossorigin="anonymous" referrerpolicy="no-referrer"></script>
+    {% get_current_language as LANGUAGE_CODE %}
+    {% get_language_info for LANGUAGE_CODE as lang %}
+
+    {% if lang.code == 'zh-hans' %}
+        <!-- Moment.JS Localisation ({{ lang.code }}) -->
+        <script src="https://cdnjs.cloudflare.com/ajax/libs/moment.js/2.29.4/locale/zh-cn.js" crossorigin="anonymous" referrerpolicy="no-referrer"></script>
+    {% else %}
+        <!-- Moment.JS Localisation ({{ lang.code }}) -->
+        <script src="https://cdnjs.cloudflare.com/ajax/libs/moment.js/2.29.4/locale/{{ lang.code }}.js" crossorigin="anonymous" referrerpolicy="no-referrer"></script>
+    {% endif %}
 {% endif %}
 <!-- End Moment JS from cdnjs -->

allianceauth/templates/bundles/refresh-notification-icon-js.html

@@ -1,3 +1,3 @@
-{% load static %}
+{% load sri %}
 
-<script src="{% static 'allianceauth/js/refresh-notification-icon.js' %}"></script>
+{% sri_static 'allianceauth/js/refresh-notification-icon.js' %}

allianceauth/templates/bundles/refresh-notifications-js.html

@@ -1,3 +1,3 @@
-{% load static %}
+{% load sri %}
 
-<script src="{% static 'allianceauth/js/refresh_notifications.js' %}"></script>
+{% sri_static 'allianceauth/js/refresh_notifications.js' %}

allianceauth/templates/bundles/timerboard-js.html

@@ -1,3 +1,3 @@
-{% load static %}
+{% load sri %}
 
-<script src="{% static 'allianceauth/js/timerboard.js' %}"></script>
+{% sri_static 'allianceauth/js/timerboard.js' %}

allianceauth/templates/bundles/timers-js.html

@@ -1,3 +1,3 @@
-{% load static %}
+{% load sri %}
 
-<script src="{% static 'allianceauth/js/timers.js' %}"></script>
+{% sri_static 'allianceauth/js/timers.js' %}

allianceauth/timerboard/migrations/0007_alter_timer_structure.py

@@ -0,0 +1,45 @@
+# Generated by Django 4.2.17 on 2025-01-06 17:16
+
+from django.db import migrations, models
+
+
+class Migration(migrations.Migration):
+
+    dependencies = [
+        ("timerboard", "0006_alter_timer_objective_alter_timer_structure_and_more"),
+    ]
+
+    operations = [
+        migrations.AlterField(
+            model_name="timer",
+            name="structure",
+            field=models.CharField(
+                choices=[
+                    ("POCO", "POCO"),
+                    ("Orbital Skyhook", "Orbital Skyhook"),
+                    ("I-HUB", "Sovereignty Hub"),
+                    ("TCU", "TCU"),
+                    ("POS[S]", "POS [S]"),
+                    ("POS[M]", "POS [M]"),
+                    ("POS[L]", "POS [L]"),
+                    ("Astrahus", "Astrahus"),
+                    ("Fortizar", "Fortizar"),
+                    ("Keepstar", "Keepstar"),
+                    ("Raitaru", "Raitaru"),
+                    ("Azbel", "Azbel"),
+                    ("Sotiyo", "Sotiyo"),
+                    ("Athanor", "Athanor"),
+                    ("Tatara", "Tatara"),
+                    ("Pharolux Cyno Beacon", "Cyno Beacon"),
+                    ("Tenebrex Cyno Jammer", "Cyno Jammer"),
+                    ("Ansiblex Jump Gate", "Ansiblex Jump Gate"),
+                    ("Mercenary Den", "Mercenary Den"),
+                    ("Moon Mining Cycle", "Moon Mining Cycle"),
+                    ("Metenox Moon Drill", "Metenox Moon Drill"),
+                    ("Other", "Other"),
+                ],
+                default="Other",
+                max_length=254,
+            ),
+        ),
+    ]

allianceauth/timerboard/models.py

@@ -1,6 +1,6 @@
 from django.contrib.auth.models import User
 from django.db import models
-from django.utils.translation import gettext as _
+from django.utils.translation import gettext_lazy as _
 
 from allianceauth.eveonline.models import EveCharacter
 from allianceauth.eveonline.models import EveCorporationInfo
@@ -23,7 +23,7 @@ class Timer(models.Model):
 
         POCO = "POCO", _("POCO")
         ORBITALSKYHOOK = "Orbital Skyhook", _("Orbital Skyhook")
-        IHUB = "I-HUB", _("I-HUB")
+        IHUB = "I-HUB", _("Sovereignty Hub")
         TCU = "TCU", _("TCU")  # Pending Remval
         POSS = "POS[S]", _("POS [S]")
         POSM = "POS[M]", _("POS [M]")
@@ -36,9 +36,10 @@ class Timer(models.Model):
         SOTIYO = "Sotiyo", _("Sotiyo")
         ATHANOR = "Athanor", _("Athanor")
         TATARA = "Tatara", _("Tatara")
-        PHAROLUX = "Pharolux Cyno Beacon", _("Pharolux Cyno Beacon")
-        TENEBREX = "Tenebrex Cyno Jammer", _("Tenebrex Cyno Jammer")
+        PHAROLUX = "Pharolux Cyno Beacon", _("Cyno Beacon")
+        TENEBREX = "Tenebrex Cyno Jammer", _("Cyno Jammer")
         ANSIBLEX = "Ansiblex Jump Gate", _("Ansiblex Jump Gate")
+        MERCDEN = "Mercenary Den", _("Mercenary Den")
         MOONPOP = "Moon Mining Cycle", _("Moon Mining Cycle")
         METENOX = "Metenox Moon Drill", _("Metenox Moon Drill")
         OTHER = "Other", _("Other")

allianceauth/timerboard/templates/timerboard/timertable.html

@@ -19,7 +19,6 @@
 
         {% for timer in timers %}
             <tr class="{% if timer.important == True %}bg-danger bg-opacity-25{% else %}bg-info bg-opacity-25{% endif %}">
-
                 <td style="width: 150px;" class="text-center">
                     {{ timer.details }}
 
@@ -30,13 +29,21 @@
                 </td>
 
                 <td class="text-center">
+                    {% comment %} Objective: Hostile (BG: Danger) {% endcomment %}
                     {% if timer.objective == "Hostile" %}
-                        <div class="badge bg-danger">{% translate "Hostile" %}</div>
+                        <div class="badge bg-danger">
+
+                    {% comment %} Objective: Friendly (BG: Primare) {% endcomment %}
                     {% elif timer.objective == "Friendly" %}
-                        <div class="badge bg-primary">{% translate "Friendly" %}</div>
+                        <div class="badge bg-primary">
+
+                    {% comment %} Objective: Neutral (BG: Secondary) {% endcomment %}
                     {% elif timer.objective == "Neutral" %}
-                        <div class="badge bg-secondary">{% translate "Neutral" %}</div>
+                        <div class="badge bg-secondary">
                     {% endif %}
+
+                        {{ timer.get_objective_display }}
+                    </div>
                 </td>
 
                 <td class="text-center">
@@ -44,49 +51,9 @@
                 </td>
 
                 <td class="text-center">
-                    {% if timer.structure == "POCO" %}
-                        <div class="badge bg-info">{% translate "POCO" %}</div>
-                    {% elif timer.structure == "Orbital Skyhook" %}
-                        <div class="badge bg-warning">{% translate "Orbital Skyhook" %}</div>
-                    {% elif timer.structure == "I-HUB" %}
-                        <div class="badge bg-warning">{% translate "I-HUB" %}</div>
-                    {% elif timer.structure == "TCU" %} {% comment %} Pending Removal {% endcomment %}
-                        <div class="badge bg-secondary">{% translate "TCU" %}</div>
-                    {% elif timer.structure == "POS[S]" %}
-                        <div class="badge bg-info">{% translate "POS [S]" %}</div>
-                    {% elif timer.structure == "POS[M]" %}
-                        <div class="badge bg-info">{% translate "POS [M]" %}</div>
-                    {% elif timer.structure == "POS[L]" %}
-                        <div class="badge bg-info">{% translate "POS [L]" %}</div>
-                    {% elif timer.structure == "Citadel[M]" or timer.structure == "Astrahus" %}
-                        <div class="badge bg-danger">{% translate "Astrahus" %}</div>
-                    {% elif timer.structure == "Citadel[L]" or timer.structure == "Fortizar" %}
-                        <div class="badge bg-danger">{% translate "Fortizar" %}</div>
-                    {% elif timer.structure == "Citadel[XL]" or timer.structure == "Keepstar" %}
-                        <div class="badge bg-danger">{% translate "Keepstar" %}</div>
-                    {% elif timer.structure == "Engineering Complex[M]" or timer.structure == "Raitaru" %}
-                        <div class="badge bg-warning">{% translate "Raitaru" %}</div>
-                    {% elif timer.structure == "Engineering Complex[L]" or timer.structure == "Azbel" %}
-                        <div class="badge bg-warning">{% translate "Azbel" %}</div>
-                    {% elif timer.structure == "Engineering Complex[XL]" or timer.structure == "Sotiyo" %}
-                        <div class="badge bg-danger">{% translate "Sotiyo" %}</div>
-                    {% elif timer.structure == "Refinery[M]" or timer.structure == "Athanor" %}
-                        <div class="badge bg-warning">{% translate "Athanor" %}</div>
-                    {% elif timer.structure == "Refinery[L]" or timer.structure == "Tatara" %}
-                        <div class="badge bg-warning">{% translate "Tatara" %}</div>
-                    {% elif timer.structure == "Cyno Beacon" or timer.structure == "Pharolux Cyno Beacon" %}
-                        <div class="badge bg-warning">{% translate "Cyno Beacon" %}</div>
-                    {% elif timer.structure == "Cyno Jammer" or timer.structure == "Tenebrex Cyno Jammer" %}
-                        <div class="badge bg-warning">{% translate "Cyno Jammer" %}</div>
-                    {% elif timer.structure == "Jump Gate" or timer.structure == "Ansiblex Jump Gate" %}
-                        <div class="badge bg-warning">{% translate "Ansiblex Jump Gate" %}</div>
-                    {% elif timer.structure == "Moon Mining Cycle" %}
-                        <div class="badge bg-success">{% translate "Moon Mining Cycle" %}</div>
-                    {% elif timer.structure == "Metenox Moon Drill" %}
-                        <div class="badge bg-warning">{% translate "Metenox Moon Drill" %}</div>
-                    {% elif timer.structure == "Other" %}
-                        <div class="badge bg-secondary">{% translate "Other" %}</div>
-                    {% endif %}
+                    <div class="badge bg-{{ timer.bg_modifier }}">
+                        {{ timer.get_structure_display }}
+                    </div>
                 </td>
 
                 <td class="text-center" nowrap>{{ timer.eve_time | date:"Y-m-d H:i" }}</td>

allianceauth/timerboard/views.py

@@ -1,12 +1,12 @@
-import datetime
 import logging
 
 from django.contrib import messages
 from django.contrib.auth.mixins import (
-    LoginRequiredMixin, PermissionRequiredMixin,
+    LoginRequiredMixin,
+    PermissionRequiredMixin,
 )
 from django.db.models import Q
-from django.shortcuts import get_object_or_404, redirect, render
+from django.shortcuts import get_object_or_404, render
 from django.template.loader import render_to_string
 from django.urls import reverse_lazy
 from django.utils import timezone
@@ -20,8 +20,8 @@ from allianceauth.timerboard.models import Timer
 
 logger = logging.getLogger(__name__)
 
-TIMER_VIEW_PERMISSION = 'auth.timer_view'
-TIMER_MANAGE_PERMISSION = 'auth.timer_management'
+TIMER_VIEW_PERMISSION = "auth.timer_view"
+TIMER_MANAGE_PERMISSION = "auth.timer_management"
 
 
 class BaseTimerView(LoginRequiredMixin, PermissionRequiredMixin, View):
@@ -29,22 +29,112 @@ class BaseTimerView(LoginRequiredMixin, PermissionRequiredMixin, View):
 
 
 class TimerView(BaseTimerView):
-    template_name = 'timerboard/view.html'
+    template_name = "timerboard/view.html"
     permission_required = TIMER_VIEW_PERMISSION
 
     def get(self, request):
+        """
+        Renders the timer view
+
+        :param request:
+        :type request:
+        :return:
+        :rtype:
+        """
+
+        def get_bg_modifier(structure):
+            """
+            Returns the bootstrap bg modifier for the given structure
+
+            :param structure:
+            :type structure:
+            :return:
+            :rtype:
+            """
+
+            if structure in bg_info:
+                return "info"
+            elif structure in bg_warning:
+                return "warning"
+            elif structure in bg_danger:
+                return "danger"
+            elif structure in bg_secondary:
+                return "secondary"
+
+            return "primary"
+
         logger.debug(f"timer_view called by user {request.user}")
         char = request.user.profile.main_character
+
         if char:
             corp = char.corporation
         else:
             corp = None
-        base_query = Timer.objects.select_related('eve_character')
+
+        base_query = Timer.objects.select_related("eve_character")
+
+        timers = []
+        corp_timers = []
+        future_timers = []
+        past_timers = []
+
+        bg_info = [
+            Timer.Structure.POCO.value,  # POCO
+            Timer.Structure.POSS.value,  # POS[S]
+            Timer.Structure.POSM.value,  # POS[M]
+            Timer.Structure.POSL.value,  # POS[L]
+        ]
+        bg_warning = [
+            Timer.Structure.ANSIBLEX.value,  # Ansiblex Jump Gate
+            Timer.Structure.ATHANOR.value,  # Athanor
+            Timer.Structure.AZBEL.value,  # Azbel
+            Timer.Structure.MERCDEN.value,  # Mercenary Den
+            Timer.Structure.METENOX.value,  # Metenox Moon Drill
+            Timer.Structure.ORBITALSKYHOOK.value,  # Orbital Skyhook
+            Timer.Structure.PHAROLUX.value,  # Pharolux Cyno Beacon
+            Timer.Structure.RAITARU.value,  # Raitaru
+            "Station",  # Legacy structure, remove in future update
+            Timer.Structure.TATARA.value,  # Tatara
+            Timer.Structure.TENEBREX.value,  # Tenebrex Cyno Jammer
+        ]
+        bg_danger = [
+            Timer.Structure.ASTRAHUS.value,  # Astrahus
+            Timer.Structure.FORTIZAR.value,  # Fortizar
+            Timer.Structure.IHUB.value,  # I-HUB
+            Timer.Structure.KEEPSTAR.value,  # Keepstar
+            Timer.Structure.SOTIYO.value,  # Sotiyo
+            Timer.Structure.TCU.value,  # TCU (Legacy structure, remove in future update)
+        ]
+        bg_secondary = [
+            Timer.Structure.MOONPOP.value,  # Moon Mining Cycle
+            Timer.Structure.OTHER.value,  # Other
+        ]
+
+        # Timers
+        for timer in base_query.filter(corp_timer=False):
+            timer.bg_modifier = get_bg_modifier(timer.structure)
+            timers.append(timer)
+
+        # Corp Timers
+        for timer in base_query.filter(corp_timer=True, eve_corp=corp):
+            timer.bg_modifier = get_bg_modifier(timer.structure)
+            corp_timers.append(timer)
+
+        # Future Timers
+        for timer in base_query.filter(corp_timer=False, eve_time__gte=timezone.now()):
+            timer.bg_modifier = get_bg_modifier(timer.structure)
+            future_timers.append(timer)
+
+        # Past Timers
+        for timer in base_query.filter(corp_timer=False, eve_time__lt=timezone.now()):
+            timer.bg_modifier = get_bg_modifier(timer.structure)
+            past_timers.append(timer)
+
         render_items = {
-            'timers': base_query.filter(corp_timer=False),
-            'corp_timers': base_query.filter(corp_timer=True, eve_corp=corp),
-            'future_timers': base_query.filter(corp_timer=False, eve_time__gte=timezone.now()),
-            'past_timers': base_query.filter(corp_timer=False, eve_time__lt=timezone.now()),
+            "timers": timers,
+            "corp_timers": corp_timers,
+            "future_timers": future_timers,
+            "past_timers": past_timers,
         }
 
         return render(request, self.template_name, context=render_items)
@@ -52,7 +142,7 @@ class TimerView(BaseTimerView):
 
 class TimerManagementView(BaseTimerView):
     permission_required = TIMER_MANAGE_PERMISSION
-    index_redirect = 'timerboard:view'
+    index_redirect = "timerboard:view"
     success_url = reverse_lazy(index_redirect)
     model = Timer
 
@@ -66,12 +156,12 @@ class AddUpdateMixin:
         Inject the request user into the kwargs passed to the form
         """
         kwargs = super().get_form_kwargs()
-        kwargs.update({'user': self.request.user})
+        kwargs.update({"user": self.request.user})
         return kwargs
 
 
 class AddTimerView(TimerManagementView, AddUpdateMixin, CreateView):
-    template_name_suffix = '_create_form'
+    template_name_suffix = "_create_form"
     form_class = TimerForm
 
     def form_valid(self, form):
@@ -82,17 +172,18 @@ class AddTimerView(TimerManagementView, AddUpdateMixin, CreateView):
         )
         messages.success(
             self.request,
-            _('Added new timer in %(system)s at %(time)s.') % {"system": timer.system, "time": timer.eve_time}
+            _("Added new timer in %(system)s at %(time)s.")
+            % {"system": timer.system, "time": timer.eve_time},
         )
         return result
 
 
 class EditTimerView(TimerManagementView, AddUpdateMixin, UpdateView):
-    template_name_suffix = '_update_form'
+    template_name_suffix = "_update_form"
     form_class = TimerForm
 
     def form_valid(self, form):
-        messages.success(self.request, _('Saved changes to the timer.'))
+        messages.success(self.request, _("Saved changes to the timer."))
         return super().form_valid(form)
 
 
@@ -107,21 +198,20 @@ def dashboard_timers(request):
         except (EveCorporationInfo.DoesNotExist, AttributeError):
             return ""
 
-        timers = Timer.objects.select_related(
-            'eve_character'
-        ).filter(
+        timers = Timer.objects.select_related("eve_character").filter(
             (Q(corp_timer=True) & Q(eve_corp=corp)) | Q(corp_timer=False),
-            eve_time__gte=timezone.now()
+            eve_time__gte=timezone.now(),
         )[:5]
 
         if timers.count():
             context = {
-                'timers': timers,
+                "timers": timers,
             }
 
             return render_to_string(
-                template_name='timerboard/dashboard.timers.html',
-                context=context, request=request
+                template_name="timerboard/dashboard.timers.html",
+                context=context,
+                request=request,
             )
         else:
             return ""

docs/development/tech_docu/celery.md

@@ -123,6 +123,7 @@ Example setting:
 CELERYBEAT_SCHEDULE['structures_update_all_structures'] = {
     'task': 'structures.tasks.update_all_structures',
     'schedule': crontab(minute='*/30'),
+    'apply_offset': True,
 }
 ```
 
@@ -130,6 +131,7 @@ CELERYBEAT_SCHEDULE['structures_update_all_structures'] = {
 
 - `'task'`: Name of your task (full path)
 - `'schedule'`: Schedule definition (see Celery documentation on [Periodic Tasks](https://docs.celeryproject.org/en/latest/userguide/periodic-tasks.html) for details)
+- `'apply_offset'`: Boolean, Apply a Delay unique to the install, in order to reduce impact on ESI. See [Apply Offset](#apply-offset)
 
 ## How can I use priorities for tasks?
 
@@ -174,9 +176,54 @@ Large numbers of installs running the same crontab (ie. `0 * * * *`) can all sla
 
 Consider Artificially smoothing out your tasks with a few methods
 
-### Offset Crontabs
+### Apply Offset
 
-Avoid running your tasks on the hour or other nice neat human numbers, consider 23 minutes on the hour instead of at zero (`28 * * * *`)
+`allianceauth.crontab` contains a series of Offsets stored in the DB that are both static for an install, but random across all AA installs.
+
+This enables us to spread our load on ESI (or other external resources) across a greater window, making it unlikely that two installs will hit ESI at the same time.
+
+Tasks defined in local.py, can have `'apply_offset': True` added to their Task Definition
+
+```python
+CELERYBEAT_SCHEDULE['taskname'] = {
+    'task': 'module.tasks.task',
+    'schedule': crontab(minute='*/30'),
+    'apply_offset': True,
+}
+```
+
+Tasks added to directly to Django Celery Beat Models (Using a Management Task etc) can pass their Cron Schedule through offset_cron(crontab)
+
+```{eval-rst}
+.. automodule:: allianceauth.crontab.utils
+    :members:
+    :undoc-members:
+```
+
+```python
+from django_celery_beat.models import CrontabSchedule, PeriodicTask
+from celery.schedules import crontab
+
+schedule = CrontabSchedule.from_schedule(offset_cron(crontab(minute='0', hour='0')))
+
+schedule, created = CrontabSchedule.objects.get_or_create(
+    minute=schedule.minute,
+    hour=schedule.hour,
+    day_of_month=schedule.day_of_month,
+    month_of_year=schedule.month_of_year,
+    day_of_week=schedule.day_of_week,
+    timezone=schedule.timezone,
+)
+
+PeriodicTask.objects.update_or_create(
+    task='module.tasks.task',
+    defaults={
+        'crontab': schedule,
+        'name': 'task name',
+        'enabled': True
+    }
+)
+```
 
 ### Subset Tasks
 

docs/features/core/analytics.md

@@ -27,6 +27,7 @@ Analytics comes preloaded with our Google Analytics token, and the three types o
 Our Daily Stats contain the following:
 
 - A phone-in task to identify a server's existence
+- A phone-in task to identify if a server is Bare-Metal or Dockerized
 - A task to send the Number of User models
 - A task to send the Number of Token Models
 - A task to send the Number of Installed Apps

pyproject.toml

@@ -52,6 +52,7 @@ dependencies = [
     "django-registration<3.4,>=3.3",
     "django-solo",
     "django-sortedm2m",
+    "django-sri",
     "dnspython",
     "mysqlclient>=2.1",
     "openfire-restapi",