Задачи — пользовательское руководство

Этот раздел описывает полный функционал управления задачами в Main Office: список, фильтры, канбан‑доски, календарь, детальная карточка, комментарии, файлы, трудозатраты и проекты. Руководство основано на актуальном интерфейсе и возможностях модулей TaskList, TaskDetail, TaskKanban, TaskFiler, TaskProjects, TaskCostList.

Обзор навигации

• Верхнее меню страницы задач:
  • Создать — открывает диалог создания задачи.
  • Проекты — список проектов с бейджами открытых задач; выбор создаёт/фильтрует задачи по проекту.
  • Таблица — переход к списку задач с фрагментом all.
  • Приватные — фильтр задач автора со статусом «приватные».
  • Задачи → «Я исполнитель», «Я автор», «Контролирую» — быстрые фрагменты фильтрации.
  • Доски — канбан‑представление.
  • Календарь — календарь событий задач.
  • Трудозатраты — список трудозатрат (тайм‑лог) по задачам.

Быстрые клавиши

• В карточке задачи:
  • Ctrl+S — сохранить изменения.
  • Ctrl+W — добавить задачу в закладки («Отслеживать»).

Список задач (таблица)

Функции интерфейса списка (TaskList):

• Заголовок и уведомления: p-toast для статусов операций.
• Группировка строк: выпадающий список «Группировать по» с вариантами:
  • status, priority, creator, assigned_to, date_created_group, progress_group.
  • Строка‑заголовок группы показывает название и счётчик задач.
• Таблица (p-table):
  • Колонки: Статус, Приоритет, Дата создания, Тема, Назначена.
  • Сортировка, ленивые загрузки, отчёт о текущей странице.
  • Контекстное меню по строке: массовое изменение «Статус», «Приоритет», «Готовность» (0–100%).
  • Выделение, раскрытие детальной панели, быстрые действия (комментарии/файлы с бейджами).
• Фильтры и фрагменты:
  • Предустановленные фрагменты: all (все публичные), created_to_me, assigned_to_me, my_private, my_bookmarks.
  • Активный фрагмент отображается в заголовке списка.

Типичные действия:

• Открыть задачу: клик по строке — детальная карточка во вкладке.
• Изменить статус/приоритет: контекстное меню → выбрать значение.
• Осмотреть группу: включить нужную группировку, свернуть/развернуть группы.

Фильтр задач

Панель фильтрации (TaskFiler) даёт полный набор полей API:

• Даты: dateCreated, startDate, endDate и их варианты gte/lte/gt/lt/isnull.
• Атрибуты: category, status, creator, priority, isPrivate и соответствующие *In.
• Связи: contentType, objectId, assignedToIn, observersIn.
• Прочее: id, idIn, creatorOrAssignment.

Действия:

• «Поиск» — применяет текущие параметры к списку.
• «Сохранить фильтр» — сохраняет пресет (имя + набор полей) в дашборде задач.
• «Сброс» — очищает форму и текущий фильтр.
• Быстрый вызов: ShiftRight открывает сайдбар фильтра.

Канбан‑доска

Представление задач по статусам (TaskKanban):

• Колонки статусов: загружаются из справочника, исключая «Отклонена».
• Карточка задачи: тема, номер, приоритет (цвет/иконка), даты начала/окончания, аватары исполнителей, дата создания.
• Перетаскивание (drag‑and‑drop): перемещает карточку между колонками, автообновляет статус задачи.
• Видимость колонок: кнопки «Показать все» и тумблеры для скрытия отдельных колонок.
• Индикатор прогресса колонки: показывается процент задач в колонке (для «Выполнено» всегда 100%).
• Просрочка: задачи с прошедшим endDate подсвечиваются.

Календарь событий задач

Календарь (TaskEventCalendar) отображает задачи как события. Используйте фильтры для сужения периода и категорий.

Детальная карточка задачи

Форма редактирования (TaskDetail):

• Поля: тема, назначенные пользователи, наблюдатели, описание, статус, приоритет, даты начала/окончания, флаг приватности, проект.
• Действия меню: «Сохранить», «Отслеживать» (в закладки); доступны горячие клавиши.
• Валидация: обязательная тема (minLength: 5), работа с Formly полями.
• Вкладки:
  • «Комментарии» — список, добавление комментариев.
  • «Файлы» — загрузка/просмотр/удаление вложений.
  • «Трудозатраты» — журнал тайм‑логов по задаче.
  • «История» — изменения по документу/задаче.

Комментарии

Компонент TaskComments:

• Список комментариев с ленивой загрузкой.
• Добавление комментария: текст ≥ 3 символов, кнопка «Добавить».
• Уведомления об успешном создании.

Файлы, вложения

Компонент TaskRelatedFiles:

• Загрузка файлов: через p-fileUpload, после загрузки список обновляется.
• Просмотр: предпросмотр изображений, ссылка на файл.
• Удаление: подтверждение, затем обновление списка.

Трудозатраты (тайм‑лог)

Компоненты TaskCostList и TaskCostDetail:

• Список трудозатрат: дата, создатель, сотрудник, часы, № задачи, примечание.
• Создание записи: кнопка «Создать трудозатраты», форма с полями «Сотрудник», «Часы», «Примечание».
• Удаление записи: подтверждение, автообновление списка.

Проекты задач

Компоненты TaskProjects и TaskProjectDetail:

• Список проектов: ID, название, актёры (сотрудники) как p-chip.
• Создание/редактирование: диалог с полями «Название», «Сотрудник» (множественный выбор).
• Верхнее меню «Проекты»: бейджи показывают количество открытых задач в проекте.

Мои задачи и связанные задачи

• «Мои задачи» (MyTask): предустановленный фильтр по авторству/назначению, выбор строки открывает карточку.
• «Связанные задачи» (RelatedTasks): фильтрация по contentType/objectId, создание связанной задачи, открытие карточки.

Статусы и приоритеты

• Статус: визуально обозначается severity (успех, предупреждение, информация, опасность) в зависимости от значения.
• Приоритет: низкий → зелёный, средний → синий, высокий → оранжевый, критический → красный.

Права доступа и приватность

• Приватные задачи видны автору и пользователям с соответствующими правами.
• Массовые изменения статусов/приоритетов доступны согласно роли.

Типовые сценарии

• Создать задачу: нажмите «Создать», заполните форму, Ctrl+S — сохранить.
• Назначить исполнителей: откройте карточку, поле «assigned_to», сохраните.
• Переместить на канбане: перетащите карточку в нужную колонку.
• Сохранить фильтр: настройте параметры, «Сохранить фильтр», задайте имя пресета.
• Добавить комментарий/файл: вкладки «Комментарии»/«Файлы» в карточке.
• Учесть время: вкладка «Трудозатраты» → «Создать трудозатраты».

Быстрые ссылки

• Меню «Задачи» (коротко): /main-office/menu/tasks
• Полное руководство (эта страница): /main-office/tasks/