allianceauth-imicusfat 1.4.2

Fleet Activity Tracking tool for Alliance Auth

ImicusFAT

An Improved FAT/PAP System for Alliance Auth.

Feature Highlights/Differences

• FATLink Creation and Population from ESI
• Fleet Type Classification (can be added in the Admin Menu)
• Graphical Statistics Views
• Many Core Functionality Improvements and Fixes

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

Contents

• Installation
  • Step 1 - Install app
  • Step 2 - Update your AA settings
  • Step 3 - Finalize the installation
• Updating
• Data Migration
  • Import from AA-FAT
  • Import from bFAT
• Settings
• 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) Important: For users migrating from bFAT, please read Migrating from bFAT 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-imicusfat

Step 2 - Update your AA settings

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

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

# ImicusFAT - https://gitlab.com/evictus.iou/allianceauth-imicusfat
CELERYBEAT_SCHEDULE["imicusfat_update_esi_fatlinks"] = {
    "task": "imicusfat.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-imicusfat

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 own FAT system or bFAT, if you have used it until now.

!!IMPORTANT!!

Only do this once and ONLY BEFORE you are using ImicusFAT.

Import from AA-FAT

python myauth/manage.py imicusfat_import_from_allianceauth_fat

Import from bFAT

python myauth/manage.py imicusfat_import_from_bfat

Settings

To customize the module, the following settings are available.

Name	Description	Default Value
IMICUSFAT_DEFAULT_FATLINK_EXPIRY_TIME	Sets the default expiry time in minutes for clickable FAT links	60

Credits

• ImicusFAT • Developed and Maintained by @exiom with @Aproia and @ppfeufer • Based on allianceauth-bfat by @colcrunch •