Top English Tutor: AI-бот для изучения английского с собственной панелью управления

Разработать Telegram-бота, который превращает личный список английских слов и выражений в готовые материалы для занятий. Пользователь должен получать перевод, транскрипцию, примеры, иллюстрацию и озвучку в одном месте — без необходимости собирать их вручную в разных сервисах.

Для владельца требовалось предусмотреть управление доступом, контроль расходов на AI и наблюдение за работой продукта.

1. Построили сценарий вокруг личного словаря

Пользователь создаёт тему и загружает слова текстом, фотографией или PDF. Бот распознаёт печатные и рукописные записи и показывает список для проверки. До запуска генерации можно добавить, исправить, удалить или переставить элементы. Такой шаг помогает исправить ошибки распознавания до создания карточек.

2. Объединили четыре AI-функции

Для каждого принятого слова или выражения сервис создаёт IPA-транскрипцию, перевод, три примера с переводами, оригинальную 2D-иллюстрацию и озвучку с американским произношением. Примеры ориентированы на уровень B2–C1. Распознавание документов, подготовка текстов, создание изображений и синтез речи подключены через API.

3. Сделали тренировку доступной прямо в Telegram

Карточки можно листать вперёд и назад, слушать произношение, показывать и скрывать перевод. Сохранённые темы доступны для повторных занятий. После проверки бота в работе убрали лишний экран выбора режима: теперь тренировка начинается сразу после выбора темы.

4. Предусмотрели длительную генерацию и ограничения расходов

Генерация выполняется в фоне и не блокирует общение с ботом. Задания сохраняются в базе данных и могут продолжиться после перезапуска. Ошибки отдельных этапов обрабатываются отдельно, а защита от повторных запросов предотвращает повторный учёт одного и того же задания.

Для каждого пользователя действует лимит в 35 принятых слов или фраз за календарный месяц. Проверка и резервирование квоты выполняются в базе данных, поэтому одновременные запросы не позволяют превысить лимит. Дополнительно предусмотрены учёт AI-вызовов и ограничение расходов.

5. Создали панель управления для владельца

В отдельном веб-интерфейсе можно включать и выключать бота, выбирать режим доступа, управлять пользователями и менять профиль бота в Telegram. Эти действия не требуют повторного развёртывания приложения.

Панель показывает использование сервиса по дням, неделям и месяцам, расход квот и затраты на текст, распознавание, изображения и аудио. Для финансового контроля предусмотрены сверка расходов AI и получение баланса хостинга, а при недоступности внешних источников — ручное обновление данных.

6. Подготовили продукт к эксплуатации

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

Основные сценарии покрыты автоматическими тестами: импорт слов, квоты, фоновая генерация, разделение пользовательских данных и управление доступом.

Технологии: Python, aiogram, FastAPI, PostgreSQL, OpenAI API. Разработка велась короткими итерациями: сценарий, реализация, проверка, обратная связь и доработка.

Создан и развёрнут многопользовательский Telegram-сервис с полным циклом подготовки учебных карточек: от загрузки списка до тренировки с иллюстрациями и озвучкой.

В состав продукта вошли:

• импорт текста, фотографий и PDF с проверкой распознанного списка;

• генерация учебного содержания, изображений и аудио;

• сохранённые темы и просмотр карточек в Telegram;

• фоновая обработка, месячные квоты и учёт AI-расходов;

• панель управления доступом, профилем бота и аналитикой;

• серверное развёртывание, мониторинг и резервное копирование.

Пользователь получает материалы для занятий из собственного словаря, а владелец — инструменты для управления сервисом и контроля его использования. Проект объединяет продуктовую проработку, разработку бота, AI-интеграции и создание административного интерфейса.