trend-engine

⚠ Текущая активная фаза — TG Text Analytics (см. docs/SPEC.md §E и AGENTS.md §1). Видео-pipeline (src/trend_engine/pipeline.py) сохранён, но deferred и помечен как legacy.

Система сбора и анализа текстовых публикаций в Telegram-каналах:

• discovery каналов по ключевым словам (Telethon userbot),
• сбор постов,
• scoring (engagement + velocity + novelty + LLM-quality + product relevance + media-attached bonus),
• format mining (LLM-разбор TG-виральной структуры),
• angle match (LLM: тема × формат × продукт),
• rich-дашборд и Markdown-digest.

Без публикации и без генерации видео на этой фазе.

Команды

make install                  # uv sync --all-groups
make tg-run-once              # один прогон TG-аналитики
make tg-dashboard             # rich-таблица постов/каналов
make tg-digest                # Markdown-сводка
make tg-auth                  # (если TELEGRAM_BACKEND=telethon) один раз залогиниться

make test                     # uv run pytest
make lint                     # uv run ruff check src tests
make fmt                      # uv run ruff format src tests && ruff check --fix
make typecheck                # uv run mypy src
make migrate                  # uv run alembic upgrade head

Документация

• AGENTS.md — инструкция для кодинг-агента, текущая фаза и traps.
• docs/BRD.md — бизнес-требования (включая roadmap М1.5 — TG-фазу).
• docs/SPEC.md — системные требования (Часть E — TG Text Analytics).