aa-fatanalysis 0.1.0__tar.gz

aa_fatanalysis-0.1.0/.gitignore

@@ -0,0 +1,8 @@
+*.pyc
+__pycache__/
+db.sqlite3
+dist/
+build/
+*.egg-info/
+.venv/
+venv/

aa_fatanalysis-0.1.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_fatanalysis-0.1.0/PKG-INFO

@@ -0,0 +1,82 @@
+Metadata-Version: 2.5
+Name: aa-fatanalysis
+Version: 0.1.0
+Summary: FAT Analysis 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: allianceauth,fatanalysis
+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: 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
+
+# FAT Analysis
+
+Alliance Auth plugin for analyzing FATs (Fleet Activity Tracking). This plugin allows for the upload of 30-day and 90-day FAT CSV files, parses them dynamically, and provides overviews and interactive charts on both a per-character and per-corporation basis.
+
+## Installation
+
+1. **Activate your Alliance Auth virtual environment**
+   ```bash
+   source /home/allianceserver/venv/auth/bin/activate
+   ```
+
+2. **Install the plugin**
+   Navigate to the directory containing this plugin and run:
+   ```bash
+   pip install -e .
+   ```
+   *(Or install via git / pip once published to a repository)*
+
+3. **Update your Alliance Auth settings**
+   Add `'fatanalysis'` to your `INSTALLED_APPS` in `myauth/myauth/settings/local.py`:
+   ```python
+   INSTALLED_APPS += [
+       'fatanalysis',
+   ]
+   ```
+
+4. **Run migrations**
+   ```bash
+   python manage.py makemigrations
+   python manage.py migrate
+   ```
+
+5. **Restart Alliance Auth services**
+   ```bash
+   sudo systemctl restart supervisor
+   ```
+   *(Or restart gunicorn and celery according to your specific setup)*
+
+## Permissions
+Assign the `fatanalysis.basic_access` permission in the admin panel to any user or group that should have access to view and upload FAT analysis data.

aa_fatanalysis-0.1.0/README.md

@@ -0,0 +1,40 @@
+# FAT Analysis
+
+Alliance Auth plugin for analyzing FATs (Fleet Activity Tracking). This plugin allows for the upload of 30-day and 90-day FAT CSV files, parses them dynamically, and provides overviews and interactive charts on both a per-character and per-corporation basis.
+
+## Installation
+
+1. **Activate your Alliance Auth virtual environment**
+   ```bash
+   source /home/allianceserver/venv/auth/bin/activate
+   ```
+
+2. **Install the plugin**
+   Navigate to the directory containing this plugin and run:
+   ```bash
+   pip install -e .
+   ```
+   *(Or install via git / pip once published to a repository)*
+
+3. **Update your Alliance Auth settings**
+   Add `'fatanalysis'` to your `INSTALLED_APPS` in `myauth/myauth/settings/local.py`:
+   ```python
+   INSTALLED_APPS += [
+       'fatanalysis',
+   ]
+   ```
+
+4. **Run migrations**
+   ```bash
+   python manage.py makemigrations
+   python manage.py migrate
+   ```
+
+5. **Restart Alliance Auth services**
+   ```bash
+   sudo systemctl restart supervisor
+   ```
+   *(Or restart gunicorn and celery according to your specific setup)*
+
+## Permissions
+Assign the `fatanalysis.basic_access` permission in the admin panel to any user or group that should have access to view and upload FAT analysis data.

aa_fatanalysis-0.1.0/fatanalysis/__init__.py

@@ -0,0 +1 @@
+__version__ = "0.1.0"

aa_fatanalysis-0.1.0/fatanalysis/apps.py

@@ -0,0 +1,6 @@
+from django.apps import AppConfig
+
+class FatAnalysisConfig(AppConfig):
+    name = 'fatanalysis'
+    label = 'fatanalysis'
+    verbose_name = 'FAT Analysis'

aa_fatanalysis-0.1.0/fatanalysis/auth_hooks.py

