Files
akyldash/docs/product/visual-review/README.md
agent aae9657b9e
CI / tests-and-images (pull_request) Successful in 2m25s
Runner smoke test / runner-smoke (pull_request) Successful in 2s
fix(review): position tutorial hints beside targets
2026-10-23 11:08:57 +03:00

9.0 KiB
Raw Permalink Blame History

Приёмка поискового экрана и лаборатории

Проверка выполнена 23 октября 2026 года в Chromium 156.0.8078.4, Playwright 1.64.1, headless, device scale factor 1. Макеты проверены при 1280×800, 1440×900, 1024×900 и 390×844 CSS px; reflow дополнительно проверен при 320×800 CSS px. Среда: Ubuntu 26.04 LTS под WSL2 Linux x86_64, Chromium 156.0.8078.4 headless, масштаб 100%, device scale factor 1.

Снимки

Покропленные сравнения областей для отдельного просмотра:

Область Overlay Разница пикселей
Шапка и навигация Overlay Diff
Фильтры Overlay Diff
Результаты Overlay Diff
Документ Overlay Diff
Footer Overlay Diff

Фактическая проверка

  • Снимок референса 1586×992 пропорционально вписан в 1280×800. Границы крупных зон расходятся с реализацией не более чем на 1 CSS px: колонки x=0/226/648/1280; рабочая область начинается около y=126, заканчивается на y=744; footer — y=744–800.
  • Вторая строка навигации измерена по макету: поиск x=26–123, «Источники» x=146–245, язык x=285–373, статус x=381–486, начало демо-подписи x=511. Референсная подпись и элементы попадают в эти координаты с расхождением около 1–2 px; у статуса остаётся несколько лишних пикселей по ширине.
  • Горизонтального переполнения при 1440, 1024 и 390 px нет.
  • При 320 px также нет горизонтального переполнения.
  • Загружены Noto Sans и Noto Serif, включая кириллические наборы; повторяющихся HTML id нет, ошибок JavaScript в сценарии не зарегистрировано.
  • В fixture проверены ответы 200 для SVG и PNG favicon; локализация проверена на фильтрах, результатах, счётчике совпадений и открытом статусе.
  • Мобильная панель фильтров удерживает фокус в цикле, делает фон inert, показывает 3 px focus ring, закрывается по Escape и возвращает фокус на кнопку открытия.
  • Playwright проверил сохранение второго фильтра при удалении первого, URL, открытие редакции, поиск по документу (1-е и 2-е совпадения), независимость языка текста от языка интерфейса, отображение поисковых подписей и выбранного статуса на кыргызском, разворачивание документа, действия профиля/пользователей/выхода, мобильную панель и возврат к результатам, изоляцию /review, ошибки поиска и редакции, повтор после ошибки и отсутствие доступных редакций.
  • Проверены print CSS (служебные панели скрыты, документ и официальный источник остаются), горизонтальная прокрутка широкой таблицы и изображения внутри документа без общей прокрутки страницы, длинные названия, prefers-reduced-motion, ошибки/повтор после ошибки, состояние без редакций, загрузка и сохранение остальных URL-фильтров при удалении одного.
  • Для фильтров и открытых <dialog> проверены Tab/Shift+Tab, Escape и возврат фокуса. При Tab с последней кнопки в кабинете обнаружено и исправлено выпадение фокуса на body; повторный прогон подтверждает цикл внутри диалога. Полный скринридерный аудит этим не заменяется.
  • Обучающая подсказка /review проверена на всех четырёх шагах при 1280×800 и 390×844: карточка не шире 320 px, использует Noto Sans/Noto Serif, полупрозрачный фон и располагается у целевого элемента без пересечения. Снимки первого шага сохранены для desktop и mobile.

Для снимков Playwright перехватывал API и отдавал локальные детерминированные fixture-ответы. Подпись «Демонстрационные данные» добавлялась только в тестовой странице перед снимком. Эти юридические тексты и результаты не входят в код продукта. Для overlay и difference исходный растр 1586×992 вписывается в 1280×800 с сохранением пропорций и полем около 1 px по бокам. В эталоне нет кнопки кабинета; в интерфейсе она сохранена для доступности действий учётной записи и остаётся заметным дополнительным элементом справа во второй строке. Макет показывает язык поиска как удаляемый чип, интерфейс использует доступный select; это функциональное расхождение пока оставлено явно видимым. Содержимое документа, системный формат даты и сглаживание текста также не совпадают попиксельно с концептом.

Повторный запуск

Из корня репозитория выполните cd tools/frontend-visual-review, затем npm ci, npx playwright install chromium и npm test. Скрипт читает текущий backend/search/review.html, перехватывает API детерминированными fixture- ответами и обновляет перечисленные выше снимки. Overlay и pixel-difference создаются, если найден исходный файл по стандартному пути или передан путь в переменной REFERENCE_IMAGE.

Оставшиеся визуальные отличия

Сглаживание текста и содержимое документа отличаются от растрового макета. Поля даты показывают системный формат Chromium. Переключатель языка интерфейса и поле языка поиска остаются разными состояниями; в макете язык показан как удаляемый чип. Дополнительная кнопка кабинета отсутствует в концепте. Не проверялись полный набор ошибок авторизации, скринридер, видимый фокус на каждом шаге, длинные реальные редакции и таблицы из корпуса. Автоматические снимки показывают композицию, но не подтверждают юридическое содержимое или доступность во всех браузерах.