diff --git a/ops/hub/NOTIFY-GATEWAY.md b/ops/hub/NOTIFY-GATEWAY.md new file mode 100644 index 0000000..4a1b42c --- /dev/null +++ b/ops/hub/NOTIFY-GATEWAY.md @@ -0,0 +1,92 @@ +# Единый шлюз уведомлений (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`.