Правила и ограничения
Страница собирает в одном месте правила, которые кабинет проверяет и о которых он сообщает ошибками. Для каждого правила указано, где оно действует.
Учёт времени (треки)
| Правило | Значение | Где действует |
|---|---|---|
| Давность начала трека | Начало не старше 7 дней. Для ролей с разрешением «Может создавать треки задним числом» ограничения нет | Мои треки, формы Добавить трек |
| Будущее время | Окончание трека не может быть в будущем | Те же формы |
| Порядок времени | Окончание позже начала | Те же формы |
| Поля времени | Достаточно любых двух из трёх: начало, окончание, длительность. Значения должны быть согласованы | Форма трека |
| Минимальная длительность | 1 минута | Форма трека |
| Максимальная длительность одного трека | 24 часа (1440 минут) | Форма трека и API |
| Описание | Обязательно, до 2000 символов | Форма трека |
| Форматы длительности | 1.5 (часы), 1д 2ч 30м, 90 (минуты) | Поля оценки и длительности |
| Норма дня | Над днём в календаре показана «батарейка» относительно 8 часов | Мои треки |
| Часовой пояс | Сутки трека считаются в часовом поясе сотрудника. Если не указан, используется Asia/Bangkok | Отчёты и «Мои треки» |
| День трека | Трек относится ко дню, в который он закончился | Отчёты «Часы по трекам» и «Распределение времени» |
Оценка и сроки задач
| Правило | Значение |
|---|---|
| Единица хранения оценки | Минуты. Максимум 600 000 минут |
| Оценка родительской задачи | По умолчанию равна сумме оценок подзадач (метка «авто»). Ручное значение отмечено жёлтым карандашом |
| Дата начала и окончания | Календарные дни. Время суток для начала и конца задачи не сохраняется |
| Подзадача и релиз | Подзадача всегда относится к релизу родителя |
| Исполнитель | Только участник команды проекта. Отключённые пользователи не выбираются |
| Теги | До 50 тегов на задачу, длина тега до 100 символов, повторы игнорируются |
Срезы «Моей работы»
| Срез | Условие |
|---|---|
| Сегодня | Сегодняшний день попадает между началом и концом задачи |
| Неделя | Задача идёт на текущей неделе (понедельник — воскресенье), но не сегодня |
| Без дат | Не заданы ни начало, ни конец |
| Позже | Остальные задачи с датами, включая прошедшие сроки |
Проекты и релизы
| Правило | Значение |
|---|---|
| Префикс проекта | Заглавная латиница, цифры и дефис, до 10 символов. Уникален |
| Типы релизов проекта | Хотя бы один тип обязателен |
| Типы задач в релизах | Хотя бы один тип обязателен. Копируются в новый релиз |
| Обязательные поля релиза | Проект, название, дата начала, дата окончания |
| Гейт релиза «Запланирован → В разработке» | Ответственный, оценка, целевая дата |
| Удаление релиза или проекта | Удаляет вложенные задачи, подзадачи и часы. Требует подтверждения |
| Папка проекта | Непустую папку (с проектами или подпапками) удалить нельзя |
Пользователи
| Правило | Значение |
|---|---|
| Логин | От 2 до 64 символов: латиница без диакритики, цифры, точка, подчёркивание, дефис. Знак «@» и пробелы недопустимы |
| Должен точно совпадать с email в Keycloak | |
| Удаление себя | Нельзя удалить собственную учётную запись |
| Назначение роли ключу | Только своя роль или роль с меньшим приоритетом |
Отчёты
| Правило | Значение |
|---|---|
| Максимальный период отчёта «Часы по трекам» | 366 дней |
| Экспорт | CSV и XLSX содержат ровно то, что показано на экране с учётом фильтров |
План ресурсов
| Правило | Значение |
|---|---|
| Перегрузка | Сумма плановых часов сотрудника по всем проектам за день больше 8. Ячейки обводятся красным |
| Массовое заполнение | Часы проставляются только в рабочие дни. Выходные, праздничные и сокращённые дни получают 0 |
| Недозагрузка на «План-факт» | Факт ниже плана более чем на 20% |
| Перерасход на «План-факт» | Факт выше плана более чем на 10% |
| Цель «Расхода ресурса» | 85–100% от плана |
| Приоритет участника | Высокий, Средний, Низкий. Влияет только на отображение |
Уведомления и интеграции
| Правило | Значение |
|---|---|
| Код привязки Element | Действует 15 минут. Принимаются только зашифрованные комнаты |
| Webhook | Адрес публично доступный HTTPS. Частные и локальные адреса отклоняются. Подпись запроса: заголовок X-Assist-Signature, HMAC-SHA256 от тела с секретом |
| Секрет webhook | Показывается один раз |
| Срок действия API-ключа | Бессрочно, 30, 90 или 365 дней |
| Токен API-ключа | Показывается один раз. Потерянный токен восстановить нельзя, ключ перевыпускают |
| Лимит запросов API | 180 запросов в минуту с одного адреса, для запросов входа 40 в минуту |
| Идемпотентность | Для запросов на изменение рекомендуется заголовок Idempotency-Key |
Конструктор полей
| Правило | Значение |
|---|---|
| Ключ поля | snake_case: начинается с буквы, строчные латинские буквы, цифры и подчёркивание, до 63 символов |
| Ключ словаря подписей | Строчные сегменты через точку, каждый начинается с буквы |
| История значений (Trackable) | Доступна для числовых полей и полей «да/нет» задачи, а также для редактируемых дат задач, релизов и проектов |
| Удаление поля | Безвозвратно удаляет колонку и данные. Требует ввода ключа поля |
Права и видимость
| Правило | Значение |
|---|---|
| Меню | Строится из прав страниц роли |
| Вкладки | Строятся из прав вкладок роли |
| Режим «Команда» на «Моей работе» | Только роли Admin и Manager |
| Список досок | Права на коллекцию «Доски» |
| Фильтр «Скрыть завершенное» | Включён по умолчанию. Если корневая задача завершена, скрывается всё её дерево |