@@ -487,8 +496,8 @@
function appendHighlighted(parent, value, query) {
const text = String(value || '');
if (!query) { parent.textContent = text; return; }
- const escaped = query.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
- const pattern = new RegExp(escaped, 'giu');
+ const terms = query.split(/\s+/).map((term) => `${term.replace(/[.*+?^${}()|[\]\\]/g, '\\$&')}${/^\p{L}{5,}$/u.test(term) ? '\\p{L}{0,2}' : ''}`);
+ const pattern = new RegExp(terms.join('\\s+'), 'giu');
let cursor = 0;
for (const match of text.matchAll(pattern)) {
parent.append(document.createTextNode(text.slice(cursor, match.index)));
@@ -804,6 +813,17 @@
$('document-dialog').addEventListener('close', () => $('document-dialog').classList.remove('search__expanded'));
$('sources-open').addEventListener('click', () => $('sources-dialog').showModal());
$('sources-close').addEventListener('click', () => $('sources-dialog').close());
+ document.addEventListener('keydown', (event) => {
+ if (event.key !== 'Tab') return;
+ const dialog = document.querySelector('dialog[open]');
+ if (!dialog) return;
+ const controls = [...dialog.querySelectorAll('a[href], button:not([disabled]), input:not([disabled]), select:not([disabled]), textarea:not([disabled]), [tabindex]:not([tabindex="-1"])')].filter((item) => item.getClientRects().length && getComputedStyle(item).visibility !== 'hidden');
+ if (!controls.length) { event.preventDefault(); dialog.focus(); return; }
+ const active = document.activeElement;
+ if (!dialog.contains(active) || (event.shiftKey && active === controls[0]) || (!event.shiftKey && active === controls.at(-1))) {
+ event.preventDefault(); (event.shiftKey ? controls.at(-1) : controls[0]).focus();
+ }
+ });
async function loadUsers() {
$('users-error').textContent = '';
const response = await apiFetch('/admin/users');
diff --git a/docs/product/frontend-pixel-perfect-plan.md b/docs/product/frontend-pixel-perfect-plan.md
index 66e37a9..13dd5b4 100644
--- a/docs/product/frontend-pixel-perfect-plan.md
+++ b/docs/product/frontend-pixel-perfect-plan.md
@@ -2,11 +2,14 @@
Дата: 23 октября 2026 года.
-Статус: основная реализация и локальная визуальная приёмка выполнены в
-`feature/frontend-pixel-perfect`. Playwright-сценарий и снимки находятся в
-репозитории; см. [отчёт](visual-review/README.md). Отдельные состояния и
-доступность перечислены как непроверенные в отчёте; CI следует сверять по
-последнему коммиту ветки.
+Статус: основная реализация и локальная приёмка выполнены в
+`feature/frontend-pixel-perfect`; после первичного прогона скорректированы
+навигация, плотность результатов, заголовок документа, fixture-контент и
+клавиатурный trap для диалогов. Скриншоты, покропленные сравнения и расширенный
+Playwright-сценарий находятся в репозитории; см. [отчёт](visual-review/README.md).
+Локальные тесты и guards из CI прошли. Ожидают runner: проверки Compose/Caddy и
+сборка production images. Независимый review запускает владелец. Скринридер и
+реальный корпус всё ещё требуют проверки.
## 1. Цель, границы и источники истины
@@ -82,24 +85,24 @@ Figma-макет с Auto Layout и переменными, ссылающийс
## 3. Этап 0 — воспроизводимый эталон
-- [ ] Перед реализацией перечитать актуальные инструкции, `DESIGN.md`,
- реализацию маршрутов и обязательные проверки; проверить доступность
- установленного Ponytail согласно правилам репозитория.
-- [ ] Сохранить чужие незакоммиченные изменения. Обновить локальный `main`
- из remote и создать тематическую `feature/` или `fix/` ветку безопасным
- способом, не перенося посторонние изменения в PR.
-- [ ] Зафиксировать основной viewport 1280×800 CSS px, браузер и его версию,
- ОС, масштаб 100%, device scale factor и высоты остальных viewport.
+- [x] Перед реализацией перечитать актуальные инструкции, `DESIGN.md`,
+ реализацию маршрутов и обязательные проверки; использовать установленный
+ Ponytail согласно правилам репозитория.
+- [x] Сохранить чужие незакоммиченные изменения, создать тематическую
+ `feature/` ветку и не переносить посторонние изменения в PR.
+- [x] Зафиксировать основной viewport 1280×800 CSS px, браузер и его версию,
+ ОС, масштаб 100%, device scale factor и остальные viewport в отчёте.
- [ ] Получить исходный снимок текущего интерфейса на тех же размерах.
-- [ ] Подготовить детерминированные тестовые данные: запрос «налог на прибыль»,
+- [x] Подготовить детерминированные тестовые данные: запрос «налог на прибыль»,
три результата из изображения, выбран первый, открыта соответствующая
- демонстрационная редакция, одинаковые фильтры и положение прокрутки.
-- [ ] Изолировать fixture от реального режима и пометить демонстрационное
- содержимое. Не добавлять подмену юридических данных в production-путь.
-- [ ] Нормализовать сохранённое изображение до 1280×800 без изменения
+ демонстрационная редакция, фильтр статуса и исходная прокрутка.
+- [x] Изолировать fixture от реального режима и пометить демонстрационное
+ содержимое только в тестовом сценарии. Не добавлять подмену юридических данных
+ в production-путь.
+- [x] Нормализовать сохранённое изображение до 1280×800 без изменения
пропорций и сохранить параметры подготовки эталона.
-- [ ] Записать выявленные конфликты изображения с нормативной типографикой
- и токенами; разрешить их до настройки мелких деталей.
+- [x] Записать конфликты изображения с нормативной типографикой и токенами;
+ согласованные ограничения приведены в отчёте.
Критерий завершения: один и тот же тестовый сценарий воспроизводится
независимо от состояния OpenSearch и текущей реальной выдачи; реальный режим
@@ -107,24 +110,29 @@ Figma-макет с Auto Layout и переменными, ссылающийс
## 4. Этап 1 — карта геометрии
-Ниже предварительные ориентиры по вложению 1280×800. Это ещё не точные
-измерения и не универсальные CSS-константы для любого экрана.
+Эталон 1586×992 пропорционально вписан в 1280×800; фактические значения
+сверены с Playwright при device scale factor 1. Допуск границ крупных зон —
+около 1 CSS px.
-| Область | Начальный ориентир |
-|---|---|
-| Шапка | y = 0–76 px |
-| Навигация и активные фильтры | y = 76–126 px |
-| Рабочая область | y = 126–743 px |
-| Footer | y = 743–800 px |
-| Фильтры | x = 0–226 px; ширина около 226 px |
-| Результаты | x = 226–648 px; ширина около 422 px |
-| Документ | x = 648–1280 px; ширина около 632 px |
+| Область | Нормализованный эталон | Реализация |
+|---|---:|---:|
+| Шапка и строка навигации | y ≈ 0–126 px | y = 0–127 px |
+| Рабочая область | y ≈ 126–744 px | y = 127–744 px |
+| Footer | y ≈ 744–800 px | y = 744–800 px |
+| Фильтры | x ≈ 0–226 px | x = 0–226 px |
+| Результаты | x ≈ 226–648 px | x = 226–648 px |
+| Документ | x ≈ 648–1280 px | x = 648–1280 px |
-- [ ] Уточнить координаты по исходнику и заполнить таблицу фактических
- измерений: границы, внутренние отступы, высоты полей и кнопок,
- межстрочные интервалы, положение текста и разделителей.
-- [ ] Описать поведение сетки вне 1280×800: фиксированная/ограниченная
- ширина фильтров и гибкие результаты/документ с минимальными ширинами.
+Внутренние контрольные координаты и ограничения см. в
+[отчёте визуальной приёмки](visual-review/README.md); там же есть overlay и
+разница по каждой крупной области.
+
+- [x] Измерить крупные границы, основную навигацию и ключевые элементы
+ документа по исходнику; фактические значения записаны в отчёте.
+- [ ] Измерить все внутренние отступы, размеры полей и кнопок, межстрочные
+ интервалы и разделители по всем областям.
+- [x] Зафиксировать адаптивные точки и проверить сетку на 1440/1024/390/320 px;
+ реальные длинные данные ещё не проверены.
- [ ] Разделить метрики повторяемых элементов и высоты, зависящие от текста.
Не выравнивать принудительно высоту всех результатов или разделов.
- [ ] Определить владельца прокрутки каждой области, поведение footer
@@ -135,10 +143,10 @@ Figma-макет с Auto Layout и переменными, ссылающийс
## 5. Этап 2 — разделение сценариев и базовых стилей
-- [ ] Разделить композиции поиска и лаборатории, сохранив маршруты,
+- [x] Разделить композиции поиска и лаборатории, сохранить маршруты,
авторизацию, кабинет, управление пользователями, обучение и черновики.
-- [ ] Ограничить лабораторные элементы маршрутом `/review`, включая
- панель проверяющего и сохранения.
+- [x] Ограничить лабораторные элементы маршрутом `/review`, включая
+ панель проверяющего и сохранения; маршрут проверен браузерным тестом.
- [ ] Использовать общий слой семантических токенов и базовых элементов;
стили поискового экрана изолировать BEM-классами.
- [ ] Устранить дублирующие и неиспользуемые правила, исправить класс статьи.
@@ -158,14 +166,14 @@ Figma-макет с Auto Layout и переменными, ссылающийс
- [ ] Поставить локальные WOFF2 Noto Sans 400/500/600 и Noto Serif 600/700
с лицензиями; исключить случайное синтетическое начертание.
-- [ ] Проверить загрузку, `font-display`, кириллицу и `Ө ө Ү ү Ң ң`.
+- [x] Проверить загрузку, `font-display`, кириллицу и `Ө ө Ү ү Ң ң`.
Визуальные снимки выполнять после `document.fonts.ready`.
- [ ] Подготовить SVG-знак по визуальному направлению референса;
сверить размер, толщину линий и положение относительно названия.
- [ ] Подготовить отдельный симметричный золотистый SVG-орнамент,
`aria-hidden`, без перекрытия управления и текста.
-- [ ] Подготовить favicon SVG и растровый fallback для 16×16/32×32;
- подключить в ``, проверить выдачу, MIME и вид во вкладке.
+- [x] Подготовить favicon SVG и растровый fallback 32×32; подключить
+ в ``, проверить выдачу и MIME. Масштабирование SVG проверено визуально.
- [ ] Подготовить единые SVG-иконки поиска, очистки, календаря, печати,
оглавления, разворачивания и стрелок; иконкам-кнопкам дать доступные имена.
- [ ] Перенести значения в токены, не размножать HEX по компонентам.
@@ -201,8 +209,9 @@ Figma-макет с Auto Layout и переменными, ссылающийс
## 8. Этап 5 — рабочее поведение и интеграция
- [ ] Сохранить поиск, сортировку, пагинацию, загрузку редакций и языков.
-- [ ] Синхронизировать состояние с URL, восстановление по ссылке и историю
- навигации; отдельный фильтр удаляется без сброса остальных.
+- [x] Синхронизировать фильтры с URL и удалять отдельный фильтр без сброса
+ остальных; сохранение второго фильтра проверяется Playwright.
+- [ ] Проверить восстановление и историю навигации через прямые ссылки и Back/Forward.
- [ ] Согласовать вид фильтров с контрактом: текущий API принимает одиночные
значения. Не имитировать множественный выбор checkbox без поддержки API.
Если нужен multiselect, отдельно описать и проверить расширение контракта.
@@ -218,8 +227,8 @@ Figma-макет с Auto Layout и переменными, ссылающийс
ссылки и таблицы; не вставлять пользовательский запрос через `innerHTML`.
- [ ] Реализовать разворачивание/возврат с сохранением выбранной редакции,
прокрутки и корректного фокуса.
-- [ ] Добавить печать через print CSS: документ, его реквизиты и источник
- без поисковых и служебных панелей.
+- [x] Добавить печать через print CSS: документ, его реквизиты и источник
+ без поисковых и служебных панелей; служебные элементы проверены в print media.
- [ ] Защитить смену запроса/документа/редакции от запоздавших ответов
через отмену запроса или проверку актуальности результата.
- [ ] Сохранить безопасный вывод очищенного документного HTML и ссылок,
@@ -232,20 +241,26 @@ Figma-макет с Auto Layout и переменными, ссылающийс
- [ ] Настроить размеры, веса, line-height и отступы после фиксации сетки.
Сверить переносы названия документа, результатов и плотность абзацев.
-- [ ] Проверить 1280×800 и ширины 1440/1024/390 px, включая длинный контент.
- Высоты и параметры окружения записать в отчёте, breakpoints выбирать
- по фактическому помещению содержимого.
-- [ ] На узких экранах открывать фильтры отдельной доступной панелью,
- документ — отдельным представлением с возвратом к результатам.
-- [ ] Сокращать/убирать орнамент на телефоне; сохранять текст без
- горизонтальной прокрутки, таблицы — в собственной области прокрутки.
-- [ ] Проверить длинные RU/KY-названия, одноязычную редакцию, отсутствие
- текста/редакций, много фильтров, широкие таблицы, изображения и ссылки.
-- [ ] Проверить loading, empty, error, retry, disabled, hover и focus-visible;
- сообщение об ошибке не уничтожает введённый запрос или черновик.
-- [ ] Проверить Tab/Enter/Escape, возврат фокуса, доступные имена,
- live-сообщения, контраст, масштабирование и `prefers-reduced-motion`.
- Компактный desktop не уменьшает touch-области ниже требований `DESIGN.md`.
+- [x] Проверить 1280×800 и ширины 1440/1024/390 px; дополнительно 320 px.
+ Высоты и параметры окружения записаны в отчёте.
+- [ ] Проверить реальные длинные редакции, длинные названия на RU/KY и подобрать
+ breakpoints на реальных данных корпуса.
+- [x] На узких экранах открывать фильтры отдельной доступной панелью,
+ документ — отдельным представлением с возвратом к результатам; проверено на 390 px.
+- [x] Сокращать/убирать орнамент на телефоне; сохранять текст без
+ горизонтальной прокрутки, широкие таблицы — в собственной области прокрутки.
+ Проверено синтетической широкой таблицей; реальные таблицы корпуса остаются открыты.
+- [x] Проверить длинные названия, отсутствие редакций, широкую таблицу и
+ широкое изображение синтетическими данными.
+- [ ] Проверить одноязычные реальные редакции, ссылки, много фильтров и
+ длинный контент из реального корпуса.
+- [x] Проверить загрузку редакции, empty, search/edition error, retry,
+ disabled-состояние без редакции и focus-visible; query сохраняется при ошибке.
+- [ ] Проверить hover и сценарии ошибок авторизации/администрирования.
+- [x] Проверить Tab/Shift+Tab/Escape, возврат фокуса мобильной панели и
+ диалогов, а также `prefers-reduced-motion`.
+- [ ] Проверить доступные имена всех элементов, live-сообщения, контраст,
+ масштабирование, скринридер и touch-области на поддерживаемых устройствах.
Критерий завершения: точность desktop не приводит к переполнению,
недоступности действий или потере контекста на узком экране.
@@ -257,13 +272,13 @@ Figma-макет с Auto Layout и переменными, ссылающийс
подтверждающий проход. Новые циклы обосновывать конкретными оставшимися
дефектами или замечаниями независимого reviewer, не бесконечной полировкой.
-- [ ] Дождаться шрифтов, изображений и стабильных данных; отключить
- влияющую на снимок анимацию, задать исходную прокрутку.
-- [ ] Открыть каждый снимок и убедиться, что это правильный сценарий,
- а не login, ошибка, незагруженная страница или другой маршрут.
-- [ ] Для 1280×800 подготовить overlay 50%, difference image и отдельные
+- [x] Дождаться шрифтов и стабильных fixture-данных, задать исходную
+ прокрутку; снимки делаются после `document.fonts.ready`.
+- [x] Проверить, что снимки показывают загруженный поисковый сценарий, а не
+ login, ошибку или другой маршрут.
+- [x] Для 1280×800 подготовить overlay 50%, difference image и отдельные
сравнения шапки, фильтров, результатов, документа и footer.
-- [ ] Сохранить снимки остальных размеров и отчёт с условиями, отклонениями,
+- [x] Сохранить снимки остальных размеров и отчёт с условиями, отклонениями,
исправлениями и известными ограничениями.
- [ ] Передать независимому reviewer запрос пользователя, эталон,
`DESIGN.md`, этот план, diff и снимки всех проверенных размеров.
@@ -292,17 +307,18 @@ Figma-макет с Auto Layout и переменными, ссылающийс
backend — до `0.13.0` для allowlist-выдачи локальных шрифтов. Контракт Search
API v1 не менялся.
-- [ ] Выполнить все проверки из актуальных `AGENTS.md` и CI: backend,
- Telegram bot, backup, deploy, host guard, verifier guard, shell syntax,
- Compose/Caddy и production images в предусмотренном окружении.
-- [ ] Добавить проверки фактических изменений: выдача static/favicon,
- браузерные сценарии поиска/редакций/поиска внутри/навигации и регрессии
- лаборатории. Для визуального сравнения использовать стабильный fixture.
-- [ ] Повысить frontend semver по реальному объёму: minor при добавлении
- совместимых функций; patch для одних исправлений. Backend повышать,
- если меняется его поведение; версии в footer должны быть согласованы.
-- [ ] После первого commit выполнить push, найти существующий PR ветки
- через `gitea-api`; создать один PR в `main`, только если его ещё нет.
+- [x] Выполнить доступные локально проверки из `AGENTS.md` и CI: backend,
+ Telegram bot, backup, deploy, host/root/verifier/audit/Compose/production
+ config/runner guards, shell syntax и Playwright.
+- [ ] Получить успешный CI на назначенном runner: `docker compose config`,
+ проверка Caddyfile и сборка backend/OpenSearch production images.
+- [x] Добавить проверки фактических изменений: static/favicon, браузерные
+ сценарии поиска/редакций/поиска внутри/навигации и регрессии лаборатории;
+ визуальное сравнение использует стабильный fixture.
+- [x] Повысить версии для совместимого функционального изменения;
+ frontend/backend версии согласованы в footer.
+- [x] Выполнить push и найти существующий PR ветки через `gitea-api`;
+ изменения остаются в одном PR #53.
- [ ] После каждого push независимый reviewer проверяет полный текущий PR,
прежние исправления и оставляет краткий PR-комментарий с явным выводом
о наличии или отсутствии блокирующих замечаний; reviewer не редактирует код.
diff --git a/docs/product/visual-review/README.md b/docs/product/visual-review/README.md
index 46e0d07..9b9cd5d 100644
--- a/docs/product/visual-review/README.md
+++ b/docs/product/visual-review/README.md
@@ -3,7 +3,8 @@
Проверка выполнена 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.
+320×800 CSS px. Среда: Ubuntu 26.04 LTS под WSL2 Linux x86_64, Chromium
+156.0.8078.4 headless, масштаб 100%, device scale factor 1.
## Снимки
@@ -14,10 +15,26 @@
- [Overlay 50% с приложенным референсом](overlay-50.png)
- [Карта абсолютной разницы пикселей](pixel-difference.png)
+Покропленные сравнения областей для отдельного просмотра:
+
+| Область | Overlay | Разница пикселей |
+|---|---|---|
+| Шапка и навигация | [Overlay](region-header-overlay.png) | [Diff](region-header-difference.png) |
+| Фильтры | [Overlay](region-filters-overlay.png) | [Diff](region-filters-difference.png) |
+| Результаты | [Overlay](region-results-overlay.png) | [Diff](region-results-difference.png) |
+| Документ | [Overlay](region-document-overlay.png) | [Diff](region-document-difference.png) |
+| Footer | [Overlay](region-footer-overlay.png) | [Diff](region-footer-difference.png) |
+
## Фактическая проверка
-- При 1280×800 шапка занимает 127 px, рабочая область — y=127–744,
- footer — y=744–800; границы колонок x=0/226/648/1280.
+- Снимок референса 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, включая кириллические наборы; повторяющихся
@@ -27,18 +44,34 @@
- Мобильная панель фильтров удерживает фокус в цикле, делает фон inert,
показывает 3 px focus ring, закрывается по Escape и возвращает фокус на
кнопку открытия.
-- Playwright проверил фильтры и URL, открытие редакции, поиск по документу
+- Playwright проверил сохранение второго фильтра при удалении первого, URL,
+ открытие редакции, поиск по документу
(1-е и 2-е совпадения), независимость языка текста от языка интерфейса,
отображение поисковых подписей и выбранного статуса на кыргызском,
- разворачивание документа, открытие кабинета с действиями профиля,
- пользователей и выхода, мобильную панель фильтров и возврат к результатам,
- а также изоляцию маршрутов поиска и `/review`.
+ разворачивание документа, действия профиля/пользователей/выхода, мобильную
+ панель и возврат к результатам, изоляцию `/review`, ошибки поиска и редакции,
+ повтор после ошибки и отсутствие доступных редакций.
+- Проверены print CSS (служебные панели скрыты, документ и официальный источник
+ остаются), горизонтальная прокрутка широкой таблицы и изображения внутри
+ документа без общей прокрутки страницы, длинные названия, `prefers-reduced-motion`,
+ ошибки/повтор после ошибки, состояние без редакций, загрузка и сохранение
+ остальных URL-фильтров при удалении одного.
+- Для фильтров и открытых `