aa-blueprints 3.0.0

Blueprint Library plugin for Alliance Auth.

AA Blueprints

This is an blueprints library app for Alliance Auth (AA) that can be used to list blueprints for your corporation or alliance.

Overview

Features

• Lists all blueprints owned by corporation or alliance (configurable with permissions)
• Manage user requests for making copies of blueprints

Hint
Blueprints sends Auth notifications to inform users about blueprint requests. If you like to get those as direct messages on Discord please consider also installing Discord Notify.

Screenshots

Library

View Blueprint

Create a Request

My Requests

Open Requests

Manage Blueprints

Installation

Requirements

AA Blueprints needs the app django-eveuniverse to function. Please make sure it is installed before before continuing.

Steps

Step 1 - Install the Package

Make sure you are in the virtual environment (venv) of your Alliance Auth installation. Then install the newest release from PyPI:

pip install aa-blueprints

Step 2 - Configure AA

• Add 'blueprints' to INSTALLED_APPS in settings/local.py.
• Add the following automated task definition:

CELERYBEAT_SCHEDULE['blueprints_update_all_blueprints'] = {
    'task': 'blueprints.tasks.update_all_blueprints',
    'schedule': 10800, # 3 hours
}
CELERYBEAT_SCHEDULE['blueprints_update_all_industry_jobs'] = {
    'task': 'blueprints.tasks.update_all_industry_jobs',
    'schedule': 3600, # 1 hour
}
CELERYBEAT_SCHEDULE['blueprints_update_all_locations'] = {
    'task': 'blueprints.tasks.update_all_locations',
    'schedule': 43200, # 12 hours
}

Step 3 - Finalize App installation

Run migrations & copy static files:

python manage.py migrate
python manage.py collectstatic

Restart your supervisor services for Auth

Step 4 - Update EVE Online API Application

Update the Eve Online API app used for authentication in your AA installation to include the following scopes:

• esi-assets.read_assets.v1
• esi-assets.read_corporation_assets.v1
• esi-characters.read_blueprints.v1
• esi-corporations.read_blueprints.v1
• esi-industry.read_character_jobs.v1
• esi-industry.read_corporation_jobs.v1
• esi-universe.read_structures.v1

Step 5 - Data import

Load EVE Online type data from ESI:

python manage.py blueprints_load_types

Permissions

ID	Description	Notes
basic_access	Can access this app
request_blueprints	Can request blueprints
manage_requests	Can review and accept blueprint requests
add_personal_blueprint_owner	Can add personal blueprint owners
add_corporate_blueprint_owner	Can add corporate blueprint owners	:warning: Should only be given to directors or the CEO.
view_alliance_blueprints	Can view alliance's blueprints
view_industry_jobs	Can view details about running industry jobs	:warning: This permission will let someone see all industry job information.

Upgrading

See UPGRADING.md.

Authors

The main authors (in alphabetical order):

• Erik Kalkoken
• Rebecca Claire Murphy, aka Myrhea
• Peter Pfeufer, aka Rounon Dax