aa-alumni 1.0.0b1__py3-none-any.whl

aa_alumni-1.0.0b1.dist-info/METADATA

@@ -0,0 +1,100 @@
+Metadata-Version: 2.4
+Name: aa-alumni
+Version: 1.0.0b1
+Summary: Integration with Alliance Auths State System
+Keywords: allianceauth,eveonline
+Author-email: Joel Falknau <joel.falknau@gmail.com>
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+Classifier: Environment :: Web Environment
+Classifier: Framework :: Celery
+Classifier: Framework :: Django
+Classifier: Framework :: Django :: 4.2
+Classifier: Framework :: Django :: 5.2
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Programming Language :: Python :: Implementation :: CPython
+Classifier: Topic :: Internet :: WWW/HTTP
+Classifier: Topic :: Internet :: WWW/HTTP :: Dynamic Content
+License-File: LICENSE
+Requires-Dist: allianceauth>=4.6.4,<6
+Requires-Dist: django-esi>=8,<9
+Project-URL: Homepage, https://gitlab.com/tactical-supremacy/aa-alumni
+Project-URL: Source, https://gitlab.com/tactical-supremacy/aa-alumni
+Project-URL: Tracker, https://gitlab.com/tactical-supremacy/aa-alumni/-/issues
+
+# Alliance Auth - Alumni
+
+## Features
+
+- Integration with Alliance Auth's State System, creates and maintains an Alumni State for past members of an Alliance and/or Corporation.
+
+## Installation
+
+### Step 1 - Prepare Auth
+
+Remove/Promote any state with a priority of `1`, Alumni is considered slightly better than the built in Guest State.
+
+### Step 2 - Install from pip
+
+```shell
+pip install aa-alumni
+```
+
+### Step 3 - Configure Auth settings
+
+Configure your Auth settings (`local.py`) as follows:
+
+- Add `'alumni'` to `INSTALLED_APPS`
+- Add below lines to your settings file:
+
+```python
+## Settings for AA-Alumni
+# Tasks
+CELERYBEAT_SCHEDULE['alumni_run_alumni_check_all'] = {
+    'task': 'alumni.tasks.run_alumni_check_all',
+    'schedule': crontab(minute="0", hour="0", day_of_week="4"),
+    'apply_offset': True,
+}
+CELERYBEAT_SCHEDULE['alumni_run_update_all_models'] = {
+    'task': 'alumni.tasks.update_all_models',
+    'schedule': crontab(minute="0", hour="0", day_of_week="3"),
+    'apply_offset': True,
+}
+```
+
+### Step 4 - Update AA's State system
+
+```shell
+python myauth/manage.py alumni_state
+```
+
+### Step 5 - Maintain Alliance Auth
+
+- Run migrations `python manage.py migrate`
+- Gather your staticfiles `python manage.py collectstatic`
+- Restart your project `supervisorctl restart myauth:`
+
+### Step 6 - Configure Further
+
+In the Admin interface, visit `alumni > config > add` or `<AUTH-URL>/admin/alumni/config/add/`
+Select the Alliances and/or Corporations for which characters with historical membership are Alumni
+
+## Settings
+
+| Name | Description | Default |
+| --- | --- | --- |
+|`ALUMNI_CHARACTERCORPORATION_RATELIMIT`| Celery Rate Limit _per worker_, 10 tasks * 10 Workers = 100 tasks/min | '10/m' |
+
+## Contributing
+
+Make sure you have signed the [License Agreement](https://developers.eveonline.com/resource/license-agreement) by logging in at <https://developers.eveonline.com> before submitting any pull requests. All bug fixes or features must not include extra superfluous formatting changes.
+

aa_alumni-1.0.0b1.dist-info/RECORD

@@ -0,0 +1,24 @@
+alumni/__init__.py,sha256=oYGhAgysyvO0h-v434BQRXMOWqlEmjgjoamWPFb4Qys,293
+alumni/admin.py,sha256=BiqnT1Gk_wJOJ1eeIFbtgQf1n2q5MLf8Wkc4CqSz5Vw,1271
+alumni/app_settings.py,sha256=soF5EtRwxvWG2ARqzm7e7Qe5dpp-NCPZ-um781fENvs,383
+alumni/apps.py,sha256=JNO5V_uldj3Y2OEJL0h4u86LoPZr5UOhzkcTFZ6VeNI,239
+alumni/models.py,sha256=UPr_xGxiRwZrFB2nmhdMPXxCVCiN7RBKGeu-ULNjGd0,3036
+alumni/providers.py,sha256=qUK2zX_DvGOwbgozn8dlgKXZ87e4Zpl4ZnYMEDLjjEY,1309
+alumni/signals.py,sha256=WpeyRa8AGfcWAR9qvy3FgfdP2zNLBzqrh7xm1cH5Klg,835
+alumni/tasks.py,sha256=r-y0M5ueWxlsdMgN-75MSU4b75zdLHXlX57xcL2Yw7Q,11991
+alumni/locale/de/LC_MESSAGES/django.mo,sha256=hTZUh1Insgy-eZmz0-Owvgy9Mh6tNw3p2X9J6tD4TwE,1250
+alumni/locale/de/LC_MESSAGES/django.po,sha256=aEAiaM_iPQFp3BCjD0-WEKRMrtLSIn2gp7INLJ5KbJY,1744
+alumni/locale/en/LC_MESSAGES/django.mo,sha256=N1pb17IfLd0ASiKO8d68-B4ygSpDkhKOCs8YTzMXQo0,380
+alumni/locale/en/LC_MESSAGES/django.po,sha256=dW_HNYdzscfIrGUoGA1-0PwV0LNn7-WdgXmdMU7pGm8,1250
+alumni/management/commands/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+alumni/management/commands/alumni_state.py,sha256=OyJKnkzk9eksk-vULSVBdGvMEhxZX_xa7eH5RXFjeJ8,759
+alumni/migrations/0001_initial.py,sha256=C8R2k4y5KvpTLU_etBQ0J3jkGYd3HAgevAekUZvzxDw,3283
+alumni/migrations/0002_auto_20211230_0147.py,sha256=p3sK1Ohdf6O20tDbMmuPJwC2vVFH-AR0kkXFy9H34_Y,626
+alumni/migrations/0003_alter_alumnisetup_options_and_more.py,sha256=JyXQqo9vR-hRx7CHsNpXLxZEjEijSBLW3zX7Zmw3Y50,1012
+alumni/migrations/0004_corporationupdatetimestamp_alter_alumnisetup_options_and_more.py,sha256=5jDhobyP_AfnBDnKlfAodriKbHrX4MyYMGf1A4oUk8w,2112
+alumni/migrations/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+alumni/tests/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+aa_alumni-1.0.0b1.dist-info/licenses/LICENSE,sha256=6TxpZBZY7OLGLrJXe6vREu--u7CjCfW19u4oXW_uZKs,1069
+aa_alumni-1.0.0b1.dist-info/WHEEL,sha256=G2gURzTEtmeR8nrdXUJfNiB3VYVxigPQ-bEQujpNiNs,82
+aa_alumni-1.0.0b1.dist-info/METADATA,sha256=oDf7ZDVPX1Hvo4mt7SaeDFxHpfE9W6K9SQ5v7urrVkg,3448
+aa_alumni-1.0.0b1.dist-info/RECORD,,

aa_alumni-1.0.0b1.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: flit 3.12.0
+Root-Is-Purelib: true
+Tag: py3-none-any

aa_alumni-1.0.0b1.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2021 Joel Falknau
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

alumni/__init__.py

@@ -0,0 +1,10 @@
+"""
+Integration with Alliance Auths State System
+
+Creates and maintains an Alumni State for past members of an Alliance and/or Corporation
+"""
+
+__version__ = "1.0.0b1"
+__title__ = "AAAlumni"
+__url__ = "https://gitlab.com/tactical-supremacy/aa-alumni"
+__esi_compatibility_date__ = "2025-11-06"

alumni/admin.py

@@ -0,0 +1,37 @@
+from solo.admin import SingletonModelAdmin
+
+from django.contrib import admin
+
+from .models import (
+    AlumniSetup, CharacterCorporationHistory, CharacterUpdateTimestamp,
+    CorporationAllianceHistory, CorporationUpdateTimestamp,
+)
+
+
+@admin.register(AlumniSetup)
+class AlumniSetupAdmin(SingletonModelAdmin):
+    filter_horizontal = ["alumni_corporations", "alumni_alliances"]
+
+
+@admin.register(CorporationAllianceHistory)
+class CorporationAllianceHistoryAdmin(admin.ModelAdmin):
+    search_fields = ['corporation_id', 'alliance_id']
+    list_display = ('corporation_id', 'alliance_id', 'record_id', 'start_date')
+
+
+@admin.register(CharacterCorporationHistory)
+class CharacterCorporationHistoryAdmin(admin.ModelAdmin):
+    search_fields = ['corporation_id', 'character']
+    list_display = ('corporation_id', 'character', 'record_id', 'start_date')
+
+
+@admin.register(CharacterUpdateTimestamp)
+class CharacterUpdateTimestampAdmin(admin.ModelAdmin):
+    search_fields = ['character__character_name', 'character__character_id']
+    list_display = ('character', 'last_updated')
+
+
+@admin.register(CorporationUpdateTimestamp)
+class CorporationUpdateTimestampAdmin(admin.ModelAdmin):
+    search_fields = ['corporation_id']
+    list_display = ('corporation_id', 'last_updated')

alumni/app_settings.py

@@ -0,0 +1,9 @@
+from django.conf import settings
+
+ALUMNI_STATE_NAME = getattr(settings, 'ALUMNI_STATE_NAME', "Alumni")
+
+ALUMNI_TASK_PRIORITY = getattr(settings, 'ALUMNI_TASK_PRIORITY', 7)
+
+ALUMNI_CHARACTERCORPORATION_RATELIMIT = getattr(settings, 'ALUMNI_CHARACTERCORPORATION_RATELIMIT', '10/m')  # 10*10workers = 100/300 per min
+
+ALUMNI_TASK_JITTER = getattr(settings, 'ALUMNI_TASK_PRIORITY', 600)

alumni/apps.py

@@ -0,0 +1,10 @@
+from django.apps import AppConfig
+
+from . import __version__
+
+
+class AlumniConfig(AppConfig):
+    default_auto_field = 'django.db.models.BigAutoField'
+    name = "alumni"
+    label = "alumni"
+    verbose_name = f"AA Alumni v{__version__}"

alumni/locale/de/LC_MESSAGES/django.po

@@ -0,0 +1,53 @@
+# SOME DESCRIPTIVE TITLE.
+# Copyright (C) YEAR THE PACKAGE'S COPYRIGHT HOLDER
+# This file is distributed under the same license as the PACKAGE package.
+# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.
+# 
+# Translators:
+# Peter Pfeufer, 2024
+# 
+#, fuzzy
+msgid ""
+msgstr ""
+"Project-Id-Version: PACKAGE VERSION\n"
+"Report-Msgid-Bugs-To: \n"
+"POT-Creation-Date: 2024-05-11 18:13+1000\n"
+"PO-Revision-Date: 2024-05-11 10:42+0000\n"
+"Last-Translator: Peter Pfeufer, 2024\n"
+"Language-Team: German (https://app.transifex.com/alliance-auth/teams/107430/de/)\n"
+"MIME-Version: 1.0\n"
+"Content-Type: text/plain; charset=UTF-8\n"
+"Content-Transfer-Encoding: 8bit\n"
+"Language: de\n"
+"Plural-Forms: nplurals=2; plural=(n != 1);\n"
+
+#: alumni/models.py:14
+msgid ""
+"Characters with these Corps in their History will be given Alumni Status"
+msgstr ""
+"Charaktere mit diesen Corps in ihrer Vergangenheit erhalten den Alumni-"
+"Status"
+
+#: alumni/models.py:18
+msgid ""
+"Characters with these Alliances in their History will be given Alumni Status"
+msgstr ""
+"Charaktere mit diesen Allianzen in ihrer Vergangenheit erhalten den Alumni-"
+"Status"
+
+#: alumni/models.py:21 alumni/models.py:24 alumni/models.py:25
+msgid "Alumni Config"
+msgstr "Alumni-Konfiguration"
+
+#: alumni/models.py:37 alumni/models.py:52
+msgid "True if the corporation has been deleted"
+msgstr "Wahr, wenn die Corporation gelöscht wurde"
+
+#: alumni/models.py:39 alumni/models.py:54
+msgid ""
+"An incrementing ID that can be used to canonically establish order of "
+"records in cases where dates may be ambiguous"
+msgstr ""
+"Eine aufsteigende ID, die zur kanonischen Festlegung der Reihenfolge von "
+"Datensätzen in Fällen verwendet werden kann, in denen Daten möglicherweise "
+"nicht eindeutig sind"

alumni/locale/en/LC_MESSAGES/django.po

@@ -0,0 +1,43 @@
+# SOME DESCRIPTIVE TITLE.
+# Copyright (C) YEAR THE PACKAGE'S COPYRIGHT HOLDER
+# This file is distributed under the same license as the PACKAGE package.
+# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.
+#
+#, fuzzy
+msgid ""
+msgstr ""
+"Project-Id-Version: PACKAGE VERSION\n"
+"Report-Msgid-Bugs-To: \n"
+"POT-Creation-Date: 2024-08-29 14:59+1000\n"
+"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
+"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
+"Language-Team: LANGUAGE <LL@li.org>\n"
+"Language: \n"
+"MIME-Version: 1.0\n"
+"Content-Type: text/plain; charset=UTF-8\n"
+"Content-Transfer-Encoding: 8bit\n"
+"Plural-Forms: nplurals=2; plural=(n != 1);\n"
+
+#: alumni/models.py:15
+msgid ""
+"Characters with these Corps in their History will be given Alumni Status"
+msgstr ""
+
+#: alumni/models.py:19
+msgid ""
+"Characters with these Alliances in their History will be given Alumni Status"
+msgstr ""
+
+#: alumni/models.py:22 alumni/models.py:25 alumni/models.py:26
+msgid "Alumni Config"
+msgstr ""
+
+#: alumni/models.py:38 alumni/models.py:53
+msgid "True if the corporation has been deleted"
+msgstr ""
+
+#: alumni/models.py:40 alumni/models.py:55
+msgid ""
+"An incrementing ID that can be used to canonically establish order of "
+"records in cases where dates may be ambiguous"
+msgstr ""

alumni/management/commands/alumni_state.py

@@ -0,0 +1,24 @@
+from django.core.management.base import BaseCommand
+
+from allianceauth.authentication.models import State
+
+from alumni import app_settings
+
+
+class Command(BaseCommand):
+    help = 'Setup/Reset/Fix the Alumni State for the Alumni Module'
+
+    def handle(self, *args, **options):
+        self.stdout.write("Creating/Reseting/Fixing the Alumni State for the Alumni Module")
+        alumni_name = app_settings.ALUMNI_STATE_NAME
+        priority = 1
+
+        created = State.objects.update_or_create(
+            name=alumni_name,
+            defaults={
+                "priority": priority, }
+        )
+        if created:
+            self.stdout.write("Success! Created Alumni State")
+        else:
+            self.stdout.write("Success! Updated Alumni State")

alumni/migrations/0001_initial.py

@@ -0,0 +1,69 @@
+# Generated by Django 3.2.10 on 2021-12-29 11:41
+
+import django.db.models.deletion
+from django.db import migrations, models
+
+
+class Migration(migrations.Migration):
+
+    initial = True
+
+    dependencies = [
+        ('eveonline', '0015_factions'),
+    ]
+
+    operations = [
+        migrations.CreateModel(
+            name='AlumniSetup',
+            fields=[
+                ('id', models.BigAutoField(auto_created=True, primary_key=True, serialize=False, verbose_name='ID')),
+            ],
+            options={
+                'verbose_name_plural': 'Alumni Config',
+            },
+        ),
+        migrations.CreateModel(
+            name='CharacterCorporationHistory',
+            fields=[
+                ('id', models.BigAutoField(auto_created=True, primary_key=True, serialize=False, verbose_name='ID')),
+                ('corporation_id', models.PositiveIntegerField()),
+                ('is_deleted', models.BooleanField(default=False, help_text='True if the corporation has been deleted')),
+                ('record_id', models.IntegerField(help_text='An incrementing ID that can be used to canonically establish order of records in cases where dates may be ambiguous')),
+                ('start_date', models.DateTimeField()),
+            ],
+        ),
+        migrations.CreateModel(
+            name='CorporationAllianceHistory',
+            fields=[
+                ('id', models.BigAutoField(auto_created=True, primary_key=True, serialize=False, verbose_name='ID')),
+                ('corporation_id', models.PositiveIntegerField()),
+                ('alliance_id', models.PositiveIntegerField(blank=True, null=True)),
+                ('is_deleted', models.BooleanField(default=False, help_text='True if the corporation has been deleted')),
+                ('record_id', models.IntegerField(help_text='An incrementing ID that can be used to canonically establish order of records in cases where dates may be ambiguous')),
+                ('start_date', models.DateTimeField()),
+            ],
+        ),
+        migrations.AddConstraint(
+            model_name='corporationalliancehistory',
+            constraint=models.UniqueConstraint(fields=('corporation_id', 'record_id'), name='CorporationAllianceRecord'),
+        ),
+        migrations.AddField(
+            model_name='charactercorporationhistory',
+            name='character',
+            field=models.ForeignKey(on_delete=django.db.models.deletion.CASCADE, to='eveonline.evecharacter'),
+        ),
+        migrations.AddField(
+            model_name='alumnisetup',
+            name='alumni_alliances',
+            field=models.ManyToManyField(blank=True, help_text='Characters with these Alliances in their History will be given Alumni Status', to='eveonline.EveAllianceInfo'),
+        ),
+        migrations.AddField(
+            model_name='alumnisetup',
+            name='alumni_corporations',
+            field=models.ManyToManyField(blank=True, help_text='Characters with these Corps in their History will be given Alumni Status', to='eveonline.EveCorporationInfo'),
+        ),
+        migrations.AddConstraint(
+            model_name='charactercorporationhistory',
+            constraint=models.UniqueConstraint(fields=('character', 'record_id'), name='CharacterCorporationRecord'),
+        ),
+    ]

alumni/migrations/0002_auto_20211230_0147.py

@@ -0,0 +1,23 @@
+# Generated by Django 3.2.10 on 2021-12-30 01:47
+
+from django.db import migrations, models
+
+
+class Migration(migrations.Migration):
+
+    dependencies = [
+        ('alumni', '0001_initial'),
+    ]
+
+    operations = [
+        migrations.AlterField(
+            model_name='corporationalliancehistory',
+            name='alliance_id',
+            field=models.PositiveIntegerField(blank=True, db_index=True, null=True),
+        ),
+        migrations.AlterField(
+            model_name='corporationalliancehistory',
+            name='corporation_id',
+            field=models.PositiveIntegerField(db_index=True),
+        ),
+    ]

alumni/migrations/0003_alter_alumnisetup_options_and_more.py

@@ -0,0 +1,27 @@
+# Generated by Django 4.2.10 on 2024-05-11 08:13
+
+from django.db import migrations, models
+
+
+class Migration(migrations.Migration):
+
+    dependencies = [
+        ('alumni', '0002_auto_20211230_0147'),
+    ]
+
+    operations = [
+        migrations.AlterModelOptions(
+            name='alumnisetup',
+            options={'verbose_name': 'Alumni Config', 'verbose_name_plural': 'Alumni Config'},
+        ),
+        migrations.AlterField(
+            model_name='charactercorporationhistory',
+            name='record_id',
+            field=models.PositiveIntegerField(help_text='An incrementing ID that can be used to canonically establish order of records in cases where dates may be ambiguous'),
+        ),
+        migrations.AlterField(
+            model_name='corporationalliancehistory',
+            name='record_id',
+            field=models.PositiveIntegerField(help_text='An incrementing ID that can be used to canonically establish order of records in cases where dates may be ambiguous'),
+        ),
+    ]

alumni/migrations/0004_corporationupdatetimestamp_alter_alumnisetup_options_and_more.py

@@ -0,0 +1,51 @@
+# Generated by Django 4.2.26 on 2025-11-14 03:28
+
+import django.db.models.deletion
+from django.db import migrations, models
+
+
+class Migration(migrations.Migration):
+
+    dependencies = [
+        ('eveonline', '0017_alliance_and_corp_names_are_not_unique'),
+        ('alumni', '0003_alter_alumnisetup_options_and_more'),
+    ]
+
+    operations = [
+        migrations.CreateModel(
+            name='CorporationUpdateTimestamp',
+            fields=[
+                ('id', models.BigAutoField(auto_created=True, primary_key=True, serialize=False, verbose_name='ID')),
+                ('corporation_id', models.PositiveIntegerField(unique=True)),
+                ('last_updated', models.DateTimeField(auto_now=True)),
+            ],
+            options={
+                'verbose_name': 'Corporation Update Timestamp',
+                'verbose_name_plural': 'Corporation Update Timestamps',
+            },
+        ),
+        migrations.AlterModelOptions(
+            name='alumnisetup',
+            options={'verbose_name': 'Alumni Config'},
+        ),
+        migrations.AlterModelOptions(
+            name='charactercorporationhistory',
+            options={'verbose_name': 'Character/Corporation History', 'verbose_name_plural': 'Character/Corporation Histories'},
+        ),
+        migrations.AlterModelOptions(
+            name='corporationalliancehistory',
+            options={'verbose_name': 'Corporation/Alliance History', 'verbose_name_plural': 'Corporation/Alliance Histories'},
+        ),
+        migrations.CreateModel(
+            name='CharacterUpdateTimestamp',
+            fields=[
+                ('id', models.BigAutoField(auto_created=True, primary_key=True, serialize=False, verbose_name='ID')),
+                ('last_updated', models.DateTimeField(auto_now=True)),
+                ('character', models.OneToOneField(on_delete=django.db.models.deletion.CASCADE, to='eveonline.evecharacter')),
+            ],
+            options={
+                'verbose_name': 'Character Update Timestamp',
+                'verbose_name_plural': 'Character Update Timestamps',
+            },
+        ),
+    ]

alumni/models.py

@@ -0,0 +1,80 @@
+from solo.models import SingletonModel
+
+from django.db import models
+from django.utils.translation import gettext as _
+
+from allianceauth.eveonline.models import (
+    EveAllianceInfo, EveCharacter, EveCorporationInfo,
+)
+
+
+class AlumniSetup(SingletonModel):
+    alumni_corporations = models.ManyToManyField(
+        EveCorporationInfo,
+        blank=True,
+        help_text=_("Characters with these Corps in their History will be given Alumni Status"))
+    alumni_alliances = models.ManyToManyField(
+        EveAllianceInfo,
+        blank=True,
+        help_text=_("Characters with these Alliances in their History will be given Alumni Status"))
+
+    def __str__(self) -> str:
+        return _("Alumni Config")
+
+    class Meta:
+        verbose_name = _("Alumni Config")
+
+
+class CorporationUpdateTimestamp(models.Model):
+    corporation_id = models.PositiveIntegerField(unique=True)
+    last_updated = models.DateTimeField(auto_now=True)
+
+    class Meta:
+        verbose_name = _("Corporation Update Timestamp")
+        verbose_name_plural = _("Corporation Update Timestamps")
+
+
+class CharacterUpdateTimestamp(models.Model):
+    character = models.OneToOneField(EveCharacter, on_delete=models.CASCADE)
+    last_updated = models.DateTimeField(auto_now=True)
+
+    class Meta:
+        verbose_name = _("Character Update Timestamp")
+        verbose_name_plural = _("Character Update Timestamps")
+
+
+class CorporationAllianceHistory(models.Model):
+    corporation_id = models.PositiveIntegerField(db_index=True)
+    alliance_id = models.PositiveIntegerField(blank=True, null=True, db_index=True)
+    is_deleted = models.BooleanField(
+        default=False,
+        help_text=_("True if the corporation has been deleted"))
+    record_id = models.PositiveIntegerField(
+        help_text=_("An incrementing ID that can be used to canonically establish order of records in cases where dates may be ambiguous"))
+    start_date = models.DateTimeField()
+
+    class Meta:
+        verbose_name = _("Corporation/Alliance History")
+        verbose_name_plural = _("Corporation/Alliance Histories")
+        constraints = [
+            models.UniqueConstraint(fields=['corporation_id', 'record_id'], name="CorporationAllianceRecord"),
+        ]
+
+
+class CharacterCorporationHistory(models.Model):
+
+    character = models.ForeignKey(EveCharacter, on_delete=models.CASCADE)
+    corporation_id = models.PositiveIntegerField()
+    is_deleted = models.BooleanField(
+        default=False,
+        help_text=_("True if the corporation has been deleted"))
+    record_id = models.PositiveIntegerField(
+        help_text=_("An incrementing ID that can be used to canonically establish order of records in cases where dates may be ambiguous"))
+    start_date = models.DateTimeField()
+
+    class Meta:
+        verbose_name = _("Character/Corporation History")
+        verbose_name_plural = _("Character/Corporation Histories")
+        constraints = [
+            models.UniqueConstraint(fields=['character', 'record_id'], name="CharacterCorporationRecord"),
+        ]

alumni/providers.py

@@ -0,0 +1,38 @@
+import typing
+
+from allianceauth.services.hooks import get_extension_logger
+from esi.openapi_clients import ESIClientProvider
+
+from . import __esi_compatibility_date__, __title__, __url__, __version__
+
+if typing.TYPE_CHECKING:
+    from esi.stubs import (
+        CharacterID, CharactersCharacterIdCorporationhistoryGetItem,
+        CorporationID, CorporationsCorporationIdAlliancehistoryGetItem,
+    )
+
+esi = ESIClientProvider(
+    compatibility_date=__esi_compatibility_date__,
+    ua_appname=__title__,
+    ua_version=__version__,
+    ua_url=__url__,
+    operations=[
+        "GetCorporationsCorporationIdAlliancehistory",
+        "GetCharactersCharacterIdCorporationhistory"]
+)
+
+logger = get_extension_logger(__name__)
+
+
+def get_corporations_corporation_id_alliancehistory(corporation_id: "CorporationID") -> list["CorporationsCorporationIdAlliancehistoryGetItem"]:
+    result = esi.client.Corporation.GetCorporationsCorporationIdAlliancehistory(
+        corporation_id=corporation_id
+    ).results()
+    return result
+
+
+def get_characters_character_id_corporationhistory(character_id: "CharacterID") -> list["CharactersCharacterIdCorporationhistoryGetItem"]:
+    result = esi.client.Character.GetCharactersCharacterIdCorporationhistory(
+        character_id=character_id
+    ).results()
+    return result

alumni/signals.py

@@ -0,0 +1,24 @@
+import logging
+
+from django.db.models.signals import post_save
+from django.dispatch import receiver
+
+from allianceauth.eveonline.models import EveCharacter
+
+from alumni.models import AlumniSetup
+from alumni.tasks import alumni_check_character, run_alumni_check_all
+
+from .app_settings import ALUMNI_TASK_PRIORITY
+
+logger = logging.getLogger(__name__)
+
+
+@receiver(post_save, sender=AlumniSetup)
+def alumni_was_updated(sender, instance: AlumniSetup, *args, **kwargs) -> None:
+    run_alumni_check_all.apply_async(priority=ALUMNI_TASK_PRIORITY)  # Type ignore
+
+
+@receiver(post_save, sender=EveCharacter)
+def character_added(sender, instance: EveCharacter, created, *args, **kwargs) -> None:
+    if created is True:
+        alumni_check_character.apply_async(args=[instance.character_id], priority=ALUMNI_TASK_PRIORITY - 1)  # Type ignore

alumni/tasks.py

@@ -0,0 +1,288 @@
+import typing
+from datetime import datetime, timezone
+from math import ceil
+from random import randint
+
+from celery import shared_task
+
+from allianceauth.authentication.models import State
+from allianceauth.eveonline.models import EveCharacter, EveCorporationInfo
+from allianceauth.services.hooks import get_extension_logger
+from esi.decorators import esi_rate_limiter_bucketed
+from esi.exceptions import (
+    ESIBucketLimitException, ESIErrorLimitException, HTTPNotModified,
+)
+from esi.rate_limiting import ESIRateLimitBucket
+
+from .app_settings import (
+    ALUMNI_CHARACTERCORPORATION_RATELIMIT, ALUMNI_STATE_NAME,
+    ALUMNI_TASK_JITTER, ALUMNI_TASK_PRIORITY,
+)
+from .models import (
+    AlumniSetup, CharacterCorporationHistory, CharacterUpdateTimestamp,
+    CorporationAllianceHistory, CorporationUpdateTimestamp,
+)
+from .providers import (
+    get_characters_character_id_corporationhistory,
+    get_corporations_corporation_id_alliancehistory,
+)
+
+if typing.TYPE_CHECKING:
+    from esi.stubs import AllianceID, CharacterID, CorporationID
+
+logger = get_extension_logger(__name__)
+
+
+def char_alliance_datecompare(alliance_id: "AllianceID", character_id: "CharacterID") -> bool:
+    """Voodoo relating to checking start dates and _next_ start dates
+
+    Necessary to determine if a character was a member of a corp
+    WHILE it was in an alliance
+
+    Parameters
+    ----------
+    alliance_id: int
+        Should match an existing EveAllianceInfo model
+
+    character_id: int
+        Should match an existing EveCharacter model
+
+    Returns
+    -------
+    bool
+        Whether True"""
+
+    character = EveCharacter.objects.get(character_id=character_id)
+    char_corp_history = CharacterCorporationHistory.objects.filter(
+        character=character).order_by('record_id')
+
+    for index, char_corp_record in enumerate(char_corp_history):
+        # Corp Joins Alliance, Between Char Join/Leave Corp
+        try:
+            filter_end_date = char_corp_history[index + 1].start_date
+        except IndexError:
+            filter_end_date = datetime.now(timezone.utc)
+
+        if CorporationAllianceHistory.objects.filter(
+            corporation_id=char_corp_record.corporation_id,
+            alliance_id=alliance_id,
+            start_date__range=(
+                char_corp_record.start_date,
+                filter_end_date)).exists() is True:
+            return True
+
+        corp_alliance_history = CorporationAllianceHistory.objects.filter(
+            corporation_id=char_corp_record.corporation_id).order_by('record_id')
+
+        for index_2, corp_alliance_record in enumerate(corp_alliance_history):
+            # Needs to be unfiltered alliance id because we need _next_ start date
+            # but check if the alliance id matches before we run any logic
+            try:
+                if corp_alliance_record.alliance_id == alliance_id:
+                    # Char Joins Corp, Between Corp Join/Leave
+                    if corp_alliance_record.start_date < char_corp_record.start_date < corp_alliance_history[index_2 + 1].start_date:
+                        return True
+                    # Char Leaves Corp, Between Corp Join/Leave
+                    elif corp_alliance_record.start_date < char_corp_history[index + 1].start_date < corp_alliance_history[index_2 + 1].start_date:
+                        return True
+                    # Corp Leaves Alliance in between Char Join/Leave Corp
+                    elif char_corp_record.start_date < corp_alliance_history[index_2 + 1].start_date < char_corp_history[index + 1].start_date:
+                        return True
+                    else:
+                        pass
+                else:
+                    pass
+            except Exception as e:
+                # Need to actually add some IndexError handling to above tasks, but lets log this gracefully so as not to cactus up the whole thing.
+                logger.exception(e)
+    return False
+
+
+@shared_task
+def alumni_check_character(character_id: "CharacterID") -> bool:
+    """Check/Update a characters alumni status using the historical models
+
+    Parameters
+    ----------
+    character_id: int
+        Should match an existing EveCharacter model
+
+    Returns
+    -------
+    bool
+        Whether the user is an alumni or not **it is updated in this function as well**"""
+
+    alumni_setup = AlumniSetup.get_solo()
+    alumni_state = State.objects.get(name=ALUMNI_STATE_NAME)
+    character = EveCharacter.objects.get(character_id=character_id)
+
+    if character.corporation_id in alumni_setup.alumni_corporations.values_list('corporation_id', flat=True):
+        # Cheapo cop-out to end early
+        alumni_state.member_characters.add(character)
+        return True
+
+    if character.alliance_id in alumni_setup.alumni_alliances.values_list('alliance_id', flat=True):
+        # Cheapo cop-out to end early
+        alumni_state.member_characters.add(character)
+        return True
+
+    for char_corp in CharacterCorporationHistory.objects.filter(character=character):
+        if char_corp.corporation_id in alumni_setup.alumni_corporations.values_list('corporation_id', flat=True):
+            # Less Cheap, but ending here is still better than the next one.
+            alumni_state.member_characters.add(character)
+            return True
+
+    for alliance in alumni_setup.alumni_alliances.all():
+        if char_alliance_datecompare(alliance_id=alliance.alliance_id, character_id=character_id):
+            alumni_state.member_characters.add(character)
+            return True
+
+    # If we reach this point, we aren't an alumni
+    alumni_state.member_characters.remove(character)
+    return False
+
+
+@shared_task
+def run_alumni_check_all() -> None:
+    for character in EveCharacter.objects.all().values('character_id'):
+        alumni_check_character.apply_async(
+            args=[character['character_id']],
+            priority=ALUMNI_TASK_PRIORITY
+        )  # pyright: ignore[reportFunctionMemberAccess, reportCallIssue]
+
+
+@shared_task(bind=True, rate_limit=ALUMNI_CHARACTERCORPORATION_RATELIMIT)
+def update_corporationalliancehistory(self, corporation_id: "CorporationID") -> None:
+    """Update CorporationAllianceHistory models from ESI
+
+    Parameters
+    ----------
+    corporation_id: int """
+
+    if corporation_id <= 98000000:  # NPC Corps don't have CCH
+        CorporationUpdateTimestamp.objects.update_or_create(
+            corporation_id=corporation_id,
+            defaults={'last_updated': datetime.now(timezone.utc)}
+        )
+
+    try:
+        for cah in get_corporations_corporation_id_alliancehistory(corporation_id):
+            CorporationAllianceHistory.objects.update_or_create(
+                record_id=cah.record_id,
+                corporation_id=corporation_id,
+                alliance_id=cah.alliance_id,
+                defaults={
+                    'is_deleted': True if cah.is_deleted == 'true' else False,
+                    'start_date': cah.start_date  # This can get adjusted by CCP i think
+                }
+            )
+        CorporationUpdateTimestamp.objects.update_or_create(
+            corporation_id=corporation_id,
+            defaults={'last_updated': datetime.now(timezone.utc)}
+        )
+    except (ESIErrorLimitException, ESIBucketLimitException) as e:
+        raise self.retry(exc=e, countdown=e.reset + 1 if e.reset is not None else 61, max_retries=3)
+    except HTTPNotModified:
+        CorporationUpdateTimestamp.objects.update_or_create(
+            corporation_id=corporation_id,
+            defaults={'last_updated': datetime.now(timezone.utc)}
+        )
+    except Exception as e:
+        logger.exception(e)
+
+
+@shared_task(bind=True, rate_limit=ALUMNI_CHARACTERCORPORATION_RATELIMIT)
+@esi_rate_limiter_bucketed(bucket=ESIRateLimitBucket(*ESIRateLimitBucket.CHARACTER_CORPORATION_HISTORY))
+def update_charactercorporationhistory(self, character_id: "CharacterID") -> None:
+    """Update CharacterCorporationHistory models from ESI
+
+    Parameters
+    ----------
+    character_id: int
+        Should match an existing EveCharacter model"""
+
+    try:
+        character = EveCharacter.objects.get(character_id=character_id)
+    except Exception as e:
+        logger.exception(e)
+        return
+    if character.character_id <= 90000000:  # NPC Characters don't have CCH
+        CharacterUpdateTimestamp.objects.update_or_create(
+            character=character,
+            defaults={'last_updated': datetime.now(timezone.utc)}
+        )
+    try:
+        for cch in get_characters_character_id_corporationhistory(character_id):
+            CharacterCorporationHistory.objects.update_or_create(
+                character=character,
+                corporation_id=cch.corporation_id,
+                record_id=cch.record_id,
+                defaults={
+                    'is_deleted': True if cch.is_deleted == 'true' else False,
+                    'start_date': cch.start_date
+                }
+            )
+        CharacterUpdateTimestamp.objects.update_or_create(
+            character=character,
+            defaults={'last_updated': datetime.now(timezone.utc)}
+        )
+    except (ESIErrorLimitException, ESIBucketLimitException) as e:
+        raise self.retry(exc=e, countdown=e.reset + 1 if e.reset is not None else 61)
+    except HTTPNotModified:
+        CharacterUpdateTimestamp.objects.update_or_create(
+            character=character,
+            defaults={'last_updated': datetime.now(timezone.utc)}
+        )
+    except Exception as e:
+        logger.exception(e)
+
+
+@shared_task
+def update_models_subset(fraction: int = 14) -> None:
+    """
+    Update a subset of the CharacterCorporation history models from ESI.
+
+    This task operates on 1/fraction of the oldest CCH and CAH records.
+
+    At 1/14th, once a day this will update all Alumni records in two weeks.
+    """
+
+    # Force create all timestamps at zero if they don't exist
+    character_timestamps = [
+        CharacterUpdateTimestamp(
+            character_id=character.id,
+            last_updated=datetime.fromtimestamp(1, timezone.utc)) for character in EveCharacter.objects.all()]
+    CharacterUpdateTimestamp.objects.bulk_create(character_timestamps, ignore_conflicts=True, batch_size=500)
+
+    corporation_timestamps = [
+        CorporationUpdateTimestamp(
+            corporation_id=corp.corporation_id,
+            last_updated=datetime.fromtimestamp(1, timezone.utc)) for corp in EveCorporationInfo.objects.all()]
+    corporation_timestamps += [
+        CorporationUpdateTimestamp(
+            corporation_id=corp["corporation_id"],
+            last_updated=datetime.fromtimestamp(1, timezone.utc)) for corp in CharacterCorporationHistory.objects.values('corporation_id').distinct()]
+    CorporationUpdateTimestamp.objects.bulk_create(corporation_timestamps, ignore_conflicts=True, batch_size=500)
+
+    for character in CharacterUpdateTimestamp.objects.all(
+    ).order_by('last_updated')[:ceil(CharacterUpdateTimestamp.objects.count() / fraction)].values('character__character_id'):
+        update_charactercorporationhistory.apply_async(
+            args=[character['character__character_id']],
+            priority=ALUMNI_TASK_PRIORITY,
+            countdown=randint(1, ALUMNI_TASK_JITTER)
+        )  # pyright: ignore[reportFunctionMemberAccess, reportCallIssue]
+
+    for char_corp_record in CorporationUpdateTimestamp.objects.all(
+    ).order_by('last_updated')[:ceil(CorporationUpdateTimestamp.objects.count() / fraction)].values('corporation_id'):
+        update_corporationalliancehistory.apply_async(
+            args=[char_corp_record['corporation_id']],
+            priority=ALUMNI_TASK_PRIORITY,
+            countdown=randint(1, ALUMNI_TASK_JITTER)
+        )  # pyright: ignore[reportFunctionMemberAccess, reportCallIssue]
+
+
+@shared_task()
+def update_all_models() -> None:
+    """Update All CharacterCorporation history models from ESI"""
+
+    update_models_subset.apply_async(priority=ALUMNI_TASK_PRIORITY)  # pyright: ignore[reportFunctionMemberAccess, reportCallIssue]