feat: Telegram settings in DB with UI edit and test send

Store notification_channels (migration 004), effective config DB over env,
PUT/test API endpoints, Settings form, and pass db session into ingest notify.

Co-authored-by: Cursor <cursoragent@cursor.com>

backend/app/services/telegram_notify.py

@@ -1,50 +1,74 @@
 import logging
 
 import httpx
+from sqlalchemy.orm import Session
 
-from app.config import get_settings
 from app.models import Event, Problem
+from app.services.notification_settings import TelegramConfig, get_effective_telegram_config
 
 logger = logging.getLogger(__name__)
 
 SEVERITY_ORDER = {"info": 10, "warning": 20, "high": 30, "critical": 40}
 
 
+class TelegramNotConfiguredError(Exception):
+    """Telegram disabled or missing token/chat_id."""
+
+
+class TelegramSendError(Exception):
+    def __init__(self, message: str, *, status_code: int | None = None) -> None:
+        super().__init__(message)
+        self.status_code = status_code
+
+
 def _severity_value(value: str) -> int:
     return SEVERITY_ORDER.get(value, 0)
 
 
-def _is_enabled() -> bool:
-    settings = get_settings()
-    return bool(
-        settings.telegram_enabled
-        and settings.telegram_bot_token.strip()
-        and settings.telegram_chat_id.strip()
-    )
-
-
-def _send_text(message: str) -> None:
-    settings = get_settings()
-    if not _is_enabled():
+def send_telegram_text(message: str, *, config: TelegramConfig | None = None, force: bool = False) -> None:
+    cfg = config or get_effective_telegram_config()
+    if not force and not cfg.active:
         return
-    url = f"https://api.telegram.org/bot{settings.telegram_bot_token}/sendMessage"
-    payload = {"chat_id": settings.telegram_chat_id, "text": message, "disable_web_page_preview": True}
+    if not cfg.bot_token or not cfg.chat_id:
+        if force:
+            raise TelegramNotConfiguredError("Telegram: не задан bot token или chat_id")
+        return
+
+    url = f"https://api.telegram.org/bot{cfg.bot_token}/sendMessage"
+    payload = {"chat_id": cfg.chat_id, "text": message, "disable_web_page_preview": True}
     try:
         with httpx.Client(timeout=8.0) as client:
             response = client.post(url, json=payload)
             response.raise_for_status()
-    except Exception:
+    except httpx.HTTPStatusError as exc:
+        detail = exc.response.text[:200] if exc.response is not None else str(exc)
+        raise TelegramSendError(f"Telegram API HTTP {exc.response.status_code}: {detail}", status_code=exc.response.status_code) from exc
+    except Exception as exc:
         logger.exception("telegram send failed")
+        raise TelegramSendError(str(exc)) from exc
 
 
-def _should_notify_severity(severity: str) -> bool:
-    settings = get_settings()
-    min_level = _severity_value(settings.telegram_min_severity)
+def send_telegram_test_message(*, config: TelegramConfig | None = None) -> None:
+    cfg = config or get_effective_telegram_config()
+    if not cfg.enabled:
+        raise TelegramNotConfiguredError("Telegram отключён (enabled=false)")
+    if not cfg.configured:
+        raise TelegramNotConfiguredError("Не задан bot token или chat_id")
+    send_telegram_text(
+        "✅ SAC: тестовое сообщение\nКанал Telegram для оповещений работает.",
+        config=cfg,
+        force=True,
+    )
+
+
+def _should_notify_severity(severity: str, *, config: TelegramConfig) -> bool:
+    min_level = _severity_value(config.min_severity)
     return _severity_value(severity) >= min_level
 
 
-def notify_event(event: Event) -> None:
-    if not _should_notify_severity(event.severity):
+def notify_event(event: Event, *, db: Session | None = None) -> None:
+    cfg = get_effective_telegram_config(db)
+    if not cfg.active or not _should_notify_severity(event.severity, config=cfg):
         return
     host = event.host.hostname if event.host else "unknown"
     message = (
@@ -55,11 +79,15 @@ def notify_event(event: Event) -> None:
         f"Title: {event.title}\n"
         f"Summary: {event.summary}"
     )
-    _send_text(message)
+    try:
+        send_telegram_text(message, config=cfg)
+    except TelegramSendError:
+        logger.exception("notify_event telegram failed event_id=%s", event.event_id)
 
 
-def notify_problem(problem: Problem, event: Event | None = None) -> None:
-    if not _should_notify_severity(problem.severity):
+def notify_problem(problem: Problem, event: Event | None = None, *, db: Session | None = None) -> None:
+    cfg = get_effective_telegram_config(db)
+    if not cfg.active or not _should_notify_severity(problem.severity, config=cfg):
         return
     host = problem.host.hostname if problem.host else "unknown"
     related = ""
@@ -73,4 +101,7 @@ def notify_problem(problem: Problem, event: Event | None = None) -> None:
         f"Title: {problem.title}\n"
         f"Summary: {problem.summary}{related}"
     )
-    _send_text(message)
+    try:
+        send_telegram_text(message, config=cfg)
+    except TelegramSendError:
+        logger.exception("notify_problem telegram failed problem_id=%s", problem.id)