From ca2a87df414aa9bb38ca3fc9be6a3b131adb7c67 Mon Sep 17 00:00:00 2001 From: buryan-agent Date: Wed, 21 Oct 2026 18:50:53 +0300 Subject: [PATCH] =?UTF-8?q?[S-21]=20=D0=9C=D0=B0=D1=80=D1=88=D1=80=D1=83?= =?UTF-8?q?=D1=82=D0=B8=D0=B7=D0=B0=D1=82=D0=BE=D1=80=20=D1=83=D0=B2=D0=B5?= =?UTF-8?q?=D0=B4=D0=BE=D0=BC=D0=BB=D0=B5=D0=BD=D0=B8=D0=B9:=20=D0=BF?= =?UTF-8?q?=D1=80=D0=B8=D0=BE=D1=80=D0=B8=D1=82=D0=B5=D1=82=D1=8B,=20?= =?UTF-8?q?=D1=82=D0=B8=D1=85=D0=B8=D0=B5=20=D1=87=D0=B0=D1=81=D1=8B,=20?= =?UTF-8?q?=D0=BB=D0=B8=D0=BC=D0=B8=D1=82,=20=D0=BE=D1=87=D0=B5=D1=80?= =?UTF-8?q?=D0=B5=D0=B4=D1=8C=20=D0=B2=20=D0=B4=D0=B0=D0=B9=D0=B4=D0=B6?= =?UTF-8?q?=D0=B5=D1=81=D1=82?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- ops/STATUS.md | 1 + ops/notify/ROUTER.md | 51 ++++++++++++++++++++++++++++++++++++++++++++ 2 files changed, 52 insertions(+) create mode 100644 ops/notify/ROUTER.md 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` не подтверждён.