📖 1. Введение

1.1. Что такое Badminton Bot

Badminton Bot — это мультиплатформенное приложение для управления тренировками по бадминтону. Оно работает в Telegram и VK, позволяя:

Игрокам — записываться на тренировки, отслеживать свои записи, получать уведомления
Тренерам и администраторам — управлять тренировками, игроками, рассылать сообщения, контролировать записи

Приложение состоит из двух частей:

Клиентская часть — для игроков (запись, просмотр, настройки)
Административная часть — для управления всем процессом (эта документация)

1.2. Для чего нужна админ-панель

📅 Управление тренировками

Создавать, редактировать, отменять, дублировать тренировки

✍️ Управление записями

Добавлять и удалять игроков с тренировок, заменять участников

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

Просматривать, редактировать, архивировать игроков, назначать теги

📨 Рассылка сообщений

Отправлять уведомления выбранным группам игроков

📢 Анонсы тренировок

Оповещать игроков о новых тренировках

⚙️ Настройки клуба

Настраивать параметры работы для вашего клуба

1.3. Как войти в админ-панель

⚠️ Важно: Доступ к админ-панели имеют только пользователи с правами администратора.

Откройте приложение в VK (Mini App)
В правом верхнем углу нажмите на иконку переключения режимов
Выберите «В админ.»

🔽 Интерфейс переключения между клиентским и административным режимами

Или перейдите по прямой ссылке вида: https://vk.com/app[ID Вашего приложения]#/admin/list

1.4. Режимы: клиентский и административный

Режим	Назначение	Доступные разделы
Клиентский	Для игроков	Тренировки, Мои записи, Настройки
Административный	Для управления	Тренировки, Игроки, Рассылки, Настройки и др.

📅 2. Управление тренировками

2.1. Просмотр всех тренировок

В разделе «Тренировки» доступны три категории:

Актуальные тренировки — предстоящие и активные тренировки
Недавно завершённые — тренировки, которые только что закончились
Архив — старые тренировки (доступны через кнопку «Показать архив»)

2.2. Создание новой тренировки

Нажмите кнопку «Добавить тренировку»

🔽 Интерфейс добавления тренировки

Заполните обязательные поля: название, место, дата/время, длительность
Настройте лимиты: максимальное и минимальное количество участников, резерв
Укажите тренеров и цену (опционально)
Добавьте комментарий (опционально)
При необходимости укажите вопрос для игроков — при записи они обязаны будут ответить
Выберите теги тренировки
Нажмите «Сохранить»

💡 Совет: Если вы хотите, чтобы определённые игроки записывались автоматически при создании тренировки (в т.ч., при дублировании уже прошедшей тренировки), создайте список и укажите его в поле Автоматический список.

2.3. Редактирование тренировки

Нажмите на иконку меню (три точки) на карточке тренировки → выберите «Редактировать». Внесите изменения и сохраните.

⚠️ Внимание: Если вы меняете время тренировки, все записанные игроки получат уведомление об изменении. Об остальных изменениях в тренировке уведомления записанных игроков не будет.

2.4. Деактивировать / активировать тренировку

Нажмите на иконку меню (три точки) на карточке тренировки → выберите Деактивировать/Активировать. Таким образом Вы можете временно приостановить запись на тренировку (активность = 0). Приостановленная тренировка не отображается в списке для всех игроков. Её видят только уже записанные на неё игроки с соответствующей маркировкой (приостановка). При приостановке существующие записи сохранятся, но все записанные игроки получат соответствующее уведомление (о приостановке).

🔽 Так выглядит приостановленная (деактивированная) тренировка

2.5. Дублирование тренировки

Используйте функцию «Дублировать» в меню тренировки. Новая тренировка создастся на неделю вперёд с теми же параметрами. Сразу после дублирования вы будете перенаправлены в созданную тренировку, которая является "Приостановленной". Для того, чтобы игроки смогли увидеть данную тренировку, её необходимо "Активировать".

2.6. Удаление тренировки

⚠️ Удалить тренировку можно только если на неё никто не записан!
Рекомендуемый процесс удаления тренировки - 1. приостановите для отключения записи 2. отмените существующие записи на тренировку 3. удалите тренировку.

2.7. Просмотр деталей тренировки

Нажмите на карточку тренировки, чтобы увидеть:

Список участников (основные и резервные)
Комментарии участников к записи
Реакции (👍) от администраторов

✍️ 3. Управление записями

