Indy Hub for Alliance Auth

A modern industry and material‑exchange management module for Alliance Auth, focused on blueprint sharing, job tracking, and corp trading workflows for EVE Online alliances and corporations.

<hr />

Table of Contents

• About
• Features
• Requirements
• Installation
• Bare Metal
• Docker
• Common
• Permissions
• Base Access (Required for all users)
• Corporation Management (Optional)
• Material Exchange Administration (Optional)
• Settings
• Updating
• Usage
• Screenshots
• Contributing

<hr />

About

Current Highlights

• Industry Jobs refresh behavior: live ESI skill refresh is now explicit on the jobs page (Force Refresh) instead of running on every render.
• Jobs freshness visibility: the jobs header now shows Last update to clarify current data recency.
• Settings render performance: settings hub uses a lightweight context path to reduce page render latency.
• Token Management safety/perf: render paths avoid live token refresh side effects and use passive validity filtering for scope coverage.
• User activity gating: manual refresh gating now uses Corptools last_known_login when available, and falls back permissively when Corptools is absent or has no usable login data.
• Industry Structures performance: resolved structure bonuses are cached persistently and invalidated only when relevant structure/rig signature fields change.

Features

• Blueprint Library: Browse, search, and manage personal and corporation blueprints.
• Industry Jobs: Track active and completed manufacturing, research, and invention jobs.
• Blueprint Copy Requests: Create requests, receive offers, chat with builders, and follow delivery status.
• Sharing Controls: Configure who can see and fulfill blueprint copy requests.
• Material Exchange: Submit buy/sell orders and follow validation/processing from one hub.
• Order Tracking: View clear statuses, timelines, and history for your requests and orders.
• Notifications: Receive in-app updates for key events (offers, deliveries, job updates).
• Analytics Hooks: Emits Alliance Auth analytics events for key Material Exchange lifecycle transitions.
• Admin Tools: Manage corp blueprint workflows and Material Exchange operations with dedicated admin views.
• Modern UI: Responsive, theme-friendly interface designed for daily operational use.

Requirements

• Alliance Auth v5.x
• Python 3.12+
• Django 5.2
• django-esi 9.x
• django-eveonline-sde 0.0.1+ (base SDE data)
• Celery (for background sync and notifications)
• (Optional) Director characters for corporate dashboards
• (Optional) Corptools, to provide corptools_characteraudit.last_known_login for activity-aware refresh gating. If absent, Indy Hub falls back to permissive behavior.
• (Optional) aa-charlink to let users authorize Indy Hub scopes through CharLink
• (Optional) aadiscordbot (preferred) or discordnotify for Discord notifications

<hr />

Installation

Bare Metal

pip install django-eveonline-sde indy-hub

Add to your local.py:

INSTALLED_APPS = [
    "eve_sde",
    "indy_hub",
]

Ensure the base eve_sde data is already loaded by following the official django-eveonline-sde setup process before using Indy Hub.

Run migrations and collect static files:

python manage.py migrate
python manage.py collectstatic --noinput

Restart services:

systemctl restart allianceauth

Docker

docker compose exec allianceauth_gunicorn bash
pip install django-eveonline-sde indy-hub
exit

Add to your conf/local.py:

INSTALLED_APPS = [
    "eve_sde",
    "indy_hub",
]

Add to your conf/requirements.txt (Always use current versions)

indy-hub==1.18.2

Ensure the base eve_sde data is already loaded in your stack by following the official django-eveonline-sde setup process before using Indy Hub.

Run migrations and collect static files:

docker compose exec allianceauth_gunicorn bash
auth migrate
auth collectstatic --noinput
exit

Restart Auth:

docker compose build
docker compose down
docker compose up -d

Common

• Set permissions in Alliance Auth (see Permissions).
• Authorize ESI tokens for blueprints and industry jobs.
• If aa-charlink is installed, Indy Hub is auto-discovered by CharLink and exposes three login options: personal Indy Hub scopes, corporation admin scopes, and Material Exchange scopes. The two admin options are intentionally not selected by default because they request broader corporation access.

<hr />

Permissions

Assign permissions in Alliance Auth to control access levels:

Base Access (Required for all users)

• Visible in admin: "indy_hub | can access Indy_Hub"
• View and manage personal blueprints
• Create and manage blueprint copy requests
• Use Material Exchange (buy/sell orders)
• View personal industry jobs
• Configure personal settings and notifications

Corporation Management (Optional)

• Visible in admin: "indy_hub | can admin Corp"
• View and manage corporation blueprints (director only)
• Handle corporation blueprint copy requests (accept/reject corp BP copy sharing)
• Access corporation industry jobs
• Configure corporation sharing settings
• This role is not meant for everyone — only for people who manage corp BPs (they can handle contracts for corpmates)
• Requires ESI director roles for the corporation

Material Exchange Administration (Optional)

• Visible in admin: "indy_hub | can admin MatExchange"
• Configure Material Exchange settings
• Manage stock availability
• View all transactions
• This role is not meant for everyone — only for people who manage the hub (they accept/reject buy and sell orders made to the corp)
• Admin panel access

Note: Permissions are independent and can be combined. Most users only need can access Indy_Hub.

