Ресурсы

Ресурс — это то, на что записывают время: человек, который делает работу, место, где её делают, аппарат, который для неё нужен. Ресурс принадлежит одному филиалу и в другой не переносится. Визит занимает один или несколько ресурсов сразу (см. Визиты).

Мастер, место, аппарат

Все три приходят с отраслевым набором (см. Отраслевые наборы).

• Мастер — человек, который делает услугу. Его можно связать с человеком из команды, и только мастера.
• Место — кресло, стол, кушетка или кабинет. Место без графика для услуг ничего не меняет: место они берут, только когда у какого-то места филиала есть график, и тогда все услуги филиала берут его сразу (см. «Услуги, цены и валюта»). Заведённому месту график ставят сразу, иначе на него не записать.
• Аппарат — прибор или оборудование, например лампа.

Названия зависят от отрасли бизнеса: в массаже, спа и велнесе говорят «специалист, кабинет, оборудование», в спорте — «тренер, зал, тренажёр», в тату — «мастер, место, оборудование», в обучении — «преподаватель, кабинет, инструмент». Устроены они везде одинаково.

Мастер как ресурс и «Мастер» как роль

Это разные вещи. Мастер-ресурс — человек, на которого записывают, он стоит в календаре филиала. Роль — набор прав с названием, который выдают человеку из команды, и называться она тоже может «Мастер». Роль можно ограничить своими визитами: тогда она видит визиты, где занят ресурс, которым человек работает. Эту связь задаёт поле Кто из команды. Её же ставит приглашение, если в нём выбран календарь: новый мастер заводится вместе с приглашением, а когда человек принимает его, он привязывается к мастеру сам (см. Приглашения в команду).

Поля и где они

Ресурсы открытого филиала лежат в разделе «Мастера, места и аппараты» левой панели (название по отрасли; раздел есть, пока стоит набор «Запись клиентов»). Список разбит на мастеров, места и аппараты, у каждого ресурса видно, когда он работает сегодня, что делает и когда у него ближайшее свободное время; отключённые лежат отдельной карточкой Отключены. У ресурса есть Название, то, кто это — мастер, место или аппарат, — и, только у мастера, Кто из команды. Время записывают только на ресурсы, добавленные здесь. Один человек — один мастер в филиале: второй ресурс на того же человека не заводится, пока первый в работе. Если сменить, кто это — мастер, место или аппарат, — ресурс перестаёт делать то, что делал раньше; отметьте, что он делает, в карточке ресурса, в окне Какие услуги делает (см. «Кто что умеет»).

Карточка ресурса

Нажмите на ресурс в списке — откроется его карточка: как идёт сегодня и неделя, обычный график и до какого дня можно записать, сколько услуг он делает из тех, которым нужен такой же мастер, место или аппарат, ближайший визит и заметка. Ниже — лента: визиты ресурса и правки самого ресурса, у каждой правки видно, кто её сделал и когда; правки графика видит только тот, кому открыт график. Из карточки меняют название, то, кто это, и человека из команды, график, услуги, а также отключают и удаляют ресурс. Заметка — для своих, например «Левша — стол у окна»: её видит тот, кто видит ресурс, а подписывается она тем, кто написал.

Отключение

Ресурс, на котором впереди есть визиты, не отключается: сначала эти визиты переносят на другой ресурс или отменяют. Проверка показывает их до того, как что-то изменится (dry_run у инструмента). После отключения:

• график впереди уходит, обычный график остаётся;
• новое время на него не записать;
• прошедшие визиты и история остаются.

Включить возвращает ресурс в работу; график нужно завести заново (см. График ресурса). Мастера нельзя включить, пока тот же человек работает другим ресурсом филиала.

Удаление

Удалить можно только ресурс, на который ни разу не записывали время. Всё, у чего есть история, отключают, и визиты помнят своего мастера или место.

Кто может

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

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

• talemo_list_resources перечисляет ресурсы в работе бизнеса или одного филиала; с deactivated вместо них — отключённые. У каждого есть role — master, place или device, во всех бизнесах одинаковый — и, у мастера, человек из команды. Человеку мастера, места и аппараты называйте так, как их называет отрасль бизнеса (vertical в talemo_list_businesses).
• talemo_create_resource принимает branch_id, name, role и, только у мастера, user_id человека из команды. Один человек — один ресурс в работе в филиале: второй отклоняется со статусом 409 и кодом record.duplicate.
• talemo_update_resource меняет название, role, человека из команды или заметку; чего нет в запросе, остаётся, а пустая note убирает заметку. Заметка подписана тем, кто её написал, и временем. Отключённый ресурс не меняют, пока его не включили: статус 409, код resource.deactivated. Если поменяли role, отметьте заново, что ресурс делает, через talemo_add_service_fit.
• talemo_deactivate_resource выводит ресурс из работы. Его график впереди уходит (вернёт его только новое продление обычного графика, а дни, изменённые руками, потеряются), и время после этого на него записать нельзя: resource.deactivated. Ресурс с записями впереди отклоняется со статусом 409, кодом resource.has_bookings и params.count: сначала эти визиты переносят или отменяют. Инструмент меняет много сразу, поэтому сначала вызовите его с dry_run: в ответе записи впереди и days_ahead — сколько дней графика уйдёт. Настоящий вызов — только когда человек это увидел и сказал «да».
• talemo_activate_resource возвращает ресурс в работу и график сам не продлевает. Если человек из команды уже работает другим ресурсом филиала, вызов отклоняется со статусом 409, кодом record.duplicate и params.field user_id.
• talemo_get_resource_history показывает, что было с ресурсом, свежее сверху, страницами: его визиты, которые состоялись или отменены, и правки самого ресурса — завели, поправили, отключили, включили, задали обычный график, расписали до даты, изменили день или кусок времени, отметили или сняли услугу, — у каждой правки кто сделал (человек, помощник Talemo по его просьбе, программа) и когда. В правке только идентификаторы, коды и числа: текста заметки нет, а услуга названа так, как она называется сейчас. visits_done считает состоявшиеся визиты, edits_count — правки; next — это before следующего вызова, без него страница последняя; only — visits или edits. Визиты видит только роль, которой они открыты, правки графика — только роль, которой открыт график; роль, ограниченная «своим», видит визиты и правки графика только своего ресурса.
• Что у ресурса впереди — talemo_list_visits с resource_id, from и live: записанные и подтверждённые визиты от этого момента.
• talemo_delete_resource удаляет только ресурс, на который ни разу не записывали время. Ресурс с записями, прошлыми или будущими, отклоняется со статусом 409, кодом resource.has_history и params.count: его отключают. Удалённый ресурс пропал, повторный вызов даёт not_found. Перед удалением спросите человека; dry_run называет, сколько записей у ресурса было.

Эти отказы — ответы, а не сбои: скажите человеку, что мешает, и измените план.