Шаблоны и повторяющиеся задачи

Трекер задач → Шаблоны нужен для регулярных сменных регламентов: открытие и закрытие, уборка, инвентаризация, проверка оборудования.

Создание шаблона

Откройте Трекер задач → Шаблоны.
Нажмите «Новый шаблон».
Укажите:
название и описание;
тип задачи;
приоритет;
заведение;
ответственного по умолчанию;
активность шаблона;
напоминание.
Добавьте пункты чек-листа.
Включите «Повторять по расписанию», если нужен автозапуск.
Нажмите «Сохранить».

Шаблон хранит:

название и описание;
тип и приоритет;
заведение;
ответственного по умолчанию;
смещение push-напоминания;
чек-лист;
расписание.

Напоминание

В шаблоне можно задать, за сколько минут до срока напомнить ответственному: 15, 30, 60 минут или за день. Можно выбрать «Без напоминания».

Напоминание создаётся вместе с задачей. Дальше оно отправляется тем же push-сервисом, что и напоминания обычных задач.

Расписание

Поддерживаются:

Ежедневно — с интервалом в N дней;
Еженедельно — с выбором дней недели и интервалом в N недель;
Ежемесячно — с выбором дня месяца и интервалом в N месяцев.

Дополнительно задаются:

время запуска в формате HH:MM;
часовой пояс;
дата начала;
дата окончания;
активность расписания.

Ограничения:

интервал — от 1 до 365;
дни недели — от 0 (понедельник) до 6 (воскресенье), без дублей;
день месяца — от 1 до 31;
даты — в формате YYYY-MM-DD;
дата окончания не может быть раньше даты начала;
часовой пояс должен быть известен системе.

Для еженедельного расписания без выбранных дней используется день недели даты начала. Для ежемесячного расписания с днём 31 месяцы без 31-го числа пропускаются.

При создании задачи срок устанавливается на расчётное время запуска.

Генерация задач

Кнопка «Создать сейчас» создаёт задачу из шаблона немедленно.
Cron scripts/run_task_recurrences.py создаёт задачи для всех активных расписаний, у которых наступил next_run_at.
Повторный запуск cron не создаёт дубль для того же запуска: уникальность проверяется по расписанию и сроку задачи.
После генерации рассчитывается следующий запуск.
После даты окончания расписание выключается.
Пропущенные запуски не восстанавливаются пачкой: cron обрабатывает текущий срок и переносит расписание вперёд.

Выключенные шаблоны

Шаблон с isActive=false:

не создаёт задачи по расписанию;
не запускается кнопкой «Создать сейчас» — API возвращает 409;
не участвует в cron-генерации.

При выключении шаблона его расписание также деактивируется. При повторном включении ближайший запуск пересчитывается. Если дата окончания уже прошла, расписание останется выключенным.

Изменение и удаление

«Изменить» открывает шаблон и расписание.
Удаление шаблона мягкое: шаблон исчезает из списка, новые задачи не создаются, уже созданные задачи сохраняются.
Удаление сразу останавливает расписание, не дожидаясь cron.
Изменение чек-листа шаблона не меняет уже созданные задачи.

Права

создание доступно пользователям с доступом к заведению;
сотруднику с одним заведением заведение подставляется автоматически;
компания-аккаунт может создать company-wide шаблон;
редактирование, запуск и удаление — создателю шаблона, пользователю с manage_templates или company-account;
сотрудник видит шаблоны своих заведений и company-wide шаблоны.

Подробнее: Права и доступ.