<hr />

Settings

Customize Indy Hub behavior in local.py:

# Discord notifications
INDY_HUB_DISCORD_DM_ENABLED = True  # Default: True
INDY_HUB_NOTIFICATION_DISPATCH_MODE = (
    "discord_direct_only"  # aa_only | discord_direct_only | both
)
INDY_HUB_NOTIFICATION_IDEMPOTENCY_TTL_SECONDS = 300  # Default: 300s
INDY_HUB_DISCORD_ACTION_TOKEN_MAX_AGE = 86400  # Default: 24 hours

# ESI task staggering (rate-limit friendly scheduling)
INDY_HUB_ESI_TASK_STAGGER_THRESHOLD = 0  # Default: 0
INDY_HUB_ESI_TASK_TARGET_PER_MIN_BLUEPRINTS = 90  # Default: 90
INDY_HUB_ESI_TASK_TARGET_PER_MIN_JOBS = 60  # Default: 60
INDY_HUB_ESI_TASK_TARGET_PER_MIN_SKILLS = 80  # Default: 80
INDY_HUB_ESI_TASK_TARGET_PER_MIN_ROLES = 60  # Default: 60
INDY_HUB_BLUEPRINTS_BULK_WINDOW_MINUTES = 0  # Default: 0
INDY_HUB_INDUSTRY_JOBS_BULK_WINDOW_MINUTES = 0  # Default: 0

# Stale refresh thresholds (hours)
INDY_HUB_SKILL_SNAPSHOT_STALE_HOURS = 24  # Default: 24
INDY_HUB_ROLE_SNAPSHOT_STALE_HOURS = 24  # Default: 24
INDY_HUB_STRUCTURE_NAME_STALE_HOURS = 24  # Default: 24

Notification dispatch modes:

• aa_only: persist Alliance Auth notifications only (recommended when a proxy already relays AA notifications to Discord).
• discord_direct_only: send direct Discord DM first; fallback to Alliance Auth notifications when direct delivery fails.
• both: persist Alliance Auth notifications and send direct Discord DMs (explicit opt-in).

Scheduled Tasks (auto-created):

• indy-hub-update-all-blueprints → Daily at 03:30 UTC
• indy-hub-update-all-industry-jobs → Every 2 hours
• indy-hub-refresh-stale-snapshots → Hourly (skills/roles/structures)

<hr />

Updating

For release-specific operational notes, see docs/UPGRADE_NOTES.md.

Bare Metal Update

# Update the package
pip install --upgrade indy-hub

# Apply migrations
python manage.py migrate

# Collect static files
python manage.py collectstatic --noinput

# Restart services
systemctl restart allianceauth

Docker Update

Update Versions in conf/requirements.txt (Always use current versions)

indy-hub==1.18.2

Update the Package:

# Exec Into the Container
docker compose exec allianceauth_gunicorn bash

# Update the package
pip install -U indy-hub

# Apply Migrations
auth migrate

# Collect static files
auth collectstatic --no-input

# Restart Services
exit
docker compose build
docker compose down
docker compose up -d

If Celery runs in dedicated containers/services in your stack, also restart worker and beat/scheduler containers.

<hr />

Usage

1. Navigate to Indy Hub in the Alliance Auth dashboard
2. Authorize ESI for blueprints and jobs via the settings

3. View Your Data:

4. Personal blueprints and industry jobs

5. Corporation blueprints (if director)
6. Pending blueprint copy requests

7. Material Exchange buy/sell orders and transaction history

8. Share Blueprints: Set sharing scopes and send copy offers to alliance members

9. Receive Notifications: View job completions and copy request updates in the notification feed

<hr />

Screenshots

Below are a few UI highlights from the current release.

Dashboard Overview

Blueprint Library

Blueprint Copy Requests

Material Exchange Hub

Order Requests

Discord Notifications

User Settings

<hr />

Contributing

• Open an issue or pull request on GitHub for help or to contribute Or contact me on discord: erkaek

<hr />

No reviews yet...

Python Requirements

• allianceauth<6,>=5
• allianceauth-app-utils>=1
• django-esi>=9.6
• django-eveonline-sde>=0.0.1b11
• requests>=2.31
• aadiscordbot; extra == "aadiscordbot"
• aa-discordnotify>=2; extra == "discordnotify"

Required Python packages to be installed and other Python requirement.

App Dependencies

Required apps:

• Allianceauth App Utils
• Discord Notify
• Django Models from EVE SDE
• django-esi

Used by apps:

-

Dependencies to other apps registered in this app directory.

Classifiers

• Environment :: Web Environment
• Framework :: Celery
• Framework :: Django
• Framework :: Django :: 5.2
• Intended Audience :: Developers
• License :: OSI Approved :: MIT License
• Operating System :: OS Independent
• Programming Language :: Python
• Programming Language :: Python :: 3 :: Only
• Programming Language :: Python :: 3.10
• Programming Language :: Python :: 3.11
• Programming Language :: Python :: 3.12
• Programming Language :: Python :: 3.13
• Programming Language :: Python :: Implementation :: CPython
• Topic :: Internet :: WWW/HTTP
• Topic :: Internet :: WWW/HTTP :: Dynamic Content