https://github.com/ppfeufer/allianceauth-afat
Another Fleet Activity Tracking tool for Alliance Auth
https://github.com/ppfeufer/allianceauth-afat
allianceauth esi eve-online fat-links fleet fleet-activity-tracking fleet-tracking
Last synced: 2 months ago
JSON representation
Another Fleet Activity Tracking tool for Alliance Auth
- Host: GitHub
- URL: https://github.com/ppfeufer/allianceauth-afat
- Owner: ppfeufer
- License: gpl-3.0
- Created: 2020-08-27T18:43:24.000Z (over 4 years ago)
- Default Branch: master
- Last Pushed: 2025-03-20T14:58:43.000Z (2 months ago)
- Last Synced: 2025-03-20T15:44:35.616Z (2 months ago)
- Topics: allianceauth, esi, eve-online, fat-links, fleet, fleet-activity-tracking, fleet-tracking
- Language: Python
- Homepage:
- Size: 7.1 MB
- Stars: 0
- Watchers: 2
- Forks: 5
- Open Issues: 4
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- Funding: .github/FUNDING.yml
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
- Codeowners: CODEOWNERS
Awesome Lists containing this project
README
# Alliance Auth AFAT — Another Fleet Activity Tracker
[](https://pypi.org/project/allianceauth-afat/)
[](https://pypi.org/project/allianceauth-afat/)
[](https://pypi.org/project/allianceauth-afat/)
[](https://pypi.org/project/allianceauth-afat/)
[](https://results.pre-commit.ci/latest/github/ppfeufer/allianceauth-afat/master)
[](http://black.readthedocs.io/en/latest/)
[](https://github.com/ppfeufer/allianceauth-afat/actions/workflows/automated-checks.yml)
[](https://codecov.io/gh/ppfeufer/allianceauth-afat)
[](https://weblate.ppfeufer.de/engage/alliance-auth-apps/)
[](https://github.com/ppfeufer/aa-forum/blob/master/CODE_OF_CONDUCT.md)
[](https://discord.gg/zmh52wnfvM)
[](https://ko-fi.com/N4N8CL1BY)
An Improved FAT/PAP System for
[Alliance Auth](https://gitlab.com/allianceauth/allianceauth).
______________________________________________________________________
- [Features and Highlights](#features-and-highlights)
- [Screenshots](#screenshots)
- [Dashboard](#dashboard)
- [Fat Link List](#fat-link-list)
- [Fat Link Details](#fat-link-details)
- [Add Fat Link View for FCs](#add-fat-link-view-for-fcs)
- [Installation](#installation)
- [Important](#important)
- [Step 1: Install the App](#step-1-install-the-app)
- [Step 2: Update Your AA Settings](#step-2-update-your-aa-settings)
- [Step 3: Finalizing the Installation](#step-3-finalizing-the-installation)
- [Updating](#updating)
- [Data Migration](#data-migration)
- [Import From Native FAT](#import-from-native-fat)
- [Settings](#settings)
- [Permissions](#permissions)
- [Changelog](#changelog)
- [Translation Status](#translation-status)
- [Contributing](#contributing)
- [Credits](#credits)
______________________________________________________________________
- Automatic tracking of participation on FAT links created via ESI
- Multiple ESI fleets (with your alts)
- Manually end ESI tracking per fleet
- Fleet type classification (can be added in the admin backend)
- Ship type overview per FAT link
- Graphical statistics views
- Custom module name
- Re-open FAT link if the FAT link has expired and is within the defined grace time
(only for clickable FAT links)
- Manually add pilots to clickable FAT links, in case they missed clicking the link
(for a period of 24 hours after the FAT links original expiry time)
- Log for the following actions (Logs are kept for a certain time, 60 days per default):
- Create FAT link
- Change FAT link
- Remove FAT link
- Re-open FAT link
- Manually add pilot to FAT link
- Remove pilot from FAT link
AFAT will work alongside the built-in native FAT System and ImicusFAT.
However, data doesn't share, but you can migrate their data to AFAT, for more
information, see below.
> [!NOTE]
>
> **Alliance Auth AFAT >= 3.0.0 needs at least Alliance Auth v4.0.0!**
>
> Please make sure to update your Alliance Auth instance _before_ you install this
> module or update to the latest version, otherwise an update to Alliance Auth will
> be pulled in unsupervised.
>
> The last version compatible with Alliance Auth v3 is `2.13.0`.
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](https://allianceauth.readthedocs.io/en/latest/installation/allianceauth.html)
for details)
> [!IMPORTANT]
>
> For users migrating from Alliance Auth's built-in FAT systems,
> please read the [specific instructions](#data-migration) FIRST.
Make sure you're in the virtual environment (venv) of your Alliance Auth installation.
Then install the latest version:
```bash
pip install allianceauth-afat
```
### Step 2: Update Your AA Settings
Configure your AA settings in your `local.py` as follows:
- Add `'afat',` to `INSTALLED_APPS`
- Add the scheduled tasks
```python
# AFAT - https://github.com/ppfeufer/allianceauth-afat
CELERYBEAT_SCHEDULE["afat_update_esi_fatlinks"] = {
"task": "afat.tasks.update_esi_fatlinks",
"schedule": crontab(minute="*/1"),
}
CELERYBEAT_SCHEDULE["afat_logrotate"] = {
"task": "afat.tasks.logrotate",
"schedule": crontab(minute="0", hour="1"),
}
```
### Step 3: Finalizing the Installation
Run migrations & copy static files
```bash
python manage.py collectstatic
python manage.py migrate
```
Restart your supervisor services for AA.
To update your existing installation of AFAT, first enable your
virtual environment (venv) of your Alliance Auth installation.
```bash
pip install -U allianceauth-afat
python manage.py collectstatic
python manage.py migrate
```
Finally, restart your supervisor services for AA
It is possible that some versions need some more changes. Always read the
[release notes](https://github.com/ppfeufer/allianceauth-afat/releases) to find out
more.
Right after the **initial** installation and running migrations,
you can import the data from Alliance Auth's native FAT system if
you have used it until now.
To import from the native FAT module, run the following command:
```shell
python myauth/manage.py afat_import_from_allianceauth_fat
```
To customize the module, the following settings can be managed in your admin backend:
| Setting | Description | Default Value |
| :--------------------------------- | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :------------ |
| Use doctrines from fittings module | Whether to use the doctrines from the Fittings modules in the doctrine dropdown or from AFATs own doctrine list. (Note: The [fittings module](https://gitlab.com/colcrunch/fittings) needs to be installed for this.) | No |
| Default FAT link expiry time | Default expiry time for clickable FAT links in Minutes | 60 |
| Default FAT link reopen grace time | Time in minutes a FAT link can be re-opened after it has expired | 60 |
| Default FAT link reopen duration | Time in minutes a FAT link is re-opened | 60 |
| Default log duration | Time in days before log entries are being removed from the DB | 60 |
| Name | Description | Notes |
| :---------------------- | :--------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| basic_access | Can access the AFAT module | Your line member probably want this permission, so they can see the module and click the FAT links they are given. They also can see their own statistics with this permission. |
| manage_afat | Can manage the AFAT module | Your Military lead probably should get this permission |
| add_fatlink | Can create FAT Links | Your regular FC or who ever should be able to add FAT links should have this permission |
| stats_corporation_own | Can see own corporation statistics | |
| stats_corporation_other | Can see statistics of other corporations | |
| logs_view | Can view the modules logs | |
To keep track of all changes, please read the
[Changelog](https://github.com/ppfeufer/allianceauth-afat/blob/master/CHANGELOG.md).
[](https://weblate.ppfeufer.de/engage/alliance-auth-apps/)
Do you want to help translate this app into your language or improve the existing
translation? - [Join our team of translators][weblate engage]!
You want to contribute to this project? That's cool!
Please make sure to read the [contribution guidelines](https://github.com/ppfeufer/allianceauth-afat/blob/master/CONTRIBUTING.md).\
(I promise, it's not much, just some basics)
AFAT is maintained by @ppfeufer and is based on
[ImicusFAT](https://gitlab.com/evictus.iou/allianceauth-imicusfat)
by @exiom with @Aproia and @ppfeufer which is based on
[allianceauth-bfat](https://gitlab.com/colcrunch/allianceauth-bfat) by @colcrunch
Both of these modules are no longer maintained and are deprecated. Both modules will
not run with the latest stable releases of Alliance Auth.
[weblate engage]: https://weblate.ppfeufer.de/engage/alliance-auth-apps/ "Weblate Translations"