В задаче можно вести чек-лист — список подпунктов которые исполнитель отмечает галочкой. Когда все галочки выставлены, прогресс задачи 100%.
Поля пункта чек-листа
| Поле | Описание |
|---|---|
title | Текст пункта |
is_completed | Выполнен / нет |
sort_order | Порядок (drag-n-drop в UI) |
completed_at | Когда отмечен выполненным |
completed_by | Кто отметил |
1
Добавить пункт
В карточке задачи → раздел Чек-лист → Добавить:
- Вводите текст.
- Enter — сохраняется.
- Появляется в списке с чекбоксом слева.
API:
POST /api/v1/tasks/{id}/checklist.
2
Отметить выполненным
Кликаете чекбокс → пункт меняет статус. В журнале фиксируется кто и когда отметил.
API: PATCH /api/v1/tasks/{id}/checklist/{itemID}/toggle.
3
Редактировать / удалить
- Двойной клик на текст → редактирование.
- Иконка корзины → удалить.
PUT /api/v1/tasks/{id}/checklist/{itemID} и DELETE.
4
Порядок (drag-n-drop)
Перетаскивайте пункты — порядок сохраняется (sort_order).
5
Шаблоны чек-листов
Если одни и те же чек-листы повторяются (например, «приёмка iPhone на ремонт» всегда содержит 8 пунктов проверки), сделайте шаблон задачи:
- Настройки → Задачи → Шаблоны → Создать.
- Заполните чек-лист один раз.
- Сохраните.
Шаблон хранится в task_templates.checklist (JSONB).
6
Прогресс задачи
В списке задач рядом с каждой видно прогресс: «3/5 пунктов выполнено».
Если включена опция «Авто-завершение по чек-листу» (в настройках задачи):
- Когда все пункты отмечены — задача автоматически переходит в статус
completed. - Удобно для рутинных задач, не нужно ручного клика «Готово».
Возможные проблемы
- «Пункты сбросились» — задача была восстановлена из корзины, пункты могли потеряться (если они были удалены навсегда). Восстановление пунктов из аудита возможно только для super-admin.
- «Прогресс показывает не то» — обновите страницу (веб-сокет).
- «Не могу применить шаблон» — у шаблона нет прав видимости. Проверьте
template.visibility.