docs: enter demo freeze housekeeping

2026-06-07 21:17:12 +03:00
parent 037d47b592
commit 1b817866a4
29 changed files with 495 additions and 58 deletions
@@ -309,4 +309,72 @@ docs/EXPLAINABLE_KPI_RU.md
 5. Добавленные UI-блоки.
 6. Добавленные тесты.
 7. Результаты проверок.
-8. Известные ограничения.
+8. Известные ограничения.
+
+---
+
+## Выполнение
+
+Статус: выполнено для Pilot v1.
+
+Краткое описание:
+
+- добавлен explainability-контракт Workforce KPI;
+- добавлен endpoint `GET /api/workforce/kpi/explain`;
+- добавлена детерминированная rule-based модель факторов;
+- добавлен confidence level `high` / `medium` / `low`;
+- UI показывает блок `Почему такой индекс активности?`;
+- Markdown-отчет содержит explainability-раздел;
+- OpenAPI и TypeScript contracts включают explain model;
+- employee-level детализация не добавлена без отдельного безопасного контракта.
+
+Ключевые файлы:
+
+- `adk-rust/crates/detmir-portal/src/workforce_kpi_explain.rs`;
+- `adk-rust/crates/detmir-portal/src/static/app.js`;
+- `adk-rust/crates/detmir-portal/src/contracts/openapi.json`;
+- `adk-rust/crates/detmir-portal/src/contracts/typescript.d.ts`;
+- `docs/EXPLAINABLE_KPI_RU.md`.
+
+API endpoint:
+
+- `GET /api/workforce/kpi/explain`.
+
+Модель explainability:
+
+- `kpi_score`;
+- `confidence`;
+- `coverage`;
+- `factors`;
+- `top_applications`;
+- `warnings`;
+- `recommendations`.
+
+Минимальные факторы:
+
+- `productive_activity`;
+- `business_app_usage`;
+- `idle_time`;
+- `afterhours_activity`;
+- `remote_session_activity`;
+- `data_coverage`;
+- `missing_data`;
+- `trend_change`.
+
+Проверки:
+
+- unit tests для explainability-модели и confidence;
+- role-filtering smoke;
+- markdown/report smoke;
+- `cargo fmt --all --check`;
+- `cargo clippy --all-targets --all-features -- -D warnings`;
+- `cargo test --all`;
+- `cargo build --release`;
+- portal smoke.
+
+Известные ограничения:
+
+- не используется ML, LLM или predictive scoring;
+- KPI не является HR-дисциплинарной оценкой;
+- персональная explainability-модель в Pilot v1 не включена;
+- качество объяснения зависит от свежести и полноты источников.