Зачем запускать команду по расписанию
Часть работы приложение выполняет не в момент действия пользователя, а по времени: закрывает и активирует спринты, предупреждает о сроках, создаёт повторяющиеся задачи. Всё это делает одна команда — cli.php pm runner. Пока её не запускают, задачи, статусы и уведомления о событиях работают как обычно, но всё, что зависит от даты, не происходит.
Готовую команду с уже подставленными путями к PHP и cli.php показывает само приложение в настройках — вводить пути вручную не нужно.
Что делает команда
- Закрывает спринты. Если у активного спринта включено «Закрывать автоматически при достижении даты окончания», а дата окончания прошла, спринт завершается. При включённом переносе незавершённые задачи переходят в следующий спринт, при включённом автосоздании следующий спринт создаётся сразу.
- Активирует спринты. Спринт со статусом «Планируется», у которого наступила дата начала, становится активным. При включённом автозаполнении в него попадают задачи из статусов категории «к выполнению».
- Предупреждает о сроках. Задачи со сроком сегодня или завтра дают событие «Deadline approaching (24h)», задачи с прошедшим сроком — «Deadline overdue». Уведомление адресовано только исполнителю задачи и уходит по электронной почте: адрес берётся из его контакта, личные каналы для этих событий не используются.
- Создаёт повторяющиеся задачи. Если у задачи настроено повторение, после её закрытия появляется следующая по правилу повторения.
Как поставить в расписание
Команду добавляет администратор сервера в системный планировщик от пользователя веб-сервера. Как часто запускать:
- Раз в сутки — для спринтов и повторяющихся задач. Этого достаточно: спринты сравниваются по датам, а не по времени суток.
- Раз в час — если предупреждения о сроках нужны в течение дня. Учтите: задача со сроком «сегодня» или «завтра» попадает в выборку при каждом запуске, поэтому уведомление придёт столько раз, сколько раз запущена команда.
- Ночью — если важно, чтобы автозакрытие спринта произошло до начала рабочего дня.
Проверить настройку можно тем же запуском из консоли: команда печатает, какие спринты закрыла и активировала и по каким задачам отправила предупреждения.
Что важно учесть
Если команда не запускается, останавливается только автоматика по датам — закрытие и активация спринтов, предупреждения о сроках, повторяющиеся задачи. Остальное приложение работает без неё.
«Сегодня» определяется по времени сервера. Если в отчётах и уведомлениях даты сдвинуты на день, проверьте часовой пояс сервера, а не настройки приложения.
Если предупреждения о сроках не приходят, проверьте адрес электронной почты в контакте исполнителя: для этих двух событий почта — единственный канал. Telegram, Max и вебхук на них не подписаны.
