br-compensations 0.0.56

Плагин Alliance Auth для управления боевыми компенсациями

BR Compensations

Плагин Alliance Auth учета компенсаций потерь в EVE Online.

Описание

BR Compensations — это плагин для Alliance Auth, который позволяет вести учет компенсаций за потери кораблей на боевых вылетах.

Возможности

• 📊 Разбор боевых отчетов и загрузка киллмэйлов
• 🌐 Интеграция с EVE API через eveuniverse
• 📱 Адаптивный интерфейс

Требования

• Python 3.8+
• Alliance Auth 4.11.2+
• Django 3.2+
• eveuniverse 1.4.0+

Установка

1. Установка через pip

pip install br-compensations

2. Настройка Alliance Auth

Добавьте 'br_compensations' в INSTALLED_APPS в файле local.py:

INSTALLED_APPS = [
    # ... другие приложения
    'eveuniverse',
    'br_compensations',
]
#Автоматическая обработка баттл репортов и киллмэйлов
CELERYBEAT_SCHEDULE['battlereports_processor'] = {
    'task': 'br_compensations.tasks.process_queued_links',
    'schedule': crontab(minute='*/5'),
}
#Автоматическая загрузка киллов из внутриигровой почты персонажей
CELERYBEAT_SCHEDULE['battlereports_fetch_char_mail'] = {
    'task': 'br_compensations.tasks.fetch_characters_mails',
    'schedule': crontab(minute='*/5'),
}
#Автоматическая загрузка баттл репортов с br.evetools.org
CELERYBEAT_SCHEDULE['Get new battle reports'] = {
    'task' : 'br_compensations.tasks.load_battle_reports',
    'schedule': crontab(minute='*/30')
}

3. Применение миграций

python manage.py migrate br_compensations

4. Сбор статических файлов

python manage.py collectstatic

5. Перезапуск сервера

# Если используете systemd
sudo systemctl restart myauth

# Или если используете supervisor
sudo supervisorctl restart myauth

Настройка

Права доступа

Плагин использует следующие права доступа:

Право	Описание
br_compensations.can_manage	Доступ к модулю компенсаций

Настройте права доступа через админ-панель Alliance Auth: Auth → Permissions.

Настройка URL

URL автоматически добавляются через auth_hooks.py. Доступ к модулю осуществляется через главное меню Alliance Auth.

Использование

Управление статусом компенсаций

• Pending — ожидает обработки
• Approved — одобрено к выплате
• Paid — выплачено
• Rejected — отклонено

Конфигурация

API

Плагин предоставляет REST API для интеграции с внешними системами.

Эндпоинты

• GET /api/br-compensations/reports/ — список всех отчётов
• POST /api/br-compensations/reports/ — создание нового отчёта
• GET /api/br-compensations/reports/{id}/ — детали отчёта
• GET /api/br-compensations/compensations/ — список компенсаций
• POST /api/br-compensations/compensations/calculate/ — расчёт компенсаций

API требует аутентификации через токен Alliance Auth.

Поддержка

• Баг-трекер: https://git.misyagin.com/ekzoman/br_compensations/issues

Лицензия

Этот проект распространяется под лицензией MIT. Подробности см. в файле LICENSE.

Благодарности

• Команде Alliance Auth за отличную платформу
• Сообществу EVE Online за вдохновение