PUBG Tournament Helper

Веб-приложение для организации и проведения турниров по игре PUBG (PlayerUnknown's Battlegrounds) с автоматизированной системой сбора статистики, подсчета очков и формирования турнирных таблиц.

🚀 Быстрый старт

Запуск приложения

npm install
npm start

Откройте браузер и перейдите по адресу http://localhost:4200

Сборка для продакшена

npm run build

📋 Функциональность

✅ Реализованные возможности

🏆 Управление турнирами

• Создание турниров в режимах Solo и Squad
• Автоматическое сохранение данных в localStorage
• Полная очистка данных турнира

🎯 Система подсчета очков

• Гибкая настройка очков за места:
  • Фиксированные очки (например: 1 место = 13 очков)
  • Множители очков (например: 1 место = x3 к убийствам)
• Настройка очков за убийства
• Готовые схемы подсчета:
  • По умолчанию (13/11/9/8/6/4/2/1 за места 1-8)
  • Киберспорт (15/12/10/8/6/4/2/1 за места 1-8)
  • Любительская (множители от x3 до x1)

📊 Загрузка и парсинг матчей

• Поиск по ID матча - прямой ввод Match ID
• Поиск по игроку - поиск последних 10 матчей игрока
• Множественный выбор матчей через удобное модальное окно
• Автоматическое кэширование для оптимизации запросов к API
• Демо-режим - работа без API ключа с тестовыми данными

👥 Управление командами

• Автоматическое формирование команд из первого матча
• Обнаружение конфликтов - когда игрок играет в разных командах
• Разрешение конфликтов:
  • Закрепление игрока за выбранной командой
  • Исключение игрока из турнира
  • Массовые действия для всех конфликтов

📈 Турнирные таблицы

• Командные результаты (Squad режим):
  • Позиция, название команды, очки, количество матчей
  • Общие убийства команды, среднее место
  • Список игроков в команде
• Индивидуальные результаты (Solo режим):
  • Позиция, имя игрока, очки, статистика
  • Урон, время выживания, средние показатели
• Переключение между видами команды/игроки
• Детализация по матчам с раскрывающимися блоками

💾 Экспорт данных

• JSON формат - полная структура турнира для последующего использования
• CSV формат - таблица результатов для работы в Excel/Google Sheets
• Автоматическое именование файлов с датой и названием турнира

🎮 Как использовать

1. Настройка API ключа (опционально)

• Получите API ключ на developer.pubg.com
• Введите ключ в поле "PUBG API Key"
• Без ключа приложение работает с демо-данными

2. Создание турнира

1. Введите название турнира
2. Выберите режим: Solo или Squad
3. Нажмите "Создать турнир"

3. Добавление матчей

Вариант A: По Match ID

1. Введите ID матча в соответствующее поле
2. Выберите правильный Shard (регион)
3. Нажмите "Добавить матч"

Вариант B: По игроку

1. Введите никнейм игрока
2. Нажмите "Найти матчи"
3. В открывшемся окне выберите нужные матчи
4. Нажмите "Добавить матчи"

4. Настройка системы очков

• Выберите режим подсчета: Solo или Team
• Настройте очки за убийства
• Выберите систему очков за места:
  • Фиксированные очки - добавляются к очкам за убийства
  • Множители - умножают очки за убийства
• Используйте готовые схемы или настройте вручную

5. Разрешение конфликтов команд

При обнаружении игроков в разных командах:

1. Автоматически откроется модальное окно
2. Для каждого игрока выберите действие:
   • Закрепить за одной из команд
   • Исключить из турнира
3. Нажмите "Применить решения"

6. Просмотр результатов

• Турнирная таблица обновляется автоматически
• Переключайтесь между видами "Команды" и "Игроки"
• Раскрывайте детали матчей для подробной статистики

7. Экспорт результатов

• JSON - для сохранения полной структуры турнира
• CSV - для работы с таблицами

🔧 Техническая информация

Технологический стек

• Frontend: Angular 18 (Standalone Components)
• Стилизация: Pure CSS with responsive design
• API: PUBG API для получения данных матчей
• Хранение: localStorage для автосохранения

Поддерживаемые платформы

• steam - Steam PC (по умолчанию и единственная поддерживаемая)

Структура проекта

src/
├── app/
│   ├── components/           # UI компоненты
│   │   ├── scoring-settings/ # Настройки системы очков
│   │   ├── tournament-standings/ # Турнирная таблица
│   │   ├── match-selection-modal/ # Выбор матчей
│   │   └── conflict-resolution-modal/ # Разрешение конфликтов
│   ├── services/            # Бизнес-логика
│   │   ├── pubg-match.service.ts # Работа с PUBG API
│   │   ├── tournament.service.ts # Управление турниром
│   │   └── storage.service.ts # Сохранение данных
│   └── models/              # Типы данных
│       └── tournament.interface.ts

🐛 Известные ограничения

1. CORS ограничения - требуется PUBG API ключ для реальных данных
2. Кэширование браузера - данные сохраняются локально
3. Язык интерфейса - только русский

📝 Лицензия

Проект создан для демонстрационных целей. Свободное использование.

---

Создано с помощью Claude Code