SHiNE-server/docs/UI-Design/VALIDATION.md

Проверка HTML-мокапов

Дата: 22.09.2026.

Выполнено

• node --check channels-v1/mockups.js — синтаксис JavaScript корректен.
• CSS разобран PostCSS без ошибок синтаксиса.
• В изолированном jsdom проверены все четыре направления: начальная отрисовка, поиск и отсутствие результатов, фильтр «Мои», открытие канала, роли читателя/владельца, переключение лайка, открытие ветки, ответ конкретному участнику, неактивная пустая отправка, сохранение черновика при закрытии, успешная отправка, независимый контекст второй публикации.
• Проверено, что HTML-подобный текст ответа отображается как текст, без создания пользовательских HTML-элементов.
• Проверены выбор/удаление вложения и возможность отправить вложение без текста, переключение макета клавиатуры, Escape и снятие inert с основного содержимого.
• Проверены публикация владельца и её сохранение при переключении роли, отдельное открытие каждого из четырёх вариантов через ?variant=.
• После последних изменений повторены синтаксическая проверка и проверки взаимодействий — успешно.
• Git показывает только новую папку docs/UI-Design/. Существующие файлы приложения не изменялись.

Инструменты DOM-проверки и временный сценарий установлены в /tmp/shine-ui-review-gporxy, зависимости приложения не менялись.

Ограничения проверки

Подключённый Browser недоступен: runtime сообщил No browser is available, список браузеров пуст. Скриншоты не получены. jsdom проверяет структуру и поведение, но не рассчитывает реальную геометрию и не заменяет визуальную проверку браузером.

Перед переносом в приложение обязательна проверка в реальном браузере: ширины 320/390/430 px, увеличение текста, длинные названия, прокрутка и восстановление позиции, экранная клавиатура Android/iOS, фокус и screen reader, контраст, состояния загрузки и ошибки. Эмуляция клавиатуры в галерее показывает только занятое ею место.

Никакие серверные операции, публикации, загрузки файлов или изменения production не выполнялись.

Уточнение документа 0.2

22.09.2026, после выбора пользователем направления:

• Обновлены DESIGN.md и README.md; HTML-галерея оставлена историческим референсом, это явно отмечено в обоих документах.
• Убраны устаревшие вопросы о выборе темы/редактора и указания показывать статистику лайков или оглавление вне меню.
• Добавлены единые компоненты, цвета двух тем, компактная шапка, полноэкранный редактор, состояния и матрица приёмки будущего переноса.
• Локально рассчитан контраст основных пар цветов. Основной текст/фон: ночь 15.34:1, день 12.98:1. Вторичный текст/фон: ночь 7.45:1, день после коррекции 5.26:1. Вторичный текст/выбранная поверхность: ночь 5.10:1, день 4.55:1. Текст акцентной кнопки: ночь 9.86:1, день 5.88:1. Граница контрола/поверхность: ночь 4.10:1, день 3.29:1.
• Эти числа относятся к непрозрачным цветам токенов. Проверка реальных CSS-состояний, прозрачностей, наложений, всех статусных цветов и геометрии потребуется при реализации; полного аудита доступности пока нет.
• Изменения документа не означают обновления приложения или визуальной проверки итогового сочетания.