У меня есть небольшой телеграм канал с мемчиками. Контент попадает туда привычным способом — круговорот воровства мемов из других каналов. Первоисточник, как правило, уже тоже участвует в круговороте.
Пока публикаций немного, встроенной в телегу отложки достаточно. Но когда накопилось двадцать фотографий, несколько видео и пара альбомов, назначать время каждому сообщению становится неудобно. Нужно держать в голове занятые часы, даты и порядок материалов. Выкладывать все одномоментно не люблю — самому пришлось погасить уведомления на такие каналы, где админ в свой обеденный перерыв дорывается до интернета и начинает постить новости одну за другой.
Мне захотелось отделить содержимое от расписания: отправлять сообщения в очередь, а время назначать не каждому посту, а каналу целиком.
Так появился небольшой бот на питоне. Разрабатывал его сам, еще после прохождения курса по питон. Не все мне понравилось в первой версии. Поэтому стал допиливать уже помощью ИИ‑агента. Ниже напишу устройство проекта и ограничения, которые оказались важнее первоначального списка функций.
Очередь вместо календаря
Основная модель довольно простая:
Сообщения пользователя
↓
Объединение альбомов
↓
Очередь конкретного канала
↓
Срабатывание временного слота
↓
Попытка публикации
↓
Изменение состояния постаДопустим, у канала есть три слота: 09:10, 13:15 и 20:45. В каждом берётся первый ожидающий пост.
У самих постов нет жёстко закреплённых дат публикации. Это удобно: можно добавить материал в конец очереди или поднять его выше, не пересчитывая время остальных сообщений.
Но у такого подхода есть следствие: показываемое пользователю время выхода это прогноз, а не обещание. Если первый пост задержался из‑за ошибки, прогноз для остальных тоже изменится.
Почему обошлось без брокера сообщений
В проекте используются Python 3.11, aiogram 3, aiosqlite и APScheduler 3.x. Приложение работает одним процессом под systemd (да‑да я знаю про контейнеры и прочее, но до сих пор делаю по‑старинке, как привык).
SQLite хранит пользователей, подключённые площадки, расписания и сообщения. APScheduler запускает задачи публикации. Отдельный брокер сообщений для такого масштаба я пока не добавлял.
Важно разделять две вещи: SQLite здесь это постоянное хранилище очереди, а планировщик — механизм пробуждения в нужное время. Само расписание тоже хранится в базе, а при старте приложения из него восстанавливаются задачи.
Такую схему легко развернуть и понять. Однако она не делает систему распределённой и не решает автоматически вопросы конкурентного доступа.
Пост это не обязательно файл на диске
Для публикации обычного сообщения не нужно сначала скачивать фотографию или видео.
После получения сообщения бот сохраняет идентификатор исходного чата и идентификатор сообщения. Позднее вызывает:
await bot.copy_message(
chat_id=target_chat_id,
from_chat_id=source_chat_id,
message_id=source_message_id,
)Метод копирует сообщение без обычной ссылки на оригинал, которая появляется при пересылке. Поэтому медиатека на VPS не нужна.
Упрощённая модель записи в очереди:
id
user_id
channel_id
from_chat_id
message_ids
media_payload
preview_text
status
created_atmessage_ids — список, потому что одна публикация может состоять из нескольких сообщений альбома. media_payload — дополнительное представление вложений, используемое для запасного способа отправки медиагруппы.
У решения есть цена: ссылка на сообщение не равнозначна резервной копии контента. Если Telegram больше не может скопировать исходник, одних идентификаторов недостаточно. Не все типы сообщений вообще поддерживают копирование, поэтому обещание «принимаем совершенно всё» было бы некорректным.
Для альбомов сохранённые file_id позволяют восстановить отправку вложений в некоторых ситуациях, но не превращают Telegram в гарантированное архивное хранилище.
Как собрать альбом из отдельных обновлений
Альбом приходит через Bot API несколькими сообщениями с общим media_group_id. Если сразу добавлять каждое вложение в очередь, один альбом превратится в несколько независимых публикаций.
В текущей реализации middleware собирает сообщения в памяти. Первое сообщение создаёт буфер и запускает ожидание; следующие сообщения той же группы добавляются в этот буфер.
Сокращённый фрагмент реализации:
class AlbumMiddleware(BaseMiddleware):
def __init__(self, latency: float = 0.6):
self.latency = latency
self.albums = {}
async def __call__(self, handler, event, data):
if not isinstance(event, Message) or not event.media_group_id:
return await handler(event, data)
group_id = event.media_group_id
if group_id in self.albums:
self.albums[group_id].append(event)
return None
self.albums[group_id] = [event]
await asyncio.sleep(self.latency)
messages = self.albums.pop(group_id, [event])
data["album"] = sorted(
messages,
key=lambda message: message.message_id,
)
return await handler(event, data)Здесь есть существенное ограничение: задержка 0.6 секунды — эвристика, а не подтверждение, что альбом получен полностью. В обновлениях нет отдельного события «альбом закончен».
Если одно из сообщений придёт поздно, группа может разделиться. При аварийном завершении процесса незаписанный буфер также потеряется.
Для небольшой однопроцессной реализации такой компромисс прост. Для более строгих требований понадобятся отдельная логика завершения сборки, обработка опоздавших частей и, возможно, постоянное хранение промежуточного состояния.
При публикации используется copy_messages, сохраняющий группировку альбома. Запасной путь — собрать медиагруппу через send_media_group из сохранённых file_id.
Однако автоматическое переключение между способами отправки тоже требует осторожности: после сетевого тайм‑аута нельзя быть уверенным, что первая попытка ничего не опубликовала.
Часовые пояса и восстановление расписания
В базе хранится локальное время слота, например 13:15, и часовой пояс пользователя.
Задача создаётся через CronTrigger:
scheduler.add_job(
execute_scheduled_slot,
trigger=CronTrigger(
hour=hour,
minute=minute,
timezone=ZoneInfo(timezone_name),
),
args=[channel_id, time_str],
id=f"post_slot_{channel_id}_{hour:02d}_{minute:02d}",
replace_existing=True,
misfire_grace_time=120,
)Именованный часовой пояс удобнее ручного прибавления трёх часов к UTC. При работе с регионами, где есть сезонный перевод времени, отдельно придётся определить поведение в пропущенные и повторяющиеся часы.
Пока при изменении настроек приложение пересоздаёт задачи публикации из базы. Для небольшого числа каналов это проще, чем поддерживать сложную синхронизацию отдельных задач.
Ещё одна тонкость касается misfire_grace_time: это допустимое опоздание уже существующей задачи, а не восстановление всех публикаций, пропущенных во время выключенного процесса.
Если приложение не работало, а при запуске заново создало cron‑задачи, прошлые слоты сами собой не воспроизведутся. Для догоняющей публикации нужен отдельный учёт выполнений и явная политика: отправлять пропущенное сразу, ограничивать количество или ждать следующего слота.
В текущей модели очередь сохраняется, но исторические слоты автоматически не догоняются.
Почему один статус error оказался неудобен
Первая обработка ошибки была слишком прямолинейной: отправка не удалась — записать error и перейти к следующему посту.
Так временный сбой сети превращался в окончательный отказ от публикации. Поэтому ошибки пришлось разделить по тому, что с ними может сделать пользователь или приложение.
Ситуация | Действие |
|---|---|
Сетевая ошибка или временная ошибка Telegram | Ограниченные повторы |
Попытки исчерпаны | Сохранить пост в очереди до следующего слота |
Нет прав на публикацию | Сохранить пост и поставить площадку на паузу |
Исходное сообщение нельзя скопировать | Исключить проблемный пост из активной очереди |
При проблемах доступа пользователю приходит сообщение с возможностью повторить отправку после восстановления прав. Непригодный исходник, наоборот, не должен бесконечно блокировать остальные материалы.
Классификация пока не идеальна. Часть ошибок определяется по типам исключений aiogram, часть по тексту ответа API. Текстовые проверки удобны для старта, но требуют аккуратности: неизвестную ошибку нельзя уверенно объявлять временной, а любой BadRequest неисправимым повреждением поста.
Отдельный случай RetryAfter. Здесь Telegram сообщает минимальное время ожидания. Нельзя произвольно сократить его ради более быстрого повтора. Если ждать внутри задачи слишком долго, повтор лучше перенести на отдельное время.
Самый неприятный случай: отправлено или нет?
Допустим, Telegram принял сообщение и опубликовал его, но ответ до приложения не дошёл. Бот видит тайм‑аут.
Если повторить запрос, может появиться дубль. Если отказаться от повтора, возможно, пост вообще не выйдет.
Есть и другой промежуток неопределённости:
Telegram опубликовал сообщение
↓
Процесс завершился до записи sent в SQLiteПосле запуска запись всё ещё будет выглядеть ожидающей публикации.
Поэтому автоматические повторы это полезная страховка, но не гарантия доставки ровно один раз. У обычного copy_message нет задаваемого приложением ключа идемпотентности, который автоматически устранил бы эту проблему.
Следующий шаг развития — сохранять идентификаторы опубликованных сообщений, вести журнал попыток и отдельно обрабатывать случаи с неопределённым результатом. Даже это не уберёт все пограничные ситуации, но сделает их видимыми.
Одновременная ручная и плановая публикация
Ещё один источник дублей — два обработчика, которые одновременно прочитали один и тот же первый пост.
Например, наступил слот расписания, а пользователь в этот момент нажал «Опубликовать сейчас».
Последовательность «прочитать pending → отправить → поставить sent» сама по себе не защищает от такой гонки. Однопроцессность тоже не спасает: асинхронные обработчики могут чередоваться.
Для строгой защиты нужен общий механизм захвата задания: например, атомарный переход pending → processing, доступный только одному исполнителю. После этого потребуется определить восстановление зависшего processing, если процесс остановился посередине.
Это отдельная задача от повторов при ошибках API. Первая защищает от конкуренции собственных обработчиков, вторая пытается пережить проблемы внешнего сервиса.
Интерфейс тоже повлиял на архитектуру
Первое меню расписания состояло из 24 кнопок на каждый час. Оно работало, но пользоваться им оказалось неудобно: для минут всё равно требовался ручной ввод.
В итоге основной экран показывает только активные слоты, а добавление времени разделено на выбор часа и минут. Есть готовые шаблоны и текстовый ввод списка.
Ещё добавлена кнопка случайного изменения минут внутри часа. Это небольшая настройка под мои привычки, так как частенько те же уведомления в списке дел у меня стоят на ровное время, полезно уведомления разделить.
Так же разделение понадобилось для входящих сообщений. В одном личном чате пользователь может отправлять посты, вводить расписание и писать обращение в поддержку. Поэтому обработчики команд и FSM‑форм должны срабатывать раньше общего обработчика контента. Иначе сообщение «у меня ошибка» вполне способно превратиться в завтрашний пост канала.
Что получилось
Самым полезным решением оказалось отделение очереди от календаря. Пользователь управляет порядком материалов и расписанием независимо друг от друга.
А самой сложной частью оказались не кнопки и не cron‑выражения, а переходы состояния: когда считать пост опубликованным, что делать после тайм‑аута и как отличить временный сбой от ситуации, которую повтором не исправить.
Для небольшого проекта связка SQLite, aiogram и APScheduler позволила обойтись без дополнительной инфраструктуры. Но простая схема не отменяет ограничений: буферизация альбомов остаётся эвристической, пропущенные слоты требуют отдельной политики, а повторная отправка может создать дубль.
Если продолжать развитие, следующим приоритетом я бы выбрал не новые кнопки, а журнал попыток публикации и единый механизм захвата заданий. Красивое расписание полезно, но сначала хорошо бы точно понимать, что произошло с предыдущим котом.
Комментарии 0