From 5820de1d85b2015c5299ce2c38f6a9fa004c2ef1 Mon Sep 17 00:00:00 2001
From: IgorRachkov <89467086+igor04091968@users.noreply.github.com>
Date: Sun, 7 Jun 2026 20:25:46 +0300
Subject: [PATCH] Add visual conformance smoke testing documentation

---
 .../TASK_012_VISUAL_CONFORMANCE_SMOKE.md      | 167 ++++++++++++++++++
 1 file changed, 167 insertions(+)
 create mode 100644 docs/roadmap/TASK_012_VISUAL_CONFORMANCE_SMOKE.md

diff --git a/docs/roadmap/TASK_012_VISUAL_CONFORMANCE_SMOKE.md b/docs/roadmap/TASK_012_VISUAL_CONFORMANCE_SMOKE.md
new file mode 100644
index 0000000..b8efdf3
--- /dev/null
+++ b/docs/roadmap/TASK_012_VISUAL_CONFORMANCE_SMOKE.md
@@ -0,0 +1,167 @@
+# docs/roadmap/
+
+## Рекомендуемые параметры
+
+Mode: xhigh
+Reasoning: maximum
+Task type: visual validation
+Quality bar: production-ready
+Breaking changes: forbidden
+Architecture changes: forbidden
+New features: forbidden
+
+## Цель
+
+Добавить автоматическую проверку того, что ключевые элементы портала реально отображаются в браузере.
+
+Не добавлять новый функционал.
+
+Проверять существующий.
+
+---
+
+## Контекст
+
+После TASK_011 выявлен gap:
+
+Отсутствует browser-level conformance validation.
+
+Есть API smoke.
+
+Есть docs smoke.
+
+Есть deployment smoke.
+
+Но нет проверки визуального отображения ключевых блоков.
+
+---
+
+## Что реализовать
+
+Создать browser smoke.
+
+Рекомендуется:
+
+* Playwright
+
+или
+
+* существующий инструмент проекта, если он уже есть.
+
+---
+
+## Проверяемые страницы
+
+Проверить наличие:
+
+### Executive
+
+* KPI
+* Explainable KPI
+* Risk Narrative
+* Recommended Actions
+
+### Workforce
+
+* KPI
+* Department Comparison
+* Trend Status
+
+### Security
+
+* UEBA
+* Risk Narrative
+* Recommended Actions
+
+### Forensics
+
+* Reports
+* Investigation data, если уже есть
+
+---
+
+## Проверяемые элементы
+
+Не проверять дизайн.
+
+Проверять:
+
+* наличие блоков;
+* наличие заголовков;
+* отсутствие ошибки рендера;
+* отсутствие пустой страницы;
+* отсутствие 500.
+
+---
+
+## Screenshots
+
+Сохранять screenshots:
+
+```text
+artifacts/browser-smoke/
+```
+
+Минимум:
+
+* executive.png
+* workforce.png
+* security.png
+* forensics.png
+
+---
+
+## Smoke Script
+
+Создать:
+
+```text
+scripts/browser-conformance-smoke.*
+```
+
+---
+
+## Documentation
+
+Создать:
+
+```text
+docs/BROWSER_CONFORMANCE_RU.md
+```
+
+Описать:
+
+* что проверяется;
+* ограничения;
+* как запускать.
+
+---
+
+## Запрещено
+
+Не делать:
+
+* новые API;
+* новые UI;
+* новые данные;
+* новые claims.
+
+---
+
+## Критерии приемки
+
+* browser smoke существует;
+* screenshots генерируются;
+* smoke проходит локально;
+* документация добавлена.
+
+---
+
+## Финальный отчет
+
+1. Используемый инструмент.
+2. Проверяемые страницы.
+3. Проверяемые блоки.
+4. Примеры screenshots.
+5. Результаты smoke.
+6. Ограничения.