aa-loa 0.0.1__tar.gz

aa_loa-0.0.1/.gitignore

@@ -0,0 +1,17 @@
+/build/
+/dist/
+/*.egg-info/
+.idea/
+.tox/
+htmlcov/
+node_modules/
+
+*.log
+*.tmp
+*.bak
+*.old
+__pycache__
+.coverage
+/coverage.xml
+alliance_auth.sqlite3
+tmp_env/

aa_loa-0.0.1/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Maddog Broekman
+
+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.

aa_loa-0.0.1/PKG-INFO

@@ -0,0 +1,128 @@
+Metadata-Version: 2.4
+Name: aa-loa
+Version: 0.0.1
+Summary: Leave of Absence module for Alliance Auth
+Project-URL: Changelog, https://github.com/mbroekman/aa-loa/blob/main/CHANGELOG.md
+Project-URL: Homepage, https://github.com/mbroekman/aa-loa
+Project-URL: Source, https://github.com/mbroekman/aa-loa
+Project-URL: Tracker, https://github.com/mbroekman/aa-loa/issues
+Author-email: Maddog Broekman <maddogbroekman@gmail.com>
+License: MIT
+License-File: LICENSE
+Keywords: allianceauth,leave_of_absence,loa
+Classifier: Environment :: Web Environment
+Classifier: Framework :: Django
+Classifier: Framework :: Django :: 4.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: Topic :: Internet :: WWW/HTTP
+Classifier: Topic :: Internet :: WWW/HTTP :: Dynamic Content
+Requires-Python: <3.14,>=3.10
+Requires-Dist: allianceauth>=3.6.0
+Requires-Dist: discord-webhook>=1.3.0
+Description-Content-Type: text/markdown
+
+# Alliance Auth - Leave of Absence (aa-loa)
+
+[![PyPI version](https://img.shields.io/pypi/v/aa-loa)](https://pypi.org/project/aa-loa/)
+[![Python versions](https://img.shields.io/pypi/pyversions/aa-loa)](https://pypi.org/project/aa-loa/)
+[![Tests](https://github.com/mbroekman/aa-loa/actions/workflows/automated-checks.yml/badge.svg)](https://github.com/mbroekman/aa-loa/actions/workflows/automated-checks.yml)
+
+A complete Leave of Absence (LOA) management module for Alliance Auth. This module allows members to declare periods of absence so that leadership is aware of their inactivity, while seamlessly integrating with other Alliance Auth features (like Discord and Activity Trackers) to prevent accidental purges.
+
+## Features
+
+- **Player Dashboard:** Easy-to-use form for players to submit a start date, end date, and an optional reason. Players can also view their past LOAs, and cancel/revoke an active LOA if they return early.
+- **HR Dashboard:** A dedicated view for Directors/HR to see a live table of all active and upcoming LOAs in the alliance.
+- **Proxy Submission:** Directors can submit an LOA on behalf of a member who might be unable to access a PC (e.g. emergencies).
+- **Discord Role Sync:** Assigns members to a specific Django Group (e.g., `[On Leave]`) when their LOA becomes active. Alliance Auth will automatically sync this to Discord, TS, or Mumble.
+- **Purge Protection:** Because the member is in the `[On Leave]` group, audit modules (like `aa-inactives` or `opcalendar`) can simply whitelist this group to exempt the member from activity purges.
+- **Webhooks:** Automatically posts a Discord Embed to a webhook URL whenever an LOA is submitted.
+- **Welcome Back Notification:** A Celery task automatically removes the member from the LOA group when the end date passes, and sends a "Welcome Back" Alliance Auth notification.
+
+### 🤖 Optional: Discord Bot Integration (`aa-discordbot`)
+
+While `aa-loa` works perfectly fine on its own, it integrates natively with [aa-discordbot](https://github.com/pvyParts/allianceauth-discordbot). 
+If your alliance has `aa-discordbot` installed, the internal Alliance Auth notifications generated by this module will automatically be forwarded as **Direct Messages (DMs)** on Discord to the user. This applies to:
+- 📩 The "Welcome Back" notification when an LOA automatically expires.
+- 🛑 The "Cancellation" notification when HR manually cancels a player's LOA.
+
+---
+
+## Installation
+
+### 1. Install the Python Package
+Activate your Alliance Auth virtual environment and install the package:
+
+```bash
+pip install -e /path/to/aa-loa/
+```
+
+### 2. Update Alliance Auth Settings
+Open your `myauth/settings/local.py` file and add `'aa_loa'` to your `INSTALLED_APPS`:
+
+```python
+INSTALLED_APPS += [
+    # ... other apps
+    'aa_loa',
+]
+```
+
+### 3. Run Database Migrations
+Run the migrations to create the database tables:
+
+```bash
+python manage.py makemigrations aa_loa
+python manage.py migrate
+```
+
+### 4. Restart Services
+Restart your Alliance Auth web service and Celery workers so they pick up the new code and background tasks:
+
+```bash
+sudo systemctl restart supervisor
+```
+*(Or restart the specific services depending on your hosting environment).*
+
+---
+
+## Configuration
+
+### 1. Setup the LOA Group
+1. Go to the **Django Admin Panel** (`/admin/`).
+2. Navigate to **Authentication and Authorization** -> **Groups** and create a new group (e.g., `On Leave`).
+   - *Optional:* Configure this group in your Discord/TS services to map to a specific `[On Leave]` Discord Role.
+3. Navigate to **Leave of Absence Configuration** -> **LOA Config**.
+4. Add a new configuration row.
+5. Select the `On Leave` group you just created.
+6. *(Optional)* Paste a Discord Webhook URL if you want real-time notifications in an HR channel when LOAs are submitted.
+
+### 2. Permissions
+Assign the following permissions to the appropriate states or groups in Alliance Auth:
+
+| Permission | Description |
+|---|---|
+| `aa_loa.basic_access` | Grants access to the LOA module for normal members. Allows them to submit and manage their own LOAs. |
+| `aa_loa.manage_loa` | Grants access to the HR Dashboard. Allows users to view all LOAs and submit proxy LOAs for other members. |
+
+### 3. Setup the Celery Periodic Task
+To ensure LOA groups are automatically assigned and removed every night, you need to configure the daily Celery task in your `local.py` settings file.
+
+Open your `myauth/settings/local.py` and add the following to your `CELERYBEAT_SCHEDULE` dictionary:
+
+```python
+from celery.schedules import crontab
+
+CELERYBEAT_SCHEDULE['aa_loa_sync_groups'] = {
+    'task': 'aa_loa.tasks.sync_loa_groups',
+    'schedule': crontab(minute='0', hour='0'),
+}
+```
+
+Restart your celery worker (`sudo systemctl restart supervisor`) and the system will automatically activate/deactivate LOAs every day at midnight!

aa_loa-0.0.1/README.md

@@ -0,0 +1,98 @@
+# Alliance Auth - Leave of Absence (aa-loa)
+
+[![PyPI version](https://img.shields.io/pypi/v/aa-loa)](https://pypi.org/project/aa-loa/)
+[![Python versions](https://img.shields.io/pypi/pyversions/aa-loa)](https://pypi.org/project/aa-loa/)
+[![Tests](https://github.com/mbroekman/aa-loa/actions/workflows/automated-checks.yml/badge.svg)](https://github.com/mbroekman/aa-loa/actions/workflows/automated-checks.yml)
+
+A complete Leave of Absence (LOA) management module for Alliance Auth. This module allows members to declare periods of absence so that leadership is aware of their inactivity, while seamlessly integrating with other Alliance Auth features (like Discord and Activity Trackers) to prevent accidental purges.
+
+## Features
+
+- **Player Dashboard:** Easy-to-use form for players to submit a start date, end date, and an optional reason. Players can also view their past LOAs, and cancel/revoke an active LOA if they return early.
+- **HR Dashboard:** A dedicated view for Directors/HR to see a live table of all active and upcoming LOAs in the alliance.
+- **Proxy Submission:** Directors can submit an LOA on behalf of a member who might be unable to access a PC (e.g. emergencies).
+- **Discord Role Sync:** Assigns members to a specific Django Group (e.g., `[On Leave]`) when their LOA becomes active. Alliance Auth will automatically sync this to Discord, TS, or Mumble.
+- **Purge Protection:** Because the member is in the `[On Leave]` group, audit modules (like `aa-inactives` or `opcalendar`) can simply whitelist this group to exempt the member from activity purges.
+- **Webhooks:** Automatically posts a Discord Embed to a webhook URL whenever an LOA is submitted.
+- **Welcome Back Notification:** A Celery task automatically removes the member from the LOA group when the end date passes, and sends a "Welcome Back" Alliance Auth notification.
+
+### 🤖 Optional: Discord Bot Integration (`aa-discordbot`)
+
+While `aa-loa` works perfectly fine on its own, it integrates natively with [aa-discordbot](https://github.com/pvyParts/allianceauth-discordbot). 
+If your alliance has `aa-discordbot` installed, the internal Alliance Auth notifications generated by this module will automatically be forwarded as **Direct Messages (DMs)** on Discord to the user. This applies to:
+- 📩 The "Welcome Back" notification when an LOA automatically expires.
+- 🛑 The "Cancellation" notification when HR manually cancels a player's LOA.
+
+---
+
+## Installation
+
+### 1. Install the Python Package
+Activate your Alliance Auth virtual environment and install the package:
+
+```bash
+pip install -e /path/to/aa-loa/
+```
+
+### 2. Update Alliance Auth Settings
+Open your `myauth/settings/local.py` file and add `'aa_loa'` to your `INSTALLED_APPS`:
+
+```python
+INSTALLED_APPS += [
+    # ... other apps
+    'aa_loa',
+]
+```
+
+### 3. Run Database Migrations
+Run the migrations to create the database tables:
+
+```bash
+python manage.py makemigrations aa_loa
+python manage.py migrate
+```
+
+### 4. Restart Services
+Restart your Alliance Auth web service and Celery workers so they pick up the new code and background tasks:
+
+```bash
+sudo systemctl restart supervisor
+```
+*(Or restart the specific services depending on your hosting environment).*
+
+---
+
+## Configuration
+
+### 1. Setup the LOA Group
+1. Go to the **Django Admin Panel** (`/admin/`).
+2. Navigate to **Authentication and Authorization** -> **Groups** and create a new group (e.g., `On Leave`).
+   - *Optional:* Configure this group in your Discord/TS services to map to a specific `[On Leave]` Discord Role.
+3. Navigate to **Leave of Absence Configuration** -> **LOA Config**.
+4. Add a new configuration row.
+5. Select the `On Leave` group you just created.
+6. *(Optional)* Paste a Discord Webhook URL if you want real-time notifications in an HR channel when LOAs are submitted.
+
+### 2. Permissions
+Assign the following permissions to the appropriate states or groups in Alliance Auth:
+
+| Permission | Description |
+|---|---|
+| `aa_loa.basic_access` | Grants access to the LOA module for normal members. Allows them to submit and manage their own LOAs. |
+| `aa_loa.manage_loa` | Grants access to the HR Dashboard. Allows users to view all LOAs and submit proxy LOAs for other members. |
+
+### 3. Setup the Celery Periodic Task
+To ensure LOA groups are automatically assigned and removed every night, you need to configure the daily Celery task in your `local.py` settings file.
+
+Open your `myauth/settings/local.py` and add the following to your `CELERYBEAT_SCHEDULE` dictionary:
+
+```python
+from celery.schedules import crontab
+
+CELERYBEAT_SCHEDULE['aa_loa_sync_groups'] = {
+    'task': 'aa_loa.tasks.sync_loa_groups',
+    'schedule': crontab(minute='0', hour='0'),
+}
+```
+
+Restart your celery worker (`sudo systemctl restart supervisor`) and the system will automatically activate/deactivate LOAs every day at midnight!

aa_loa-0.0.1/aa_loa/__init__.py

@@ -0,0 +1,2 @@
+__version__ = "0.0.1"
+default_app_config = "aa_loa.apps.LoaConfig"

aa_loa-0.0.1/aa_loa/admin.py

@@ -0,0 +1,15 @@
+from django.contrib import admin
+
+from .models import LeaveOfAbsence, LOAConfig
+
+
+@admin.register(LOAConfig)
+class LOAConfigAdmin(admin.ModelAdmin):
+    list_display = ["__str__", "loa_group"]
+
+
+@admin.register(LeaveOfAbsence)
+class LeaveOfAbsenceAdmin(admin.ModelAdmin):
+    list_display = ["user", "start_date", "end_date", "is_active", "is_revoked"]
+    list_filter = ["is_revoked", "start_date", "end_date"]
+    search_fields = ["user__username"]

aa_loa-0.0.1/aa_loa/apps.py

@@ -0,0 +1,10 @@
+from django.apps import AppConfig
+
+
+class LoaConfig(AppConfig):
+    name = "aa_loa"
+    label = "aa_loa"
+    verbose_name = "Leave of Absence"
+
+    def ready(self):
+        import aa_loa.signals  # noqa

aa_loa-0.0.1/aa_loa/auth_hooks.py

@@ -0,0 +1,30 @@
+from allianceauth import hooks
+from allianceauth.services.hooks import MenuItemHook, UrlHook
+
+from . import urls
+
+
+class LoaMenuItem(MenuItemHook):
+    def __init__(self):
+        MenuItemHook.__init__(
+            self,
+            "Leave of Absence",
+            "fas fa-plane-departure fa-fw",
+            "aa_loa:index",
+            navactive=["aa_loa:"],
+        )
+
+    def render(self, request):
+        if request.user.has_perm("aa_loa.basic_access"):
+            return MenuItemHook.render(self, request)
+        return ""
+
+
+@hooks.register("menu_item_hook")
+def register_menu():
+    return LoaMenuItem()
+
+
+@hooks.register("url_hook")
+def register_urls():
+    return UrlHook(urls, "aa_loa", r"^loa/")

aa_loa-0.0.1/aa_loa/forms.py

@@ -0,0 +1,50 @@
+from django import forms
+from django.contrib.auth.models import User
+from django.utils import timezone
+
+from .models import LeaveOfAbsence
+
+
+class PlayerLOAForm(forms.ModelForm):
+    class Meta:
+        model = LeaveOfAbsence
+        fields = ["start_date", "end_date", "reason"]
+        widgets = {
+            "start_date": forms.DateInput(attrs={"type": "date", "class": "form-control", "onkeydown": "return false"}),
+            "end_date": forms.DateInput(attrs={"type": "date", "class": "form-control", "onkeydown": "return false"}),
+            "reason": forms.Textarea(attrs={"class": "form-control", "rows": 3}),
+        }
+
+    def __init__(self, *args, **kwargs):
+        super().__init__(*args, **kwargs)
+        # Set minimum date for HTML5 date pickers to today
+        today_str = timezone.localdate().strftime("%Y-%m-%d")
+        self.fields['start_date'].widget.attrs.update({'min': today_str})
+        self.fields['end_date'].widget.attrs.update({'min': today_str})
+
+    def clean_start_date(self):
+        start_date = self.cleaned_data.get("start_date")
+        if start_date and start_date < timezone.localdate():
+            raise forms.ValidationError("Start date cannot be in the past.")
+        return start_date
+
+    def clean(self):
+        cleaned_data = super().clean()
+        start_date = cleaned_data.get("start_date")
+        end_date = cleaned_data.get("end_date")
+
+        if start_date and end_date:
+            if start_date > end_date:
+                raise forms.ValidationError("End date cannot be before start date.")
+        return cleaned_data
+
+
+class DirectorLOAForm(PlayerLOAForm):
+    user = forms.ModelChoiceField(
+        queryset=User.objects.all().order_by("username"),
+        widget=forms.Select(attrs={"class": "form-control"}),
+        label="Player",
+    )
+
+    class Meta(PlayerLOAForm.Meta):
+        fields = ["user", "start_date", "end_date", "reason"]

aa_loa-0.0.1/aa_loa/migrations/0001_initial.py

@@ -0,0 +1,49 @@
+# Generated by Django 5.2.15 on 2026-07-24 14:45
+
+import django.db.models.deletion
+from django.conf import settings
+from django.db import migrations, models
+
+
+class Migration(migrations.Migration):
+
+    initial = True
+
+    dependencies = [
+        ('auth', '0012_alter_user_first_name_max_length'),
+        migrations.swappable_dependency(settings.AUTH_USER_MODEL),
+    ]
+
+    operations = [
+        migrations.CreateModel(
+            name='LeaveOfAbsence',
+            fields=[
+                ('id', models.AutoField(auto_created=True, primary_key=True, serialize=False, verbose_name='ID')),
+                ('start_date', models.DateField()),
+                ('end_date', models.DateField()),
+                ('reason', models.TextField(blank=True, null=True)),
+                ('created_at', models.DateTimeField(auto_now_add=True)),
+                ('updated_at', models.DateTimeField(auto_now=True)),
+                ('is_revoked', models.BooleanField(default=False, help_text='Set to true if the user returned early.')),
+                ('notified_return', models.BooleanField(default=False, help_text='Set to true once the welcome back notification is sent.')),
+                ('submitted_by', models.ForeignKey(blank=True, help_text='If submitted by a Director, this logs who did it.', null=True, on_delete=django.db.models.deletion.SET_NULL, related_name='proxy_loas', to=settings.AUTH_USER_MODEL)),
+                ('user', models.ForeignKey(on_delete=django.db.models.deletion.CASCADE, related_name='loas', to=settings.AUTH_USER_MODEL)),
+            ],
+            options={
+                'ordering': ['-start_date'],
+                'permissions': (('basic_access', 'Can access the LOA module'), ('manage_loa', 'Can manage LOAs for other users and view HR dashboard')),
+            },
+        ),
+        migrations.CreateModel(
+            name='LOAConfig',
+            fields=[
+                ('id', models.AutoField(auto_created=True, primary_key=True, serialize=False, verbose_name='ID')),
+                ('discord_webhook_url', models.URLField(blank=True, help_text='Optional Discord Webhook URL for Director notifications when LOAs are created.', null=True)),
+                ('loa_group', models.ForeignKey(blank=True, help_text='The Django Group to assign to users while their LOA is active.', null=True, on_delete=django.db.models.deletion.SET_NULL, to='auth.group')),
+            ],
+            options={
+                'verbose_name': 'LOA Config',
+                'verbose_name_plural': 'LOA Config',
+            },
+        ),
+    ]

aa_loa-0.0.1/aa_loa/models.py

@@ -0,0 +1,81 @@
+from django.contrib.auth.models import Group, User
+from django.db import models
+from django.utils import timezone
+
+
+class LOAConfig(models.Model):
+    loa_group = models.ForeignKey(
+        Group,
+        on_delete=models.SET_NULL,
+        null=True,
+        blank=True,
+        help_text="The Django Group to assign to users while their LOA is active.",
+    )
+    discord_webhook_url = models.URLField(
+        blank=True,
+        null=True,
+        help_text="Optional Discord Webhook URL for Director notifications when LOAs are created.",
+    )
+
+    class Meta:
+        verbose_name = "LOA Config"
+        verbose_name_plural = "LOA Config"
+
+    def __str__(self):
+        return "Leave of Absence Configuration"
+
+
+class LeaveOfAbsence(models.Model):
+    user = models.ForeignKey(User, on_delete=models.CASCADE, related_name="loas")
+    start_date = models.DateField()
+    end_date = models.DateField()
+    reason = models.TextField(blank=True, null=True)
+
+    submitted_by = models.ForeignKey(
+        User,
+        on_delete=models.SET_NULL,
+        null=True,
+        blank=True,
+        related_name="proxy_loas",
+        help_text="If submitted by a Director, this logs who did it.",
+    )
+    created_at = models.DateTimeField(auto_now_add=True)
+    updated_at = models.DateTimeField(auto_now=True)
+    
+    is_revoked = models.BooleanField(
+        default=False, help_text="Set to true if the user returned early."
+    )
+    notified_return = models.BooleanField(
+        default=False, help_text="Set to true once the welcome back notification is sent."
+    )
+
+    class Meta:
+        permissions = (
+            ("basic_access", "Can access the LOA module"),
+            ("manage_loa", "Can manage LOAs for other users and view HR dashboard"),
+        )
+        ordering = ["-start_date"]
+
+    def __str__(self):
+        return f"LOA: {self.user.username} ({self.start_date} to {self.end_date})"
+
+    @property
+    def is_active(self):
+        if self.is_revoked:
+            return False
+        today = timezone.now().date()
+        return self.start_date <= today <= self.end_date
+
+    @property
+    def is_past(self):
+        if self.is_revoked:
+            return True
+        today = timezone.now().date()
+        return self.end_date < today
+
+    @property
+    def is_future(self):
+        if self.is_revoked:
+            return False
+        today = timezone.now().date()
+        return self.start_date > today

aa_loa-0.0.1/aa_loa/signals.py

@@ -0,0 +1,14 @@
+from django.db.models.signals import post_save
+from django.dispatch import receiver
+
+from .models import LeaveOfAbsence
+from .tasks import send_loa_webhook, sync_loa_groups
+
+
+@receiver(post_save, sender=LeaveOfAbsence)
+def on_loa_saved(sender, instance, created, **kwargs):
+    if created:
+        send_loa_webhook.delay(instance.id)
+    
+    # Trigger a sync immediately so if it's active today, they get the role
+    sync_loa_groups.delay()

aa_loa-0.0.1/aa_loa/tasks.py

@@ -0,0 +1,106 @@
+import logging
+
+import requests
+from celery import shared_task
+from django.utils import timezone
+from django.db import models
+from allianceauth.services.hooks import get_extension_logger
+from allianceauth.notifications import notify
+
+from .models import LeaveOfAbsence, LOAConfig
+
+logger = get_extension_logger(__name__)
+
+
+@shared_task
+def sync_loa_groups():
+    """
+    Checks all LOAs and adds/removes users from the designated LOA Django group.
+    """
+    config = LOAConfig.objects.first()
+    if not config or not config.loa_group:
+        logger.warning("LOA Config or LOA Group is not set. Cannot sync groups.")
+        return
+
+    loa_group = config.loa_group
+    today = timezone.now().date()
+    
+    # 1. Add users with active LOAs
+    active_loas = LeaveOfAbsence.objects.filter(
+        start_date__lte=today,
+        end_date__gte=today,
+        is_revoked=False
+    )
+    for loa in active_loas:
+        if not loa.user.groups.filter(id=loa_group.id).exists():
+            loa.user.groups.add(loa_group)
+            logger.info(f"Added {loa.user.username} to LOA Group.")
+
+    # 2. Remove users whose LOAs have ended or been revoked, 
+    # but ONLY if they don't have another overlapping active LOA.
+    inactive_loas = LeaveOfAbsence.objects.filter(
+        models.Q(end_date__lt=today) | models.Q(is_revoked=True)
+    )
+    
+    for loa in inactive_loas:
+        user = loa.user
+        # Check if they have another active LOA right now
+        has_active = LeaveOfAbsence.objects.filter(
+            user=user,
+            start_date__lte=today,
+            end_date__gte=today,
+            is_revoked=False
+        ).exists()
+        
+        if not has_active and user.groups.filter(id=loa_group.id).exists():
+            user.groups.remove(loa_group)
+            logger.info(f"Removed {user.username} from LOA Group.")
+            
+            # Send Welcome Back Notification if not sent
+            if not loa.notified_return and loa.end_date < today and not loa.is_revoked:
+                notify(
+                    user=user,
+                    title="Welcome Back from LOA",
+                    message="Welcome back! Your LOA has expired. Let us know if you need an extension.",
+                    level="info"
+                )
+                loa.notified_return = True
+                loa.save(update_fields=["notified_return"])
+
+
+@shared_task
+def send_loa_webhook(loa_id):
+    """
+    Sends a Discord webhook notification when a new LOA is submitted.
+    """
+    config = LOAConfig.objects.first()
+    if not config or not config.discord_webhook_url:
+        return
+
+    try:
+        loa = LeaveOfAbsence.objects.get(id=loa_id)
+    except LeaveOfAbsence.DoesNotExist:
+        return
+
+    title = "New Leave of Absence"
+    if loa.submitted_by:
+        title = f"Proxy LOA submitted by {loa.submitted_by.username}"
+
+    embed = {
+        "title": title,
+        "color": 16753920, # Orange
+        "fields": [
+            {"name": "Player", "value": loa.user.username, "inline": True},
+            {"name": "Start", "value": str(loa.start_date), "inline": True},
+            {"name": "End", "value": str(loa.end_date), "inline": True},
+        ]
+    }
+    
+    if loa.reason:
+        embed["fields"].append({"name": "Reason", "value": loa.reason[:1000], "inline": False})
+
+    payload = {"embeds": [embed]}
+    try:
+        requests.post(config.discord_webhook_url, json=payload, timeout=5)
+    except Exception as e:
+        logger.error(f"Failed to send LOA webhook: {e}")

aa_loa-0.0.1/aa_loa/templates/aa_loa/hr_dashboard.html

@@ -0,0 +1,147 @@
+{% extends "allianceauth/base-bs5.html" %}
+{% load i18n %}
+{% load django_bootstrap5 %}
+
+{% block page_title %}{% translate "LOA HR Dashboard" %}{% endblock page_title %}
+
+{% block extra_css %}
+    {% include 'bundles/datatables-css-bs5.html' %}
+{% endblock %}
+
+{% block content %}
+<div class="col-lg-12">
+    <h1 class="page-header text-center">Leave of Absence - HR Dashboard</h1>
+    
+    <div class="row" style="margin-bottom: 20px;">
+        <div class="col-md-12 text-right">
+            <a href="{% url 'aa_loa:index' %}" class="btn btn-primary">Go to Player Dashboard</a>
+        </div>
+    </div>
+
+    <div class="row">
+        <!-- Proxy Submit -->
+        <div class="col-md-4">
+            <div class="panel panel-warning">
+                <div class="panel-heading">
+                    <h3 class="panel-title">Proxy Submit LOA</h3>
+                </div>
+                <div class="panel-body">
+                    <form method="post" action="{% url 'aa_loa:hr_dashboard' %}">
+                        {% csrf_token %}
+                        {% bootstrap_form form %}
+                        <br>
+                        <button type="submit" class="btn btn-warning btn-block">Submit Proxy LOA</button>
+                    </form>
+                </div>
+            </div>
+        </div>
+
+        <!-- All LOAs -->
+        <div class="col-md-8">
+            <div class="panel panel-default">
+                <div class="panel-heading">
+                    <h3 class="panel-title">All LOAs</h3>
+                </div>
+                <div class="panel-body">
+                    <table class="table table-striped table-hover" id="loaTable">
+                        <thead>
+                            <tr>
+                                <th>Player</th>
+                                <th>Status</th>
+                                <th>Start Date</th>
+                                <th>End Date</th>
+                                <th>Reason</th>
+                                <th>Proxy</th>
+                                <th>Actions</th>
+                            </tr>
+                        </thead>
+                        <tbody>
+                            {% for loa in loas %}
+                            <tr>
+                                <td>{{ loa.user.username }}</td>
+                                <td>
+                                    {% if loa.is_revoked %}
+                                        <span class="label label-default">Cancelled</span>
+                                    {% elif loa.is_active %}
+                                        <span class="label label-success">Active</span>
+                                    {% elif loa.is_future %}
+                                        <span class="label label-info">Upcoming</span>
+                                    {% else %}
+                                        <span class="label label-default">Past</span>
+                                    {% endif %}
+                                </td>
+                                <td>{{ loa.start_date }}</td>
+                                <td>{{ loa.end_date }}</td>
+                                <td>{{ loa.reason|default:"-" }}</td>
+                                <td>{{ loa.submitted_by.username|default:"-" }}</td>
+                                <td>
+                                    {% if not loa.is_revoked and not loa.is_past %}
+                                    <!-- Trigger Modal -->
+                                    <button type="button" class="btn btn-xs btn-danger" data-bs-toggle="modal" data-bs-target="#hrRevokeModal{{ loa.id }}">
+                                        Cancel
+                                    </button>
+
+                                    <!-- Modal -->
+                                    <div class="modal fade" id="hrRevokeModal{{ loa.id }}" tabindex="-1" aria-labelledby="hrRevokeModalLabel{{ loa.id }}" aria-hidden="true">
+                                        <div class="modal-dialog">
+                                            <div class="modal-content">
+                                                <div class="modal-header">
+                                                    <h5 class="modal-title" id="hrRevokeModalLabel{{ loa.id }}">Confirm Cancellation</h5>
+                                                    <button type="button" class="btn-close" data-bs-dismiss="modal" aria-label="Close"></button>
+                                                </div>
+                                                <div class="modal-body">
+                                                    Are you sure you want to cancel the Leave of Absence for <strong>{{ loa.user.username }}</strong>?
+                                                </div>
+                                                <div class="modal-footer">
+                                                    <button type="button" class="btn btn-secondary" data-bs-dismiss="modal">Go Back</button>
+                                                    <form method="post" action="{% url 'aa_loa:hr_revoke' loa.id %}" style="display:inline;">
+                                                        {% csrf_token %}
+                                                        <button type="submit" class="btn btn-danger">Yes, Cancel LOA</button>
+                                                    </form>
+                                                </div>
+                                            </div>
+                                        </div>
+                                    </div>
+                                    {% else %}
+                                        -
+                                    {% endif %}
+                                </td>
+                            </tr>
+                            {% endfor %}
+                        </tbody>
+                    </table>
+                </div>
+            </div>
+        </div>
+    </div>
+</div>
+{% endblock content %}
+
+{% block extra_javascript %}
+{% include 'bundles/datatables-js-bs5.html' %}
+<script>
+    $(document).ready(function() {
+        $('#loaTable').DataTable({
+            "order": [[ 2, "desc" ]],
+            "dom": "<'row'<'col-sm-12 col-md-6'l><'col-sm-12 col-md-6'f>>" +
+                   "<'row'<'col-sm-12 mb-2'p>>" +
+                   "<'row'<'col-sm-12'tr>>" +
+                   "<'row'<'col-sm-12 col-md-5'i><'col-sm-12 col-md-7'p>>"
+        });
+
+        // When start_date changes, update the min attribute of end_date
+        $('#id_start_date').on('change', function() {
+            var startDate = $(this).val();
+            if (startDate) {
+                $('#id_end_date').attr('min', startDate);
+                
+                // If end_date is now before start_date, clear it
+                var endDate = $('#id_end_date').val();
+                if (endDate && endDate < startDate) {
+                    $('#id_end_date').val('');
+                }
+            }
+        });
+    });
+</script>
+{% endblock %}

aa_loa-0.0.1/aa_loa/templates/aa_loa/index.html

@@ -0,0 +1,134 @@
+{% extends "allianceauth/base-bs5.html" %}
+{% load i18n %}
+{% load django_bootstrap5 %}
+
+{% block page_title %}{% translate "Leave of Absence" %}{% endblock page_title %}
+
+{% block content %}
+<div class="col-lg-12">
+    <h1 class="page-header text-center">Leave of Absence</h1>
+    
+    {% if perms.aa_loa.manage_loa %}
+    <div class="row" style="margin-bottom: 20px;">
+        <div class="col-md-12 text-right">
+            <a href="{% url 'aa_loa:hr_dashboard' %}" class="btn btn-warning">Go to HR Dashboard</a>
+        </div>
+    </div>
+    {% endif %}
+
+    <div class="row">
+        <!-- New LOA Form -->
+        <div class="col-md-4">
+            <div class="panel panel-primary">
+                <div class="panel-heading">
+                    <h3 class="panel-title">Submit LOA</h3>
+                </div>
+                <div class="panel-body">
+                    <form method="post" action="{% url 'aa_loa:index' %}">
+                        {% csrf_token %}
+                        {% bootstrap_form form %}
+                        <br>
+                        <button type="submit" class="btn btn-success btn-block">Submit</button>
+                    </form>
+                </div>
+            </div>
+        </div>
+
+        <!-- Existing LOAs -->
+        <div class="col-md-8">
+            <div class="panel panel-default">
+                <div class="panel-heading">
+                    <h3 class="panel-title">Your LOAs</h3>
+                </div>
+                <div class="panel-body">
+                    {% if loas %}
+                    <table class="table table-striped table-hover">
+                        <thead>
+                            <tr>
+                                <th>Status</th>
+                                <th>Start Date</th>
+                                <th>End Date</th>
+                                <th>Reason</th>
+                                <th>Actions</th>
+                            </tr>
+                        </thead>
+                        <tbody>
+                            {% for loa in loas %}
+                            <tr>
+                                <td>
+                                    {% if loa.is_revoked %}
+                                        <span class="label label-default">Cancelled</span>
+                                    {% elif loa.is_active %}
+                                        <span class="label label-success">Active</span>
+                                    {% elif loa.is_future %}
+                                        <span class="label label-info">Upcoming</span>
+                                    {% else %}
+                                        <span class="label label-default">Past</span>
+                                    {% endif %}
+                                </td>
+                                <td>{{ loa.start_date }}</td>
+                                <td>{{ loa.end_date }}</td>
+                                <td>{{ loa.reason|default:"-"|truncatechars:50 }}</td>
+                                <td>
+                                    {% if loa.is_active or loa.is_future %}
+                                        <!-- Trigger Modal -->
+                                        <button type="button" class="btn btn-xs btn-danger" data-bs-toggle="modal" data-bs-target="#revokeModal{{ loa.id }}">
+                                            Return Early / Cancel
+                                        </button>
+
+                                        <!-- Modal -->
+                                        <div class="modal fade" id="revokeModal{{ loa.id }}" tabindex="-1" aria-labelledby="revokeModalLabel{{ loa.id }}" aria-hidden="true">
+                                            <div class="modal-dialog">
+                                                <div class="modal-content">
+                                                    <div class="modal-header">
+                                                        <h5 class="modal-title" id="revokeModalLabel{{ loa.id }}">Confirm Cancellation</h5>
+                                                        <button type="button" class="btn-close" data-bs-dismiss="modal" aria-label="Close"></button>
+                                                    </div>
+                                                    <div class="modal-body">
+                                                        Are you sure you want to return early and cancel this Leave of Absence?
+                                                    </div>
+                                                    <div class="modal-footer">
+                                                        <button type="button" class="btn btn-secondary" data-bs-dismiss="modal">Go Back</button>
+                                                        <form method="post" action="{% url 'aa_loa:revoke' loa.id %}" style="display:inline;">
+                                                            {% csrf_token %}
+                                                            <button type="submit" class="btn btn-danger">Yes, Cancel LOA</button>
+                                                        </form>
+                                                    </div>
+                                                </div>
+                                            </div>
+                                        </div>
+                                    {% endif %}
+                                </td>
+                            </tr>
+                            {% endfor %}
+                        </tbody>
+                    </table>
+                    {% else %}
+                    <p class="text-muted">You have no active or historical LOAs.</p>
+                    {% endif %}
+                </div>
+            </div>
+        </div>
+    </div>
+</div>
+{% endblock content %}
+
+{% block extra_javascript %}
+<script>
+    $(document).ready(function() {
+        // When start_date changes, update the min attribute of end_date
+        $('#id_start_date').on('change', function() {
+            var startDate = $(this).val();
+            if (startDate) {
+                $('#id_end_date').attr('min', startDate);
+                
+                // If end_date is now before start_date, clear it
+                var endDate = $('#id_end_date').val();
+                if (endDate && endDate < startDate) {
+                    $('#id_end_date').val('');
+                }
+            }
+        });
+    });
+</script>
+{% endblock extra_javascript %}

aa_loa-0.0.1/aa_loa/urls.py

@@ -0,0 +1,12 @@
+from django.urls import path
+
+from . import views
+
+app_name = "aa_loa"
+
+urlpatterns = [
+    path("", views.loa_index, name="index"),
+    path("revoke/<int:loa_id>/", views.revoke_loa, name="revoke"),
+    path("hr/", views.loa_hr_dashboard, name="hr_dashboard"),
+    path("hr/revoke/<int:loa_id>/", views.hr_revoke_loa, name="hr_revoke"),
+]

aa_loa-0.0.1/aa_loa/views.py

@@ -0,0 +1,81 @@
+from django.contrib import messages
+from django.contrib.auth.decorators import login_required, permission_required
+from django.shortcuts import get_object_or_404, redirect, render
+from django.utils import timezone
+
+from .forms import DirectorLOAForm, PlayerLOAForm
+from .models import LeaveOfAbsence
+from allianceauth.notifications import notify
+
+
+@login_required
+@permission_required("aa_loa.basic_access")
+def loa_index(request):
+    user_loas = LeaveOfAbsence.objects.filter(user=request.user).order_by("-start_date")
+    
+    if request.method == "POST":
+        form = PlayerLOAForm(request.POST)
+        if form.is_valid():
+            loa = form.save(commit=False)
+            loa.user = request.user
+            loa.save()
+            messages.success(request, "Leave of Absence submitted successfully.")
+            return redirect("aa_loa:index")
+    else:
+        form = PlayerLOAForm()
+
+    return render(
+        request,
+        "aa_loa/index.html",
+        {"loas": user_loas, "form": form},
+    )
+
+
+@login_required
+@permission_required("aa_loa.basic_access")
+def revoke_loa(request, loa_id):
+    loa = get_object_or_404(LeaveOfAbsence, id=loa_id, user=request.user)
+    if request.method == "POST":
+        loa.is_revoked = True
+        loa.save()
+        messages.success(request, "LOA cancelled/revoked.")
+    return redirect("aa_loa:index")
+
+
+@login_required
+@permission_required("aa_loa.manage_loa")
+def hr_revoke_loa(request, loa_id):
+    loa = get_object_or_404(LeaveOfAbsence, id=loa_id)
+    if request.method == "POST":
+        loa.is_revoked = True
+        loa.save()
+        messages.success(request, f"LOA for {loa.user.username} cancelled by HR.")
+        notify(
+            user=loa.user,
+            title="Leave of Absence Cancelled",
+            message=f"Your Leave of Absence starting on {loa.start_date} was cancelled by HR ({request.user.username}).",
+            level="warning"
+        )
+    return redirect("aa_loa:hr_dashboard")
+
+@login_required
+@permission_required("aa_loa.manage_loa")
+def loa_hr_dashboard(request):
+    all_loas = LeaveOfAbsence.objects.all().select_related("user").order_by("-start_date")
+    
+    if request.method == "POST":
+        form = DirectorLOAForm(request.POST)
+        if form.is_valid():
+            loa = form.save(commit=False)
+            loa.submitted_by = request.user
+            loa.save()
+            messages.success(request, f"Proxy LOA submitted for {loa.user.username}.")
+            return redirect("aa_loa:hr_dashboard")
+    else:
+        form = DirectorLOAForm()
+
+    return render(
+        request,
+        "aa_loa/hr_dashboard.html",
+        {"loas": all_loas, "form": form},
+    )

aa_loa-0.0.1/pyproject.toml

@@ -0,0 +1,52 @@
+[build-system]
+build-backend = "hatchling.build"
+requires = [
+    "hatchling",
+]
+
+[project]
+name = "aa-loa"
+description = "Leave of Absence module for Alliance Auth"
+readme = "README.md"
+keywords = [
+    "allianceauth",
+    "leave_of_absence",
+    "loa",
+]
+license = { text = "MIT" }
+authors = [
+    { name = "Maddog Broekman", email = "maddogbroekman@gmail.com" },
+]
+requires-python = ">=3.10,<3.14"
+classifiers = [
+    "Environment :: Web Environment",
+    "Framework :: Django",
+    "Framework :: Django :: 4.2",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Operating System :: OS Independent",
+    "Programming Language :: Python",
+    "Programming Language :: Python :: 3 :: Only",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Topic :: Internet :: WWW/HTTP",
+    "Topic :: Internet :: WWW/HTTP :: Dynamic Content",
+]
+dynamic = [
+    "version",
+]
+dependencies = [
+    "allianceauth>=3.6.0",
+    "discord-webhook>=1.3.0",
+]
+urls.Changelog = "https://github.com/mbroekman/aa-loa/blob/main/CHANGELOG.md"
+urls.Homepage = "https://github.com/mbroekman/aa-loa"
+urls.Source = "https://github.com/mbroekman/aa-loa"
+urls.Tracker = "https://github.com/mbroekman/aa-loa/issues"
+
+[tool.hatch]
+version.path = "aa_loa/__init__.py"
+build.include = [
+    "/aa_loa",
+]