Домики · Rest&Go

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

SPEC-UI-05. Брони и проживание

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

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

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

2. Scope

Входит: C-20 Брони, C-21 Детали брони, C-22 Ключ доступа (интерфейс), C-23 Начало проживания, C-24 Активное проживание, C-24a Продление, C-24b Выселение, C-24c Итог, C-24s Срочная помощь, плашка текущей брони (ТЗ §5.1).

Не входит: технология открытия замка (BLE, NFC, QR, PIN), офлайн-ключи и связь с контроллером капсулы — механика связи приложения с отелем вынесена за рамки комплекта (ТЗ §1.4); C-22 обращается к внешнему «сервису доступа» через интерфейс SPEC-INT-01 §3.6. Не входят: блок «Комфорт» (свет, климат; ТЗ C-24, v2), заказ услуг во время проживания (ТЗ C-24 «доп. услуги и заказ» — требует исполнения на площадке, B-032), счётчики воды и электричества, шкафчики, фото капсулы при выезде с проверкой (B-015), «Изменить время» на C-21 (B-032).

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

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

C-20 — корень вкладки «Брони». C-21 и C-24 открываются в стеке. C-22, C-23 и поток выселения C-24b → C-24c — полноэкранные модалки без tab bar. Плашка текущей брони ведёт на C-21 (статус «Подтверждена») или C-24 («Активна»).

Словарь действий (B-014): «Отменить бронь» — только до заселения; «Выселиться» — кнопка на C-24; «Завершить проживание» — финальная кнопка C-24b.

3.2. Экраны

Плашка текущей брони (на каждой вкладке)

