allianceauth-afat 1.4.4b1

Another Fleet Activity Tracking tool for Alliance Auth

Alliance Auth AFAT - Another Fleet Activity Tracker

An Improved FAT/PAP System for Alliance Auth.

AFAT is a privately maintained whitelabel of ImicusFAT. The only reason AFAT exists is because I don't like having an alliance internal meme as a name for a module in my Auth system. Nothing else ...

Features and highlights

• FATLink Creation and Population from ESI
• Automatic tracing of participation on FAT links created via ESI
• Fleet Type Classification (can be added in the Admin Menu)
• Graphical Statistics Views

AFAT will work alongside the built-in native FAT System, bFAT and ImicusFAT. However, data does not share, but you can migrate their data to AFAT, for more information see below.

Contents

• Installation
• Updating
• Data Migration
  • From Alliance Auth native FAT
  • From bFAT
  • From ImicusFAT
• Settings
• Permissions
• Changelog
• Credits

Installation

Important

This app is a plugin for Alliance Auth. If you don't have Alliance Auth running already, please install it first before proceeding. (see the official AA installation guide for details)

For users migrating from one of the other FAT systems, please read the specific instructions FIRST.

Step 1 - Install app

Make sure you are in the virtual environment (venv) of your Alliance Auth installation. Then install the latest version:

pip install allianceauth-afat

Step 2 - Update your AA settings

Configure your AA settings (local.py) as follows:

• Add 'afat', to INSTALLED_APPS
• Add the scheduled task so ESI links will be updated automagically

# AFAT - https://github.com/ppfeufer/allianceauth-afat
CELERYBEAT_SCHEDULE["afat_update_esi_fatlinks"] = {
    "task": "afat.tasks.update_esi_fatlinks",
    "schedule": crontab(minute="*/1"),
}

Step 3 - Finalize the installation

Run migrations & copy static files

python manage.py collectstatic
python manage.py migrate

Restart your supervisor services for AA.

Updating

To update your existing installation of ImicusFAT, first enable your virtual environment (venv) of your Alliance Auth installation.

pip install -U allianceauth-afat

python manage.py collectstatic
python manage.py migrate

Finally restart your supervisor services for AA

Data Migration

Right after the initial installation and running migrations, you can import the data from Alliance Auth's native FAT system, from bFAT or from ImicusFAT if you have used one of these until now.

!!IMPORTANT!!

Only do this once and ONLY BEFORE you are using AFAT. A later migration is not possible.

Import from native FAT

python myauth/manage.py afat_import_from_allianceauth_fat

Import from bFAT

python myauth/manage.py afat_import_from_bfat

Import from ImicusFAT

python myauth/manage.py afat_import_from_imicusfat

Settings

To customize the module, the following settings are available.

Name	Description	Default Value
AFAT_DEFAULT_FATLINK_EXPIRY_TIME	Sets the default expiry time for clickable FAT links in Minutes	60

Permissions

Name	Description	Notes
afat.Alliance Auth AFAT.Can access the Alliance Auth AFAT Module	Users with this permission can acces the AFAT module and register their participation through clickable FAT links	Your line member probably want this permission
afat.FAT Link.Can Manage the AFAT Module	User with this permission can manage the complete AFAT Module. They can create, edit and remove FAT links as well as they can create and remove FATs	Your Military lead probably should get this permission
afat.Fat Link.Can add FAT Link	Users with this permission can only add FAT links	Your regular FC or who ever should be able to add FAT links should have this permission

There are probably a lot more permissions registered in your Django Admin Panel, but they are not used as of now, so you can happiely ignore them.

Changelog

To keep track of all changes, please read the Changelog.

Credits

• AFAT • Privately maintained by @ppfeufer is a whitelabel of ImicusFAT maintained by @exiom with @Aproia and @ppfeufer • Based on allianceauth-bfat by @colcrunch •