79 lines
3.2 KiB
Markdown
79 lines
3.2 KiB
Markdown
# 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 удалены.
|
||
|
||
## Конфигурация
|
||
|
||
Основные переменные:
|
||
|
||
```env
|
||
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`.
|
||
|
||
```bash
|
||
kubectl apply -k k8s
|
||
```
|
||
|
||
Миграции выполняются entrypoint-ом контейнера перед запуском процессов.
|
||
|
||
## Структура
|
||
|
||
```text
|
||
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/ манифесты для портала
|
||
```
|