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',
]
3. Настройка Celery Beat
# Автоматическая обработка баттл репортов и киллмэйлов
CELERYBEAT_SCHEDULE['Process scheduled reports'] = {
'task': 'br_compensations.tasks.process_queued_links',
'schedule': crontab(minute='*/5'),
}
# Автоматическая загрузка киллов из внутриигровой почты персонажей
CELERYBEAT_SCHEDULE['Get kills from user inbox'] = {
'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')
}
4. Применение миграций
python manage.py migrate br_compensations
5. Сбор статических файлов
python manage.py collectstatic
6. Перезапуск сервера
# Если используете 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.
Использование
Управление статусом компенсаций
| Статус | Код | Описание |
|---|---|---|
| Новый | N |
Ожидает обработки |
| Компенсирован | C |
Одобрено к выплате |
| Отклонен | R |
Отклонено |
Управление статусом боевых отчетов
| Статус | Код | Описание |
|---|---|---|
| Новый | N |
Ожидает обработки |
| В обработке | P |
Обрабатывается |
| Завершен | C |
Успешно обработан |
| Ошибка | F |
Ошибка обработки |
| Переинициализация | R |
Требуется повторная обработка |
API
Плагин предоставляет REST API для интеграции с внешними системами.
Эндпоинты
Боевые отчеты
GET /api/battle-reports/— список всех отчётовPOST /api/battle-reports/— создание нового отчётаGET /api/battle-reports/{id}/— детали отчётаPATCH /api/battle-reports/{id}/— обновление отчёта
Киллмэйлы
GET /api/killmails/— список киллмэйловGET /api/killmails/{id}/— детали киллмэйлаPATCH /api/killmails/{id}/— обновление статуса киллмэйла
Фильтры
GET /api/filters/— список фильтровPOST /api/filters/— добавление фильтраDELETE /api/filters/{id}/— удаление фильтра
Парсер почты
GET /api/mailparser/— список персонажей для парсинга почтыPOST /api/mailparser/— добавление персонажаDELETE /api/mailparser/{id}/— удаление персонажа
Поиск сущностей
POST /api/filter-term/find— поиск сущностей в EVE Universe
API требует аутентификации через токен Alliance Auth.
Конфигурация
Настройка прокси
Для работы с внешними API через прокси настройте параметры в админ-панели:
| Параметр | Описание |
|---|---|
| HTTP Proxy | HTTP прокси (формат: http://host:port) |
| HTTPS Proxy | HTTPS прокси (формат: https://host:port) |
| SOCKS5 Proxy | SOCKS5 прокси (формат: socks5://host:port) |
Типы активности
| Тип | Код | Описание |
|---|---|---|
| CTA | C |
Call To Arms |
| HOMEDEF | H |
Home defence |
| OTHER | O |
Other |
Задачи Celery
| Задача | Интервал | Описание |
|---|---|---|
process_queued_links |
5 мин | Обработка отложенных ссылок |
fetch_characters_mails |
5 мин | Загрузка киллов из почты |
load_battle_reports |
30 мин | Загрузка БР с br.evetools.org |
fetch_all_characters_mails |
по требованию | Полная загрузка почты |
process_mass_action |
по требованию | Массовая обработка киллмэйлов |
Поддержка
Лицензия
Этот проект распространяется под лицензией MIT. Подробности см. в файле LICENSE.
Благодарности
- Команде Alliance Auth за отличную платформу
- Сообществу EVE Online за вдохновение
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distributions
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file br_compensations-0.1.27-py3-none-any.whl.
File metadata
- Download URL: br_compensations-0.1.27-py3-none-any.whl
- Upload date:
- Size: 232.3 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.2.0 CPython/3.12.12
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
e820d4ca20c7bcbeefebbf148452e4eb467d5f0e84a4e649278edea43d84562a
|
|
| MD5 |
00331eccf4c31a9152d79be10cfb0c46
|
|
| BLAKE2b-256 |
7439a8ac81e4f171f47b0ba23a94c2bc32859813bfe44ffa436535940e323b3b
|
