test: add browser conformance smoke

2026-06-07 20:36:26 +03:00
parent 5820de1d85
commit 037d47b592
6 changed files with 343 additions and 9 deletions
@@ -0,0 +1,80 @@
+# Browser Conformance Smoke
+
+`scripts/browser-conformance-smoke.mjs` проверяет, что ключевые блоки портала
+AWatch-rus реально отображаются в браузере. Проверка не оценивает дизайн,
+цвета, pixel-perfect верстку или бизнес-корректность данных.
+
+## Что проверяется
+
+- Executive view:
+  - KPI;
+  - Explainable KPI;
+  - Risk Narrative;
+  - Recommended Actions.
+- Workforce view:
+  - KPI;
+  - сравнение подразделений;
+  - статус тренда;
+  - Explainable KPI.
+- Security view:
+  - события безопасности;
+  - связь рисков и активности;
+  - Recommended Actions для ИБ;
+  - кандидаты на проверку.
+- Forensics view:
+  - расследования;
+  - timeline событий;
+  - материалы расследования;
+  - аудит.
+
+Также проверяется:
+
+- страница не пустая;
+- нет browser page errors;
+- нет console errors;
+- нет HTTP 500 responses;
+- создаются screenshots.
+
+## Как запускать
+
+Сначала запустить портал AWatch-rus. Затем:
+
+```bash
+AWATCH_BROWSER_SMOKE_URL=http://127.0.0.1:8720/portal/ \
+  node scripts/browser-conformance-smoke.mjs
+```
+
+Если портал защищен basic auth:
+
+```bash
+AWATCH_BROWSER_SMOKE_BASIC_AUTH='<BASE64_USER_PASSWORD>' \
+AWATCH_BROWSER_SMOKE_URL=https://<PORTAL_HOST>/portal/ \
+  node scripts/browser-conformance-smoke.mjs
+```
+
+## Артефакты
+
+Скриншоты сохраняются в:
+
+```text
+artifacts/browser-smoke/
+```
+
+Минимальный набор:
+
+- `executive.png`;
+- `workforce.png`;
+- `security.png`;
+- `forensics.png`.
+
+Каталог является runtime artifact и не предназначен для коммита в Git.
+
+## Ограничения
+
+- Smoke не добавляет новые API, UI, данные или claims.
+- Smoke не доказывает production performance.
+- Smoke не заменяет ручную демонстрационную проверку перед показом заказчику.
+- Smoke не проверяет весь портал: только ключевые блоки Executive, Workforce,
+  Security и Forensics.
+- Risk Narrative проверяется в Executive view. Security view проверяет
+  существующий блок связи рисков и активности, без ML/LLM claims.
@@ -165,3 +165,65 @@ docs/BROWSER_CONFORMANCE_RU.md
 4. Примеры screenshots.
 5. Результаты smoke.
 6. Ограничения.
+
+---
+
+## Выполнение
+
+Статус: выполнено.
+
+Используемый инструмент:
+
+- Playwright через существующий локальный loader проекта.
+
+Создан smoke:
+
+- `scripts/browser-conformance-smoke.mjs`.
+
+Создана документация:
+
+- `docs/BROWSER_CONFORMANCE_RU.md`.
+
+Обновлен README:
+
+- добавлена ссылка на browser conformance smoke.
+
+Проверяемые страницы/роли:
+
+- Executive / `data-view-mode="executive"`;
+- Workforce / `data-view-mode="manager"`;
+- Security / `data-view-mode="security"`;
+- Forensics / `data-view-mode="forensics"`.
+
+Проверяемые блоки:
+
+- KPI;
+- Explainable KPI;
+- Risk Narrative;
+- Recommended Actions;
+- Department Comparison;
+- Trend Status;
+- события безопасности;
+- связь рисков и активности;
+- Investigation data;
+- timeline событий;
+- материалы расследования;
+- аудит.
+
+Примечание: отдельный блок Risk Narrative проверяется в Executive view. В
+Security view smoke проверяет уже существующий блок связи рисков и активности,
+не добавляя новый UI и не создавая новый claim.
+
+Screenshots:
+
+- `artifacts/browser-smoke/executive.png`;
+- `artifacts/browser-smoke/workforce.png`;
+- `artifacts/browser-smoke/security.png`;
+- `artifacts/browser-smoke/forensics.png`.
+
+Ограничения:
+
+- smoke не проверяет дизайн pixel-perfect;
+- smoke не добавляет новые API, UI или данные;
+- screenshots являются runtime artifacts и не коммитятся в Git;
+- live customer-stand visual validation остается отдельным acceptance шагом.