Разработка Telegram-бота для выдачи кодов

1. Общая цель

Создать Telegram-бота, который выдаёт 6-значные коды подтверждения из общих почтовых ящиков Outlook.

2. Структура меню и логика работы

Главное меню бота:

• Запросить код

• Инструкция

• Мои почты

(поддержка в чате бота не нужна, никакой связи с поддержкой внутри бота)

Работа при нажатии «Запросить код»:

Если у пользователя ещё нет добавленных почт:

Бот предлагает добавить почту.

Пользователь вводит email (например: gta5@outlook.com).

Бот проверяет наличие этой почты в общей базе

Если почта найдена в базе – успешно добавляется в «Мои почты» пользователя.

Если почты нет в базе – бот сообщает, что такая почта не поддерживается.

После добавления почты (или если почты уже есть):

Бот показывает список почт пользователя («Мои почты»).

Пользователь выбирает одну почту.

Бот отправляет сообщение:Запросите код в Rockstar Games / Social Club

Ожидаю код...

Важно: Когда пользователь запрашивает код на компьютере в лаунчере, бот редактирует это же сообщение и заменяет «Ожидаю код...» на сам код (например: 333512). Код берется последний из почты, т.е по факту бот проверяет последнее сообщение от noreply@ro********es.com на почте и этот код отправляет в бота.

3. Дополнительные возможности

Мои почты – отдельный пункт (или кнопка), где пользователь может:

Просмотреть все свои добавленные почты

Удалить почту

Добавить новую почту

Каждый пользователь имеет свой личный список почт (почты добавляются индивидуально).

4. Технические требования

Общая база содержит почтовые ящики Outlook.

Бот подключается к этим почтам через IMAP.

Автоматический парсинг только 6-значного цифрового кода из писем.

Бот должен быстро обнаруживать новое письмо (желательно в течение 5-15 секунд).

Использовать редактирование сообщения (edit_message_text) для замены «Ожидаю код» на актуальный код.

База данных для хранения:

бд общих почт

Личных почт каждого пользователя

Активных ожиданий кодов

5. Антиспам

3 запроса на одну почту в течение 30 минут.

Ограничение считается по каждой почте отдельно.

6. Админ-панель (обязательно)

Возможность добавлять/менять 5 общих почт (логин + пароль IMAP)

Просмотр всех пользователей и их добавленных почт

Статистика запросов

Логи

7. Дополнительные пожелания

Чистый и понятный интерфейс с эмодзи и inline-кнопками.

Хорошая обработка ошибок (почта не найдена, код не пришёл, таймаут и т.д.).

В сообщении «Ожидаю код» можно добавить таймер или статус.

Инструкция должна быть понятной для пользователей.