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

52 lines
2.4 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# Маршрутизатор уведомлений
## Проблема
Каждый бот писал сам: мониторинг, агенты, 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` не подтверждён.