BRD Widget 8.7.3 Поддержка диплинков
Направление работ: Widget Код раздела: 8.7.3 Раздел: Общие работы > Архитектура и инфраструктура > Поддержка диплинков Статус: черновик Ответственный: Панкова Л.А. Версия: 0.1 Обновлено: 11.08.26
1. Назначение
Раздел описывает поддержку диплинков в виджете: открытие виджета по идентификатору и возврат клиента в нужное место после авторизации.
Документ описывает клиентскую маршрутизацию по диплинкам. Встраивание виджета партнером и получение конфигурации — раздел 8.2; вызовы методов — раздел 8.7.1.
Раздел связан с разделом Widget: 8.2 Интеграция виджета партнером.
2. Ключевые понятия
Диплинк — ссылка, открывающая виджет в нужном состоянии.
Идентификатор виджета (widgetId) — параметр, по которому открывается конкретный виджет.
Возврат после авторизации (returnUrl) — адрес, по которому клиент возвращается после входа.
3. Scope
Входит
S1: Открытие виджета по идентификатору (параметр пути или запроса)
S2: Возврат клиента после авторизации
S3: Предвыбор площадки по ссылке
S4: Предвыбор даты и времени по ссылке
S5: Ссылка на созданный заказ (на будущую реализацию)
Не входит
- Widget: 8.2 Общие работы > Интеграция виджета партнером
- Widget: 8.7.1 Общие работы > Архитектура и инфраструктура > Используемые методы
4. BR
Раздел технический; отдельных бизнес-требований Back нет. Требования определяются архитектурой маршрутизации виджета и связаны с Widget: 8.2 Интеграция виджета партнером.
5. Функциональные требования (UC + FR)
FR — functional requirements, что интерфейс должен уметь делать по определенному UC.
| ID | Сценарий | Функциональное требование | BR | Вес | Статус |
|---|---|---|---|---|---|
| S1: #FR8.7.3-1 | Клиент открывает виджет по ссылке | Виджет открывается по идентификатору widgetId, переданному в пути (/widget/{widgetId}) или в параметре запроса (?widgetId=). | 1 | Реализовано | |
| S2: #FR8.7.3-2 | Клиент возвращается после входа | После входа виджет возвращает клиента по адресу возврата (returnUrl), если он задан. | 2 | Реализовано | |
| S3: #FR8.7.3-3 | Клиент открывает ссылку на конкретную площадку | Виджет открывается с уже выбранной площадкой, если она передана в ссылке, и показывает календарь этой площадки. Если площадка недоступна или не входит в партнерскую зону этого виджета, параметр игнорируется: виджет открывается в обычном виде по своим настройкам, сообщение об ошибке не показывается. | 2 | Не реализовано, см. OQ8.7.3-1 | |
| S4: #FR8.7.3-4 | Клиент открывает ссылку с датой и временем | Виджет открывается с уже выбранными датой и временем, если они переданы в ссылке. Если слот занят, вышел за горизонт бронирования или иначе недоступен, параметр игнорируется: клиент видит календарь без предвыбора, сообщение об ошибке не показывается. | 2 | Не реализовано, см. OQ8.7.3-1 | |
| S5: #FR8.7.3-5 | Клиент открывает ссылку на созданный заказ (на будущую реализацию) | Виджет открывается на созданном заказе по ссылке. | 3 | Не реализовано — на будущую реализацию, потребителя нет: «Поделиться» копирует текст (Widget: 7.1.1), QR ведет в магазин приложений (Widget: 7.2) |
6. Открытые вопросы
| ID | Источник | Вопрос | Кому | Статус |
|---|---|---|---|---|
| #OQ8.7.3-1 | Figma / продукт | Подтвердить перечень поддерживаемых диплинков виджета помимо widgetId (например, предвыбор площадки, даты или времени): сейчас поддерживается только открытие по widgetId и возврат по returnUrl. Решение: добавляются все три сценария — предвыбор площадки, предвыбор даты и времени, ссылка на созданный заказ. Все три с весом 2. Ссылка на заказ нужна смежным разделам: «Поделиться» (Widget: 7.1.1) и рабочий QR на экране успеха (Widget: 7.2). | Бизнес | Закрыт |
| #OQ8.7.3-2 | Решение 11.08.26 | Требуется определить формат новых диплинков перед реализацией: имена и вид параметров (путь или query), поведение при недоступной площадке или занятом слоте, приоритет параметров ссылки над настройками виджета (например, ссылка ведёт на площадку, не входящую в партнёрскую зону виджета), а также нужна ли авторизация для открытия ссылки на созданный заказ. Уточнено 12.08.26: ссылка на заказ (FR8.7.3-5) переведена в «на будущую реализацию» — оба ее потребителя отпали, поэтому вопрос авторизации по ней сейчас не актуален. Определить формат нужно для двух оставшихся диплинков: предвыбор площадки (FR8.7.3-3) и предвыбор даты и времени (FR8.7.3-4) — имена и вид параметров, поведение при недоступной площадке или занятом слоте, приоритет параметров ссылки над настройками виджета (например, ссылка ведет на площадку вне партнерской зоны виджета). Решение по поведению: настройки виджета приоритетнее параметров ссылки — неверный или недоступный параметр игнорируется, виджет открывается в обычном виде без сообщения об ошибке. Зафиксировано в FR8.7.3-3 и FR8.7.3-4. Именование параметров определяет разработка при реализации. | Разработка | Закрыт |