aa-kanban 0.5.0__tar.gz

aa_kanban-0.5.0/.gitignore

@@ -0,0 +1,25 @@
+/build/
+/dist/
+/*.egg-info/
+.idea/
+.tox/
+htmlcov/
+node_modules/
+
+*.log
+*.tmp
+*.bak
+*.old
+__pycache__
+.coverage
+/coverage.xml
+alliance_auth.sqlite3
+db.sqlite3
+*.sqlite3
+tmp_env/
+.venv/
+
+# Tijdelijke (scratch) scripts in de root
+/*test*.py
+/append_task.py
+/make_migrations.py

aa_kanban-0.5.0/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_kanban-0.5.0/PKG-INFO

@@ -0,0 +1,96 @@
+Metadata-Version: 2.5
+Name: aa-kanban
+Version: 0.5.0
+Summary: Kanban Plugin for Alliance Auth
+Author-email: Maddog Broekman <maddogbroekman@gmail.com>
+License: 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.
+License-File: LICENSE
+Keywords: aa_kanban,allianceauth
+Classifier: Environment :: Web Environment
+Classifier: Framework :: Django
+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: Topic :: Internet :: WWW/HTTP
+Classifier: Topic :: Internet :: WWW/HTTP :: Dynamic Content
+Requires-Python: <3.14,>=3.10
+Requires-Dist: allianceauth>=5
+Description-Content-Type: text/markdown
+
+# AA Kanban
+
+Alliance Auth plugin for native Kanban boards.
+
+## Features
+
+- **Native Kanban boards** with an intuitive drag-and-drop interface.
+- **Permission management** per board (read-only and write groups).
+- **Global Discord Webhooks** (Admin panel): Receive notifications when new boards are created.
+- **Board-specific Discord Webhooks** (Admin panel): Receive notifications when cards are moved across lists on a specific board.
+- **Direct Messages (DMs)**: Discord DM notifications are sent directly to users when they are assigned to or removed from cards (requires the `aadiscordbot` app to be installed and active).
+
+## Installation
+
+```bash
+pip install aa-kanban
+```
+
+Add the app to your `local.py`:
+
+```python
+INSTALLED_APPS += [
+    "aa_kanban",
+]
+```
+
+Run the database migrations:
+
+```bash
+python manage.py migrate
+```
+
+Gather static files:
+
+```bash
+python manage.py collectstatic
+```
+
+Restart your supervisor services to load the new code (e.g., gunicorn and celery).
+
+## Discord Webhooks Configuration
+
+To receive updates in your Discord channels, you can configure webhooks in the Django Admin panel:
+
+1. **Global Board Creation Webhook**:
+   - Go to **Admin** > **Kanban Settings** > **Global Kanban Settings**.
+   - Fill in the **Board creation webhook** field with your Discord Webhook URL. You will receive a message whenever a new board is created.
+2. **Board-Specific Card Movement Webhooks**:
+   - Go to **Admin** > **Boards** and edit a specific board.
+   - Fill in the **Discord webhook cards** field. Any card movements between lists on this board will be posted to this webhook.

aa_kanban-0.5.0/README.md

@@ -0,0 +1,50 @@
+# AA Kanban
+
+Alliance Auth plugin for native Kanban boards.
+
+## Features
+
+- **Native Kanban boards** with an intuitive drag-and-drop interface.
+- **Permission management** per board (read-only and write groups).
+- **Global Discord Webhooks** (Admin panel): Receive notifications when new boards are created.
+- **Board-specific Discord Webhooks** (Admin panel): Receive notifications when cards are moved across lists on a specific board.
+- **Direct Messages (DMs)**: Discord DM notifications are sent directly to users when they are assigned to or removed from cards (requires the `aadiscordbot` app to be installed and active).
+
+## Installation
+
+```bash
+pip install aa-kanban
+```
+
+Add the app to your `local.py`:
+
+```python
+INSTALLED_APPS += [
+    "aa_kanban",
+]
+```
+
+Run the database migrations:
+
+```bash
+python manage.py migrate
+```
+
+Gather static files:
+
+```bash
+python manage.py collectstatic
+```
+
+Restart your supervisor services to load the new code (e.g., gunicorn and celery).
+
+## Discord Webhooks Configuration
+
+To receive updates in your Discord channels, you can configure webhooks in the Django Admin panel:
+
+1. **Global Board Creation Webhook**:
+   - Go to **Admin** > **Kanban Settings** > **Global Kanban Settings**.
+   - Fill in the **Board creation webhook** field with your Discord Webhook URL. You will receive a message whenever a new board is created.
+2. **Board-Specific Card Movement Webhooks**:
+   - Go to **Admin** > **Boards** and edit a specific board.
+   - Fill in the **Discord webhook cards** field. Any card movements between lists on this board will be posted to this webhook.

aa_kanban-0.5.0/aa_kanban/__init__.py

@@ -0,0 +1,3 @@
+"""Alliance Auth Kanban Plugin."""
+
+__version__ = "0.5.0"

aa_kanban-0.5.0/aa_kanban/admin.py

@@ -0,0 +1,129 @@
+"""Admin configuration for aa_kanban.
+
+Business-functionaliteit (boards, lijsten, cards, labels) wordt beheerd via
+de frontend. De admin is hier read-only voor overzicht/debug. Alleen Comments
+blijven bewerkbaar voor moderatie-doeleinden.
+"""
+
+from django.contrib import admin
+
+from .models import Board, Card, Comment, Label, List, KanbanSetting
+
+
+@admin.register(Board)
+class BoardAdmin(admin.ModelAdmin):
+    """Read-only board overview, except for technical webhook settings."""
+
+    list_display = ("name", "slug", "created_by", "created_at", "updated_at")
+    search_fields = ("name", "description")
+    readonly_fields = (
+        "name",
+        "slug",
+        "description",
+        "view_groups",
+        "write_groups",
+        "created_by",
+        "created_at",
+        "updated_at",
+    )
+
+    def has_add_permission(self, request) -> bool:  # type: ignore[override]
+        return False
+
+    # Allow changing so admins can edit webhooks
+    def has_change_permission(self, request, obj=None) -> bool:  # type: ignore[override]
+        return True
+
+    def has_delete_permission(self, request, obj=None) -> bool:  # type: ignore[override]
+        return False
+
+@admin.register(KanbanSetting)
+class KanbanSettingAdmin(admin.ModelAdmin):
+    """Global configuration for aa_kanban."""
+
+    list_display = ("__str__", "board_creation_webhook")
+    
+    def has_add_permission(self, request) -> bool:  # type: ignore[override]
+        # Only allow 1 instance
+        from .models import KanbanSetting
+        if KanbanSetting.objects.exists():
+            return False
+        return True
+
+
+@admin.register(List)
+class ListAdmin(admin.ModelAdmin):
+    """Read-only list overview. Manage columns via the board frontend."""
+
+    list_display = ("name", "board", "order", "created_at")
+    list_filter = ("board",)
+    search_fields = ("name", "board__name")
+    readonly_fields = ("name", "board", "order", "created_at", "updated_at")
+
+    def has_add_permission(self, request) -> bool:  # type: ignore[override]
+        return False
+
+    def has_change_permission(self, request, obj=None) -> bool:  # type: ignore[override]
+        return False
+
+    def has_delete_permission(self, request, obj=None) -> bool:  # type: ignore[override]
+        return False
+
+
+@admin.register(Label)
+class LabelAdmin(admin.ModelAdmin):
+    """Read-only label overview. Manage labels via the board frontend."""
+
+    list_display = ("name", "color", "board")
+    list_filter = ("board", "color")
+    search_fields = ("name", "board__name")
+    readonly_fields = ("name", "color", "board")
+
+    def has_add_permission(self, request) -> bool:  # type: ignore[override]
+        return False
+
+    def has_change_permission(self, request, obj=None) -> bool:  # type: ignore[override]
+        return False
+
+    def has_delete_permission(self, request, obj=None) -> bool:  # type: ignore[override]
+        return False
+
+
+@admin.register(Card)
+class CardAdmin(admin.ModelAdmin):
+    """Read-only card overview. Manage cards via the board frontend."""
+
+    list_display = ("title", "list", "order", "due_date", "created_at")
+    list_filter = ("list__board", "list")
+    search_fields = ("title", "description")
+    readonly_fields = (
+        "title",
+        "description",
+        "list",
+        "order",
+        "assignees",
+        "labels",
+        "due_date",
+        "created_by",
+        "created_at",
+        "updated_at",
+    )
+
+    def has_add_permission(self, request) -> bool:  # type: ignore[override]
+        return False
+
+    def has_change_permission(self, request, obj=None) -> bool:  # type: ignore[override]
+        return False
+
+    def has_delete_permission(self, request, obj=None) -> bool:  # type: ignore[override]
+        return False
+
+
+@admin.register(Comment)
+class CommentAdmin(admin.ModelAdmin):
+    """Comments are manageable from admin for moderation purposes."""
+
+    list_display = ("card", "author", "created_at")
+    list_filter = ("created_at",)
+    search_fields = ("text", "author__username", "card__title")
+    readonly_fields = ("created_at",)

aa_kanban-0.5.0/aa_kanban/apps.py

@@ -0,0 +1,8 @@
+from django.apps import AppConfig
+
+
+class AaKanbanConfig(AppConfig):
+    default_auto_field = "django.db.models.BigAutoField"
+    name = "aa_kanban"
+    label = "aa_kanban"
+    verbose_name = "Kanban"

aa_kanban-0.5.0/aa_kanban/auth_hooks.py

@@ -0,0 +1,33 @@
+"""Alliance Auth hooks for aa_kanban."""
+
+from allianceauth import hooks
+from allianceauth.services.hooks import MenuItemHook, UrlHook
+
+from . import urls
+
+
+class AaKanbanMenuItem(MenuItemHook):
+    """Menu item hook for aa_kanban."""
+
+    def __init__(self):
+        super().__init__(
+            "Kanban",
+            "fas fa-columns fa-fw",
+            "aa_kanban:index",
+            navactive=["aa_kanban:"],
+        )
+
+    def render(self, request):
+        if request.user.has_perm("aa_kanban.basic_access"):
+            return super().render(request)
+        return ""
+
+
+@hooks.register("menu_item_hook")
+def register_menu():
+    return AaKanbanMenuItem()
+
+
+@hooks.register("url_hook")
+def register_urls():
+    return UrlHook(urls, "aa_kanban", r"^kanban/")

aa_kanban-0.5.0/aa_kanban/migrations/0001_initial.py

@@ -0,0 +1,123 @@
+# Generated by Django 5.2.17 on 2026-09-09 20:28
+
+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='General',
+            fields=[
+                ('id', models.BigAutoField(auto_created=True, primary_key=True, serialize=False, verbose_name='ID')),
+            ],
+            options={
+                'permissions': (('basic_access', 'Can access this app'), ('manage_boards', 'Can manage kanban boards')),
+                'managed': False,
+                'default_permissions': (),
+            },
+        ),
+        migrations.CreateModel(
+            name='Board',
+            fields=[
+                ('id', models.BigAutoField(auto_created=True, primary_key=True, serialize=False, verbose_name='ID')),
+                ('name', models.CharField(max_length=255)),
+                ('slug', models.SlugField(blank=True, max_length=255, unique=True)),
+                ('description', models.TextField(blank=True)),
+                ('created_at', models.DateTimeField(auto_now_add=True)),
+                ('updated_at', models.DateTimeField(auto_now=True)),
+                ('created_by', models.ForeignKey(blank=True, null=True, on_delete=django.db.models.deletion.SET_NULL, related_name='+', to=settings.AUTH_USER_MODEL)),
+                ('view_groups', models.ManyToManyField(blank=True, help_text='Groups that have read-only access to this board.', related_name='kanban_view_boards', to='auth.group')),
+                ('write_groups', models.ManyToManyField(blank=True, help_text='Groups that have write/mutation access to this board.', related_name='kanban_write_boards', to='auth.group')),
+            ],
+            options={
+                'verbose_name': 'Board',
+                'verbose_name_plural': 'Boards',
+                'ordering': ['name'],
+            },
+        ),
+        migrations.CreateModel(
+            name='Card',
+            fields=[
+                ('id', models.BigAutoField(auto_created=True, primary_key=True, serialize=False, verbose_name='ID')),
+                ('title', models.CharField(max_length=255)),
+                ('description', models.TextField(blank=True)),
+                ('order', models.PositiveIntegerField(default=0)),
+                ('due_date', models.DateTimeField(blank=True, null=True)),
+                ('created_at', models.DateTimeField(auto_now_add=True)),
+                ('updated_at', models.DateTimeField(auto_now=True)),
+                ('assignees', models.ManyToManyField(blank=True, related_name='assigned_kanban_cards', to=settings.AUTH_USER_MODEL)),
+                ('created_by', models.ForeignKey(blank=True, null=True, on_delete=django.db.models.deletion.SET_NULL, related_name='+', to=settings.AUTH_USER_MODEL)),
+            ],
+            options={
+                'verbose_name': 'Card',
+                'verbose_name_plural': 'Cards',
+                'ordering': ['order', 'id'],
+            },
+        ),
+        migrations.CreateModel(
+            name='Comment',
+            fields=[
+                ('id', models.BigAutoField(auto_created=True, primary_key=True, serialize=False, verbose_name='ID')),
+                ('text', models.TextField()),
+                ('created_at', models.DateTimeField(auto_now_add=True)),
+                ('author', models.ForeignKey(on_delete=django.db.models.deletion.CASCADE, related_name='kanban_comments', to=settings.AUTH_USER_MODEL)),
+                ('card', models.ForeignKey(on_delete=django.db.models.deletion.CASCADE, related_name='comments', to='aa_kanban.card')),
+            ],
+            options={
+                'verbose_name': 'Comment',
+                'verbose_name_plural': 'Comments',
+                'ordering': ['created_at'],
+            },
+        ),
+        migrations.CreateModel(
+            name='Label',
+            fields=[
+                ('id', models.BigAutoField(auto_created=True, primary_key=True, serialize=False, verbose_name='ID')),
+                ('name', models.CharField(max_length=50)),
+                ('color', models.CharField(default='primary', help_text='Bootstrap badge color style (e.g. primary, success, danger, warning, info, dark)', max_length=20)),
+                ('board', models.ForeignKey(on_delete=django.db.models.deletion.CASCADE, related_name='labels', to='aa_kanban.board')),
+            ],
+            options={
+                'verbose_name': 'Label',
+                'verbose_name_plural': 'Labels',
+                'ordering': ['name'],
+                'unique_together': {('board', 'name')},
+            },
+        ),
+        migrations.AddField(
+            model_name='card',
+            name='labels',
+            field=models.ManyToManyField(blank=True, related_name='cards', to='aa_kanban.label'),
+        ),
+        migrations.CreateModel(
+            name='List',
+            fields=[
+                ('id', models.BigAutoField(auto_created=True, primary_key=True, serialize=False, verbose_name='ID')),
+                ('name', models.CharField(max_length=100)),
+                ('order', models.PositiveIntegerField(default=0)),
+                ('created_at', models.DateTimeField(auto_now_add=True)),
+                ('updated_at', models.DateTimeField(auto_now=True)),
+                ('board', models.ForeignKey(on_delete=django.db.models.deletion.CASCADE, related_name='lists', to='aa_kanban.board')),
+            ],
+            options={
+                'verbose_name': 'List',
+                'verbose_name_plural': 'Lists',
+                'ordering': ['order', 'id'],
+            },
+        ),
+        migrations.AddField(
+            model_name='card',
+            name='list',
+            field=models.ForeignKey(on_delete=django.db.models.deletion.CASCADE, related_name='cards', to='aa_kanban.list'),
+        ),
+    ]

aa_kanban-0.5.0/aa_kanban/migrations/0002_kanbangroup_alter_board_view_groups_and_more.py

@@ -0,0 +1,38 @@
+# Generated by Django 5.2.17 on 2026-09-21 08:37
+
+from django.conf import settings
+from django.db import migrations, models
+
+
+class Migration(migrations.Migration):
+
+    dependencies = [
+        ('aa_kanban', '0001_initial'),
+        migrations.swappable_dependency(settings.AUTH_USER_MODEL),
+    ]
+
+    operations = [
+        migrations.CreateModel(
+            name='KanbanGroup',
+            fields=[
+                ('id', models.BigAutoField(auto_created=True, primary_key=True, serialize=False, verbose_name='ID')),
+                ('name', models.CharField(max_length=255, unique=True)),
+                ('members', models.ManyToManyField(blank=True, related_name='kanban_groups', to=settings.AUTH_USER_MODEL)),
+            ],
+            options={
+                'verbose_name': 'Kanban Group',
+                'verbose_name_plural': 'Kanban Groups',
+                'ordering': ['name'],
+            },
+        ),
+        migrations.AlterField(
+            model_name='board',
+            name='view_groups',
+            field=models.ManyToManyField(blank=True, help_text='Kanban groups that have read-only access to this board.', related_name='kanban_view_boards', to='aa_kanban.kanbangroup'),
+        ),
+        migrations.AlterField(
+            model_name='board',
+            name='write_groups',
+            field=models.ManyToManyField(blank=True, help_text='Kanban groups that have write/mutation access to this board.', related_name='kanban_write_boards', to='aa_kanban.kanbangroup'),
+        ),
+    ]

aa_kanban-0.5.0/aa_kanban/migrations/0003_kanbansetting_board_discord_webhook_cards.py

@@ -0,0 +1,29 @@
+# Generated by Django 5.2.17 on 2026-09-21 09:53
+
+from django.db import migrations, models
+
+
+class Migration(migrations.Migration):
+
+    dependencies = [
+        ('aa_kanban', '0002_kanbangroup_alter_board_view_groups_and_more'),
+    ]
+
+    operations = [
+        migrations.CreateModel(
+            name='KanbanSetting',
+            fields=[
+                ('id', models.BigAutoField(auto_created=True, primary_key=True, serialize=False, verbose_name='ID')),
+                ('board_creation_webhook', models.URLField(blank=True, help_text='Discord Webhook URL for global board creation notifications.', null=True)),
+            ],
+            options={
+                'verbose_name': 'Kanban Setting',
+                'verbose_name_plural': 'Kanban Settings',
+            },
+        ),
+        migrations.AddField(
+            model_name='board',
+            name='discord_webhook_cards',
+            field=models.URLField(blank=True, help_text='Discord Webhook URL for card movement notifications on this board.', null=True),
+        ),
+    ]

aa_kanban-0.5.0/aa_kanban/migrations/__init__.py

@@ -0,0 +1 @@
+"""Database migrations package."""