51 lines
2.4 KiB
Markdown
51 lines
2.4 KiB
Markdown
# Единый слой уведомлений
|
||
|
||
## Зачем
|
||
|
||
Доступ к Telegram нестабилен, и оповещение инфраструктуры нельзя строить
|
||
на канале, который может не работать. Поэтому **Matrix — основной канал**,
|
||
Telegram — зеркало.
|
||
|
||
Проверено 15.10.2026: тестовое уведомление доставлено в Matrix,
|
||
**в Telegram — НЕ доставлено**. Именно поэтому слой и построен.
|
||
|
||
## Как устроено
|
||
|
||
```
|
||
событие (диск, сертификат, хранилище, обновление)
|
||
↓
|
||
notify.send(text)
|
||
├─→ Matrix (основной) — комната «Инфраструктура: уведомления»
|
||
└─→ Telegram (зеркало) — если доступен
|
||
```
|
||
|
||
`send()` возвращает `True`, если доставлено **хотя бы одним** каналом, —
|
||
чтобы вызывающая сторона не слала уведомление повторно.
|
||
|
||
## Файлы
|
||
|
||
| Файл | Назначение |
|
||
|---|---|
|
||
| `/root/.buryan-notify.env` | адрес Matrix, токен, комната (права 600) |
|
||
| `/opt/buryan-hub/scripts/notify.py` | сам модуль |
|
||
| `ops/notify/*.py` | копия в репозитории для истории |
|
||
|
||
## Комната
|
||
|
||
`!xmPlMatgPxoOgHOPEA:matrix.buryans.ru` — «Инфраструктура: уведомления»,
|
||
**без сквозного шифрования**: это машинные сообщения, а не переписка.
|
||
Для команд людей используется отдельная комната бота.
|
||
|
||
## Как переведены скрипты
|
||
|
||
Исходная функция переименована в `send_alert_telegram`, а `send_alert`
|
||
стала обёрткой над общим слоем. **Логика не изменилась** — те же имя,
|
||
аргумент и результат. Копии оригинала лежат рядом: `*.before-notify`.
|
||
|
||
Откат одного скрипта: `cp check_disk.py.before-notify check_disk.py`.
|
||
|
||
## Задел
|
||
|
||
Слой позволяет добавить третий канал (или убрать Telegram) изменением
|
||
одного файла, а не сорока трёх.
|