Реклама теряет деньги тихо. Кампания без дневного бюджета за выходные тратит больше плана. Модерация отклонила объявления, и показы встали. Ссылка ведёт на страницу, где товара уже нет, а клики продолжают оплачиваться. Счётчик Метрики отвязался от кампании, и статистика целей с этого дня неверна. На балансе кабинета кончились деньги.
Такое всплывало при сборке отчёта в конце месяца. А каждая из этих ситуаций стоит ровно столько, сколько проходит времени до её обнаружения.
Задача: узнавать о проблеме в тот же день. Условия:
— сигнал приходит туда, где команда и так работает: в Telegram, при необходимости на почту;
— каждый получает только свои кабинеты и кампании;
— сообщений мало. Мониторинг, который присылает сорок одинаковых уведомлений, перестают читать, и он становится хуже, чем никакого;
— проверок будет много, и писать их будут разные разработчики. Новая проверка не должна означать переделку системы.
Спроектировал и написал ядро движка алертов и доставку в Telegram. Сами проверки на этом движке пишет команда, и именно под это строилась архитектура.
ПЕРВАЯ ВЕРСИЯ: СЕРВИС ДОСТАВКИ
Отдельный сервис на FastAPI и Telegram-бот. Получатель подключается по токену с ограниченным сроком жизни, видит свои подписки списком и кнопкой в чате ставит любую на паузу или отключает. Сервис сам разворачивается на сервере после каждого обновления основной ветки.
ВТОРАЯ ВЕРСИЯ: ДВИЖОК В ПЛАТФОРМЕ
Три независимых слоя:
— проверка получает настройки и возвращает список найденных проблем. Больше она ничего не знает;
— канал доставки получает готовое сообщение и доставляет его одному получателю. Сделал Telegram и почту;
— справочники для форм: кабинеты, кампании, клиенты, из которых пользователь выбирает, что проверять.
Всё остальное делает ядро, и написано оно один раз для всех проверок.
ЖИЗНЕННЫЙ ЦИКЛ ПРОБЛЕМЫ
Каждая найденная проблема приходит с устойчивым отпечатком. По нему ядро отличает новую проблему от вчерашней:
— новая: уведомление уходит сразу;
— известная и ещё активная: повтор не раньше заданного интервала;
— исчезла из выборки: закрывается сама;
— вернулась: открывается заново, счётчик возвратов растёт.
Если прошлый запуск проверки ещё идёт, новый не стартует и не дублирует сообщения.
ПЛАНИРОВЩИК
Раз в 5 секунд выбирает проверки, чья очередь подошла, и ставит их в очередь задач. Расписание задаётся интервалом или по дням и часам, с учётом часового пояса. Новая проверка запускается сразу после создания, не дожидаясь первого интервала.
ПОЛУЧАТЕЛИ
Профили получателей и их привязка к правилам: одна проверка может уходить нескольким людям в разные каналы. Telegram подключается по одноразовой ссылке через бота привязки: в базе хранится только хеш токена, у ссылки есть срок жизни, второй раз она не сработает.
ЖУРНАЛ
Каждый запуск, каждая проблема и каждая попытка доставки записываются отдельно: сколько проблем найдено, сколько новых, закрытых и вернувшихся, сколько сообщений дошло и сколько нет, с текстом ошибки.
ИНСТРУМЕНТЫ ДЛЯ КОМАНДЫ
Генератор заготовок: мастер в терминале создаёт каркас новой проверки, канала или справочника и сам подключает его к системе. К нему — внутренняя документация по движку, три пошаговых руководства (как добавить проверку, канал и справочник) и эталонные проверки для образца.
О проблеме в рекламе команда узнаёт в день её появления, а не при сборке отчёта в конце месяца. Для кампании без дневного бюджета или кабинета с нулевым балансом это разница между потерянными часами и потерянной неделей.
Уведомления читают, потому что их мало. Одна проблема — одно сообщение, повтор только по интервалу, решённое закрывается само и больше не напоминает о себе. Каждый получает только свои кабинеты, в Telegram или на почту.
Движок стал общим инструментом команды: четыре разработчика написали на нём 10 рабочих проверок. Баланс и темп расхода в Директе и Промостраницах, кампании без дневного бюджета, модерация, битые ссылки и страницы без товара, привязка счётчиков Метрики, аномальное падение целей, напоминания о встречах. Ни одной из них не пришлось заново решать повторы, расписание и доставку: это уже было в ядре.
Новая проверка под конкретный процесс — это модуль на готовом каркасе, а не новый проект.