FAT Analysis
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_SCHEDULEentry inlocal.pyis 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) andfatanalysis.manage_fatanalysis(directors/leadership).
Installation
-
Activate your Alliance Auth virtual environment
source /home/allianceserver/venv/auth/bin/activate
-
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)
-
Update your Alliance Auth settings Add
'fatanalysis'to yourINSTALLED_APPSinmyauth/myauth/settings/local.py:INSTALLED_APPS += [ "fatanalysis", ]
-
Run migrations
python manage.py makemigrations python manage.py migrate
-
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.
migratecreates 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)
| 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)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| 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 logRelease 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 logSecurity 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.
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 logA 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.