# 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.