Skip to main content

FAT Analysis

PyPI version Python versions Tests

Alliance Auth plugin for analyzing FATs (Fleet Activity Tracking). This plugin provides multi-year AFAT ingestion, automated scraping from external Alliance Auth instances (e.g. INIT Auth) via session cookie authentication, direct CSV imports, and interactive dynamic dashboard visualizations (30d, 90d, 120d, YTD, multi-year) on both a per-character and per-corporation basis.

Features

  • Multi-Year AFAT Ingestion: Store and track monthly FAT periods across multiple years with dynamic fleet activity categorizations (e.g., Strategic, QRF, Peacetime).
  • INIT Auth Scraper: Built-in scraper service to ingest reports directly from remote Alliance Auth AFAT instances using session cookies.
  • Frontend Director UI: Manage scraper credentials, test live connections, trigger on-demand imports, and upload CSVs directly from the web interface without needing Django admin.
  • Automatic Sync: A Celery task fetches the current month from INIT Auth on a schedule (default every 6 hours; during the first 3 days of a month the previous month too). Switch it on or off and set the interval on the Sync & Ingestion page. The plugin keeps its own Celery beat entry, so no CELERYBEAT_SCHEDULE entry in local.py is needed.
  • Dynamic Time Windows: Switch instantly between 30 Days (Latest), 90 Days, 120 Days, YTD, specific years, and All Time.
  • Corp Participation & Averages: Active Participation compares the mains with FATs to the corp's mains in Auth; the dashboard also shows corp averages (FATs per month, per active pilot and per member) for the selected window.
  • Pilot Longitudinal Detail: Track individual pilot participation trends over time with interactive Chart.js line and doughnut charts.
  • Permissions Management: Separate fatanalysis.basic_access (members) and fatanalysis.manage_fatanalysis (directors/leadership).

Installation

  1. Activate your Alliance Auth virtual environment

    source /home/allianceserver/venv/auth/bin/activate
    
  2. Install the plugin Navigate to the directory containing this plugin and run:

    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:

    INSTALLED_APPS += [
        "fatanalysis",
    ]
    
  4. Run migrations

    python manage.py makemigrations
    python manage.py migrate
    
  5. Restart Alliance Auth services

    sudo systemctl restart supervisor
    

    (Or restart gunicorn and celery according to your specific setup) Celery beat must be running for the automatic sync. migrate creates its schedule (fatanalysis_auto_sync, every 6 hours); it needs a session cookie on the Sync & Ingestion page to fetch data.

Permissions

  • fatanalysis.basic_access: Allows members to view the FAT Analysis dashboard, filter by time windows, and view player details.
  • fatanalysis.manage_fatanalysis: Allows directors/leadership to access Sync & Ingestion management, configure the AFAT scraper, import CSVs, and manage/delete recording periods.

Metadata

Release files for aa-fatanalysis 1.2.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for aa-fatanalysis 1.2.0
File Size Uploaded Provenance Actions
aa_fatanalysis-1.2.0.tar.gz 40.8 kB With provenance Details for aa_fatanalysis-1.2.0.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for aa-fatanalysis 1.2.0
File Interpreter ABI Platform Actions
aa_fatanalysis-1.2.0-py3-none-any.whl Python 3 none any Details for aa_fatanalysis-1.2.0-py3-none-any.whl

Total release size: 102.0 kB

Release files / aa_fatanalysis-1.2.0.tar.gz

Download URL aa_fatanalysis-1.2.0.tar.gz
Size 40.8 kB
Tags Source
SHA-256 checksum
How to use checksums
8e5a9a310f1b02d065c709185888c5b705ba6a5ea7b8765dfc2396faf4a19960
BLAKE2b-256 checksum
How to use checksums
4fb81a79934d8ceddb099b0103a79fbf441708eaa50827e1f9beb26277e2981d
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 6, 2026.

Transparency log

Release files / aa_fatanalysis-1.2.0-py3-none-any.whl

Download URL aa_fatanalysis-1.2.0-py3-none-any.whl
Size 61.2 kB
Tags Python 3
SHA-256 checksum
How to use checksums
28522996595965eb4676ec04524a183c45522d4c2923eb4d4cbe3922d862ecd7
BLAKE2b-256 checksum
How to use checksums
dce14018e7f795841d45e1ab76bc11b65c7d15776ad21c1f086b39f1d5bd2081
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 6, 2026.

Transparency log

Security for aa-fatanalysis 1.2.0

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Full provenance

Both files in this release have been uploaded with provenance metadata.

Select from 2 files

Attestation for aa_fatanalysis-1.2.0.tar.gz

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 6, 2026.

Transparency log

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page