docs: record visual reference review

2026-09-21 07:49:14 +07:00
parent 9c521514fc
commit 94f9e408fb
2 changed files with 40 additions and 5 deletions
@@ -0,0 +1,35 @@
+# UX reference review — 2026-09-21
+
+## Reproducible capture
+
+Команда:
+
+```bash
+node scripts/capture-visual-matrix.mjs \
+  --base-url http://127.0.0.1:4321 \
+  --output /tmp/rf4-visual-matrix-20260921
+```
+
+Результат текущего прохода: `168` screenshots и `manifest.json` во внешней
+директории — `14` маршрутов × `4` ширины (`320/390/768/1280`) × `3` режима
+(`system/light/dark`). `document overflow: 0`.
+
+## Representative manual review
+
+В Chromium вручную просмотрены light/mobile (`390 × 844`) snapshots для:
+
+- главной страницы — header, hero, карточки точек, empty/long content и footer;
+- `/status` — source cards, legend, status labels и footer;
+- `/waterbodies/р-вьюнок` — breadcrumb, title block, data passport, empty state;
+- `/admin` — admin navigation, token form, CTA и footer.
+
+На этих кадрах не обнаружены горизонтальная обрезка, выход контента за viewport,
+сломанные изображения или потеря читаемого focus/контраста из-за декоративных
+элементов. Это representative review, а не утверждение production acceptance.
+
+## Limits and follow-up
+
+PNG намеренно не добавляются в репозиторий: capture остаётся воспроизводимым
+внешним артефактом, а долговременное хранение reference-набора требует отдельного
+решения. Production Lighthouse/CLS/INP и time-to-first-useful-answer также
+остаются открытыми до пилота.