Домики · Rest&Go

renar/guest-app/spec/SPEC-UI-03.md · Исходный файл

SPEC-UI-03. Поиск

Уточнение от 12.11.2026: компоновка карты, QR и карточка капсулы. При расхождении применяется уточнение.

1. Назначение

Документ описывает главный экран приложения — карту со свободными капсулами — и путь от карты к решению «бронировать эту капсулу». Принцип шерингового приложения: гость видит, что свободно рядом прямо сейчас, сколько это стоит и что входит в цену, не выбирая город и даты.

Карта C-10 — первый экран приложения: при запуске система открывает её без онбординга и входа (SR-02#1, решение заказчика 11.11.2026, ADAPT-001 B-035). При первом запуске системный запрос геолокации показывается поверх карты, без поясняющего экрана (SR-02#2).

2. Scope

Входит: C-10 Карта (с поиском, чипами, пинами, шторкой, состояниями), C-11 Фильтры, C-12 Карточка отеля, C-13 Карточка капсулы, полноэкранная галерея.

Не входит: веб-раскладка «список слева, карта справа» (ТЗ §6); динамические цены — для меток «Высокий спрос» и «−15 %» оставлено место (SPEC-UI-01 3.7.8), логика не описывается; лимиты воды и электричества (ТЗ C-13 «Душ: 15 мин включено» — показываются строкой из справочника, без счётчиков).

3. Разделы, специфичные для типа

3.1. Общая структура

C-10 — экран запуска приложения и корень вкладки «Карта»; после splash приложение открывает C-10 (SR-02#1). C-12 и C-13 открываются в стеке вкладки. C-11 — модальная шторка на 90 %. Термины интерфейса (B-013): «отель» — площадка с капсулами; «капсула» — номер; «бронь» — существительное, «забронировать» — действие.

3.2. Экраны

C-10. Карта

Слои сверху вниз:

Слой Содержимое Нормы
Карта полноэкранная, стиль подложки — светлый минималистичный (приглушённые дороги #E6E8EC, вода #DCE6F5, POI скрыты кроме транспорта); в тёмной теме — тёмный стиль провайдера SPEC-INT-01 (Яндекс MapKit)
Поиск поле 48 на bg/screen, radius/full, elevation/1, отступы 16 сверху от safe area и по бокам; иконка search 20, плейсхолдер «Адрес, аэропорт, вокзал»; справа кнопка фильтров 40 (sliders-horizontal) с бейджем числа активных фильтров (SR-14#2); справа от поля вне его — кнопка bell 40 на bg/screen с точкой непрочитанных SPEC-UI-01 3.7.2, 3.7.26
Баннер геолокации при отказе в доступе: строка 48 под поиском, status/warning/bg, иконка map-pin-off, «Включите геолокацию», ghost «Настройки» (SR-12#1) —
Чипы ряд под поиском, отступ 8: «Сейчас», «На ночь», «С душем», «Self-service дешевле» — это быстрые значения фильтров C-11 и синхронизированы с ними 3.7.4
Пины пин каждого опубликованного отеля видимой области (SR-10#1) одного цвета action/primary с минимальной ценой «от 590 ₽» или «от 4 500 ₽/ночь», без статусной окраски и числа свободных (SR-10#2); близкие пины объединяются в кластер с числом отелей, нажатие приближает карту (SR-10#3); решение заказчика 11.11.2026, B-036 3.7.13
«Моё местоположение» круглая кнопка 44 bg/screen, elevation/1, иконка locate-fixed, справа, 16 над шторкой —
Шторка 3 положения: свёрнута «12 отелей рядом», половина, весь экран; список карточек отелей по возрастанию расстояния (SR-11#1) 3.7.14, 3.7.11

Если цена «1 ч» у отеля отсутствует, пин показывает минимальный доступный тариф с его единицей: «от 4 500 ₽/ночь» (TC-027-neg). Статус доступности и число свободных капсул показываются в шторке и карточке отеля, не на пине.

Действия:

Состояния:

Состояние Отображение ref
Загрузка шимер-скелетон: пины — пилюли 32×72 на позициях последнего ответа, в шторке — заголовок и 3 карточки отеля; поиск, чипы и подложка карты статичны; обновление после перемещения — полоса прогресса без скелетона SR-60#1, SPEC-UI-01 §3.7.24
Нет геолокации баннер; карта центрирована на последнем адресе поиска или центре города по умолчанию (Москва) SR-12#1
Нет отелей в видимой области шторка в положении «половина» с пустым состоянием: иллюстрация, «Рядом нет капсул», строка «Ближайший: Rest&Go Истра, 42 км», secondary M «Показать» (сдвигает карту) SR-13#1
Нет сети баннер «Нет соединения. Данные на 14:20» и последние загруженные пины SR-60#2

Под шторкой при текущей брони видна плашка брони (SR-30#1).

C-11. Фильтры

Модальная шторка 90 %, заголовок «Фильтры», крестик; контент прокручивается; низ — закреплённая пара кнопок.

Секция Контрол Значения
Когда сегмент + выбор даты «Сейчас» / «Выбрать дату и время»
Длительность чипы (одиночный выбор) 1 ч, 3 ч, 6 ч, Ночь, Сутки
Цена за выбранную длительность слайдер диапазона 0 – 10 000 ₽, шаг 100 ₽
Тип капсулы чипы (множественный выбор, из справочника) Базовая, Комфорт, Work & Rest, Премиум, Семейная
Уровень сервиса чипы «Полностью готова», «Self-service, дешевле»
Удобства чипы с иконками (множественный) Душ, Санузел, Рабочее место, ТВ, Парковка, Для двоих
Минимальный рейтинг сегмент Любой, 4+, 4,5+

Низ: ghost «Сбросить» слева (SR-14#3) и primary L «Показать 3 отеля» справа — число обновляется не позднее 1 с после изменения (SR-14#4); при 0 — кнопка disabled «Нет подходящих отелей». Применение фильтров оставляет на карте только отели, у которых хотя бы одна капсула подходит под каждый фильтр одновременно (SR-14#1).

C-12. Карточка отеля

Прокручиваемая страница, app bar прозрачный поверх галереи и становится bg/screen после прокрутки на высоту галереи; действия app bar: назад.

Сверху вниз:

  1. Галерея 16:10 на всю ширину без полей, счётчик «1 / 12» (3.7.19).
  2. Заголовок: название title/2 (до 2 строк) → адрес callout text/secondary → строка: «0,8 км · 10 мин пешком» caption и secondary S «Маршрут» с иконкой navigation (SR-15#3).
  3. Рейтинг компактный; тап → C-25.
  4. Удобства на территории: ряд до 5 колонок, иконка 28 + подпись caption под ней (парковка, общая кухня, вендинг, душевая, Wi-Fi); при более чем 5 — горизонтальная прокрутка.
  5. Капсулы — главный блок: заголовок title/3 «Капсулы» и счётчик caption «Свободно 3 из 5»; переключатель «Показать занятые» справа (по умолчанию выключен, SR-15#2, B-011); вертикальный список карточек капсул (3.7.12) с бейджем, ценой «N ₽/ч» и «Выбрать» (SR-15#1). Недоступные капсулы не показываются.
  6. Об отеле: описание body (4 строки и ghost «Подробнее»); правила проживания — 3 пункта с иконками и ghost «Все правила».
  7. Отзывы: средняя оценка, 2 – 3 последние карточки отзывов (SPEC-UI-06), ghost «Все отзывы» → C-25.
  8. Как добраться: мини-карта 16:9 radius/l с пином (тап — полноэкранная карта), текстовая инструкция body, строка-плашка «Поддержка: круглосуточно» из часов работы поддержки.

Загрузка (SR-60#1, SPEC-UI-01 §3.7.24): скелетоном — галерея, название, адрес, рейтинг, удобства, 2 карточки капсул, описание, отзывы, мини-карта; app bar и заголовки разделов статичны; «Маршрут» disabled.

Действия: «Выбрать» → C-13 этой капсулы; «Маршрут» → выбор навигатора (Яндекс Карты, Яндекс Навигатор, 2ГИС, Apple / Google Maps), при отсутствии — веб-маршрут.

C-13. Карточка капсулы

App bar: назад, заголовок «Капсула №3» после прокрутки. Снизу закреплена панель CTA (bg/screen, elevation/2, отступ 12): слева «от 690 ₽ / ч» (price/l + caption), справа primary M «Забронировать от 690 ₽» (SR-16#3). Для капсулы, занятой сейчас, — secondary M «Выбрать время» → C-14 в режиме «Запланировать».

Сверху вниз (референс-компоновка «Snow Minimal»):

  1. Галерея 16:10 с полями 16, radius/l, счётчик.
  2. Название: «Капсула Comfort» title/2 → рейтинг компактный «★ 4.8 (2 340 отзывов)».
  3. Описание body text/secondary, 2 строки.
  4. Ключевое оснащение: ряд из 3 – 4 равных колонок: иконка 28 + подпись caption (Wi-Fi, Кондиционер, Приватность, Душ).
  5. Статус и чистота: бейдж статуса → строка callout с иконкой sparkles «Убрана сегодня в 14:20» (SR-16#1) → «Чистота 4,9» (рейтинг чистоты).
  6. Строка-плашка адреса: map-pin «Москва, ул. Лесная, 7» и справа «2,4 км ›» → C-12.
  7. Параметры: таблица 2 колонки: Тип, Площадь «8 м²», Вместимость «1 гость», Уровень сервиса.
  8. Оснащение полностью: сетка 2 колонки, иконка 20 + подпись callout.
  9. Что включено: строки callout из справочника лимитов («Душ: 15 мин включено»).
  10. Тарифы: таблица: длительность слева callout, цена справа body/strong; строка «Продление — 590 ₽/ч» (SR-16#2).
  11. Залог: строка-плашка status/info/bg: «Залог 1 000 ₽ — заблокируем при оплате и вернём после выселения»; при 0 ₽ — «Без залога» (SR-16#2).
  12. Отзывы о капсуле: 2 карточки и ghost «Все отзывы».

Загрузка (SR-60#1, SPEC-UI-01 §3.7.24): скелетоном — галерея, название, рейтинг, описание, оснащение, статус и уборка, адрес, значения параметров, тарифы, залог, отзывы и цена в панели CTA; заголовки разделов статичны; «Забронировать» disabled.

3.3. User journeys

J3.1 Найти капсулу «прямо сейчас» (ТЗ §4, сц. 1, шаги 1 – 3)

№ Действие Результат ref
1 Запускает приложение после splash сразу C-10, без онбординга и входа SR-02#1
1a При первом запуске отвечает на системный запрос геолокации поверх карты C-10 центрирована на госте либо с баннером «Включите геолокацию» SR-02#2, SR-12#1
1b Смотрит на карту C-10 с пинами отелей видимой области SR-10#1
2 Смотрит на пины на каждом минимальная цена «от N ₽», пины одного цвета SR-10#2
3 Нажимает на кластер близких отелей карта приближена, кластер раскрыт в отдельные пины SR-10#3
4 Поднимает шторку список по расстоянию SR-11#1
5 Тапает на пин превью и «Подробнее» SR-11#2
6 Нажимает «Подробнее» C-12 со списком свободных капсул SR-15#1
7 Нажимает «Выбрать» C-13 с временем уборки SR-16#1
8 Прокручивает C-13 тарифы и залог SR-16#2
9 Нажимает «Забронировать от N ₽» C-14; без входа — диалог C-02d «Войдите, чтобы забронировать» (SPEC-UI-02) SR-16#3, SR-01#2

J3.2 Найти по адресу с фильтрами

№ Действие Результат ref
1 Вводит «Шереметьево», выбирает подсказку карта на аэропорте SR-12#2
2 Открывает фильтры, включает «С душем» число на кнопке обновлено SR-14#4
3 Нажимает «Показать 1 отель» на карте подходящие отели SR-14#1
4 Возвращается на карту бейдж «1» на кнопке фильтров SR-14#2
5 Открывает фильтры, «Сбросить» фильтры сняты SR-14#3

J3.3 Пустые и аварийные ситуации

№ Действие Результат ref
1 Открывает карту без разрешения геолокации баннер «Включите геолокацию» SR-12#1
2 Сдвигает карту в область без отелей ближайший отель и расстояние SR-13#1
3 Включает «Показать занятые» на C-12 занятые капсулы с «Занята до 18:00» SR-15#2
4 Нажимает «Маршрут» выбор навигатора SR-15#3

3.4. Сквозные элементы

Экраны доступны без авторизации (SR-01#1). Ошибка загрузки C-12 или C-13 — полноэкранное состояние «Нет соединения» (SR-60#2). Отсутствие фото — заглушка image-off. Карточки выдерживают произвольное число удобств и строк справочника (ТЗ §8).

3.5. Тон и стиль

По SPEC-UI-01 3.10. Цена всегда с единицей времени; расстояние — с одним знаком после запятой до 10 км, далее целым.

3.6. Accessibility

Каждый пин доступен диктору как кнопка: «Rest&Go Сити, от 590 рублей»; кластер — «3 отеля, приблизить». Список в шторке дублирует пины — с ним гость с диктором проходит сценарий без карты. Галерея: каждое фото с alt из подписи справочника, либо «Фото капсулы, 1 из 12».

3.7. i18n

Подсказки адресов — на языке интерфейса, если провайдер карт возвращает перевод; иначе — оригинал. Единицы: «км», «мин»; в EN — «km», «min».

4. Связь с требованиями

BR-01; SR-10, SR-11, SR-12, SR-13, SR-14, SR-15, SR-16; SR-02 (запуск на карте); частично SR-01 (просмотр без входа), SR-30 (плашка).

5. Связь с другими SPEC

depends-on: SPEC-UI-01, SPEC-DATA-01 (поля отеля и капсулы, статусы), SPEC-INT-01 (карты, навигаторы).

6. Verification

TC-004, TC-005, TC-026 … TC-043 и парные -neg (SR-02, SR-10 … SR-16), см. TRACEABILITY.md. Сквозной путь — SPEC-UC-01.

Метаданные RENAR
id: SPEC-UI-03
title: "Поиск: карта, фильтры, карточка отеля, карточка капсулы (C-10 – C-13)"
type: SPEC-UI
source: { adapt: ADAPT-001, adapt-section: "Forward §2; B-011, B-013, B-021, B-035, B-036, B-037", tz-section: "§5.2 C-10 – C-13; §3.2; решение заказчика 11.11.2026" }
depends-on: [SPEC-UI-01, SPEC-DATA-01, SPEC-INT-01]
screens: [C-10, C-11, C-12, C-13]
ai-provenance:
  generated-by: "anthropic-claude-opus-5-5@2026-11-11"
  generated-at: "2026-11-11T12:00:00Z"
  prompt-template: "renar-agent-ru.md@1.0"
  context-tokens: null
  output-tokens: null
  human-edits: false