---
id: "SPEC-UI-101"
title: "Интерфейс и общие компоненты"
type: "SPEC-UI"
source: {"kind": "prototype-baseline", "entry": "html/app/web.html", "contract-ref": null}
depends-on: ["SPEC-ARCH-101"]
ai-provenance: {"generated-by": "OpenAI Codex", "generated-at": "2026-11-11T11:26:09Z", "prompt-template": null, "context-tokens": null, "output-tokens": null, "human-edits": false}
---

# SPEC-UI-101. Интерфейс и общие компоненты

## Источники

Реестр маршрутов и ссылки на эталонные HTML-макеты приведены в [SPEC-ARCH-101](SPEC-ARCH-101.md). Светлая и тёмная темы зафиксированы в парных макетах W1–W5. W6 и W7 показывают состояния загрузки поиска и карточки отеля.

## Нормы интерфейса

1. Экран должен использовать токены и компоненты [UI Kit](../../../html/ui-kit/index.html), общие [токены](../../../html/assets/tokens.css) и [стили компонентов](../../../html/assets/components.css).
2. Для каждого нового компонента или нового состояния сначала должна быть записана спецификация анатомии, размеров, токенов, поведения и доступности. Затем компонент должен появиться в UI Kit до использования в макете.
3. Для экрана с загрузкой данных интерфейс должен показывать скелетон формы основного контента при длительной загрузке. Для восстанавливаемой сетевой ошибки интерфейс должен предоставлять повтор запроса.
4. При изменении интерфейса сначала актуализируется RENAR, затем макет, затем соответствующий экран мок-приложения.

## Экранные требования

- **W1 Лендинг.** [SR-101](../sr/SR-101.md).
- **W2 Поиск.** [SR-102](../sr/SR-102.md).
- **W3 Карточка отеля.** [SR-103](../sr/SR-103.md).
- **W4 Оформление.** [SR-104](../sr/SR-104.md).
- **W8 Детали брони.** [SR-105](../sr/SR-105.md).
- **W5 Личный кабинет.** [SR-106](../sr/SR-106.md).
- **W9 Вход гостя.** [SR-107](../sr/SR-107.md).
- **W10 Поддержка.** [SR-108](../sr/SR-108.md).
- **W11 Информационные страницы.** [SR-109](../sr/SR-109.md).

## Адаптация визуального языка Rest&Go для веба

Уточнение заказчика от 12.11.2026. Веб-приложение использует Inter, черничный акцент, нейтральные контуры и серию иллюстраций Rest&Go в светлой и тёмной темах. Токены акцента #5C527E / #FFFFFF и #AFA2D4 / #211B30, контуры #DDD5E6 и #4B435A. Экраны поиска, отеля, оформления, кабинета, поддержки, входа и справочных страниц используют общую систему поверхностей и типографики. Основные подписи — от 14 px, интерактивные области — от 44 px. Боковое меню кабинета сохраняет веб-компоновку. Колонки складываются на узком экране.

- Главная объясняет сервис, показывает визуальный гайд и затем карту с поиском. Полный гайд доступен по /guide. На главной гайд содержит четыре равновысокие иллюстрированные карточки. Выбор карточки открывает инструкцию в отдельном окне: верификация, оплата, аренда, заселение и выезд. Текст описывает возможности веб-мока и указывает, где продолжить сценарий в приложении.
- W2 и W3 сохраняют рабочую карту, фильтры, галерею локации и список капсул. У карточки капсулы и в W4 используется доступное фото, иначе фирменная зарисовка. Галерея показывает фотографии локации при наличии. Отзывы доступны по отдельному действию.
- W4 использует пошаговую форму и компактный итог справа на широком экране. Сумма, отдельный залог и основное действие видны сразу. Состав цены, промокод и бонусы раскрываются по запросу. Правила доступны до оплаты. Ошибка платежа, отсутствие карты и истечение времени имеют явные подписи.
- W8 показывает иллюстрированный итог сразу после оплаты. Данные аренды, залог и доступ к брони размещаются отдельными группами. Таймеры брони и проживания показывают событие, отсчёт, срок и иллюстрацию. Текущие брони доступны в «Моих шерингах».
- W10 показывает вопрос первым, а соответствующую ему зарисовку в отдельной ячейке. Ответ раскрывается ниже отдельной строкой и не перекрывает заголовок или изображение. Длинные вопросы переносятся. Фильтрация по темам и открытие чата сохраняются.