3.1. Добавление игрока на тренировку

Откройте страницу тренировки
Нажмите кнопку «Добавить игрока»
Выберите игрока из списка (доступны все игроки Вашего клуба)
При необходимости добавьте комментарий к записи
Нажмите «Добавить»

📌 Примечание: Пользователь, создавший данного игрока получит уведомление о том, что его игрок добавлен на тренировку.

3.2. Отмена записи

На странице тренировки рядом с записью необходимого игрока нажмите на иконку меню (три точки) и выберите соответствующий пункт. Подтвердите отмену. Игрок, запись которого была отменена администратором, получит уведомление об отмене только если было заполнено соответствующее поле (причина).

🔽 Отмена записи на тренировку администратором

3.3. Перенос записи

Любого записанного на тренировку игрока администратор может перенести на любую другую (созданную, активную, не прошедшую) тренировку, вне зависимости от тегов игрока и тренировки.

3.4. Поставить лайк

Функционал лайков даёт возможность обеспечивать обратную связь от администратора игрокам. Наиболее частый пример использования лайков - подтверждение получения предоплаты за игрока на данную тренировку. При простановке лайка пользователь, добавивший данного игрока на тренировку получит соответствующее уведомление.

👥 4. Управление игроками

🔽 Блок "Управление игроками"

4.1. Просмотр списка всех игроков

В режиме администрирования в разделе «Игроки» доступны:

Поиск — по имени, комментарию, телефону
Фильтр по тегам — показывать только игроков с определёнными тегами
Сортировка — по имени, дате регистрации, ближайшему дню рождения

4.2. Просмотр карточки игрока

Нажмите на игрока в списке, чтобы увидеть:

Фото, имя, дату рождения, возраст
Назначенные теги
Информацию о владельце (платформа, контакты)
Списки тренировок, в которых состоит игрок

4.3. Редактирование данных игрока

В карточке игрока измените нужные поля и нажмите «Сохранить».

4.4. Управление тегами игрока

В разделе «Теги» карточки игрока можно добавлять или удалять теги.

4.5. Архивация / удаление игрока

Если игрок был ранее записан хотя бы на одну тренировку, система не даст удалить его, но переведет его в статус "Архивные игроки". Игроки с данным статусом не отображаются в списках и выглядит это так, будто его более не существует. При этом, если игрок не был записан ни на одну тренировку, то при удалении запись уничтожается полностью и безвозвратно.

⚠️ Удаление игрока: Невозможно удалить (в т.ч. архивировать) игрока, у которого есть активные записи на тренировки. Сначала необходимо отменить все записи на активные (не прошедшие) тренировки.

🏷️ 5. Управление тегами

5.1. Создание тега

В разделе «Настройки» в режиме администрирования:

🔽 Блок "Управление игроками"

Перейдите к разделу Управление тегами
Нажмите «Добавить тег»
Введите название и выберите цвет
Нажмите «Сохранить»

🔽 Интерфейс "Управление тегами"

5.2. Назначение тегов игрокам и тренировкам

Теги можно назначать:

Игрокам — через карточку игрока (раздел «Теги»)
Тренировкам — при создании/редактировании тренировки

💡 Как это работает:

Пользователь увидит тренировку, если один или несколько тегов тренировки есть у любого игрока пользователя;
Пользователь сможет записать на тренировку только того игрока, у которого есть один или несколько тегов тренировки;
Тренировки без тегов доступны всем пользователям, на них можно записать любого игрока.
При назначении тега игроку пользователю отправляется соответствующее уведомление (какой тег присвоен и сколько тренировок доступно).

Важно! Рекомендуются короткие (1-2 слова), информативные наименования тегов. Теги являются публичной информацией, каждый пользователь видит, какие теги присвоены его игрокам.

Теги можно использовать для разграничения доступа пользователей к тренировкам по следующим критериям:

Уровень игры — Новички / Любители, Рейтинг ЛАБ (до 300, 300-400, 400-500 и т.п.), Группа (A,B,C,D,E, BC, DE, FG ....)
Дни недели и гео — например, если вы хотите для отдельной группы игроков выделить тренировки по средам в ФОКе, для всех будет понятен тег "Среда ФОК"
и мн. другое — не бойтесь экспериментировать с тегами. В любой момент любой тег можно удалить и он без последствий удалится у всех игроков, со всех тренировок.

📍 6. Управление местами тренировок

В разделе «Настройки» в режиме администрирования:

