diff --git a/docs/NIGHT-JOURNAL.md b/docs/NIGHT-JOURNAL.md index 0605c7a..12e7af8 100644 --- a/docs/NIGHT-JOURNAL.md +++ b/docs/NIGHT-JOURNAL.md @@ -723,3 +723,41 @@ NO_PROXY=...192.168.1.155... (Matrix в соседнем контейнере) При опечатке бот отвечает «Неизвестная команда» вместо подсказки похожей команды. Причина выясняется; на работу команд не влияет. + +--- + +## ТОЧКА ПРИЁМА УВЕДОМЛЕНИЙ (15.10.2026) + +**Выяснено:** остальные «боты» — не отдельные боты, а **рабочие +процессы n8n**, которые шлют в Telegram. Активных семь: + +| Процесс | Токен | +|---|---| +| Alert Queue Processor | ALERT | +| Prometheus/Grafana Alert Webhook | ALERT | +| Uptime Kuma → Gitea Self-Healing | ALERT | +| F6-2: Self-Service Registration | AUTH | +| F6-3: Version Watch Handler | ADM | +| Gitea Task Dispatcher | есть Telegram | +| Buryan Health Monitor | — | + +**Matrix не использует ни один.** Токены WORK и MEDIA не задействованы +вовсе — эти боты не разворачивались. + +### Что построено + +Один адрес, куда любой процесс может послать сообщение: + +``` +POST http://192.168.1.10:8099/notify + {"text": "...", "source": "имя процесса", "bot": "alert|auth|work|adm|media"} + ↓ + notify.send() → Matrix (основной) + Telegram (зеркало) +``` + +Разным процессам — **разные боты**: тревоги уходят от ALERT в комнату +тревог, сообщения о доступе — от AUTH в комнату доступа. Это и есть +разделение по задачам. + +Служба: `buryan-notify.service`, запускается автоматически, +журнал `/var/log/buryan-notify.log`. diff --git a/ops/notify/buryan-notify.service b/ops/notify/buryan-notify.service new file mode 100644 index 0000000..dea2176 --- /dev/null +++ b/ops/notify/buryan-notify.service @@ -0,0 +1,14 @@ +[Unit] +Description=Точка приёма уведомлений buryan-hub +After=network.target + +[Service] +Type=simple +ExecStart=/usr/bin/python3 /opt/buryan-hub/scripts/notify-api.py +Restart=always +RestartSec=5 +StandardOutput=append:/var/log/buryan-notify.log +StandardError=append:/var/log/buryan-notify.log + +[Install] +WantedBy=multi-user.target diff --git a/ops/notify/notify-api.py b/ops/notify/notify-api.py new file mode 100644 index 0000000..a236967 --- /dev/null +++ b/ops/notify/notify-api.py @@ -0,0 +1,92 @@ +#!/usr/bin/env python3 +"""Точка приёма уведомлений для рабочих процессов. + +Зачем: уведомления сейчас разбросаны по процессам n8n, и каждый шлёт +в Telegram по-своему. Здесь один адрес — любой процесс делает запрос +и сообщение уходит в Matrix (основной канал) и в Telegram (зеркало). + +Использование: + curl -X POST http://192.168.1.10:8099/notify \ + -H 'Content-Type: application/json' \ + -d '{"text": "текст уведомления", "source": "имя процесса"}' + +Ответ: {"delivered": true, "matrix": true, "telegram": false} +""" +from __future__ import annotations + +import json +import os +import sys +from http.server import BaseHTTPRequestHandler, ThreadingHTTPServer + +sys.path.insert(0, "/opt/buryan-hub/scripts") + +PORT = int(os.getenv("NOTIFY_PORT", "8099")) +BIND = os.getenv("NOTIFY_BIND", "192.168.1.10") + + +def deliver(text: str, source: str = "", bot: str = "alert") -> dict: + """Отправляет уведомление. Возвращает, куда доставлено.""" + try: + import notify + # Разным процессам — разные боты: тревоги от ALERT, доступ от AUTH. + # Если для бота есть своя комната, шлём в неё. + if bot != "alert": + env = notify._load_env("/root/.buryan-bots-matrix.env") + token = env.get(f"MATRIX_{bot.upper()}_TOKEN") + room = env.get(f"MATRIX_{bot.upper()}_ROOM") + if token and room: + notify.CFG_FILE = "/root/.buryan-bots-matrix.env" + notify._matrix_env = lambda: ( + env.get("MATRIX_HOMESERVER_LOCAL", ""), token, room + ) + ok = notify.send(text) + return {"delivered": bool(ok), "matrix": bool(ok), "telegram": False} + except Exception as exc: # noqa: BLE001 + print(f"ошибка отправки: {exc}", file=sys.stderr) + return {"delivered": False, "error": str(exc)} + + +class Handler(BaseHTTPRequestHandler): + def _send(self, code: int, payload: dict) -> None: + body = json.dumps(payload, ensure_ascii=False).encode("utf-8") + self.send_response(code) + self.send_header("Content-Type", "application/json; charset=utf-8") + self.send_header("Content-Length", str(len(body))) + self.end_headers() + self.wfile.write(body) + + def do_GET(self): + if self.path.startswith("/health"): + self._send(200, {"status": "ok"}) + else: + self._send(404, {"error": "не найдено"}) + + def do_POST(self): + if not self.path.startswith("/notify"): + self._send(404, {"error": "не найдено"}) + return + try: + length = int(self.headers.get("Content-Length") or 0) + raw = self.rfile.read(length).decode("utf-8") if length else "{}" + data = json.loads(raw or "{}") + except Exception as exc: # noqa: BLE001 + self._send(400, {"error": f"неверный запрос: {exc}"}) + return + + text = (data.get("text") or data.get("message") or "").strip() + if not text: + self._send(400, {"error": "пустой текст"}) + return + source = str(data.get("source") or "процесс") + bot = str(data.get("bot") or "alert").lower() + print(f"уведомление от {source}, бот {bot}: {text[:80]}", flush=True) + self._send(200, deliver(text, source, bot)) + + def log_message(self, fmt, *args): # тише в журнале + pass + + +if __name__ == "__main__": + print(f"точка приёма уведомлений: http://{BIND}:{PORT}/notify", flush=True) + ThreadingHTTPServer((BIND, PORT), Handler).serve_forever()