Техническое задание: Telegram-бот для доступа к онлайн-курсу :
1. Цель
Создать Telegram-бота, который выполняет функцию «замка» к курсу:
• доступ предоставляется только после успешной оплаты на сайте;
• пользователь получает видеоуроки и конспекты без возможности пересылки/скачивания;
• доступ автоматически закрывается через 90 дней;
• бот напоминает о завершении доступа и предлагает оплатить продление;
• есть раздел Help для технической поддержки (без обратной связи по содержанию курса).
2. Платформа и окружение
• Мессенджер: Telegram.
• Часовой пояс: Europe/Kyiv.
• Язык интерфейса: украинский (возможность добавить английский в будущем).
• Оплата: через сайт (лендинг) с интеграцией MonoPay.
3. Логика оплаты и доступа
1. Пользователь осуществляет оплату на сайте (MonoPay).
2. После подтверждения payment_success бэкенд:
• создает одноразовый redeem-token (24–32 символа, действителен 14 дней);
• генерирует короткий код (6 цифр, действителен 14 дней);
• отправляет пользователю:
• страницу успеха с кнопкой «Открыть доступ в Telegram» (ссылка с токеном);
• транзакционный e-mail с ссылкой и 6-значным кодом.
3. Варианты активации в боте:
• Пользователь переходит по ссылке → бот читает start=<redeem_token>, проверяет на бэкенде → открывает доступ.
• Если пользователь запустил бота без ссылки → бот запрашивает 6-значный код из письма → проверка на бэкенде → открывает доступ.
• Бот должен быть связан с лендингом: после успешной оплаты пользователь автоматически получает ссылку на бота (на странице успеха и в e-mail) для активации доступа.
• Доступ предоставляется на 90 дней.
4. Автоматические сообщения
• День 0: «Оплата получена ✅ Доступ открыт до [дата]. Начать с Урока 1?»
• День 75 и 85: напоминание «Доступ завершится [дата]. Продлить на 90 дней?» + кнопка.
• День 90: «Доступ завершен. Можно продлить еще на 90 дней» + кнопка.
• День 97 (опционально): повторное предложение продлить доступ.
5. Контент
• Видеоуроки и конспекты хранятся в Telegram (через file_id).
• Все сообщения отправляются с параметром protect_content=true (чтобы запретить пересылку/сохранение).
• Видео — с supports_streaming=true.
• Конспекты — в формате PDF (sendDocument, также с protect_content=true).
• Важно: защита от записи экрана невозможна — это ограничение платформы.
6. Меню бота
• Мой курс → список модулей и уроков.
• Конспекты → список PDF.
• Продлить доступ → переход на страницу оплаты.
• Help → форма обращения в техподдержку.
7. Help (техподдержка)
• Пользователь выбирает тему → описывает проблему → может прикрепить скриншот.
• Бот автоматически добавляет технические данные (user_id, платформа).
• Обращение поступает в приватный админ-чат в Telegram с кнопками: «Ответить», «Закрыть».
• Автоответ пользователю: «Обращение №[ID] получено. Ответим в течение 24 часов (10:00–18:00 по Киеву).»
8. Админ-функции
• Просмотр пользователей, статуса доступа, даты окончания.
• Привязка e-mail ↔️ telegram_user_id.
• Выдача доступа вручную, закрытие доступа, отправка оффера на продление.
• Логирование всех событий (оплаты, доступы, обращения).
9. База данных (структура)
• users: id, telegram_user_id, email, created_at
• orders: id, email, сумма, статус, paid_at
• redeem_tokens: id, order_id, token_hash, expires_at, used_at
• short_codes: id, order_id, code_hash, expires_at, used_at
• access: user_id, access_from, access_to, status
• lessons: id, module_no, lesson_no, title, video_file_id, pdf_file_id
• tickets: id, user_id, topic, text, attachments[], status, created_at, resolved_at
10. Безопасность
• redeem-токены и коды хранятся в виде хешей.
• Каждый токен/код одноразовый.
• Вебхуки MonoPay проверяются по подписи.
• Лимиты на частоту запросов (защита от злоупотреблений).
11. Тест-кейсы
1. Оплата → получение ссылки → активация доступа.
2. Оплата → получение кода → активация через код.
3. Использованный или просроченный токен/код → отказ.
4. Напоминание на 75/85 день → кнопка продления.
5. Закрытие доступа на 90 день → оффер продления.
6. Оплата продления → продление доступа еще на 90 дней.
7. Создание обращения в Help → сообщение админу → ответ пользователю.
12. Чек-лист запуска
1. Настроить MonoPay (мерчант, вебхуки).
2. Реализовать бэкенд для:
• обработки payment_success;
• генерации токенов и кодов;
• проверки токенов/кодов;
• управления доступами;
• рассылки напоминаний.
3. Реализовать бота:
• /start с токеном;
• /start без токена → запрос кода;
• меню (Курс / Конспекты / Продлить / Help);
• отправка уроков с защитой.
4. Интегрировать e-mail рассылку (отправка инструкций после оплаты).
5. Загрузить видео и PDF в бот → сохранить file_id.
6. Настроить админ-чат для Help.
7. Протестировать сценарии (оплата, активация, продление, Help).
Пожалуйста, в вашем ответе укажите примеры выполненных работ, стоимость и сроки реализации этого проекта.
