Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://gitlab.com/ErikKalkoken/aa-structures

App for managing Eve Online structures with Alliance Auth - https://aa-structures.readthedocs.io/en/latest/
https://gitlab.com/ErikKalkoken/aa-structures

Alliance Auth Eve Online django python

Last synced: about 2 months ago
JSON representation

App for managing Eve Online structures with Alliance Auth - https://aa-structures.readthedocs.io/en/latest/

Host: gitlab.com
URL: https://gitlab.com/ErikKalkoken/aa-structures
Owner: ErikKalkoken
License: mit
Created: 2019-11-15T01:20:02.259Z (about 5 years ago)
Default Branch: master
Last Synced: 2024-11-17T13:59:54.503Z (about 2 months ago)
Topics: Alliance Auth, Eve Online, django, python
Stars: 6
Forks: 6
Open Issues: 17
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- License: LICENSE

Awesome Lists containing this project

README

        # Structures

App for managing Eve Online structures with Alliance Auth.

[![release](https://img.shields.io/pypi/v/aa-structures?label=release)](https://pypi.org/project/aa-structures/)

[![python](https://img.shields.io/pypi/pyversions/aa-structures)](https://pypi.org/project/aa-structures/)

[![django](https://img.shields.io/pypi/djversions/aa-structures?label=django)](https://pypi.org/project/aa-structures/)

[![pipeline](https://gitlab.com/ErikKalkoken/aa-structures/badges/master/pipeline.svg)](https://gitlab.com/ErikKalkoken/aa-structures/-/pipelines)

[![codecov](https://codecov.io/gl/ErikKalkoken/aa-structures/branch/master/graph/badge.svg?token=wq6yixsYRE)](https://codecov.io/gl/ErikKalkoken/aa-structures)

[![Documentation Status](https://readthedocs.org/projects/aa-structures/badge/?version=latest)](https://aa-structures.readthedocs.io/en/latest/?badge=latest)

[![license](https://img.shields.io/badge/license-MIT-green)](https://gitlab.com/ErikKalkoken/aa-structures/-/blob/master/LICENSE)

[![pre-commit](https://img.shields.io/badge/pre--commit-enabled-brightgreen?logo=pre-commit&logoColor=white)](https://github.com/pre-commit/pre-commit)

[![Code style: black](https://img.shields.io/badge/code%20style-black-000000.svg)](https://github.com/psf/black)

[![chat](https://img.shields.io/discord/790364535294132234)](https://discord.gg/zmh52wnfvM)

## Overview

This app is for managing Eve Online structures with [Alliance Auth](https://gitlab.com/allianceauth/allianceauth). It allows all member corporations to see a current list of all their structures in Auth. In addition it allows forwarding Eve Online notifications to Discord.

## Features

Structures adds the following main features to Alliance Auth:

- Structure browser with a detailed list of all structures owned by member corporations, automatically synced with the game server

- Structures include all Upwell structures, Custom Offices and Starbases / POSes

- Automatically forwards Eve Online notifications to Discord channels as alerts for these categories:

  - Upwell structures

  - Customs offices

  - Starbases

  - Moon mining

  - Sovereignty

  - Wars

  - Corporation membership changes

- Automatically adds timers from relevant notifications to [Alliance Auth Structure Timers](https://allianceauth.readthedocs.io/en/v2.8.1/features/apps/timerboard.html) or [Structure Timers II](https://gitlab.com/ErikKalkoken/aa-structuretimers) app (if installed)

- Fittings, contents of Upwell structures (e.g. fuel blocks and ammo) and current fuel usage

- Additional structure notifications generated by the app:

  - Configurable alerts to warn about fuel running at in structures and POSes, and which can replace the ESI notifications

  - Notifications to inform when structures have been refueled (BETA)

  - Configurable alerts to warn about jump fuel (liquid ozone) running low in jump gates

  - POS reinforced (BETA)

- Tax rates and access settings of Customs Offices

- Permissions define which structures are visible to a user based on organization membership

- Self-defined tags help to better organize structures

- Ability to increase notification response time and sync resilience with multiple sync characters per structure owner

- Automatically sends alerts to users and admin when token become invalid or sync from ESI fails

- Interface for 3rd party monitoring of the services status

- Chinese :cn:, English :us:, German :de: and Russian :ru: localization

Please also check out [Discord Notify](https://gitlab.com/ErikKalkoken/aa-discordnotify) that will automatically forward auth notifications to the respective users on Discord.

## Screenshots

Here is an example for the main list of structures:

![StructureList](https://imgpile.com/images/GCxK7E.png)

You can also see the fittings and contents any upwell structures:

![Fitting](https://imgpile.com/images/GCxtQh.png)

The tax rate and access configuration of customs offices is visible too:

![Poco details](https://imgpile.com/images/GCxPyg.png)

And you can see the configuration for starbases:

![Poco details](https://imgpile.com/images/GCxMPr.png)

This is an example for a notification posted on Discord:

![Notification example](https://i.imgur.com/oqBqeFy.png)

## Documentation

Please see the [operation manual](https://aa-structures.readthedocs.io/en/latest/operations.html#installation) for the installation guide.