feat(workforce): explain role profile scoring

docs/DETMIR_COMMERCIAL_MODULES_RU.md

@@ -52,13 +52,26 @@ Runtime-файл на сервере портала:
 - `default_role` задает роль для агрегированного отчета;
 - `planned_hours_per_day` задает плановый рабочий день для роли;
 - `default_weight` применяется к приложениям без явного правила;
-- `application_weights` задает веса приложений по подстроке имени.
+- `application_weights` задает веса приложений по подстроке имени;
+- `description` объясняет бизнес-смысл роли и используется для прозрачной
+  интерпретации weighted KPI.
 
 Пример логики:
 
 - бухгалтер: `1C = 1.0`, `Excel = 0.9`, `YouTube = 0.0`;
-- продажи: `CRM = 1.0`, `browser = 0.8`, `mail = 0.8`;
-- разработчик: `IDE/code = 1.0`, `terminal = 0.9`, `browser = 0.7`.
+- оператор: `1C/CRM/RDP = 0.9..1.0`, офис и почта ниже;
+- разработчик: `IDE/code = 1.0`, `terminal = 0.9`, `browser = 0.7`;
+- администратор: `RDP/SSH/terminal/monitoring = 0.9..1.0`;
+- менеджер/продажи: `CRM/mail/browser/documents = 0.7..1.0`.
+
+JSON отчета содержит объяснение расчета:
+
+- активная роль;
+- доступные роли;
+- плановое время;
+- фактическое app time;
+- взвешенное время;
+- matched rule по каждому приложению из top breakdown.
 
 После изменения runtime-файла нужно перезапустить портал:
 

docs/DETMIR_PORTAL_GUI_PLAN_RU.md

@@ -35,6 +35,10 @@ baseline и раздела `Phase 8: Post-MVP Enhancements`.
 - отчет поддерживает `Взвешенную активность` при наличии
   `/etc/detmir-portal-workforce-policy.json`; публичный пример лежит в
   `configs/detmir-workforce-policy.example.json`;
+- пример policy содержит типовые роли `accountant`, `operator`, `developer`,
+  `admin`, `manager`, `sales`;
+- JSON портала возвращает объяснение расчета weighted KPI: активную роль,
+  каталог ролей, planned/app/weighted seconds и matched rule по приложениям;
 - отчет использует Worktime management snapshot и показывает сравнение
   подразделений/ответственных за текущий день;
 - JSON отчета содержит `workforce.department_comparison`,