aa-market-manager 0.1.2a0

AllianceAuth Market Management Tool

Market Manager for Alliance Auth

Market Manager and Market Browser plugin for Alliance Auth.

Features

• Market Browser

  • Item Search with Autocomplete
  • Buy/Sell Orders
  • Item Statistics (WIP)

• Fetching Public orders by selectable Regions

• Fetching Character Orders from provided Tokens

  • Will append EveCharacter (and more) details to orders gathered from other means

• Fetching Corporation Orders from provided Tokens

  • Will append EveCorporation (and more) details to orders gathered from other means
  • Minor sanity checking to check for ingame Roles before hitting market ESI to reduce errors from tokens with no access to data.

• WIP Structure ID Resolver

  • Resolves Stations via Django-EveUniverse EveEntity resolver
  • Resolves Citadels internally
    • Fetches Corporation Citadels from Corporation Tokens loaded with the appropriate EVE Roles ("Station_Manager")
    • get_universe_structures_structure_id requires docking ACL Access. As there is no way to tell who has docking (even the owner corporation is not a guarantee),

• Will detect and use any tokens loaded by other means, if you request the scopes as part of a wider scoped app (Such as an Audit tool etc.)

Planned Features

• Configurable Alerts
  • Quantity and/or Price Orders.
• Item Statistics, Currently only Volume is calculated, welcoming advice on Medians and Percentiles in Django
• Manually defining Tokens that are on ACLs for use in pulling structures from the get_universe_structures_structure_id endpoint which wont require Station_Manager.

Installation

Step 1 - Django Eve Universe

Market Manager is an App for Alliance Auth, Please make sure you have this installed. Market Manager is not a standalone Django Application

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

Step 2 - Install app

pip install aa-market-manager

Step 3 - Configure Auth settings

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

• Add 'marketmanager' to INSTALLED_APPS
• Add below lines to your settings file:

## Settings for AA-MarketManager
# Market Orders
CELERYBEAT_SCHEDULE['marketmanager_fetch_public_market_orders'] = {
    'task': 'marketmanager.tasks.fetch_public_market_orders',
    'schedule': crontab(minute=0, hour='*/3'),
}
CELERYBEAT_SCHEDULE['marketmanager_fetch_all_character_orders'] = {
    'task': 'marketmanager.tasks.fetch_all_character_orders',
    'schedule': crontab(minute=0, hour='*/3'),
}
CELERYBEAT_SCHEDULE['marketmanager_fetch_all_corporation_orders'] = {
    'task': 'marketmanager.tasks.fetch_all_corporation_orders',
    'schedule': crontab(minute=0, hour='*/3'),
}
# Structure Information
CELERYBEAT_SCHEDULE['marketmanager_fetch_public_structures'] = {
    'task': 'marketmanager.tasks.fetch_public_structures',
    'schedule': crontab(minute=0, hour=0, day_of_week=3),
}
CELERYBEAT_SCHEDULE['marketmanager_fetch_all_corporations_structures'] = {
    'task': 'marketmanager.tasks.fetch_all_corporations_structures',
    'schedule': crontab(minute=0, hour='*/3'),
}

Step 4 - Maintain Alliance Auth

• Run migrations python manage.py migrate
• Gather your staticfiles python manage.py collectstatic
• Restart your project supervisorctl restart myauth:

Step 4 (Optional) - Pre-Load Django-EveUniverse

This is less required the more you have used eveuniverse in the past

• python manage.py eveuniverse_load_data map This will load Regions, Constellations and Solar Systems

Step 5 - Configure Further

In the Admin interface, visit marketmanager > config > add or <AUTH-URL>/admin/marketmanager/config/add/ Select the Regions you would like to pull Public Market Data for.