From ee6393bb030a1e4aa2f29ad30caed17a504eb13d Mon Sep 17 00:00:00 2001 From: "pavel.korolkov" Date: Tue, 11 Aug 2026 19:06:54 +0500 Subject: [PATCH] docs: Add new svacer widget documentations --- .../documentation/admin/widgets/types.ru.md | 37 +++++++++++++++++++ .../documentation/release-notes/v1.7.0.ru.md | 11 ++++++ 2 files changed, 48 insertions(+) create mode 100644 content/documentation/release-notes/v1.7.0.ru.md diff --git a/content/documentation/admin/widgets/types.ru.md b/content/documentation/admin/widgets/types.ru.md index 8727fa5f..3497f295 100644 --- a/content/documentation/admin/widgets/types.ru.md +++ b/content/documentation/admin/widgets/types.ru.md @@ -1298,6 +1298,43 @@ sum(increase(http_requests_total[{{range}}])) При стратегии «Гибрид» и числе маркеров в снимке выше порога вкладка «Находки» недоступна без фильтра по статусу ревью, критичности или чекеру. {{< /alert >}} +### Активность разметки Svacer + +Виджет показывает, кто и сколько размечает находки в Svacer за выбранный период: список ревьюеров, карточку выбранного ревьюера с распределением вердиктов и активностью по дням, а также журнал операций разметки с выгрузкой в CSV. + +#### Авторизация + +Конфигурация авторизации описана в разделе [«Внешние сервисы»](../external-services/#svacer). + +#### Конфигурация + +| Название | Обязательность | Описание | Значение по умолчанию | +|-----------------------------------|----------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------|-----------------------| +| Период по умолчанию (дней) | нет | С каким периодом виджет открывается; читатель может переключить период в самом виджете. От 1 до 30 дней, сутки считаются по UTC | 30 | +| План операций разметки за 30 дней | нет | Сколько операций разметки ожидается от одного ревьюера за 30 дней. В более узком периоде план пересчитывается пропорционально; если поле пустое, план не показывается | - | +| Показывать ФИО | нет | Подставляет имена и email вместо логинов; без административного токена Svacer будут показаны логины | Включено | +| Кэшировать журнал разметки | нет | Если выключено, журнал загружается из Svacer при каждом запросе виджета | Включено | +| Время жизни кэша (секунды) | нет | Сколько секунд виджет может показывать уже загруженные данные, не обращаясь к Svacer. Допустимый диапазон при указании значения: 30–86400 | Значение инстанса | + +#### Параметры запроса + +При просмотре виджета доступны следующие параметры: + +* Период — «7 дней», «14 дней», «30 дней» или «Абсолютный диапазон времени» с границами «от» и «до». +* «Все проекты» — проекты Svacer, найденные в журнале за период; если ни один проект не выбран, учитываются все. + +#### Просмотр данных + +* Список ревьюеров — «Поиск по ФИО или логину», сортировка «по объёму» или «по алфавиту». Если задан план, рядом с числом операций показывается процент его выполнения. +* Карточка ревьюера — «Операций», «План», «Активность», «По дням», распределение вердиктов и «Где размечал». Клик по столбику в «По дням» фильтрует журнал по этому дню. +* Метрика — «Операции» или «Маркеры». «Операции» — транзакции разметки за период, то есть выполненная работа. «Маркеры» — находки, на которых сейчас стоит вердикт ревьюера; они считаются по одной ветке, поэтому ветку нужно выбрать в блоке «Ветка». +* Таблица — в метрике «Операции» колонки «Время», «Проект», «Вид», «Комментарий» и «Что поставлено», в метрике «Маркеры» — «Файл», «Детектор», «Размечено», «Сообщение» и «Вердикт». Раскрытие строки операции показывает маркеры, которых она коснулась. +* «Скачать .csv» — выгрузка строк таблицы с учётом выбранных фильтров. + +{{< alert level="info" >}} +Если журнал за период слишком велик, виджет показывает только последние операции и предупреждает об этом; числа в карточке ревьюера при этом занижены. Чтобы увидеть полные данные, сузьте период. +{{< /alert >}} + ### S3 bucket Виджет позволяет просматривать содержимое S3-совместимых хранилищ объектов, таких как Amazon S3, Yandex Object Storage, MinIO и другие. diff --git a/content/documentation/release-notes/v1.7.0.ru.md b/content/documentation/release-notes/v1.7.0.ru.md new file mode 100644 index 00000000..bad76ea4 --- /dev/null +++ b/content/documentation/release-notes/v1.7.0.ru.md @@ -0,0 +1,11 @@ +--- +title: v1.7.0 +weight: 890 +description: Заметки о выпуске v1.7.0 — виджет «Активность разметки Svacer». +--- + +## Новые возможности + +### Виджеты + +Добавлен виджет [«Активность разметки Svacer»](../../admin/widgets/types/#активность-разметки-svacer): показывает, кто и сколько размечает находки в Svacer за выбранный период, с планом разметки на ревьюера и выгрузкой журнала в CSV.