diff --git a/ops/STATUS.md b/ops/STATUS.md index 0ea6149..2d08fe5 100644 --- a/ops/STATUS.md +++ b/ops/STATUS.md @@ -57,6 +57,7 @@ | S-18 | Вход по коду из Matrix | ⛔ | нужна кастомная стадия Authentik | | S-19 | Единый поиск по сервисам | ✅ | `!найди`, `/search`: книги, фильмы, сериалы, документы, продукты, рецепты | | S-20 | Страница «Моё» | ✅ | `/me`: продолжить просмотр, покупки, документы, книги | +| S-21 | Маршрутизатор уведомлений | ✅ | приоритеты, тихие часы, лимит 3/день, дедуп, очередь → дайджест | | S-16 | Vikunja опубликована | ✅ | https://vikunja.buryans.ru (LAN + VPS, сертификат) | ## X. Инфраструктура diff --git a/ops/notify/ROUTER.md b/ops/notify/ROUTER.md new file mode 100644 index 0000000..68c7ae6 --- /dev/null +++ b/ops/notify/ROUTER.md @@ -0,0 +1,51 @@ +# Маршрутизатор уведомлений + +## Проблема + +Каждый бот писал сам: мониторинг, агенты, Home Assistant, медиа, книги. +Итог — шум, который хочется выключить целиком. + +## Как работает + +Все уведомления идут через `POST /notify` в hub-core и проходят политику: + +| Приоритет | Поведение | +|---|---| +| `critical` | отправляется всегда, даже ночью | +| `high` | отправляется всегда | +| `normal` | днём — сразу; ночью — в очередь; больше 3 в день — в очередь | +| `low` | всегда в очередь, уходит в дайджест | + +- **Тихие часы:** 23:00–08:00 (для `normal`). +- **Лимит:** 3 сообщения в день (для `normal`). +- **Дедупликация:** одинаковый текст в течение 10 минут — отбрасывается. +- **Очередь:** `/var/lib/hub-notify/queue.json`, разбирается дайджестом в 12:00. +- **Журнал:** `/var/lib/hub-notify/log.jsonl` — что ушло, что отложено, что отброшено. + +## Примеры + +```bash +# критичное — уйдёт сразу +curl -X POST localhost:9120/notify -d '{"title":"Страж","message":"Диск 95%","priority":"critical"}' + +# обычное — днём сразу, ночью в дайджест +curl -X POST localhost:9120/notify -d '{"message":"Новый фильм добавлен"}' + +# шум — только в дайджест +curl -X POST localhost:9120/notify -d '{"message":"Почистил логи","priority":"low"}' +``` + +## Проверено + +``` +critical → {"ok": true, "action": "sent"} +low → {"ok": true, "action": "queued"} +``` + +Дайджест в 12:00 включает раздел «📥 Накопилось за день» и очищает очередь. + +## Что улучшить дальше + +- Проставить приоритеты существующим ботам (сейчас по умолчанию `normal`). +- Разные комнаты для разных тем (инфраструктура / семья / медиа). +- Повторные напоминания, если `critical` не подтверждён.