Веб-панель для автоматизации и управления Telegram рассылками

Это веб-панель управления, написанная на Python с использованием фреймворка FastAPI, которая служит графическим интерфейсом для ранее описанного скрипта автоматизации рассылок в Telegram (core_logic.py). Панель позволяет пользователю управлять Telegram-аккаунтами, запускать рассылки и отслеживать их выполнение через браузер. Для хранения данных используется база данных SQLAlchemy.

Ключевые возможности

Централизованное управление аккаунтами: Веб-интерфейс позволяет добавлять новые, просматривать список существующих и удалять Telegram-аккаунты из базы данных вместе с их файлами сессий.

Веб-авторизация: Реализован пошаговый процесс добавления новых аккаунтов непосредственно через браузер. Пользователь вводит номер телефона, затем код подтверждения из Telegram, и, при необходимости, пароль двухфакторной аутентификации (2FA). Система обрабатывает все этапы, создает файл сессии и сохраняет аккаунт.

Запуск и настройка кампаний: Пользователь может выбирать аккаунты для участия в рассылке и запускать задачи в фоновом режиме. Для каждой кампании можно указать индивидуальные настройки (например, файлы с целями и сообщениями).

Фоновое выполнение задач: Рассылки выполняются как фоновые процессы (BackgroundTasks). Это означает, что пользователь может закрыть страницу в браузере, и задача продолжит выполняться на сервере.

Мониторинг в реальном времени: Панель отображает текущий статус задачи (например, "Готов к запуску", "Выполняется", "Завершено", "Ошибка") и позволяет просматривать последние записи из лог-файла, что дает возможность отслеживать прогресс и диагностировать проблемы.

Безопасная остановка: Предусмотрена возможность отправить сигнал для корректной остановки текущей задачи. Скрипт завершит свое текущее действие (например, отправку сообщения) и остановится, не прерывая процесс резко.

Логика работы

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

Добавление аккаунта: Пользователь заполняет форму, указывая номер телефона и другие настройки (прокси, файлы). Сервер инициирует процесс авторизации через Telethon, отправляя код на указанный номер. После ввода кода (и пароля 2FA, если нужно) сервер сохраняет файл сессии и добавляет запись об аккаунте в базу данных.

Запуск кампании: Пользователь выбирает один или несколько активных аккаунтов, настраивает параметры и нажимает кнопку "Старт".

Браузер отправляет запрос на сервер. Сервер (FastAPI) принимает этот запрос, проверяет, не выполняется ли другое задание, и запускает основную логику рассылки (run_script_logic) в фоновом режиме.

Пользователь сразу перенаправляется обратно на главную страницу, где видит, что статус задачи изменился на "Запускается..." или "Выполняется".

JavaScript на странице периодически отправляет запросы к серверу для получения актуального статуса и логов, обновляя информацию на экране без перезагрузки страницы.

После завершения рассылки статус автоматически обновляется на "Завершено" или "Ошибка".