arm-core/openspec/specs/quality-metrics-ui/spec.md

quality-metrics-ui Specification

Purpose

Экран «Качество первички» веб-интерфейса: матрица «источник × причина», динамика по месяцам, список документов ячейки, выгрузка фактов; пункт меню по праву.

Requirements

Requirement: Экран «Качество первички»

Веб-интерфейс SHALL содержать экран «Качество первички» с фильтрами (период, ГК, тип документа, источник, скан/цифровой), матрицей «источник × причина» (колонки PDF, Excel, Всего; технические отказы — отдельным столбцом по файлам с пометкой, что фильтр типа на них не действует), динамикой по месяцам выбранной причины и кнопкой выгрузки фактов (CSV / JSON). Фильтра по ЮЛ на экране нет (API его поддерживает). Справочник ГК для фильтра SHALL запрашиваться один раз за жизнь экрана, в том числе при пустом ответе или ошибке.

Scenario: Пустой справочник ГК

• WHEN справочник ГК пуст или запрос завершился ошибкой
• THEN экран не повторяет запрос бесконечно

Scenario: Выбран источник

• WHEN в фильтре выбран PDF
• THEN матрица показывает одну колонку

Requirement: Переход из ячейки в документ

Клик по ячейке матрицы SHALL открывать список документов ячейки (постранично, со счётчиками правок «сервис» и «наш разбор» и исходом); из строки списка, если документ ещё существует, SHALL быть переход в экран проверки документа.

Scenario: Документ удалён

• WHEN документ ячейки уже удалён
• THEN строка показана без ссылки на документ

Requirement: Пункт меню по праву

Боковое меню SHALL показывать пункт «Качество первички» только при наличии QUALITY_METRICS_VIEW и снова SHALL скрывать пункты по полю permission: «Пользователи и роли» скрыт без USERS_ADMIN. Доступ по-прежнему решает сервер.

Scenario: Нет права

• WHEN в /me нет QUALITY_METRICS_VIEW
• THEN пункта «Качество первички» в меню нет

Scenario: Нет USERS_ADMIN

• WHEN в /me нет USERS_ADMIN
• THEN пункт «Пользователи и роли» скрыт