Домики · Rest&Go

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

SPEC-UI-06. Отзывы

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

Отзывы и рейтинг чистоты — главный инструмент доверия: гость заходит в приватное пространство после другого человека. Документ описывает чтение отзывов об отеле (C-25), форму отзыва после выселения (C-26) и карточку отзыва, которая используется также на C-12 и C-13.

2. Scope

Входит: C-25 Отзывы об отеле, C-26 Оставить отзыв, компонент «Карточка отзыва».

Не входит: модерация и ответы администрации (админ-панель, ТЗ §7 A-10) — клиент только показывает ответ; рейтинг гостя.

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

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

C-25 открывается в стеке из C-12 (рейтинг, «Все отзывы») и из push «Ответ на отзыв». C-26 — полноэкранная модалка из C-24c и из истории брони (в течение 14 дней после выселения, B-018).

3.2. Компонент «Карточка отзыва»

Сверху вниз, отступ 16, разделитель 1 border/default между карточками:

  1. Строка: аватар-инициалы 32 (bg/muted, label) → имя «Анна К.» body/strong → справа дата «12 нояб.» caption text/secondary.
  2. Строка: звёзды 16 × 5 (заливка rating/star по оценке) → «Капсула Comfort · №3» caption.
  3. Теги (до 3) — чипы bg/subtle высотой 28, caption.
  4. Текст body, 4 строки, затем ghost «Читать полностью».
  5. Фото — ряд миниатюр 64 radius/s, тап — полноэкранная галерея.
  6. Ответ администрации (SR-42#3): блок bg/subtle, radius/m, отступ 12, слева полоса 3 border/strong; заголовок label «Ответ Rest&Go» и дата; текст callout.

Имя показывается как «Имя + первая буква фамилии».

3.3. Экраны

C-25. Отзывы об отеле

  1. App bar: «Отзывы · Rest&Go Сити».
  2. Сводка (SR-42#1): слева «4,8» (display/timer 44 pt, без tnum) и «120 отзывов» caption; справа распределение по звёздам — 5 строк баров (SPEC-UI-01 3.7.10).
  3. По категориям: 4 строки «Чистота 4,9», «Комфорт 4,7», «Тишина 4,6», «Расположение 4,8» с полосами.
  4. Фильтры — ряд чипов: «Все», «С фото» (SR-42#2), «5 ★», «4 ★», «3 ★ и ниже», «По капсуле ▾» (шторка со списком капсул отеля). Одиночный выбор, кроме «По капсуле», который комбинируется с остальными.
  5. Лента карточек отзывов по убыванию даты; подгрузка по 20 при прокрутке со скелетоном 2 карточек.
  6. Пустое состояние: «Отзывов пока нет»; при фильтре — «Нет отзывов с такими условиями» и ghost «Сбросить фильтр».

Загрузка (SR-60#1, SPEC-UI-01 §3.7.24): скелетоном — сводка, 4 строки категорий и 3 карточки отзывов; app bar статичен; чипы фильтров disabled до загрузки.

C-26. Оставить отзыв

Модалка, app bar с крестиком, заголовок «Отзыв».

  1. Шапка: миниатюра капсулы 48 → «Капсула Comfort · №3» body/strong → «Rest&Go Сити · 12 нояб.» caption (SR-40#1).
  2. Общая оценка: title/3 «Как всё прошло?» → 5 звёзд по 40 → подпись выбранной оценки.
  3. По категориям: «Чистота», «Комфорт», «Тишина» — по 5 звёзд 28 в строке; необязательны.
  4. Блок «Что пошло не так?» (SR-40#4) — появляется при оценке 3 и ниже, анимация motion/base: строка-плашка status/warning/bg с текстом «Нам жаль. Расскажите, что пошло не так» → теги-чипы «Грязно», «Шумно», «Неудобная кровать», «Холодно», «Не работал замок» → secondary M «Написать в поддержку» → C-40 с привязкой к брони.
  5. Быстрые теги (при оценке 4 – 5): «Чисто», «Тихо», «Удобная кровать», «Хорошее расположение».
  6. Текст: многострочное поле 120, плейсхолдер «Что понравилось или нет?», счётчик caption «0 / 1000».
  7. Фото: загрузчик (SPEC-UI-01 3.7.20), до 5 фото (SR-40#3).
  8. primary L «Отправить» — disabled до выбора общей оценки (SR-40#2).

После отправки — тост «Спасибо за отзыв», возврат на экран-источник; отзыв сразу виден в C-12 и C-25 (SR-41#1, B-018). Ошибка сети — черновик сохраняется, тост с «Повторить». Повторный отзыв на ту же бронь невозможен (SR-41#2): вход в C-26 заменён текстом «Спасибо за отзыв».

3.4. User journeys

J6.1 Оставить отзыв (ТЗ §4, сц. 4)

№ Действие Результат ref
1 На C-24c нажимает «Оценить проживание» C-26 этой брони SR-40#1
2 Вводит текст без звёзд «Отправить» неактивна SR-40#2
3 Выбирает 3 звезды блок «Что пошло не так?» SR-40#4
4 Прикрепляет 6-е фото тост «Можно прикрепить до 5 фото» SR-40#3
5 Нажимает «Отправить» отзыв в C-12 и C-25 SR-41#1
6 Пытается оценить ту же бронь снова «Спасибо за отзыв», формы нет SR-41#2

J6.2 Прочитать отзывы

№ Действие Результат ref
1 На C-12 нажимает рейтинг C-25 со сводкой и барами SR-42#1
2 Выбирает «С фото» только отзывы с фото SR-42#2
3 Читает отзыв с ответом блок «Ответ Rest&Go» SR-42#3

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

C-25 доступен без авторизации; C-26 — только автору завершённой брони. Push «Ответ на отзыв» открывает C-25 с прокруткой к отзыву гостя (TC-097-neg).

3.6. Тон и стиль

По SPEC-UI-01 3.10. Низкая оценка не стыдит гостя: формулировка «Нам жаль» и сразу путь к помощи.

3.7. Accessibility

Ввод оценки — слайдер для диктора «Оценка, 3 из 5, Нормально»; бары распределения озвучиваются «5 звёзд, 80 отзывов».

3.8. i18n

Подписи оценок: «Ужасно / Плохо / Нормально / Хорошо / Отлично» — «Terrible / Poor / Okay / Good / Excellent». Отзывы показываются на языке оригинала.

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

BR-04; SR-40, SR-41, SR-42.

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

depends-on: SPEC-UI-01, SPEC-DATA-01 (сущность «Отзыв»).

6. Verification

TC-084 … TC-092 и парные -neg. Сквозной путь — SPEC-UC-04.

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

Метаданные RENAR
id: SPEC-UI-06
title: "Отзывы: C-25, C-26"
type: SPEC-UI
source: { adapt: ADAPT-001, adapt-section: "Forward §5; B-018, B-037", tz-section: "§5.2 C-25 – C-26; §4 сц. 4" }
depends-on: [SPEC-UI-01, SPEC-DATA-01]
screens: [C-25, C-26]
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