@@ -0,0 +1,30 @@
+from allianceauth import hooks
+from allianceauth.services.hooks import MenuItemHook, UrlHook
+from django.utils.translation import gettext_lazy as _
+
+from . import urls
+
+class FatAnalysisMenuItem(MenuItemHook):
+    """This class ensures only authorized users will see the menu entry"""
+    def __init__(self):
+        # Setup menu entry for sidebar
+        MenuItemHook.__init__(
+            self,
+            _('FAT Analysis'),
+            'fas fa-chart-line fa-fw',
+            'fatanalysis:index',
+            navactive=['fatanalysis:']
+        )
+
+    def render(self, request):
+        if request.user.has_perm('fatanalysis.basic_access'):
+            return MenuItemHook.render(self, request)
+        return ''
+
+@hooks.register('menu_item_hook')
+def register_menu():
+    return FatAnalysisMenuItem()
+
+@hooks.register('url_hook')
+def register_urls():
+    return UrlHook(urls, 'fatanalysis', r'^fatanalysis/')

aa_fatanalysis-0.1.0/fatanalysis/forms.py

@@ -0,0 +1,15 @@
+from django import forms
+
+class CsvImportForm(forms.Form):
+    PERIOD_CHOICES = (
+        (30, '30 Days'),
+        (90, '90 Days'),
+    )
+    csv_file = forms.FileField(label='FAT CSV File')
+    period_type = forms.ChoiceField(choices=PERIOD_CHOICES, label='Period Type')
+    custom_date = forms.DateTimeField(
+        required=False,
+        label='Custom Date (Optional)',
+        help_text='Leave empty to use current date and time. Use format YYYY-MM-DD HH:MM if your browser does not show a date picker.',
+        widget=forms.DateTimeInput(attrs={'type': 'datetime-local'})
+    )

aa_fatanalysis-0.1.0/fatanalysis/migrations/0001_initial.py

@@ -0,0 +1,36 @@
+# Generated by Django 5.2.16 on 2026-07-31 17:05
+
+import django.db.models.deletion
+from django.db import migrations, models
+
+
+class Migration(migrations.Migration):
+
+    initial = True
+
+    dependencies = [
+        ('eveonline', '0025_remove_evecharacter_last_updated_and_more'),
+    ]
+
+    operations = [
+        migrations.CreateModel(
+            name='UploadPeriod',
+            fields=[
+                ('id', models.AutoField(auto_created=True, primary_key=True, serialize=False, verbose_name='ID')),
+                ('upload_date', models.DateTimeField(auto_now_add=True)),
+                ('uploader', models.CharField(max_length=255)),
+                ('period_type', models.IntegerField(choices=[(30, '30 Days'), (90, '90 Days')])),
+            ],
+        ),
+        migrations.CreateModel(
+            name='FatEntry',
+            fields=[
+                ('id', models.AutoField(auto_created=True, primary_key=True, serialize=False, verbose_name='ID')),
+                ('character_name', models.CharField(max_length=255)),
+                ('total_fats', models.IntegerField(default=0)),
+                ('fat_details', models.JSONField(blank=True, default=dict)),
+                ('character', models.ForeignKey(blank=True, null=True, on_delete=django.db.models.deletion.SET_NULL, to='eveonline.evecharacter')),
+                ('period', models.ForeignKey(on_delete=django.db.models.deletion.CASCADE, related_name='fat_entries', to='fatanalysis.uploadperiod')),
+            ],
+        ),
+    ]

aa_fatanalysis-0.1.0/fatanalysis/migrations/0002_alter_uploadperiod_upload_date.py

@@ -0,0 +1,19 @@
+# Generated by Django 5.2.15 on 2026-07-31 17:31
+
+import django.utils.timezone
+from django.db import migrations, models
+
+
+class Migration(migrations.Migration):
+
+    dependencies = [
+        ('fatanalysis', '0001_initial'),
+    ]
+
+    operations = [
+        migrations.AlterField(
+            model_name='uploadperiod',
+            name='upload_date',
+            field=models.DateTimeField(default=django.utils.timezone.now),
+        ),
+    ]

aa_fatanalysis-0.1.0/fatanalysis/migrations/__init__.py

@@ -0,0 +1 @@
+# Migrations module

aa_fatanalysis-0.1.0/fatanalysis/models.py

