feat(portal): add department business risk

2026-06-04 12:52:40 +03:00
parent a30ab9cc95
commit 27e9ef2046
4 changed files with 386 additions and 3 deletions
@@ -0,0 +1,79 @@
+# Business Risk
+
+`Business Risk` - управленческий слой AWatch-rus / DetMir, который показывает
+не просто активность сотрудников, а зоны организационного риска по
+подразделениям.
+
+## Назначение
+
+Слой предназначен для руководителя и собственника бизнеса. Он отвечает на
+вопросы:
+
+- где KPI активности нельзя считать надежным;
+- где активность подразделения снижена;
+- где есть падение тренда;
+- где проблемные рабочие места портят доверие к отчету.
+
+Business Risk не является автоматическим обвинением сотрудников или
+подразделений. Это read-only приоритизация управленческой проверки.
+
+## API
+
+`GET /api/reports` отдает массив `business_risk`.
+
+Элемент массива:
+
+- `department` - подразделение;
+- `trust_score` - доверие к KPI в процентах;
+- `activity_score` - индекс активности подразделения в процентах;
+- `trend` - `RISING`, `STABLE`, `FALLING` или `UNKNOWN`;
+- `risk_level` - `LOW`, `MEDIUM`, `HIGH` или `CRITICAL`.
+
+## Логика риска
+
+На риск влияют:
+
+- низкий `trust_score`;
+- низкий `activity_score`;
+- падающий тренд активности;
+- отсутствие телеметрии;
+- наличие проблемных узлов в SLA покрытия агентов.
+
+`local_fallback` не считается подтвержденным KPI. Если телеметрия свежая, но
+пришла из диагностического fallback-источника, она может подтверждать факт
+наличия агента, но снижает доверие к KPI и повышает бизнес-риск.
+
+## UI
+
+В портале отображается карточка `Риски подразделений`.
+
+Показывается ТОП-10 подразделений с максимальным риском:
+
+- подразделение;
+- trust KPI;
+- активность;
+- тренд;
+- уровень риска.
+
+## Markdown
+
+Оперативный отчет содержит раздел:
+
+```text
+## Риски подразделений
+```
+
+Раздел можно использовать в PDF/Markdown-отчете для руководителя.
+
+## Executive Summary
+
+Executive summary показывает до 3 наиболее рискованных подразделений, если
+их уровень риска выше `LOW`.
+
+## Ограничения
+
+- Это proxy-модель управленческого риска, а не юридическое заключение.
+- Для точной интерпретации нужны корректные expected nodes, стабильная
+  telemetry и актуальные department rollups.
+- Если данных по подразделению нет, риск может повышаться из-за недостаточной
+  доказательной базы, а не из-за фактической работы сотрудников.