monitoring-tg

Backend-сервис мониторинга Telegram-каналов для Portal. Публичный API и AI-классификация работают на Go, Python оставлен только как внутренний MTProto/Telethon-адаптер для авторизации, опроса каналов и дозагрузки медиа. Сервис сохраняет сообщения в Postgres, раскладывает каналы по вертикалям/подразделам и выполняет AI-анализ через OpenAI-compatible endpoint, общий с другими сервисами портала.

Пользовательский UI живёт в portal/frontend/src/app/features/monitoring-tg. Этот сервис не отдаёт отдельные HTML-страницы и работает как API/worker за портальным прокси /api/monitoring-tg.

Доступ

• Админские операции остаются за ролью admin в Portal: portal прокидывает X-User-Is-Admin=1.
• Отдел видит только свои подразделы, каналы, сообщения и промпты через X-User-Department-Id.
• Руководитель отдела может создавать и редактировать подразделы своего отдела: portal прокидывает X-User-Is-Department-Head=1.
• Пароли подразделов и IP allowlist удалены.

Конфигурация

Основные переменные:

TG_API_ID=
TG_API_HASH=
TG_PHONE=
TG_SESSION_STRING=

POSTGRES_HOST=postgres.monitoring-tg.svc.cluster.local
POSTGRES_PORT=5432
POSTGRES_USER=parser
POSTGRES_PASSWORD=parser
POSTGRES_DB=parser

PUBLIC_BASE_PATH=/api/monitoring-tg
PYTHON_BASE_URL=http://127.0.0.1:8001

LLM_ENABLED=true
LLM_BASE_URL=http://10.2.3.5:8002
LLM_API_KEY=
LLM_MODEL=qwen2.5-14b
LLM_CLASSIFIER_OWNER=go

Локального админ-пароля нет: админские API доступны только через роль admin в Portal.

Запуск в k8s

Манифесты лежат в k8s/. Перед применением нужно заполнить k8s/secrets.yaml реальными Telegram-кредами и, при необходимости, LLM_API_KEY.

kubectl apply -k k8s

Миграции выполняются entrypoint-ом контейнера перед запуском процессов.

Структура

src/parser_bot/
├── api/         внутренние FastAPI роуты Telegram-адаптера
├── db/          SQLAlchemy модели + сессии
├── scheduler/   APScheduler-воркер периодического опроса
├── telegram/    Telethon-клиент
├── config.py    pydantic-settings
└── main.py      FastAPI lifespan + uvicorn для внутреннего адаптера
cmd/server/      Go API для Portal
cmd/classifier/  Go-воркер фоновой LLM-классификации сообщений
alembic/         миграции
k8s/             манифесты для портала