@@ -0,0 +1,27 @@
+from django.db import models
+from allianceauth.eveonline.models import EveCharacter
+from django.utils import timezone
+
+class UploadPeriod(models.Model):
+    PERIOD_CHOICES = (
+        (30, '30 Days'),
+        (90, '90 Days'),
+    )
+    upload_date = models.DateTimeField(default=timezone.now)
+    uploader = models.CharField(max_length=255)
+    period_type = models.IntegerField(choices=PERIOD_CHOICES)
+    
+    def __str__(self):
+        return f"{self.get_period_type_display()} Upload ({self.upload_date.strftime('%Y-%m-%d %H:%M')})"
+
+class FatEntry(models.Model):
+    period = models.ForeignKey(UploadPeriod, on_delete=models.CASCADE, related_name='fat_entries')
+    character = models.ForeignKey(EveCharacter, on_delete=models.SET_NULL, null=True, blank=True)
+    character_name = models.CharField(max_length=255)
+    total_fats = models.IntegerField(default=0)
+    
+    # Stores dynamic fleet types (e.g. Strategic, QRF, Astartes) without hardcoding columns
+    fat_details = models.JSONField(default=dict, blank=True)
+
+    def __str__(self):
+        return f"{self.character_name} - {self.total_fats} FATs"

aa_fatanalysis-0.1.0/fatanalysis/templates/fatanalysis/base.html

@@ -0,0 +1,21 @@
+{% extends "allianceauth/base-bs5.html" %}
+{% load i18n %}
+
+{% block page_title %}{% trans "FAT Analysis" %}{% endblock page_title %}
+
+{% block content %}
+    <div class="row">
+        <div class="col-md-12">
+            <h1 class="page-header text-center">{% trans "FAT Analysis Dashboard" %}</h1>
+            {% block fatanalysis_content %}{% endblock %}
+        </div>
+    </div>
+{% endblock %}
+
+{% block extra_css %}
+    {% include 'bundles/datatables-css-bs5.html' %}
+{% endblock %}
+
+{% block extra_javascript %}
+    {% include 'bundles/datatables-js-bs5.html' %}
+{% endblock %}

aa_fatanalysis-0.1.0/fatanalysis/templates/fatanalysis/import_csv.html

@@ -0,0 +1,20 @@
+{% extends "fatanalysis/base.html" %}
+{% load i18n %}
+{% load django_bootstrap5 %}
+
+{% block fatanalysis_content %}
+    <div class="panel panel-default">
+        <div class="panel-heading">
+            <h3 class="panel-title">{% trans "Import FAT CSV" %}</h3>
+        </div>
+        <div class="panel-body">
+            <p>{% trans "Upload your 30 or 90 days FAT CSV file here. The system will automatically parse all columns, including any dynamic fleet types." %}</p>
+            <form method="POST" enctype="multipart/form-data">
+                {% csrf_token %}
+                {% bootstrap_form form %}
+                <button type="submit" class="btn btn-primary">{% trans "Upload" %}</button>
+                <a href="{% url 'fatanalysis:index' %}" class="btn btn-default">{% trans "Cancel" %}</a>
+            </form>
+        </div>
+    </div>
+{% endblock %}

aa_fatanalysis-0.1.0/fatanalysis/templates/fatanalysis/index.html

