Files
buryan-infra/ops/notify/ROUTER.md

2.4 KiB
Raw Permalink Blame History

Маршрутизатор уведомлений

Проблема

Каждый бот писал сам: мониторинг, агенты, 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 — что ушло, что отложено, что отброшено.

Примеры

# критичное — уйдёт сразу
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 не подтверждён.