# Единый шлюз уведомлений (10.11.2026) ## Зачем Путей уведомлений было **пять**, каждый со своими правилами. Отсюда спам и невозможность предсказать, что и когда придёт. ``` ДО ПОСЛЕ check-services ──► Matrix check-services ─┐ notify.py ──► Matrix notify.py ─┤ Hermes ──► Matrix Hermes ─┤ Kuma ──► hub (ломался) Kuma ─┼──► HUB /notify ──► Matrix swarm-watchdog ──► Matrix swarm-watchdog ─┤ (политика) матрица-бриджи ─┘ Hermes: журнал + только critical ``` ## Что сделано ### 1. hub `/notify` — единственная точка доставки Политика внутри: | Правило | Как работает | |---|---| | **Дедуп** | одинаковые title+message в окне 10 минут не повторяются | | **Тихие часы** | 23:00–08:00 normal откладывается в очередь | | **Суточный лимит** | не больше 3 normal-сообщений в день | | **Приоритеты** | `critical`/`high` проходят всегда, `low` — в очередь | ### 2. `/notify` понимает формат Uptime Kuma Раньше Kuma присылала `{monitor, heartbeat, msg}`, хаб отвечал `empty` и **молча выбрасывал**. Теперь разбирает и превращает в: * `heartbeat.status != 1` → «Монитор: X упал», priority **high** * иначе → «Монитор: X поднялся», priority **low** ### 3. Hermes стал журналом, а не вторым каналом Было: любое событие с severity high/critical → уведомление. Это дублировало доставку (Kuma → hub **и** Kuma → Hermes → hub). Стало: | Событие | Доставка | |---|---| | `severity=critical` | ✅ в Matrix | | провал задания (`etype=job`, high/critical) | ✅ в Matrix | | всё остальное | 📓 только журнал (`journal-only`) | ### 4. Авто-починка эскалирует через `critical` `auto_repair.py`: «не смог починить» теперь `critical`, а не `high` — такие события доходят до владельца, обычные успехи остаются в журнале. ### 5. Утренняя сводка очереди `notify_digest.py` — задание Hermes **`notify-digest`** в 09:00. Разбирает очередь, отправляет одну сводку и очищает. Раньше очередь росла до **100 записей / 24 КБ** и никто её не читал. ### 6. `swarm-watchdog` переведён на шлюз `alert_matrix()` больше не шлёт curl'ом напрямую в Matrix, а зовёт `notify.py` — значит подчиняется дедупу, тихим часам и лимиту. ## Проверка ``` Kuma-формат → /notify: {"ok": true, "action": "sent"} запись: "title": "Монитор: Тестовый монитор", "priority": "high" low-событие Hermes: delivered=1 (journal-only) ← в Matrix не ушло critical-событие: delivered=1 (http:200) ← доставлено swarm-watchdog прогон: ок, сообщений нет очередь: 0 ``` ## Что осталось | # | Что | |---|---| | 1 | Матричные бриджи (`webhook-to-matrix`, `smtp-to-matrix`, `matrix-vpn-bot`) — они пересылают **контент**, а не статус; их можно оставить напрямую | | 2 | Дайджесты (`media_digest`, `events_digest`, `weekly`, `resume`) — контент, не алерты | | 3 | Убрать дубль-подписку Kuma (id=2), если решим оставить только путь через Hermes | ## Итог Теперь любое **состояние** системы идёт через один шлюз с одной политикой. Добавить новый источник — значит просто вызвать `POST /notify`.