Компонент SPEC-UI-01 3.7.16. Видна, пока у гостя есть бронь «Подтверждена» или «Активна» (SR-30#1). При нескольких таких бронях показывается ближайшая по времени. Содержимое по статусу:

Статус Вторая строка Кнопка
Подтверждена, «Сейчас» «Капсула №3 · Успейте дойти 19:45» «Открыть» → C-21
Подтверждена, запланирована «Капсула №3 · Заезд завтра в 10:00» «Открыть» → C-21
Активна «Капсула №3 · Осталось 2:14:30» (цвет по 3.7.15) «Открыть» → C-24

C-20. Брони

  1. App bar: заголовок «Брони».
  2. Сегмент «Текущие» / «История» (SPEC-UI-01 3.7.5). «Текущие» — статусы «Ожидает оплаты», «Подтверждена», «Активна» (SR-26#1); «История» — «Завершена», «Отменена», «Не заехал», группировка по месяцам с заголовком caption.
  3. Карточка брони: фото 72 radius/l → отель body/strong → «Капсула Comfort · №3» caption → «12 нояб., 15:30 — 18:30» caption → справа сверху бейдж статуса, справа снизу сумма price/s.
  4. Пустое состояние (SR-26#2): иллюстрация «календарь», «У вас пока нет броней», primary M «Найти капсулу» → C-10.
  5. Неавторизованный гость: пустое состояние «Войдите, чтобы видеть брони», primary M «Войти» → C-02.

Загрузка (SR-60#1, SPEC-UI-01 §3.7.24): скелетоном — 3 карточки брони; app bar, сегмент «Текущие» и «История», tab bar статичны.

C-21. Детали брони (до заселения)

  1. Статус-блок: бейдж статуса → таймер (display/timer 32 pt вариант): «Успейте дойти 19:45» или «До заезда 1 д 4 ч».
  2. Отель и капсула: две строки-плашки со ссылками на C-12 и C-13.
  3. Время: «12 нояб., 15:30 — 18:30 · 3 ч».
  4. Состав и стоимость: свёрнутый список, раскрывается: аренда, услуги, скидки, итого, залог (статус «Заблокирован»).
  5. Маршрут: мини-карта 16:9 и secondary M «Маршрут».
  6. Главная кнопка primary L «Ключ доступа» с иконкой key-round → C-22 (видна только при статусах «Подтверждена» и «Активна», SR-31#4). Ключ доступен за 10 мин до времени заезда (B-023); раньше — кнопка disabled с подписью «Доступен с 09:50».
  7. danger-ghost «Отменить бронь» (SR-27#1) → диалог: заголовок «Отменить бронь?», текст «Вернём 1 690 ₽ на карту •• 0004. Залог разблокируем», кнопки danger L «Отменить бронь» и ghost «Оставить» (SR-27#2, SR-60#3). Сумма возврата рассчитывается по правилам отмены (B-009).
  8. Строка-плашка «Связаться с поддержкой» → C-40 с привязкой к брони.

Для статуса «Ожидает оплаты» вместо пунктов 6 – 7 — primary L «Оплатить» → C-16 и таймер «Оплатите за 9:12».

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

C-22. Ключ доступа (интерфейс)

Полноэкранная модалка, фон bg/screen, крестик в app bar, заголовок «Капсула №3».

  1. Крупная кнопка «Открыть» по центру верхней половины (SPEC-UI-01 3.7.18) с состояниями: ожидание → открывается → открыто | ошибка.
  2. Нажатие отправляет запрос во внешний сервис доступа (SPEC-INT-01 §3.6) и переводит кнопку в «Открывается» (SR-31#1). Ответ «открыто» — «Открыто» и через 1,5 с переход на C-23 (если бронь «Подтверждена»). Ответ «ошибка» или нет ответа за 10 с — «Не удалось открыть» (SR-31#2).
  3. Номер капсулы title/2.
  4. Резервный код: строка-плашка «Резервный код ••••••» и ghost «Показать» / «Скрыть» (SR-31#3). Код — 6 цифр title/2 с tnum, разбит пробелом «482 917».
  5. Подсказка callout text/secondary с иконкой smartphone: «Поднесите телефон к замку» (текст уточняется после выбора технологии, ТЗ C-22).
  6. Ghost «Не открывается?» → C-40 с быстрой темой «Не открывается дверь»; в состоянии «Ошибка» ссылка выделена status/danger/fg (SR-31#2).

Без сети (B-028): резервный код показывается из кэша, кнопка «Открыть» disabled с подписью «Нет сети — используйте резервный код».

C-23. Начало проживания

  1. title/1 «Добро пожаловать»; body text/secondary «Пара шагов перед отдыхом».
  2. Чек-лист-инструкция из 4 пунктов (компонент 3.7.17, без блокировки): footprints «Снимите обувь у входа» → package-open «Возьмите тапочки» → bed-double «Проверьте комплект белья» → circle-check «Всё в порядке?».
  3. primary L «Начать проживание» → бронь «Активна», C-24 (SR-32#1). Время аренды отсчитывается от времени заезда брони (B-023).
  4. secondary L «Сообщить о проблеме» → C-40 с привязкой к брони и быстрыми темами «Грязно», «Нет комплекта», «Неисправность»; вложение фото (SR-32#2).

C-24. Активное проживание

App bar: заголовок «Rest&Go Сити · №3», справа иконка life-buoy «Срочная помощь» → C-24s. Tab bar виден.

  1. Таймер (SPEC-UI-01 3.7.15): «Осталось» → «2:14:30» → «Выезд в 18:30» (SR-33#1). Менее 15 мин — цвет warning и баннер под таймером на status/warning/bg: «Продлить проживание?» и primary S «Продлить» (SR-33#2). Время вышло — значение «+0:03:12» цветом danger, баннер на status/danger/bg: «Время вышло. Каждый час — 590 ₽» (SR-33#3, B-016).
  2. Стоимость: строка «Сейчас: 2 280 ₽» body/strong и ghost «Детали» (раскрывает аренду и продления) (SR-33#4).
  3. Кнопки: primary L «Продлить» → C-24a; secondary L «Выселиться» → C-24b.
  4. Wi-Fi: две строки-плашки: «Сеть RestGo_Guest» и «Пароль ••••••••» с ghost «Показать» и иконкой-кнопкой copy «Копировать» → буфер обмена и тост «Скопировано» (SR-34#1). Блок скрыт, если у отеля нет Wi-Fi.
  5. Поддержка: строка-плашка «Поддержка» → C-40 с привязкой к брони.
  6. Правила: ghost «Правила проживания» → шторка.

Без сети: таймер считает время локально от последнего серверного значения; «Продлить» и «Выселиться» показывают тост «Нужна сеть» с «Повторить» (B-028).

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

C-24a. Продление

Модальная шторка 70 %.

  1. Заголовок «Продлить проживание»; строка callout «Капсула свободна до 21:00» с иконкой calendar-clock.
  2. Плитки 3 колонки: «+1 ч», «+3 ч», «До утра» (до 08:00; не показывается после 05:00), цена на каждой (SR-35#1); цена — по цене продления за час (B-022). Плитка, конец которой пересекает следующую бронь, — unavailable с подписью «Занято с 20:00» (SR-35#2).
  3. Новое время выезда: «Выезд в 19:30» body/strong.
  4. primary L «Продлить за 590 ₽» — оплата привязанным способом без перехода на C-16; успех — тост «Продлено до 19:30», таймер увеличен (SR-35#4); ошибка — C-16e.
  5. Если каждый вариант недоступен (SR-35#3): вместо плиток — пустое состояние «Продлить в этой капсуле нельзя» и карточка свободной капсулы этого отеля с primary M «Перейти» (→ C-13 с режимом «Сейчас»); при отсутствии свободных — «Свободных капсул нет» и secondary M «Связаться с поддержкой».

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

C-24b. Выселение

Полноэкранная модалка, заголовок «Выселение».

  1. title/1 «Перед выходом»; счётчик «Отмечено 0 из 4».
  2. Чек-лист (3.7.17), каждый пункт обязателен (B-015): «Уберите бельё в отсек», «Выбросьте мусор», «Заберите вещи», «Закройте дверь».
  3. Необязательное фото капсулы: загрузчик (3.7.20), лимит 3 фото, подпись caption «Фото защитит вас при спорах о залоге».
  4. primary L «Завершить проживание» — disabled до отметки каждого пункта (SR-36#1).
  5. Диалог подтверждения: «Завершить проживание? Ключ перестанет работать», кнопки primary L «Завершить» и ghost «Отмена» (SR-36#2, SR-60#3).

C-24c. Итог

  1. Иллюстрация, title/1 «Спасибо!», body text/secondary «Вы провели с нами 4 ч».
  2. Чек: карточка bg/subtle: «Аренда 3 ч» 1 690 ₽ → «Продление 1 ч» 590 ₽ → «Услуги» → «Скидка и бонусы» → разделитель → «Итого оплачено» price/l (SR-37#1).
  3. Залог: строка с бейджем: «Заблокирован · вернём в течение 24 ч» (status/info); «Возвращён» (status/success); «Удержан» (status/danger) с причиной и ghost «Оспорить» → C-40 (TC-082-neg).
  4. Бонусы: «+45 бонусов» body/strong цветом loyalty/* уровня гостя.
  5. primary L «Оценить проживание» → C-26 (SR-40#1); после отправки отзыва — текст «Спасибо за отзыв».
  6. secondary L «Скачать чек» → PDF кассового чека (SR-37#2); если чек не готов — тост «Чек формируется, пришлём на email и в уведомления».
  7. Ghost «На карту» → C-10.

C-24s. Срочная помощь

Модальная шторка 60 %, фон bg/screen; заголовок title/3 «Срочная помощь».

  1. danger L «Позвонить 112» с иконкой phone → системный набор 112.
  2. primary L «Позвонить в поддержку» → набор номера горячей линии.
  3. secondary L «Написать в поддержку» → C-40 с привязкой к брони.
  4. caption text/secondary: адрес отеля и номер капсулы для диктовки диспетчеру, ghost «Копировать адрес».

Автоматическая отправка сигнала тревоги не выполняется (B-026).

3.3. User journeys

J5.1 Заселение (ТЗ §4, сц. 2)

№ Действие Результат ref
1 Видит плашку брони на любой вкладке отель, статус, таймер, «Открыть» SR-30#1
2 Нажимает «Открыть» на плашке C-21 с кнопкой «Ключ доступа» SR-31#4
3 Нажимает «Ключ доступа», затем «Открыть» «Открывается» → «Открыто» SR-31#1
3a Сервис доступа вернул ошибку «Не удалось открыть», «Не открывается?» SR-31#2
3b Нажимает «Показать» у резервного кода 6 цифр SR-31#3
4 На C-23 нажимает «Начать проживание» C-24, статус «Активна» SR-32#1
4a Нажимает «Сообщить о проблеме» C-40 с привязкой к брони SR-32#2
5 Смотрит на C-24 «Осталось 2:14:30», «Выезд в 18:30» SR-33#1
6 Видит стоимость «Сейчас: 1 690 ₽» SR-33#4
7 Копирует пароль Wi-Fi тост «Скопировано» SR-34#1

J5.2 Продление и выселение (ТЗ §4, сц. 3)

№ Действие Результат ref
1 За 14 мин до выезда смотрит на C-24 таймер warning, баннер «Продлить?» SR-33#2
2 Нажимает «Продлить» C-24a с 3 вариантами и ценами SR-35#1
2a Следующая бронь в 20:00 «+3 ч» недоступна SR-35#2
2b Недоступен каждый вариант предложена свободная капсула SR-35#3
3 Нажимает «Продлить за 590 ₽» выезд сдвинут на 1 ч SR-35#4
4 Не выселяется вовремя таймер danger, «Время вышло» SR-33#3
5 Нажимает «Выселиться», отмечает 3 из 4 пунктов «Завершить проживание» неактивна SR-36#1
6 Отмечает 4-й пункт, «Завершить проживание», «Завершить» бронь «Завершена» SR-36#2
7 Видит C-24c чек и статус залога SR-37#1
8 Нажимает «Скачать чек» PDF чека SR-37#2

J5.3 Управление бронями

№ Действие Результат ref
1 Открывает «Брони» без броней «У вас пока нет броней», «Найти капсулу» SR-26#2
2 Открывает «Текущие» только текущие статусы SR-26#1
3 На C-21 нажимает «Отменить бронь» диалог с суммой возврата SR-27#1
4 Подтверждает отмену бронь «Отменена», залог разблокирован SR-27#2

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

Права: экраны доступны только владельцу брони (SPEC-SEC-01). Push по событиям: «10 мин до окончания времени на дорогу», «До выезда 15 мин», «Время проживания истекло», «Залог возвращён» (SR-51#1); нажатие открывает C-21 или C-24 (SR-51#2). Error states: ошибка оплаты продления — C-16e; ошибка сервиса доступа — состояние C-22. Empty state — C-20.

3.5. Тон и стиль

По SPEC-UI-01 3.10. На C-24 нет рекламы и лишних блоков: таймер, стоимость, два действия, Wi-Fi, помощь.

3.6. Accessibility

Кнопка «Открыть» озвучивает состояние («Открывается», «Открыто», «Ошибка, не удалось открыть»), смена состояния сопровождается вибро-откликом. Таймер C-24 озвучивается раз в минуту и при пересечении 15 мин. Чек-лист — группа чекбоксов с озвучкой «отмечено 3 из 4».

3.7. i18n

Длительности в итоге: «4 ч» / «4 h», «1 д 4 ч» / «1 d 4 h». Номер 112 одинаков в обеих локалях.

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

BR-02 (SR-26, SR-27), BR-03 (SR-30 … SR-37), BR-04 (SR-40#1 — вход в отзыв).

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

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

6. Verification

TC-060 … TC-083 и парные -neg (SR-26, SR-27, SR-30 … SR-37). Сквозные пути — SPEC-UC-02, SPEC-UC-03.

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

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

Метаданные RENAR
id: SPEC-UI-05
title: "Брони и проживание: C-20 – C-24c"
type: SPEC-UI
source: { adapt: ADAPT-001, adapt-section: "Forward §4; B-014, B-015, B-016, B-023, B-026, B-028, B-037", tz-section: "§5.1; §5.2 C-20 – C-24c; §4 сц. 2 – 3" }
depends-on: [SPEC-UI-01, SPEC-PROC-01, SPEC-INT-01]
screens: [C-20, C-21, C-22, C-23, C-24, C-24a, C-24b, C-24c, C-24s]
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