aa-blueprint-forge

AA Blueprint Forge

A Blueprint Forge App for Alliance Auth

---

• AA Blueprint Forge
  • Features
  • Screenshots
  • Installation
    • Step 1 - Install the Package
    • Step 2 - Configure Alliance Auth
    • Step 3 - Add the Scheduled Tasks
    • Step 3.1 - (Optional) Add own Logger File
    • Step 4 - Migrate & Preload EVE SDE Data
    • Step 4.1 - Migrate App and collect static
    • Step 5 - Setting up Permissions
    • Step 6 - (Optional) Setting up Compatibilies
  • Translations
  • Contributing

Features

• Interactive Blueprint Catalog & Directory:
  • Browse public blueprints offered by characters and corporations across your alliance.
  • Global blueprint search in the catalog directory with real-time preview of matching blueprints on provider cards.
  • Filter blueprints by type (Originals / BPOs, Copies / BPCs), group, and location.
  • Dedicated /overview/ route with direct navigation and deep-linking into provider catalogs.
• Batch Ordering System & Shopping Cart:
  • Add multiple blueprints across different providers into a unified shopping cart.
  • Customize requested runs and copy quantities per item with optional customer notes.
  • Complete order workflow with status tracking (Pending, Accepted, Delivered, Declined, Cancelled).
  • Dedicated order management dashboard with tab filtering, order history, and deletion.
  • Role-based manager permissions for order oversight (global and corporation-scoped).
• Personal & Corporation Inventory (My Blueprints):
  • Comprehensive overview of your own personal and corporation blueprint inventories.
  • Interactive KPI summary cards for quick filtering between BPOs and BPCs.
  • Detailed blueprint stats including Material Efficiency (ME), Time Efficiency (TE), runs, and storage locations.
• Flexible Catalog Offering & Privacy Controls:
  • Toggle public or private visibility for each character and corporation catalog.
  • Configurable offering modes: Offer all blueprints, BPOs only, or BPCs only.
  • Selective BPO offering: Selectively publish specific BPOs while keeping sensitive blueprints unlisted.
• Automated EVE Online ESI Synchronization:
  • Background synchronization for blueprints, character/corporation assets, stations, and citadels via Celery tasks.
  • Live status indicators, timestamp tracking, and error reporting in the settings dashboard.
• Discord & Alliance Auth Notifications:
  • Instant Discord notifications for new orders and order status changes with direct order links.
  • Configurable notification recipient groups globally and per owner.
• Superuser Administration Dashboard:
  • Dedicated /superuser/ administration view to inspect all owners and raw inventories across the installation.
  • On-demand sync task triggers and global notification group configuration.
• Modern Responsive React SPA:
  • Built with React, TypeScript, and Vite for a fast and fluid user experience.
  • Dark-mode optimized design with responsive tables, loading animations, and standardized modals.
• Multi-Language Support:
  • Full localization support for English and German.

Screenshots

Installation

[!NOTE] AA Blueprint Forge needs at least Alliance Auth v5 Please make sure to update your Alliance Auth before you install this APP

Step 1 - Install the Package

Make sure you're in your virtual environment (venv) of your Alliance Auth then install the pakage.

pip install aa-blueprint-forge

Step 2 - Configure Alliance Auth

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

INSTALLED_APPS = [
    # other apps
    "eve_sde",  # only if it not already existing
    "bpforge",
    # other apps?
]

# This line is right below the `INSTALLED_APPS` list, if not already exist!
INSTALLED_APPS = ["modeltranslation"] + INSTALLED_APPS

Step 3 - Add the Scheduled Tasks

To set up the Scheduled Tasks add following code to your local.py

if "bpforge" in INSTALLED_APPS:
    CELERYBEAT_SCHEDULE["AA Blueprint Forge :: Update Blueprints"] = {
        "task": "bpforge.tasks.update_all_blueprints",
        "schedule": 600,
    }

Step 3.1 - (Optional) Add own Logger File

To set up the Logger add following code to your local.py Ensure that you have writing permission in logs folder.

LOGGING["handlers"]["bpforge_file"] = {
    "level": "INFO",
    "class": "logging.handlers.RotatingFileHandler",
    "filename": os.path.join(BASE_DIR, "log/bpforge.log"),
    "formatter": "verbose",
    "maxBytes": 1024 * 1024 * 5,
    "backupCount": 5,
}
LOGGING["loggers"]["extensions.bpforge"] = {
    "handlers": ["bpforge_file"],
    "level": "DEBUG",
}

Step 4 - Migrate & Preload EVE SDE Data

AA Blueprint Forge uses EVE SDE data to map IDs to names for EveTypes. You will need to preload some data from SDE once.

python manage.py migrate eve_sde
python manage.py esde_load_sde

Step 4.1 - Migrate App and collect static

Migrate the app and collect static.

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

Step 5 - Setting up Permissions

With the Following IDs you can set up the permissions for Blueprint Forge

Step 6 - (Optional) Setting up Compatibilies

The Following Settings can be setting up in the local.py

• BPFORGE_APP_NAME: "YOURNAME" - Set the name of the APP
• BPFORGE_TASKS_TIME_LIMIT: 7200 - Defines the time (in seconds) a task will timeout

If you set up BPFORGE_LOGGER_USE to True you need to add the following code below:

Translations

Help us translate this app into your language or improve existing translations. Join our team!"

Contributing

You want to improve the project? Please ensure you read the Contribution Guidelines