## Карта и навигация веб-приложения

Уточнение заказчика от 12.11.2026. Главная W1 размещает знакомство с Rest&Go, визуальный гайд и карту именно в этом порядке. Действие «Найти капсулу» в первом блоке переводит фокус в поиск на этой же странице. Вкладка «Капсулы» открывает главную W1 с описанием и гайдами. Прямой URL поиска W2 сохраняется. W1 и W2 используют один компонент поиска. Карта находится в адаптивном блоке 16:9. Поиск и фильтры расположены над картой, рядом с ней или ниже на узком экране доступен переход к «Моим шерингам». Подсказки поиска включают адреса и названия опубликованных локаций и места из демонстрационного справочника. Поиск допускает неполный адрес и обычные различия в пунктуации. Обычная прокрутка над картой прокручивает страницу, масштаб меняется кнопками или колесом с Ctrl. При открытии видны карта, поиск по городу, адресу или названию локации, геолокация, масштаб, QR и вход в фильтры. QR использует камеру браузера или ручной ввод кода. Список доступен по явному запросу и показывает тот же набор локаций. Состояние без результатов отображается рядом с поиском. Карта, подсказки, фильтры и повтор запроса остаются доступны. Геолокация запрашивает разрешение браузера. При отказе пользователь может указать адрес.

Верхняя панель повторяет порядок, иконки, контраст и округлую форму навигации приложения: «Профиль», «Капсулы», «Поддержка». Размер текста адаптирован под веб. Активный раздел отмечен. «Мои шеринги» находятся в профиле. Переключатель темы расположен рядом с панелью и сохраняет выбор. На широком и узком экране панель остаётся вверху при прокрутке. Её полупрозрачный фон слегка размывает содержимое позади панели.

При выборе метки локации или результата поиска открывается окно «Выберите модуль» с адресом и списком модулей. Для каждого модуля указаны тип, номер, вместимость, площадь, доступность и цена. Занятый модуль допускает выбор времени, недоступный помечается отдельно. Выбор модуля переключает окно на его галерею, описание, оснащение и форму бронирования. Для галереи используются фото конкретного модуля, а при отсутствии фото показываются подписанные демонстрационные виды снаружи и внутри. На широком экране сведения и форма размещаются рядом, на узком форма следует за сведениями. Возврат к списку сохраняет локацию и карту. Бронь продолжает существующий сценарий времени, тарифа, верификации, оплаты и управления проживанием. QR сразу открывает найденный модуль. В подтверждённой брони действие «Я на месте» открывает подсказку по заселению и ведёт к ключу. Ключ поддерживает кнопку открытия и QR конкретной капсулы, а чек-листы используют существующие действия брони. Пустые состояния, локации без фотографий и окна с подсказками используют соответствующие зарисовки из UI Kit. Реальные фотографии остаются доступны в галерее и карточках при наличии. Форма оплаты и действия с бронью используют те же поверхности, шрифт, контуры и черничный акцент. Переходы, масштабирование и появление диалога учитывают настройку уменьшенного движения. Диалог поддерживает закрытие клавишей Escape и возвращает фокус на элемент вызова.


## Компоновка, карта и справочные страницы

Под картой W1/W2 расположена компактная легенда, поясняющая метку, кластер и переход к списку. Карта 16:9 использует черничные маркеры и собственные цвета подложки в обеих темах. В окне выбора модуля сначала показаны доступные, затем модули с выбором времени и недоступные. Заголовок локации и адрес отделены от списка. В строке выделены название, статус и цена. Разметка удерживает текст и действия внутри карточек при узком экране и длинных подписях.

Правила, политика обработки данных, оферта и страница партнёров используют фирменные зарисовки, Inter, черничные акценты, контуры и адаптивную типографику. В документах визуально разделены вступление и разделы. Текст документов сохраняется.


## Контейнеры и выбор времени на узком экране