🔽 Интерфейс блока "Управление местами тренировок"

6.1. Добавление нового места

Перейдите в раздел «Места»
Нажмите «Добавить место»
Введите название, загрузите фото, добавьте комментарий
Нажмите «Сохранить»

6.2. Редактирование и удаление места

Нажмите на иконку редактирования ✏️ или удаления 🗑️ рядом с местом в списке.

📨 7. Рассылка сообщений

7.1. Создание рассылки

Перейдите в раздел «Сообщения»
Выберите получателей:
- Всем игрокам — все зарегистрированные игроки клуба
- По тренировке — участники конкретной тренировки
- По тегу — игроки с определённым тегом
- Конкретному игроку — выбранный игрок
Введите текст сообщения
Нажмите «Отправить»

📌 Примечание: Сообщение автоматически отправляется на платформу получателя (Telegram или VK).

7.2. Шаблоны сообщений

В разделе «Шаблоны» вы можете просматривать, редактировать и активировать/деактивировать шаблоны для разных типов уведомлений.

📢 8. Анонсы тренировок

8.1. Создание анонса

Откройте страницу тренировки
Нажмите на иконку меню → «Отправить анонс»
Система автоматически покажет количество потенциальных получателей
Нажмите «Отправить»

💡 Как это работает:

Анонс отправляется только тем пользователям, у которых есть игроки с соответствующими тренировке тегами;
Если в тренировке есть список автоматически записанных игроков (и игрок в списке на момент отправки анонса), ему отправляется соответствующее уведомление (вы записаны автоматически на тренировку);
Нет ограничений по количеству отправки анонсов, но рекомендуем не злоупотреблять количеством (при подтверждении отправки видна история предыдущих анонсов);
Если вы не отправите анонс вручную, он будет отправлен автоматически за 24 часа до тренировки.

8.2. Автоматические анонсы

Система автоматически отправит анонс за 24 часа до тренировки, если есть свободные места и анонс не был отправлен вручную ранее.

👤 9. Управление пользователями

9.1. Информация о пользователе

В карточке игрока отображается информация о его владельце: платформа регистрации (Telegram/VK), контактные данные.

9.2. Блокировка пользователя

В карточке игрока нажмите «Заблокировать пользователя» и выберите тип блокировки:

Только просмотр — может смотреть, но не записываться
Временная блокировка — блокировка на определённый срок
Полный бан — полная блокировка всех действий

📋 10. Списки игроков

Частый запрос от клубов - необходима т.н. основа (базовая группа игроков), у которой должно быть приоритетное право на запись, вне зависимости от того успели они записаться на тренировку или нет. Мы реализуем это через автоматическую запись на тренировку по спискам. Можно создать неограниченное количество списков под каждый тип тренировки. Автоматически записанный на тренировку игрок получает соответствующее уведомление и может отменить свою запись. Также, пользователь может в настройках запретить добавлять его игроков в автоматическую запись.

🔽 Интерфейс блока "Списки игроков"

10.1. Создание списка

Перейдите в раздел «Списки»
Нажмите «Создать»
Укажите название и цвет
Добавьте игроков в список
Нажмите «Сохранить»

10.2. Автоматическая запись через список

При создании тренировки укажите список в поле «Автоматический список». Игроки из этого списка будут автоматически записаны на тренировку.

💡 Совет: Используйте списки для постоянных участников, которые всегда приходят на определённые тренировки.

10.3. Редактирование списка

Перейдите в раздел «Списки»
Нажмите на иконку рядом с соответствующим списком.
Добавьте игроков в список
Нажмите «Сохранить»
Если нужно изменить состав участников в списке, нажмите на иконку рядом со соответствующим списком

Интерфейс просмотра состава списка игроков

🔽 Интерфейс просмотра состава игроков в блоке "Списки игроков"

Используйте стрелки вверх и вних для изменения позиций игроков в скиске. Используйте круговые стрелки для того, чтобы поменять игрока местами с другим выбранным. Корзина - удалить игрока из данного списка.

⚙️ 11. Настройки

11.1. Настройки клуба

Максимум игроков на пользователя — сколько игроков может добавить один пользователь
Настройки уведомлений по умолчанию — какие уведомления включены для новых пользователей

11.2. VK интеграция

Для работы с VK необходимо настроить:

VK App URL — ссылка на ваше VK Mini App
VK Group Token — токен группы для отправки сообщений
VK Group ID — идентификатор группы