Группы услуг

Группа ставит услуги прайса под подпись: «Маникюр», «Педикюр», «Уход». Услуга стоит в одной группе или ни в какой. У каждого филиала свой прайс и свои группы: между филиалами группа не делится (см. Услуги, цены и валюта).

Где видно

• Раздел «Услуги и цены»: прайс идёт группами, в порядке, который задал бизнес, а услуги без группы стоят последними под подписью «Без группы» — но только когда группы вообще есть. Слева в панели раздела те же группы с числом услуг: нажатие на группу показывает только её услуги, Все услуги — весь прайс. Кнопка «…» у группы переименовывает её, двигает выше или ниже и удаляет. В окне услуги есть поле Группа; пункт «+ Новая группа» в нём и в панели заводит группу тут же.
• Страница записи филиала (см. Страница записи филиала): те же подписи в том же порядке, сверху ряд ссылок на группы, а услуги без группы — под подписью «Другие услуги». Группа, в которой нет ни одной услуги, доступной для записи, не показывается.
• Виджет «Прайс» в приложении: группы с числом услуг, услуги без группы последними.

Что такое группа

• Название, 1–60 знаков, на первом языке обслуживания бизнеса. В филиале оно одно, регистр не важен: две «Маникюр» не различить. Переводов у групп пока нет, клиент видит название так, как его написал бизнес.
• Место среди групп филиала, с нуля, без дыр. Новая группа встаёт на названное место и сдвигает остальных вниз; передвинутая сдвигает тех, кто между старым местом и новым; удалённая смыкает ряд. Место дальше последнего — последнее.
• Услуги. Удаление группы услуги не удаляет: они остаются в прайсе без группы. Деактивированные услуги сохраняют группу и возвращаются в неё, когда их активируют.

Кто может

Смотреть группы — право смотреть услуги, заводить, переименовывать, двигать и удалять — право их менять (см. Услуги, цены и валюта). Роль с перечнем филиалов работает с группами этих филиалов. Без набора «Запись клиентов» групп нет.

Инструменты и отказы

• talemo_list_service_groups перечисляет группы бизнеса или одного филиала по порядку: name, position и services — сколько услуг прайса стоит в группе. Группа одной услуги — group в talemo_list_services; прайс приходит группами, услуги без группы последними.
• talemo_create_service_group принимает branch_id, name и, по желанию, position и service_ids. Названные услуги переходят в новую группу сразу, так что «сделай группу Дизайн и перенеси туда эти услуги» — один вызов. В ответе группа, after — группа перед ней (null, если она первая) — и moved: каждая перешедшая услуга и группа, откуда она пришла. Когда переходят услуги, сначала покажите человеку dry_run.
• talemo_update_service_group переименовывает группу или переставляет на другую position. В ответе группа, какая она сейчас, и was — прежние название и место.
• talemo_delete_service_group удаляет группу. В ответе группа, какой она была, и service_ids — услуги, что в ней стояли, и деактивированные тоже. Чтобы вернуть, заведите группу заново с теми же name, position и этими service_ids. Перед удалением спросите человека; dry_run скажет, сколько услуг останется без группы.
• group_id у talemo_create_service и talemo_update_service ставит услугу в группу её филиала. В talemo_update_service пустая строка выводит услугу из группы, а пропущенное поле оставляет как есть.
• Название, которое в филиале уже есть, отказывает 409 с кодом record.duplicate и params.field name. Филиал, группа или услуга не из этого бизнеса или филиала — record.reference_missing с params.field branch_id, service_ids или group_id; группа, которой нет, — not_found. Пустое название, длиннее 60 знаков, и отрицательное место — request.body_invalid.