Карточка гайда размещает заголовок и пояснение над зарисовкой. Зарисовка полностью видна в отдельной области одинаковой высоты. Длинные подписи переносятся и не заходят на соседние элементы. Карта 16:9 получает тонкий черничный контур с внутренним световым краем. Шапка и подвал используют компактные зарисовки Rest&Go, сохраняют читаемость и доступность действий на узком экране.

В окне модуля и на шаге «Время и тариф» даты размещаются в переносимой сетке. Выбранный день подписан полностью. Селектор времени, тарифы, суммы, подсказки и действия остаются в пределах своих колонок. Узкий экран использует вертикальную раскладку формы и итогов. Длинный диалог прокручивается по вертикали, закрытие доступно сверху. При смене дня или тарифа предыдущий расчёт не используется, пока текущий выбор не подтверждён.


## Контраст элементов и плавность веб-интерфейса

В строке поиска адрес, кнопка «Найти» и соседние действия выровнены по центру. Поле и кнопка имеют одинаковую высоту. Подсказки открываются под полем и не сдвигают строку. Полосы прокрутки скрыты, прокрутка страницы, списка и диалогов остаётся доступной мышью, клавиатурой и жестом.

Шапка и подвал сохраняют исходный фон. В узкой декоративной полосе проигрывается одна и та же история Rest&Go: персонаж подходит с сумкой, бронирует капсулу, отдыхает и уходит. Полоса не перекрывает навигацию, текст и ссылки. Анимация длится 20 секунд и зациклена с 10-секундной паузой после ухода персонажа. Проходы плавные, без вертикальных скачков. У бронирования и отдыха есть отдельные остановки, между зарисовками плавная смена прозрачности. Когда полоса выходит из видимой области, цикл приостанавливается и возобновляется с того же места при возвращении. При уменьшенном движении показывается статичная зарисовка отдыха.

Сегментные переключатели, включая «Сейчас» и «Запланировать», ракурсы «Снаружи» и «Внутри», тарифы и выбор модуля имеют различимые границы, фон и состояние выбора в обеих темах. В веб-интерфейсе используются короткие переходы для страниц, диалогов, смены шага и состояния элементов. При предпочтении уменьшенного движения эти переходы отключаются.


## Мои отзывы в профиле

Профиль предоставляет вход в «Мои отзывы». Отдельно показаны завершённые аренды, ожидающие оценки, и отзывы гостя. Открывается одна форма из профиля и итога выезда. Общая оценка обязательна, критерии «Чистота», «Комфорт», «Тишина» необязательны. В сохранённом отзыве видны те же подписи и выставленные баллы от 1 до 5. Для новых отзывов пропущенный критерий обозначается «Не оценено». Исторические отзывы показывают сохранённые значения. После отправки аренда исчезает из списка ожидающих оценки.

### Веб-прототип 07.1 «Черничные детали»

Отдельный веб-вход сохраняет верхнюю навигацию, переключатель темы, гайд и ссылки на документы. Палитра, прозрачные зарисовки и компоненты общие с мобильным вариантом 07.1. На широком экране карта располагается под кратким знакомством с сервисом, в блоке 16:9, на узком экране высота карты сохраняет место для управления. Лупа открывает общий поиск и фильтры. Актуальная бронь, выбор локации и модуля используют мобильные данные.

Гостевые маршруты используют те же модули, что и приложение: вход и верификация, бронирование, промокод и бонусы, билет и чек, доступ и заселение, продление и выезд, оценки, профиль, способы оплаты, уведомления и чат. Веб-вход фиксирует канал `web`. История отзывов использует веб-список и ведёт в общую форму оценки. Камера, геолокация, открытие дверей и оплаты работают в рамках возможностей браузера и демонстрационных интеграций.

В обоих веб-входах актуальные брони, фото, оплата, ключ и подтверждение условий используют общие компоненты из SPEC-UI-08. Основной сайт сохраняет свою карту, а выбранные в ней тариф и время передаются в общий экран оформления.

Уточнение к общим компонентам: в оплате остаются ссылки на документы, открывающиеся внутри приложения поверх текущего экрана. Список актуальных броней раскрывается от трёх карточек, при двух используется карусель.

После выбора тарифа гостевой веб-путь ведёт сразу к оплате. Дополнительные услуги приобретаются отдельно на экране управления активным проживанием.
