Аналитика рабочей документации

Что это за экран

Аналитика рабочей документации — обзорный экран с агрегированными показателями по проекту: сводные KPI, тренд замечаний за 30 дней, распределение по важности, топ документов с риском. Этот экран не используется для оперативной работы — он помогает увидеть состояние документации в целом и тренды.

Главная аудитория: руководители проектов и нормоконтроль. Используется для отчётности и принятия управленческих решений.

Где найти аналитику

URL: /sod/projects/<projectId>/modules/working-docs/coordination/analytics

Попасть можно:

из координационного дашборда — CTA-карточка «Аналитика» или KPI «Документов высокого риска»;
из реестра замечаний и реестра согласований — через breadcrumbs координационного контура.

Что показывает экран

Экран разбит на несколько блоков сверху вниз:

KPI-карточки — четыре больших числа.
Тренд замечаний за 30 дней — график «открыто/закрыто» по дням.
Распределение по важности — сколько замечаний на каком уровне.
Топ документов с риском — рейтинг 8 документов.

KPI-карточки

Четыре больших числа в шапке экрана:

KPI	Что считает
Незаполненных листов	Сумма по всем документам проекта: листы в реестре, для которых ещё не загружен файл
Открытых замечаний	Количество замечаний в статусе «Открыто» по всему проекту
Блокирующих замечаний	Открытые замечания с флагом «Блокирует публикацию»
Документов высокого риска	Количество документов с risk_level = «high»

Эти KPI пересекаются с KPI на координационном дашборде. Разница: на дашборде они кликабельны (ведут в реестры с фильтрами), а здесь — просто индикаторы для общей картины.

Тренд замечаний за 30 дней

Линейный график за последние 30 дней. По оси X — дни (DD.MM), по оси Y — количество событий.

Две линии:

Открытые — сколько замечаний было создано в этот день (по created_at).
Закрытые — сколько замечаний было закрыто в этот день (по closed_at / resolved_at).

Что показывает график:

если линия «Открытые» постоянно выше «Закрытых» — замечания накапливаются;
если линии в среднем одинаковые — проект в равновесии;
если «Закрытые» выше «Открытых» — идёт разбор накопленного, проект сходится.

Тренд считается на лету из массива замечаний проекта. Для очень больших проектов (10k+ замечаний) данные могут быть менее детальными.

Распределение по важности

Список или диаграмма с количеством замечаний по уровням важности:

Информация (info).
Незначимое (minor).
Существенное (major).
Критичное (critical).
Блокирующее (blocking).

Сортируется по убыванию количества. Помогает понять, что в проекте больше всего волнует — много мелких опечаток или мало, но серьёзных проблем.

Топ документов с риском

Карточка с рейтингом из 8 документов, отсортированных по убыванию risk_score.

По каждому документу:

Код документа · Наименование.
Сводка: отсутствует листов / неподтверждено листов / спорных листов.
Тег уровня риска:
- красный (high) — критичный;
- жёлтый (medium) — средний;
- синий (low) — низкий;
Числовой risk_score — рассчитанная оценка риска.

Что входит в risk_score:

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

Чем выше risk_score, тем больше внимания требует документ.

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

Как читать аналитику

Что вижу	Что это значит	Что делать
Линия «Открытые» растёт, «Закрытые» — нет	Замечания накапливаются, исполнители не успевают	Перераспределить исполнителей, провести совещание по разбору
Много блокирующих замечаний при низком общем числе	Концентрация критичных проблем	Открыть реестр замечаний с пресетом «Блокирующие» и разобрать по одному
Один документ в топе риска с большим отрывом	Узкое место проекта	Провести разбор по этому документу с автором и согласующим
Высокий процент незаполненных листов	Проект ещё не дошёл до полноты	Проверить, кто ведёт реестр валидатора, ускорить заполнение
Все KPI близки к нулю	Проект в порядке	Использовать аналитику для отчёта руководству

Сценарии использования

Сценарий 1. Понедельный обзор для руководителя

Открыть аналитику в понедельник утром.
Посмотреть KPI — как изменились за неделю.
Посмотреть тренд за 30 дней — что было динамики, что замедлилось.
Открыть топ документов с риском — что добавилось / убавилось.
Сформировать план работы на неделю.

Сценарий 2. Подготовка к совещанию

Открыть аналитику.
Сделать скриншоты KPI и тренда.
Зафиксировать топ-3 рисковых документа для обсуждения.
Перейти в реестр замечаний с пресетом «Блокирующие» — выгрузить DOCX для совещания.

Сценарий 3. Контроль после крупной загрузки

После загрузки нового пакета РД дождаться согласования.
Открыть аналитику — увидеть всплеск открытых замечаний на тренде.
Через несколько дней проверить, что число закрытых начало превышать открытые — пакет нормально разбирается.

Что важно понимать

Аналитика — это срез на момент открытия. Цифры не обновляются в реальном времени без перезагрузки страницы.
Данные тренда считаются локально. Для больших проектов это может приводить к задержке загрузки страницы.
Аналитика не заменяет реестры. Она показывает «что в среднем», но для конкретных действий нужно идти в реестр замечаний или согласований.
Risk-score — это эвристика. Он помогает приоритизировать, но не является абсолютной мерой. Финальное решение всегда за руководителем с пониманием проектного контекста.

Контрольный список руководителя

Раз в неделю заглядывать в аналитику.
Сравнивать тренд «открытые/закрытые» с предыдущей неделей.
Реагировать на рост блокирующих замечаний.
Использовать топ документов с риском как чек-лист совещаний.

Что не делает аналитика

Не редактирует данные.
Не отправляет уведомления.
Не позволяет фильтровать по конкретному документу или комплекту — для этого есть реестры.
Не сравнивает периоды (нет «прошлая неделя vs эта неделя»). При необходимости — сравнивать вручную по скриншотам.

Визуальные материалы (добавим на следующем шаге)

Скриншот: верхние KPI-карточки.
Скриншот: тренд замечаний за 30 дней с двумя линиями.
Скриншот: распределение по важности.
Скриншот: топ документов с риском.