Домики · Rest&Go

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

SPEC-UI-04. Бронирование и оплата

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

Документ описывает поток от выбора капсулы до подтверждённой брони: время и тариф, дополнительные услуги, сводка и оплата, экран подтверждения с таймером на дорогу. Гость видит каждую сумму, залог и правила отмены до нажатия «Оплатить».

2. Scope

Входит: C-14 Время и тариф, C-15 Дополнительные услуги, C-16 Подтверждение и оплата, C-16e Ошибка оплаты (состояние C-16, адресуемое отдельно), C-17 Бронь подтверждена.

Не входит: динамическое ценообразование (метки — место в плитке тарифа); подписка и B2B-оплата; экран 3-D Secure (рендерит платёжный провайдер, SPEC-INT-01).

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

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

Поток — полноэкранная модалка поверх вкладки. App bar: крестик (закрытие с диалогом «Прервать бронирование?»), заголовок шага, индикатор «1 из 3». Низ каждого шага — закреплённая панель: слева итог текущего выбора («1 690 ₽ · 3 ч»), справа primary M «Далее». Неавторизованный или неверифицированный гость попадает в поток «Вход» (SPEC-UI-02) до C-14 (SR-01#2, SR-06#1).

3.2. Экраны

C-14. Время и тариф

  1. Шапка брони: миниатюра 48 radius/m → «Капсула Comfort · №3» body/strong → «Rest&Go Сити» caption.
  2. Сегмент «Сейчас» / «Запланировать» (по умолчанию «Сейчас»; для занятой сейчас капсулы — «Запланировать»).
  3. Дата и время заезда (только «Запланировать»): строка-плашка «Заезд: 12 нояб., 10:00» → шторка выбора даты и времени (SPEC-UI-01 3.7.7), шаг 30 мин, горизонт 30 дней (SR-20#4, B-010). Когда выбрана «Ночь», шторка должна предлагать только дату, а время заезда должно быть 22:00 (B-038).
  4. Длительность: заголовок title/3 «Сколько нужно?» → сетка плиток 3 колонки: «1 ч», «3 ч», «6 ч», «Ночь», «Сутки»; на каждой цена (SR-20#1). Плитка «Ночь» должна иметь подпись caption «22:00 – 08:00». Плитки тарифов, которых нет у капсулы, не показываются. Выбранная — заливка action/primary.
  5. Итог времени: строка body/strong с иконкой clock: «Заезд 15:30 — выезд 18:30» (SR-20#2). Тариф «Ночь» — фиксированный интервал 22:00 – 08:00 (решение заказчика 11.11.2026, B-038):
    • Если гость выбирает «Ночь» в режиме «Сейчас» с 08:00 до 21:59, то система должна показать «Заезд 22:00 — выезд 08:00».
    • В этом случае система должна показать под строкой плашку status/info/bg «Ночь начинается в 22:00».
    • В этом случае система должна переключить сегмент в «Запланировать» с датой «сегодня» и временем заезда 22:00.
    • Если гость выбирает «Ночь» в режиме «Сейчас» с 22:00 до 07:59, то заезд должен быть текущим временем, а выезд — 08:00.
    • Цена «Ночи» при заезде после 22:00 не должна отличаться от цены на плитке.
    • Время до 22:00 и после 08:00 не должно входить в бронь «Ночь».
  6. Уровень сервиса (если у капсулы есть Self-service, SR-21#1): сегмент «Полностью готова» / «Self-service −20 %» → под ним пояснение caption с иконкой package: «Вы сами застелите запечатанный комплект белья. Скидка — на аренду». Цены на плитках пересчитываются при смене уровня.
  7. Конфликт интервала (SR-20#3): для «Ночи» пересечение должно проверяться только по интервалу 22:00 – 08:00 (B-038). Выбранная плитка с рамкой status/danger/fg; под сеткой — строка-плашка status/danger/bg: «Занято с 17:00. Ближайшее время: 20:00» и secondary S «Выбрать 20:00» (переключает в «Запланировать» с этим временем). «Далее» неактивна.

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

C-15. Дополнительные услуги

  1. Заголовок title/3 «Добавить к брони?», подзаголовок caption «Подготовим к вашему приезду».
  2. Список строк 72: фото услуги 48 radius/m → название body и описание caption → цена «+290 ₽» price/s (SR-22#1) → справа переключатель или счётчик «− 1 +» (для штучных).
  3. Группа «Бельё» — радио «Одноразовое» (входит в цену) / «Многоразовое» (+N ₽).
  4. Перечень услуг — из справочника отеля (ТЗ §3.1 и C-15: бельё, пижама, тапочки, набор гигиены, ранний заезд, поздний выезд, завтрак; B-022).
  5. Низ: ghost «Пропустить» (сбрасывает выбор и открывает C-16, SR-22#2) и primary M «Далее».

Если в отеле нет услуг, C-15 пропускается (TC-049-neg).

Состояния загрузки нет: перечень услуг приходит вместе с данными C-14 (SPEC-UI-01 §3.7.24).

C-16. Подтверждение и оплата

  1. Сводка (карточка bg/subtle, radius/xl): отель, капсула, «12 нояб., 15:30 — 18:30», «3 ч», уровень сервиса; ghost «Изменить» → C-14.
  2. Детализация (SR-23#2): строки callout слева, суммы body/strong справа: «Аренда · 3 ч» 1 690 ₽; «Услуги» 290 ₽ (раскрывается списком); «Скидка и бонусы» −100 ₽ цветом status/success/fg; разделитель; «Итого» title/3 и price/l. Строки с нулём не показываются.
  3. Залог — отдельной строкой под «Итого», вне суммы (SR-23#1): строка-плашка status/info/bg, иконка shield, «Залог 1 000 ₽ · заблокируем на карте и вернём после выселения».
  4. Способ оплаты: строка-плашка «Мир •• 0004» с логотипом и ghost «Сменить» → список способов (SPEC-UI-07 C-32).
  5. Промокод: строка-плашка «Есть промокод?» → поле с кнопкой «Применить»; ошибка — текст причины под полем, сумма не меняется (SR-23#3).
  6. Бонусы: строка с переключателем «Списать 100 бонусов» и подписью caption «1 бонус = 1 ₽, до 30 % аренды» (видна при балансе > 0; B-017).
  7. Правила отмены: caption text/secondary, 2 строки, ghost «Подробнее» (шторка с правилами; значения — B-009).
  8. Кнопка primary L «Оплатить 1 690 ₽» — закреплена внизу (SR-24#1). При обработке — loading, повторные нажатия не принимаются (SR-24#3).

Под кнопкой caption: «Нажимая „Оплатить“, вы принимаете правила бронирования». Чек отправляется на email или телефон гостя (54-ФЗ, B-005).

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

C-16e. Ошибка оплаты

Полноэкранное состояние поверх C-16: иллюстрация «карта с крестом» → title/1 «Оплата не прошла» → строка-плашка status/danger/bg с причиной от провайдера («Недостаточно средств») → primary L «Попробовать снова» → secondary L «Сменить карту» (SR-24#2). Бронь остаётся «Ожидает оплаты» 10 мин; над кнопками таймер caption «Капсула закреплена за вами ещё 9:12» (SR-24#4).

Требуется подтверждение личности — переход на C-05 (SR-06#1).

C-17. Бронь подтверждена

  1. Иллюстрация успеха 160×120 (галочка в круге status/success/solid), анимация появления motion/slow.
  2. title/1 «Бронь подтверждена»; caption «№ A-1042».
  3. body/strong «Капсула №3 закреплена за вами».
  4. Таймер (бронь «Сейчас»): подпись «Успейте дойти», значение display/timer «19:45», под ним полоса прогресса (SR-25#1). Для брони «Запланировать» вместо таймера — «Заезд завтра в 10:00» title/3. Для «Ночи», оплаченной с 08:00 до 21:59, система не должна показывать таймер «Успейте дойти». Вместо таймера система должна показать «Заезд сегодня в 22:00» title/3 и caption «Ключ будет доступен с 21:50» (B-038).
  5. Подсказка caption text/secondary с иконкой info: «Если не успеете за 20 мин, бронь отменится» (SR-25#2; правило — B-007, B-008).
  6. Кнопки: primary L «Маршрут» → навигатор; secondary L «К брони» → C-21.

После закрытия C-17 на каждой вкладке появляется плашка брони (SR-30#1).

3.3. User journeys

J4.1 Бронирование «Сейчас» на 3 часа (ТЗ §4, сц. 1, шаги 5 – 9)

№ Действие Результат ref
1 Открывает C-14 5 плиток с ценами SR-20#1
2 Выбирает «3 ч» «Заезд 15:30 — выезд 18:30» SR-20#2
3 Выбирает «Self-service −20 %» цены пересчитаны, пояснение про комплект SR-21#1
4 «Далее» → C-15, видит цены услуг цена у каждой услуги SR-22#1
5 Нажимает «Пропустить» C-16 без услуг SR-22#2
6 Смотрит сводку залог отдельной строкой SR-23#1
7 Проверяет детализацию строки и «Итого» SR-23#2
8 Вводит истёкший промокод причина, сумма прежняя SR-23#3
9 Нажимает «Оплатить 1 690 ₽» списание и холд залога SR-24#1
9a Нажимает «Оплатить» повторно во время обработки второе нажатие не принято SR-24#3
9b Провайдер отклоняет C-16e с причиной и двумя кнопками SR-24#2
9c Не оплачивает 10 мин бронь «Отменена» SR-24#4
10 Видит C-17 таймер «Успейте дойти 20:00» SR-25#1
11 Не приходит за 20 мин бронь «Не заехал», push SR-25#2

J4.2 Конфликт времени и запланированная бронь

№ Действие Результат ref
1 Выбирает «3 ч», капсула занята с 17:00 «Ближайшее время: 20:00» SR-20#3
2 Нажимает «Выбрать 20:00» режим «Запланировать», 20:00 SR-20#2
3 Открывает календарь даты после +30 дней неактивны SR-20#4

J4.3 «Ночь» днём (B-038)

№ Действие Результат ref
1 В 15:30 в режиме «Сейчас» выбирает «Ночь» «Заезд 22:00 — выезд 08:00», плашка «Ночь начинается в 22:00», сегмент «Запланировать» SR-20#2
2 Оплачивает C-17 без таймера, «Заезд сегодня в 22:00» SR-25#1

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

Права — только авторизованный гость с личностью, подтверждённой через Госуслуги (SR-06#1). Уведомления: «Бронь подтверждена», «10 мин до окончания времени на дорогу» (SR-51#1). Потеря сети на C-16 — кнопка «Оплатить» неактивна, баннер «Нет соединения»; после восстановления статус оплаты запрашивается повторно, двойного списания нет (SPEC-PROC-01, идемпотентность).

3.5. Тон и стиль

По SPEC-UI-01 3.10. Деньги — без мелкого шрифта: залог и правила отмены видны без прокрутки на экране 375×812 при отсутствии услуг.

3.6. Accessibility

Плитки тарифа — радиогруппа «Длительность», каждая озвучивается «3 часа, 1 690 рублей, выбрано». Таймер C-17 озвучивается раз в минуту. Сумма на кнопке «Оплатить» озвучивается полностью.

3.7. i18n

«Ночь» → «Night», «Сутки» → «24 h». Валюта — рубль в обеих локалях.

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

BR-02; SR-20, SR-21, SR-22, SR-23, SR-24, SR-25; SR-06#1 (вход в C-05).

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

depends-on: SPEC-UI-01, SPEC-PROC-01 (жизненный цикл брони, таймеры), SPEC-INT-01 (платёжный провайдер).

6. Verification

TC-044 … TC-059 и парные -neg (SR-20 … SR-25). Сквозной путь — SPEC-UC-01.

Визуальные нормы экранов пути аренды и тема основных действий уточнены в SPEC-UI-08.

Отображение текущих броней, таймеров и итога оплаты уточнено в SPEC-UI-08.

Метаданные RENAR
id: SPEC-UI-04
title: "Бронирование и оплата: C-14 – C-17"
type: SPEC-UI
source: { adapt: ADAPT-001, adapt-section: "Forward §3; B-005, B-006, B-007, B-008, B-009, B-010, B-022, B-037, B-038", tz-section: "§5.2 C-14 – C-17; §4 сц. 1" }
depends-on: [SPEC-UI-01, SPEC-PROC-01, SPEC-INT-01]
screens: [C-14, C-15, C-16, C-16e, C-17]
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