@@ -0,0 +1,94 @@
+{% extends "fatanalysis/base.html" %}
+{% load i18n %}
+
+{% block fatanalysis_content %}
+    <div class="row">
+        <div class="col-md-12">
+            <a href="{% url 'fatanalysis:period_list' %}" class="btn btn-default pull-right" style="margin-left: 10px;">
+                <i class="fas fa-list"></i> {% trans "Manage Periods" %}
+            </a>
+            <a href="{% url 'fatanalysis:import_csv' %}" class="btn btn-primary pull-right">
+                <i class="fas fa-upload"></i> {% trans "Import CSV" %}
+            </a>
+        </div>
+    </div>
+    <br>
+
+    <div class="panel panel-default">
+        <div class="panel-heading">
+            <h3 class="panel-title">{% trans "FAT Trend Over Time (Alliance Total)" %}</h3>
+        </div>
+        <div class="panel-body">
+            <canvas id="trendChart" height="100"></canvas>
+        </div>
+    </div>
+
+    <div class="row">
+        <div class="col-md-6">
+            <div class="panel panel-default text-center">
+                <div class="panel-body">
+                    <h3>{% trans "30 Days Dashboard" %}</h3>
+                    <p>{% trans "View the latest 30 days FATs per character." %}</p>
+                    <a href="{% url 'fatanalysis:overview_30' %}" class="btn btn-primary btn-lg">
+                        <i class="fas fa-calendar-alt"></i> {% trans "30 Days Overview" %}
+                    </a>
+                </div>
+            </div>
+        </div>
+        <div class="col-md-6">
+            <div class="panel panel-default text-center">
+                <div class="panel-body">
+                    <h3>{% trans "90 Days Dashboard" %}</h3>
+                    <p>{% trans "View the latest 90 days FATs per character." %}</p>
+                    <a href="{% url 'fatanalysis:overview_90' %}" class="btn btn-primary btn-lg">
+                        <i class="fas fa-calendar-alt"></i> {% trans "90 Days Overview" %}
+                    </a>
+                </div>
+            </div>
+        </div>
+    </div>
+{% endblock %}
+
+{% block extra_javascript %}
+    {{ block.super }}
+    <script src="https://cdn.jsdelivr.net/npm/chart.js"></script>
+    <script>
+        $(document).ready(function() {
+
+            // Trend Chart
+            const trendCtx = document.getElementById('trendChart').getContext('2d');
+            new Chart(trendCtx, {
+                type: 'bar',
+                data: {
+                    labels: {{ trend_labels|safe }},
+                    datasets: [
+                        {
+                            label: '{% trans "30 Days FATs" %}',
+                            data: {{ trend_30|safe }},
+                            borderColor: '#36A2EB',
+                            backgroundColor: 'rgba(54, 162, 235, 0.2)',
+                            tension: 0.1,
+                            fill: true
+                        },
+                        {
+                            label: '{% trans "90 Days FATs" %}',
+                            data: {{ trend_90|safe }},
+                            borderColor: '#FF6384',
+                            backgroundColor: 'rgba(255, 99, 132, 0.2)',
+                            tension: 0.1,
+                            fill: true
+                        }
+                    ]
+                },
+                options: {
+                    responsive: true,
+                    scales: {
+                        y: {
+                            beginAtZero: true
+                        }
+                    }
+                }
+            });
+        });
+    </script>
+{% endblock %}

aa_fatanalysis-0.1.0/fatanalysis/templates/fatanalysis/overview.html

