Конституция проекта

Как работает панель метрик

Канонические правила продукта: метрики, поиск, тональность и отчёты в публичной панели.

6 официальных каналов 10 фильтров площадок 13 продуктовых тегов 3 account_scope

Главный KPI

ERR

Основной показатель — вовлечение: реакции, репосты, пересылки и комментарии относительно просмотров.

Поиск

свежие сверху

Ищет по заголовку, описанию, распознанному тексту с картинок и транскриптам.

Тональность

15+ комм./контентная группа

Считается только по контентной группе, если после локальной очистки хватает комментариев.

Отчёты

снимок данных

Отчёт открывается из сохранённого состояния: цифры и выводы не меняются задним числом.

← Назад к панели метрик

Метрики

Панель метрик считает охват, просмотры и вовлечение по выбранному периоду и площадкам.

Правило

Охват и просмотры

Как считается или работает Данные считаются устаревшими, если последний сбор был больше 36 часов назад, если нет более точного platform-specific правила.

Охват показывает, сколько внимания получил материал. Просмотры складываются по выбранным площадкам и периоду.

Если данные старые, подозрительные или отсутствуют, панель метрик должна честно показать предупреждение.
Для длинных окон при короткой истории платформа может показывать одинаковые цифры на 90, 180 и 365 днях.

Правило

Вовлечение (ERR)

Как считается или работает Вовлечение (ERR) = ((реакции без двойного учёта лайков + репосты + пересылки + комментарии) / просмотры) × 100.

Вовлечённость (ERR) = ((реакции без двойного учёта лайков + репосты + пересылки + комментарии) / просмотры) × 100.

Если у публикации нет просмотров, вовлечённость (ERR) по ней не считается.
Для рейтинга по вовлечённость (ERR) исключаются публикации с просмотрами меньше 100.
Плашка новое ставится, если публикации меньше 120 часов.

Поиск

Поиск использует сохранённые данные, показывает самые свежие сверху и запускает AI-анализ только как отдельную пользовательскую команду.

Правило

Поиск

Как считается или работает Поиск смотрит заголовок, описание, распознанный текст с картинок, транскрипты, формат и связанные публикации в контентной группе.

Финальная выдача сортируется по дате публикации: самые свежие сверху; чем ниже — тем старее.

Релевантность нужна для отбора кандидатов, но не ломает хронологический порядок.
Контентная группа помогает найти связанные публикации, но чтение поиска не запускает AI.

Правило

Свежий AI-анализ поиска

Как считается или работает Готовые контентная группа/sentiment данные могут входить в payload, но не заменяют search-specific AI-анализ с площадочными различиями, комментариями и метриками.

Каждый пользовательский search analysis/report пересчитывается заново по выбранному скоупу публикаций.

Выборка Промптшоу, Технорепорт или любой майский скоуп получает новый анализ, даже если отдельные бандлы уже анализировались в дашборде.
Search report использует свежий analysis_task_id; при provider failure fact-only отчёт разрешён только с явным предупреждением.

Правило

Search-specific payload

Как считается или работает Контентная группа sentiment и другие готовые анализы являются входными сигналами, но не являются кэшем результата search AI.

Search AI получает стек данных именно выбранной пользователем сборки: публикации, платформенные различия, комментарии, метрики, format/контентная группа context и search prompt.

Один уже посчитанный бандл и выборка всех материалов формата за месяц — разные search analysis tasks.
Повторный анализ нужен для нового скоупа, даже если отдельные элементы ранее анализировались в других блоках.

Тональность комментариев

Тональность показывает реакцию аудитории на контентную группу.

Правило

Единица анализа

Как считается или работает Контентная группа является единственной рабочей единицей тональности.

Тональность отдельной публикации не используется в интерфейсе и API; источник истины — анализ контентной группы.

Верхний виджет и summary берут тональность только из готовых анализов контентных групп.
Одна контентная группа учитывается в агрегате один раз.

Правило

Порог достаточности

Как считается или работает Ровно 15 комментариев уже достаточно. Комментарии передаются в на уровне контентной группы анализ батчами по 100.

Перед анализом локально исключаются пустые тексты, дубли, боты и явно не тематичные сообщения. Если осталось меньше 15 пригодных комментариев, статус insufficient_data.

Если comments_hash или member_hash изменился, старый sentiment становится stale.
UI должен объяснять на уровне контентной группы порог, а не создавать ощущение на уровне публикации фильтрации.
Пороги аномалий: негатив > 0.70, шум > 0.30, разница площадок > 0.60.

Правило

Фильтры площадок

Как считается или работает Фильтр площадки выбирает контентные группы, где есть публикация выбранной площадки.

Сама оценка тональности остаётся по всей контентной группе, а не дробится обратно на посты.

Summary/API агрегируют только достаточные анализы со status=ok.
API показывает bundles_analyzed, bundles_insufficient, bundles_missing_analysis, comments_threshold и coverage_ratio.

Отчёты

Отчёты строятся из сохранённого скоупа и честно маркируют отсутствие AI-анализа.

Правило

Отчёты

Как считается или работает Окно месяца MSK (Europe/Moscow, UTC+3) — единый timezone source of truth (см. DATE-006). В месячном отчёте участвуют фильтры: YouTube, vk_video, vk_post, vk_channel, instagram_reels, instagram_post, telegram_video, telegram_post, TikTok, facebook, x, x_en, max. Видео-группы: Рилсы, ТикТоки, Шортсы, Горизонтальные видео YouTube, Горизонтальные видео ВК.

Месячный отчёт — сохранённая сущность за календарный месяц, а не live-пересчёт при каждом открытии.

Telegram-посты в отчёте ранжируются по пересылкам на 100 просмотров и имеют минимум 1000 просмотров.
YouTube Shorts определяется по /shorts/, коротким признакам или длительности до 180 секунд.
Пустые и служебные блоки в публичный отчёт не попадают.

Правило

Публичный артефакт monthly

Как считается или работает Поле artifact_urls в snapshot, API и job result месячного отчёта должно содержать ровно ключ png; HTML/JSON/PDF могут существовать только как внутренние файлы рендера и хранения.

Все новые месячные отчёты публикуют наружу только PNG.

Публичный route /reports/monthly/{scope}/{YYYY-MM} редиректит на report.png.
PDF route месячного отчёта остаётся disabled; JSON route отдаёт нормализованный snapshot с png-only artifact_urls.
Custom/advanced reports не подпадают под это правило.

Правило

Лучшие посты Telegram

Как считается или работает Лучшие посты Telegram ранжируются как пересылки × 100 / просмотры.

Так отчёт показывает публикации, которые чаще пересылают относительно охвата.

Минимум просмотров для попадания в блок: 1000.