Домики · Rest&Go

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

SPEC-UI-02. Вход и аккаунт

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

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

Документ описывает диалог-приглашение ко входу, вход по номеру телефона и SMS-коду, подтверждение личности через Госуслуги (ЕСИА) и привязку способа оплаты. Это «первый слой доверия» шерингового приложения: сеть убеждается, что гость реальный и платёжеспособный, а гость видит, зачем у него просят данные.

Решение заказчика 11.11.2026 (ADAPT-001 B-035): приложение запускается сразу на карте C-10 (SR-02#1, SPEC-UI-03), онбординга C-01 и поясняющего экрана геолокации C-01a нет, системный запрос геолокации показывается поверх карты (SR-02#2). Вход откладывается до нажатия «Забронировать» (SR-01#2). Анкеты C-04, съёмки документа и селфи нет: данные гостя приходят из Госуслуг (SR-05#1).

Экраны C-02d, C-02, C-03, C-05, C-06 образуют модальный поток «Вход». Поток открывается с первого действия, требующего авторизации, и возвращает гостя к этому действию (SR-01#2, SR-01#3).

2. Scope

Входит: C-02d диалог «Войдите, чтобы забронировать», C-02 Вход, C-03 Код из SMS, C-05 Подтверждение личности через Госуслуги (4 состояния), C-06 Привязка способа оплаты.

Не входит: экраны ЕСИА во встроенном браузере — их вид задаёт Госуслуги (контракт — SPEC-INT-01 §3.3); юридические тексты согласий (утверждает юрист заказчика, ADAPT-001 B-002, B-003); вход через сторонние аккаунты — убран решением заказчика 11.11.2026 (B-027, B-035).

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

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

Поток «Вход»: C-02d → C-02 → C-03 → C-05 → C-06. C-02d — диалог поверх экрана-источника (SPEC-UI-01, модальный диалог). C-02 … C-06 — полноэкранная модалка: app bar с крестиком слева (закрыть поток и вернуться на экран-источник) и индикатором шагов справа (caption, text/secondary): «1 из 3» на C-02, «2 из 3» на C-03, «3 из 3» на C-05; C-06 показывается без индикатора. Контент выровнен по левому краю, поля 16. Главная кнопка — primary L, закреплена над клавиатурой с отступом 12.

Порядок шагов для нового гостя: C-02d → C-02 → C-03 → C-05 → C-06 → C-14 выбранной капсулы (SR-01#3). Для вернувшегося гостя с подтверждённой личностью: C-02d → C-02 → C-03 → экран-источник. Если гость авторизован, но личность не подтверждена, «Забронировать» открывает C-05 (SR-06#1).

3.2. Экраны

C-02d. Диалог «Войдите, чтобы забронировать»

Модальный диалог поверх C-13 на bg/scrim (SR-01#2):

Зона Содержимое Токены
Заголовок «Войдите, чтобы забронировать» title/2
Текст «Вход по номеру телефона займёт минуту. Карта и карточки доступны без входа.» body, text/secondary
Кнопки primary M «Войти» → C-02; ghost M «Не сейчас» → закрыть диалог, остаться на C-13 —

Диалог закрывается тапом по затемнению так же, как «Не сейчас». Бронь при показе диалога не создаётся.

C-02. Вход

Индикатор «1 из 3». Сверху вниз:

  1. Заголовок title/1 «Вход или регистрация»; текст body text/secondary «Пришлём код в SMS».
  2. Поле телефона с маской и селектором страны (SPEC-UI-01 3.7.2). Фокус и цифровая клавиатура открываются сразу.
  3. Чекбокс 1 (обязательный): «Принимаю [правила сервиса] и [оферту]» — ссылки text/link открывают документ во встроенном браузере.
  4. Чекбокс 2 (обязательный): «Даю [согласие на обработку персональных данных]» (152-ФЗ ст. 9; раздельно от оферты — B-002).
  5. Чекбокс 3 (необязательный): «Хочу получать новости и скидки».
  6. Кнопка primary L «Получить код» (SR-03#1: неактивна до полного номера и отметки чекбоксов 1 и 2).

Кнопок входа через сторонние аккаунты на экране нет: вход только по номеру телефона и SMS-коду (решение заказчика 11.11.2026, ADAPT-001 B-035).

Чекбоксы по умолчанию не отмечены. Состояния: некорректный номер — ошибка под полем «Проверьте номер» (SR-03#3); загрузка — кнопка loading; ошибка отправки — тост «Не удалось отправить код. Повторите попытку» (TC-007-neg); слишком частые запросы — текст под кнопкой caption status/danger/fg «Слишком много попыток. Повторите через 10 мин».

C-03. Код из SMS

Индикатор «2 из 3».

  1. Заголовок title/1 «Введите код»; текст body text/secondary «Отправили на +7 900 000-00-01» и ghost «Изменить номер» (возврат на C-02 с сохранённым номером).
  2. 6 ячеек кода (SPEC-UI-01 3.7.3); проверка запускается после 6-й цифры без кнопки (SR-04#1).
  3. Таймер «Отправить повторно через 0:59» → ghost «Отправить повторно» (SR-04#3).

Состояния: неверный код (SR-04#2) — красные ячейки, встряска, «Неверный код», ячейки очищены; код истёк (SR-04#4) — текст «Код истёк» и ghost «Отправить новый код»; 5 неверных попыток — «Слишком много попыток» и блокировка ввода на 10 мин (B-001); проверка — спиннер. После верного кода новый гость переходит на C-05 (SR-06#3); гость с подтверждённой личностью — на экран-источник.

C-05. Подтверждение личности через Госуслуги

Индикатор «3 из 3». Экран открывается сразу после первого входа по SMS-коду (SR-06#3). Четыре состояния:

Состояние Содержимое Действия
Вступление иллюстрация «щит» → title/1 «Подтвердите личность через Госуслуги» → body text/secondary «Один раз перед первой бронью. Мы получим ФИО, дату рождения и паспорт — вводить их вручную не нужно.» → 2 пункта с иконками: shield-check «В капсулу заходите только вы», lock «Данные хранятся в России» → чекбокс согласия на получение данных из Госуслуг (B-003) primary L «Войти через Госуслуги» (неактивна до отметки согласия); ghost «Вернуться к карте»
Встроенный браузер шторка на 95 % высоты с веб-вью ЕСИА; сверху — домен esia.gosuslugi.ru с иконкой lock и крестик «Закрыть» вход выполняется на стороне Госуслуг; закрытие крестиком — состояние «Ошибка» с причиной «Вход отменён»
«Проверьте данные» title/1 «Проверьте данные» → поля только для чтения: «ФИО», «Дата рождения», «Паспорт» (серия и номер, маскированы кроме 4 последних цифр), «Телефон» (SR-05#1) → поле «Email — необязательно» (клавиатура email; подсказка «Пришлём чеки на почту») → caption text/secondary «Данные неверны? Исправьте их на Госуслугах и повторите вход» primary L «Всё верно» → C-06 (SR-05#2); ghost «Повторить вход»
Загрузка (SR-60#1, SPEC-UI-01 §3.7.24) после возврата из ЕСИА — заголовок «Проверьте данные» и подписи полей статично; 4 строки-плашки значений — шимер-скелетон «Всё верно» disabled до получения данных
Ошибка иллюстрация «документ с крестом», title/1 «Не удалось подтвердить личность», строка-плашка с причиной на status/danger/bg: «Учётная запись Госуслуг не подтверждена» либо «Вход отменён» (SR-06#2) primary L «Повторить» → состояние «Встроенный браузер»; secondary L «Вернуться к карте» → C-10

Поля только для чтения отображаются как строки-плашки без рамки ввода и не получают фокус (TC-013-neg). Валидация: возраст меньше 18 лет по дате рождения из Госуслуг — состояние «Ошибка» с причиной «Бронирование доступно с 18 лет» (B-031); некорректный email — «Проверьте email» (TC-014-neg).

C-06. Способ оплаты

  1. Заголовок title/1 «Способ оплаты».
  2. Список строк-плашек (SPEC-UI-01 3.7.27), радио справа:
    • «Банковская карта» (credit-card) → открывает форму провайдера (SR-07#1);
    • «СБП» (zap) — подпись caption «Без залога недоступно» при отсутствии поддержки холда у СБП (B-006);
    • кошелёк устройства: «Apple Pay» / «Google Pay» / «Mir Pay» — только при наличии на устройстве (SR-07#2).
  3. Блок залога: строка-плашка на status/info/bg, иконка info, текст «Мы временно заблокируем 1 000 ₽ и вернём после выселения» (SR-07#3); блок скрыт при залоге 0 ₽.
  4. Кнопка primary L «Привязать».

Форма провайдера открывается внутри приложения (SDK или веб-вью в шторке на 90 %); 3-D Secure — внутри той же шторки. Успех — тост «Карта привязана», возврат на экран-источник. Отказ — текст причины от провайдера под формой, список карт не меняется (TC-018-neg).

3.3. User journeys

J2.1 Первый запуск — описан в SPEC-UI-03 (J3.1): приложение открывает C-10 (SR-02#1), системный запрос геолокации — поверх карты (SR-02#2).

J2.2 Вход нового гостя из бронирования

№ Действие Результат ref
1 Без входа открывает карту, отель и капсулу C-10, C-12, C-13 без запроса входа SR-01#1
2 На C-13 нажимает «Забронировать от N ₽» диалог C-02d «Войдите, чтобы забронировать» SR-01#2
2a Нажимает «Не сейчас» диалог закрыт, C-13 SR-01#2
3 Нажимает «Войти» C-02 SR-01#2
4 Вводит номер, отмечает чекбоксы 1 и 2 «Получить код» активна SR-03#1
5 Нажимает «Получить код» SMS с кодом из 6 цифр, C-03 SR-03#2
6 Вводит 6 цифр код проверен без кнопки, C-05 SR-04#1, SR-06#3
6a Вводит неверный код красные ячейки, «Неверный код» SR-04#2
6b Ждёт 60 с, нажимает «Отправить повторно» новое SMS SR-04#3
7 Отмечает согласие, нажимает «Войти через Госуслуги», входит в ЕСИА «Проверьте данные»: ФИО, дата рождения, паспорт только для чтения SR-05#1
7a Учётная запись не подтверждена или вход отменён причина и «Повторить», «Вернуться к карте» SR-06#2
7b Нажимает «Вернуться к карте» C-10; бронь недоступна до подтверждения SR-06#1
8 Оставляет email пустым, нажимает «Всё верно» профиль сохранён, C-06 SR-05#2
9 Привязывает карту тост «Карта привязана», C-14 выбранной капсулы SR-07#1, SR-01#3

J2.3 Вход вернувшегося гостя — шаги 2 – 6 из J2.2; личность уже подтверждена, поэтому C-05 не показан и открыт экран-источник (SR-06#3, TC-017-neg).

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

3.5. Тон и стиль

По SPEC-UI-01 3.10. Каждый запрос данных начинается с причины («Один раз перед первой бронью»). Слова «KYC», «ЕСИА», «верификация» гостю не показываются: «подтверждение личности через Госуслуги».

3.6. Accessibility

Ячейки кода объявляются диктору как одно поле «Код из SMS, 6 цифр». Поля только для чтения на C-05 объявляются с пометкой «только для чтения». Чекбоксы согласий — отдельные элементы с полным текстом. Встроенный браузер ЕСИА озвучивает заголовок «Вход через Госуслуги».

3.7. i18n

Маска телефона зависит от выбранной страны; список стран — по CLDR, первые: Россия, Казахстан, Беларусь, Армения, Узбекистан. Тексты согласий — на языке интерфейса; юридически значимая редакция — русская. Экраны ЕСИА показываются на русском языке независимо от языка интерфейса.

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

BR-05; SR-01, SR-02, SR-03, SR-04, SR-05, SR-06, SR-07.

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

depends-on: SPEC-UI-01 (токены и компоненты), SPEC-SEC-01 (сессия, OTP, хранение ПДн), SPEC-INT-01 (SMS-шлюз, Госуслуги (ЕСИА), платёжный провайдер). Экран запуска C-10 — SPEC-UI-03.

6. Verification

TC-001 … TC-021 и парные -neg (SR-01 … SR-07), см. TRACEABILITY.md. Сквозной путь — SPEC-UC-01.

Метаданные RENAR
id: SPEC-UI-02
title: "Вход и аккаунт: C-02d – C-06"
type: SPEC-UI
source: { adapt: ADAPT-001, adapt-section: "Forward §6; B-001, B-002, B-003, B-019, B-020, B-027, B-035, B-037", tz-section: "§5.2 C-02 – C-06; решение заказчика 11.11.2026" }
depends-on: [SPEC-UI-01, SPEC-SEC-01, SPEC-INT-01]
screens: [C-02d, C-02, C-03, C-05, C-06]
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