Руководство пользователя (онбординг и механики)

Это краткое и наглядное описание того, как работать с системой: роли, группы, мероприятия, бронирования и оповещения.

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

• Добавьте бота @jem_reminder_bot в вашу Telegram‑группу.
• Откройте мини‑приложение (портал) через Telegram (кнопка есть в профиле бота).
• Выберите созданную группу. Вы будете считаться ее владельцем.
• Задайте базовые настройки группы: роли для бронирования и оповещения по умолчанию.
• Создайте мероприятие и проверьте, как приходят групповые/личные оповещения.

👤 Роли и доступ

• Владелец: полный контроль над группой и участниками; может удалять группу и передавать владение.
• Админ: управляет пользователями и мероприятиями в группе.
• Участник: видит мероприятия, бронирует роли, получает/настраивает личные напоминания, снимает свои брони.

Передача владения: владелец может передать права другому участнику; сам станет админом.

🤖 Добавление бота и участников

• Владелец добавляет бота @jem_reminder_bot в Telegram‑группу.
• Участников можно добавлять в мини‑приложении на странице настроек группы:
• по Telegram ID,
• по никнейму (@username),
• по номеру телефона.
• так же участник добавится автоматически при первом бронировании любой роли мерпориятия в группе.

✅ Подтверждение новых пользователей (ожидание/старт)

• Если человек ещё не пользовался ботом, он попадает в лист ожидания подтверждения.
• Когда человек запускает бот командой `/start`, система:
• проверяет по его Telegram ID/никнейму — если есть неподтверждённая запись, подтверждает автоматически;
• если записей по ID/нику нет, но есть ожидание по номеру телефона, бот попросит отправить номер (кнопкой). После подтверждения телефон связывается, и пользователь добавляется в группу.

🛠 Настройки группы (по умолчанию)

Владелец/админ может задать шаблоны, которые применяются к новым мероприятиям:

• Роли для бронирования (например: Ведущий, Техник, Оператор).
• Групповые оповещения (когда и что отправлять в групповой чат для бронирования или напоминания).
• Личные оповещения (когда напоминать участнику о мероприятии).

Настройки по умолчанию используются при создании мероприятий вручную.

📅 Создание мероприятий

• Нажмите «Создать мероприятие». Можно создать одно или сразу несколько событий.
• К событиям автоматически привяжутся:
• роли для бронирования из настроек группы,
• групповые оповещения.
• Личные оповещения создаются автоматически, когда пользователь бронирует роль. Так же любой участник может добавить личные оповещения, даже если он его не забронировал.

🎫 Бронирование ролей

• Участник может бронировать/снимать бронь для себя.
• Владелец/админ может назначить участника на роль (как будто он сам забронировал).
• При брони роли пользователю назначаются личные оповещения в соответствии с настройками группы.

🔔 Оповещения

• Групповые: отправляются в чат группы в заданное время; владелец/админ может добавлять/удалять и отправлять «сейчас» (с кнопками бронирования/отмены).
• Личные: приходят пользователю в личные сообщения в заданное время. Если ролей у пользователя нет — строка с ролями не добавляется (сообщение короче и чище).

👑 Назначение ответственных

Владелец/админ может назначить ответственным конкретного участника на роль прямо из карточки мероприятия. Это эквивалентно обычной брони от имени участника и учитывается в уведомлениях и аналитике.

📊 Аналитика

Доступна владельцу/админу:

• количество мероприятий по дням,
• кто бронировал роли (статистика по пользователям),
• сколько свободных ролей осталось (по типам),
• фильтры по периоду и по пользователям.

📜 Аудит (журнал действий)

Владелец/админ видит историю изменений: создание/редактирование мероприятий, бронирование/снятие брони, создание/удаление оповещений и т. п.

🏷 Отображаемые имена

Для каждого пользователя в каждой группе можно задать отображаемое имя (display name), чтобы в интерфейсе брони были удобнее читаемы.

💬 Сообщения от имени бота

Владелец/админ может отправлять сообщения в группу или лично пользователю от имени бота (для важных объявлений и напоминаний).

📂 Активные и архив

• Во вкладке Активные — события, которые позже текущего времени.
• Всё, что прошло, попадает в Архив.

🔁 Повторяющиеся мероприятия

• Любое мероприятие можно сделать повторяющимся (шаблон).
• Поддерживается ручная генерация событий на заданный горизонт (например, «каждую неделю на 60 дней вперёд»).
• В настройках видно, на какие дни будут созданы мероприятия перед подтверждением.

Нужна помощь или есть идеи по улучшению? Свяжитесь с админом/владельцем группы или суперадмином проекта.