@@ -0,0 +1,141 @@
+{% extends "fatanalysis/base.html" %}
+{% load i18n %}
+
+{% block fatanalysis_content %}
+    <div class="row">
+        <div class="col-md-12">
+            <a href="{% url 'fatanalysis:index' %}" class="btn btn-default pull-right">
+                <i class="fas fa-arrow-left"></i> {% trans "Back to Dashboard" %}
+            </a>
+            <h2>{{ title }} <small>({{ period.upload_date|date:"Y-m-d"|default:"No uploads yet" }})</small></h2>
+        </div>
+    </div>
+    {% if period %}
+    <div class="row">
+        <div class="col-md-12">
+            <div class="panel panel-default">
+                <div class="panel-heading">
+                    <h3 class="panel-title">{% trans "Historical FAT Trend" %} ({{ period_type }} {% trans "Days" %})</h3>
+                </div>
+                <div class="panel-body">
+                    <canvas id="historicalTrendChart" height="100"></canvas>
+                </div>
+            </div>
+        </div>
+    </div>
+    
+    <div class="row">
+        <div class="col-md-4">
+            <div class="panel panel-default">
+                <div class="panel-heading">
+                    <h3 class="panel-title">{% trans "Top 10 Players" %}</h3>
+                </div>
+                <div class="panel-body">
+                    <canvas id="topPlayersChart"></canvas>
+                </div>
+            </div>
+        </div>
+        <div class="col-md-8">
+            <div class="panel panel-default">
+                <div class="panel-heading">
+                    <h3 class="panel-title">{% trans "All Players" %}</h3>
+                </div>
+                <div class="panel-body">
+                    <table class="table table-striped table-hover" id="overview-table">
+                        <thead>
+                            <tr>
+                                <th>{% trans "Character" %}</th>
+                                <th>{% trans "Total FATs" %}</th>
+                                {% for header in dynamic_headers %}
+                                <th>{{ header }}</th>
+                                {% endfor %}
+                            </tr>
+                        </thead>
+                        <tbody>
+                            {% for entry in entries %}
+                            <tr>
+                                <td>
+                                    <a href="{% url 'fatanalysis:player_detail' character_name=entry.character_name period_type=period_type %}">
+                                        {{ entry.character_name }}
+                                    </a>
+                                </td>
+                                <td><strong>{{ entry.total_fats }}</strong></td>
+                                {% for value in entry.dynamic_values %}
+                                <td>{{ value }}</td>
+                                {% endfor %}
+                            </tr>
+                            {% empty %}
+                            <tr>
+                                <td colspan="{{ dynamic_headers|length|add:2 }}" class="text-center">{% trans "No FAT data available." %}</td>
+                            </tr>
+                            {% endfor %}
+                        </tbody>
+                    </table>
+                </div>
+            </div>
+        </div>
+    </div>
+    {% else %}
+    <div class="alert alert-info">
+        {% trans "No uploads found for this period type yet." %}
+    </div>
+    {% endif %}
+{% endblock %}
+
+{% block extra_javascript %}
+    {{ block.super }}
+    {% if period %}
+    <script src="https://cdn.jsdelivr.net/npm/chart.js"></script>
+    <script>
+        $(document).ready(function() {
+            $('#overview-table').DataTable({
+                "order": [[ 1, "desc" ]]
+            });
+
+            // Pie Chart for Top Players
+            const topCtx = document.getElementById('topPlayersChart').getContext('2d');
+            new Chart(topCtx, {
+                type: 'pie',
+                data: {
+                    labels: {{ top_labels|safe }},
+                    datasets: [{
+                        data: {{ top_data|safe }},
+                        backgroundColor: [
+                            '#FF6384', '#36A2EB', '#FFCE56', '#4BC0C0', '#9966FF',
+                            '#FF9F40', '#E7E9ED', '#8AC926', '#1982C4', '#6A4C93'
+                        ]
+                    }]
+                },
+                options: {
+                    responsive: true
+                }
+            });
+
+            // Trend Chart
+            const trendCtx = document.getElementById('historicalTrendChart').getContext('2d');
+            new Chart(trendCtx, {
+                type: 'line',
+                data: {
+                    labels: {{ trend_labels|safe }},
+                    datasets: [{
+                        label: '{{ period_type }} {% trans "Days FATs" %}',
+                        data: {{ trend_data|safe }},
+                        borderColor: '#36A2EB',
+                        backgroundColor: 'rgba(54, 162, 235, 0.2)',
+                        tension: 0.1,
+                        fill: true
+                    }]
+                },
+                options: {
+                    responsive: true,
+                    scales: {
+                        y: {
+                            beginAtZero: true
+                        }
+                    }
+                }
+            });
+        });
+    </script>
+    {% endif %}
+{% endblock %}

aa_fatanalysis-0.1.0/fatanalysis/templates/fatanalysis/period_delete.html

@@ -0,0 +1,24 @@
+{% extends "fatanalysis/base.html" %}
+{% load i18n %}
+
+{% block fatanalysis_content %}
+    <div class="row">
+        <div class="col-md-6 col-md-offset-3">
+            <div class="panel panel-danger">
+                <div class="panel-heading">
+                    <h3 class="panel-title">{% trans "Delete Upload Period" %}</h3>
+                </div>
+                <div class="panel-body">
+                    <p>{% trans "Are you sure you want to delete the FAT upload for" %} <strong>{{ period.get_period_type_display }}</strong> {% trans "on" %} <strong>{{ period.upload_date|date:"Y-m-d H:i" }}</strong>?</p>
+                    <p class="text-danger">{% trans "This will also delete all associated FAT entries and data. This action cannot be undone." %}</p>
+                    
+                    <form method="POST">
+                        {% csrf_token %}
+                        <button type="submit" class="btn btn-danger">{% trans "Yes, Delete" %}</button>
+                        <a href="{% url 'fatanalysis:period_list' %}" class="btn btn-default">{% trans "Cancel" %}</a>
+                    </form>
+                </div>
+            </div>
+        </div>
+    </div>
+{% endblock %}