feat: add UI/visual testing to pipeline

docs/architecture/ui-testing.md

@@ -0,0 +1,40 @@
+# UI / Visual Testing
+
+## Обзор
+
+UI тесты — часть шага тестирования в пайплайне orchestrator.
+Аналитик пишет тест-кейсы → тестировщик выполняет через Playwright + vision-анализ.
+
+## Инфраструктура
+
+- Runner: /home/slin/tools/ui-test/run_tests.js
+- Chromium: ~/.cache/ms-playwright/chromium_headless_shell-1217/
+- Шаблон тест-кейсов: tests/ui/TEST_CASES_TEMPLATE.md
+
+## Процесс
+
+### Аналитик
+Создаёт docs/work-items/<ET-xxx>/04b-ui-test-cases.md по шаблону.
+Обязательно если задача добавляет или меняет UI.
+
+### Тестировщик
+```
+node /home/slin/tools/ui-test/run_tests.js \
+  docs/work-items/<ET-xxx>/04b-ui-test-cases.md \
+  /tmp/ui-screenshots/<ET-xxx>/
+```
+Читает PNG через Filesystem, анализирует через vision, пишет секцию в 13-test-report.md.
+
+## Severity
+
+| Уровень | Описание | Действие |
+|---------|----------|----------|
+| P0/P1 | Элемент не отображается, поломка верстки | back-to:dev |
+| P2 | Заметный визуальный дефект | FAIL |
+| P3 | Косметика | WARN |
+
+## Ограничения
+
+- WebGL (MapLibre) → software renderer в headless. Карта рендерится, но может отличаться.
+- Тайлы грузятся по сети — wait: 4000-5000 обязателен.
+- Скриншоты в /tmp/ — не коммитятся, артефакты run.