autosrp 0.0.2

Automatic SRP Review

Auto SRP

A streamlined Ship Replacement Program (SRP) management app for AllianceAuth.

Contents

• Overview
• Key Features
• Installation
• Updating
• Settings
• Permissions

Overview

Auto SRP helps alliances and corporations manage ship replacement submissions, reviews, and payouts end to end. Automatically. Without user submissions.

Key Features

• FC-driven submissions

  • Pilots do not submit losses, FCs (or users with the submit permission) create SRP reports.
  • Automatic: paste a zKill “related” link or a (beta) EVE Tools BR link to auto-fill systems and time.
  • Manual: specify systems and time window, the expected doctrine, and eligible alliances/corporations (org filter.
  • FCs have access to see reports they have submitted.

• Doctrine fit matching (https://gitlab.com/colcrunch/fittings)

  • Losses are matched against doctrine fits automatically.
  • Reviewers can change the selected fit and re-run the fit check at any time.

• Payout calculation and overrides

  • Suggested payouts are computed from base rewards (if configured, otherwise it uses market data) with configurable penalty schemes.
  • Reviewers can override the payout per kill when needed.
  • The application provides a detailed report of the match, including the doctrine, the fit, and the payout. Simply click details.

• Review workflow

  • Add or remove kills from a report, then approve or reject with optional comments.
  • If the character is attached to the user in AA and they have Discord configured, the user will be notified on approval/rejection (including comments).
    • Users can disable this notification on an individual level.

• Configurable penalties

  • Define penalty schemes (per-missing/wrong module), optionally include rigs/subsystems, and set a max cap.

• Flexible rewards

  • Set base rewards per doctrine and ship, enabling fixed payouts independent of market prices.

• Analytics

  • Manager and user-level dashboards: submission counts, payouts, loss values, and trends.
  • Users also have the same stats, but specific to them.

Installation

1. Install the app

Install into your AllianceAuth virtual environment via pip.

pip install autosrp

2. Configure AA settings

• Add 'autosrp' to INSTALLED_APPS
• Optionally, configure settings from the Settings section below to enable integrations and tune fit checking

3. Finalize install

Run migrations and collect static files.

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

Then restart your AA services.

Run the following command to create the initial item data.

python manage.py autosrp_preload_data

Once it has finished, you can create the initial price data.

python manage.py refresh_item_prices

Configuring before use

1. Configure Orgranization Filters (done only in the admin menu)

1.1 [99009902] or [99009902, 99009903]

2. Configure Doctrine Base Awards If Needed

3. Configure Penalties If Needed

Updating

pip install -U autosrp

Run migrations and collectstatic.

Settings

Setting	Default	Description
AUTOSRP_JANICE_API_KEY	""	Optional API key for Janice pricing lookups when available.
AUTOSRP_FITCHECK_IGNORE_CATEGORY_IDS	{8, 18, 20, 5}	Category IDs to ignore during doctrine/fit comparison.
AUTOSRP_FITCHECK_IGNORE_GROUP_NAMES	{"Festival Launcher"}	Eve group names to ignore during doctrine/fit comparison.

Integrations auto-detection:

• AA Discordbot: enabled when the aadiscordbot app is installed
• AA Discord Notify: enabled when the discordnotify app is installed
• Discord Proxy: detected if discordproxy is installed and importable

Scheduled task for updating prices

CELERYBEAT_SCHEDULE['autosrp_update_all_prices'] = {
    'task': 'autosrp.services.services_update.update_all_prices',
    'schedule': crontab(minute=0, hour=3, day_of_week='sun'),
}

Permissions

Permission	Description
autosrp.manage	Can manage Auto SRP settings.
autosrp.submit	Can submit Auto SRP requests.
autosrp.review	Can review Auto SRP batches.