# RENAR-описание: мобильное приложение гостя Rest&Go

Комплект требований по стандарту [RENAR](https://renar.tech/ru/) (операционная редакция 1.0, манифест — RENAR 1.1). Версия комплекта **0.1 — черновик**: не утверждён Архитектором, ТЗ не подписано, ADAPT не одобрен.

## Что описано

Система `guest-app` — мобильное приложение гостя (iOS, Android) и серверные модули, без которых оно работает: поиск по карте, бронирование и оплата, проживание (таймер, продление, выселение), отзывы, аккаунт и подтверждение личности, лояльность, поддержка, уведомления. Источник — [ТЗ на дизайн-концепт](../ТЗ%20на%20дизайн-концепт.md) §5 и сценарии 1 – 4.

**Вынесено за скобки (решение заказчика, B-034):** механика связи приложения с отелем — замки и технология ключа, IoT, датчики, телеметрия, вендинг, метеринг воды и электричества, шкафчики, блок «Комфорт». Экран «Ключ доступа» описан как интерфейс к внешнему «Сервису доступа» (SPEC-INT-01 §3.6). Веб-версия и админ-панель описаны в отдельных черновых комплектах.

**Изменение входа (решение заказчика 11.11.2026, B-035, ADR-08):** приложение запускается сразу на карте C-10, онбординга C-01 и экрана C-01a нет; вход по телефону и SMS-коду запрашивается при нажатии «Забронировать» (диалог C-02d); личность подтверждается через Госуслуги (ЕСИА) на C-05 вместо KYC-провайдера и анкеты C-04; затем привязка оплаты C-06 и возврат на C-14. Затронуты SR-01, SR-02, SR-05, SR-06, BR-05, SPEC-UI-01 … 03, SPEC-ARCH-01, SPEC-INT-01, SPEC-SEC-01, SPEC-DATA-01, SPEC-UC-01, SPEC-TEST-01.

**Карта без статусной окраски (решение заказчика 11.11.2026, B-036):** пины одного цвета показывают только минимальную цену; близкие пины объединяются в кластер с числом отелей (SR-10, SPEC-UI-01 3.7.13, SPEC-UI-03).

**Шимер-скелетон при загрузке (решение заказчика 11.11.2026, B-037):** каждый экран с серверными данными показывает при загрузке шимер-скелетон формы контента (SR-60#1, SPEC-UI-01 3.7.24).

**Тариф «Ночь» — фиксированный интервал 22:00 – 08:00 (решение заказчика 11.11.2026, B-038):** выбор «Ночи» с 08:00 до 21:59 создаёт запланированную бронь на сегодня 22:00 – завтра 08:00 без таймера «Успейте дойти», ключ доступен с 21:50; выбор с 22:00 до 07:59 — заезд сейчас, выезд 08:00, цена та же; в режиме «Запланировать» выбирается дата, заезд 22:00; занятость капсулы считается только по 22:00 – 08:00 (SR-20#2, SR-25#1, SPEC-UI-04, SPEC-PROC-01, SPEC-DATA-01).

**Визуальный язык:** палитра «Snow Minimal» (белая база `#FFFFFF`/`#F4F5F7`, графитовое действие `#1F232B`, голубой вторичный акцент `#7A96C9`) и тёмная пара — [SPEC-UI-01](guest-app/spec/SPEC-UI-01.md). Макеты не входят в комплект; они строятся по этим документам.

## Комплекты веб-приложения и админ-панели

- [Веб-приложение гостя](web-app/README.md)
- [Административное приложение](admin-app/README.md)

## Как читать

| Если нужно | Открыть |
| --- | --- |
| как выглядит интерфейс: цвета, шрифты, отступы, компоненты | [SPEC-UI-01](guest-app/spec/SPEC-UI-01.md) |
| как устроен конкретный экран | SPEC-UI-02 … 07 (по разделам), перечень экранов — [SPEC-ARCH-01 §3.6](guest-app/spec/SPEC-ARCH-01.md) |
| что система должна делать | [guest-app/sr/](guest-app/sr/) — 42 SR, 110 пронумерованных утверждений `SR-NN#n` |
| зачем | [guest-app/br/](guest-app/br/) — 7 BR |
| сквозные сценарии ТЗ 1 – 4 | SPEC-UC-01 … 04 |
| как проверять | [guest-app/tc/](guest-app/tc/) — пара pos/neg на каждое утверждение; [TRACEABILITY.md](guest-app/TRACEABILITY.md) |
| что неясно в ТЗ и как мы это поняли | [adapt/ADAPT-001.md](adapt/ADAPT-001.md) — 38 находок |
| что подписать с заказчиком | [actz/ACTZ-001.md](actz/ACTZ-001.md) — проект протокола, 30 вопросов |

## Структура

```text
renar/
├── tz/TZ-2026-001.md          регистрационная карточка ТЗ
├── ar/AR-001.md               состязательный обзор ТЗ (другая модель)
├── adapt/ADAPT-001.md         прямая интерпретация + обратные находки
├── actz/ACTZ-001.md           проект протокола уточнения ТЗ № 1
├── guest-app/
│   ├── br/  BR-01 … BR-07
│   ├── sr/  SR-01 … SR-63 (42 файла)
│   ├── spec/ ARCH, SEC, DATA, PROC, INT, TEST, UI-01 … 07, UC-01 … 04
│   ├── tc/  TC-001 … TC-110 и TC-NNN-neg (220 файлов)
│   └── TRACEABILITY.md
├── RENAR-CONFORMANCE.yaml     манифест (черновик, честные false)
└── VERSIONS.yaml              запись версии комплекта
```

## Что нужно, чтобы утвердить версию

1. Подпись заказчика под ТЗ (TZ-2026-001).
2. Ответы заказчика на ACTZ-001 и двусторонняя подпись; находки ADAPT-001 получают `decided-in`.
3. Подпись Архитектора под ADAPT-001 (QG-3) и фиксация вердикта AR-001.
4. Перенос каталога под git (V1 – V6 носителя, MVR-2).
5. QG-0: Архитектор утверждает версию комплекта.

## Известные пробелы

- **SPEC-API** (контракт мобильного API с примерами) и **SPEC-OPS** не написаны — следующая версия комплекта.
- **Security-TC** (негативные сценарии T1 – T11 из SPEC-SEC-01), **contract-TC** против sandbox провайдеров и **E2E journey-TC** для SPEC-UC — после выбора провайдеров.
- В TC не заполнены judge, baseline-снимки (появятся после утверждения макетов) и красная история (заполняет runner до реализации).
- `ai-provenance`: счётчики токенов не измерялись (null).

## Уточнение мобильного интерфейса от 12.11.2026

[Карта капсул, QR, вход, профиль и поддержка](guest-app/spec/SPEC-UI-08.md) — правила новой компоновки и сценариев в черновике 0.1. Требования SR-64…69 и проверки TC-111…116 с негативными парами приведены в [матрице прослеживаемости](guest-app/TRACEABILITY.md).
