Telegram-бот — розыгрыши и конкурсы с проверкой подписки и рефералкой

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

1. Конкурс. Вы создаёте конкурс в чате за 8 шагов и запускаете его. Ссылка на конкурс показана в карточке: разместите её в канале.
2. Участие. Человек читает правила, соглашается на обработку данных и получает билет с номером и личным кодом.
3. Приглашения. По желанию участник делится своей ссылкой. Билет за друга выдаётся, когда друг впервые открыл бота по ссылке и сам нажал «Участвовать».
4. Остановка. По сроку или кнопкой. Бот закрывает снимок билетов и показывает его хэш.
5. Розыгрыш. Вы вводите свой публичный seed или создаёте случайный и подтверждаете. Победители выбираются по алгоритму из seed и хэша снимка.
6. Протокол. Результат видят только администраторы, пока вы не опубликуете протокол. Публикация отправляет сообщения победителям и остальным участникам.
7. Проверка. Протокол открывается в чате и скачивается файлом. Скрипт проверки пересчитывает победителей без установки бота.

Для участника

• Один экран. Кнопки правят одно сообщение. Новые сообщения приходят только для итогов, напоминаний и файлов.
• Мои билеты. Номера билетов, код участника, сколько билетов можно получить ещё.
• Правила. Полный текст конкурса постранично.
• Итоги. Победители показаны сокращённо, протокол открывается в чате.
• Свои данные. Выгрузка данных файлом и удаление. В закрытых конкурсах билеты остаются без имени и ника.
• Команды. `/start`, `/giveaways`, `/join`, `/tickets`, `/rules`, `/privacy`, `/help`.

Для организатора

• Конкурсы. Название, описание, призы по местам, резервные победители, даты, правила, предел билетов. Черновик, запуск по расписанию, остановка, отмена с причиной.
• Правила не меняются после запуска. Участники согласились с конкретным текстом, призы и предел билетов зафиксированы.
• Защита от накрутки. Самоприглашение и приглашение уже знакомых боту людей не считаются. Серия приглашений быстрее порога ждёт вашей проверки. Участника можно исключить с причиной.
• Условие канала. Необязательное и по умолчанию выключено. Включается только если бот администратор канала или группы. Проверка при участии и при остановке конкурса.
• Снимок билетов. При остановке закрывается снимок с хэшем. Исключение участника пересобирает снимок, запись остаётся в журнале.
• Воспроизводимый розыгрыш. Публичный seed (свой или случайный), резервные победители, замена отказавшегося по порядку. Повторный розыгрыш только после отмены прежнего с причиной, история сохраняется.
• Сообщения участникам. До трёх на конкурс, например напоминание о сроке.
• Участники. Поиск по коду или нику, карточка, исключение и возврат, билеты на проверке.
• Роли и журнал. Владелец, администратор, оператор, наблюдатель. Все важные действия записываются в журнал.
• Выгрузки. Участники в CSV, протокол в JSON, журнал в CSV.
• Диагностика. Состояние бота, права в канале, очередь сообщений, резервная копия базы кнопкой.

Честность и данные

• Проверяемый протокол. В нём seed, хэш снимка, алгоритм, номера билетов победителей и история отменённых розыгрышей.
• Скрипт проверки. `tools/verify_protocol.py` и команда `python -m a0giveaway verify`.
• Минимум данных. Бот хранит Telegram id, имя и ник, время согласия, билеты и приглашения. Телефоны и адреса не запрашиваются.
• Один раз. Повторное нажатие не создаёт второй билет, повторный розыгрыш без отмены невозможен.
• Расписание. Конкурс открывается и закрывается сам по времени, состояние хранится в базе и переживает перезапуск.
• Безопасность. Права ролей проверяются при каждом нажатии, тексты пользователей экранируются, запросы к базе параметризованы, секреты в журнале скрываются, частые нажатия ограничиваются.