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

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

Ключові можливості

Централізоване керування акаунтами: Веб-інтерфейс дозволяє додавати нові, переглядати список існуючих та видаляти Telegram-акаунти з бази даних разом із їхніми файлами сесій.

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

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

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

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

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

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

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

Додавання акаунту: Користувач заповнює форму, вказуючи номер телефону та інші налаштування (проксі, файли). Сервер ініціює процес авторизації через Telethon, надсилаючи код на вказаний номер. Після введення коду (і пароля 2FA, якщо потрібно) сервер зберігає файл сесії та додає запис про акаунт до бази даних.

Запуск кампанії: Користувач обирає один або декілька активних акаунтів, налаштовує параметри та натискає кнопку "Старт".

Браузер надсилає запит на сервер. Сервер (FastAPI) приймає цей запит, перевіряє, чи не виконується інше завдання, і запускає основну логіку розсилки (run_script_logic) у фоновому режимі.

Користувач одразу перенаправляється назад на головну сторінку, де бачить, що статус завдання змінився на "Запускається..." або "Виконується".

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

Після завершення розсилки статус автоматично оновлюється на "Завершено" або "Помилка".