enduro-trails/docs/architecture/ui-testing.md

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