Покрытие документации по задачам

Эта карта нужна авторам документации LadVen OS, чтобы модуль задач был описан полностью и одинаково полезно для владельца бизнеса, руководителя отдела и сотрудника. Документация должна объяснять не внутреннее устройство системы, а управленческий смысл: как поставить задачу, закрепить ответственность, вести исполнение, принять результат, увидеть риски и не потерять договоренности.

Цель покрытия

Документация по задачам должна отвечать на пять вопросов:

1. Где пользователь находится: список, карточка, создание, редактирование, автоматизация.
2. Какой рабочий вопрос решает экран или блок.
3. Какие действия доступны и что произойдет после действия.
4. Какие состояния, ограничения и ошибки пользователь может увидеть.
5. Какие скриншоты нужны, чтобы сценарий был понятен без доступа к демо-стенду.

Писать нужно на языке процесса: результат, срок, ответственный, проверка, файлы, договоренности, контроль руководителя, история изменений. Не писать про backend, API, компоненты, хранилища, кэш, внутренние статусы разработки и технические классы.

Редакционный принцип

Каждая статья строится от рабочего сценария к элементам интерфейса:

1. Назвать бизнес-задачу пользователя.
2. Показать, где она выполняется в LadVen OS.
3. Объяснить видимые блоки и элементы управления.
4. Дать порядок действий.
5. Добавить хорошую практику и типичные ошибки.
6. Описать проверку результата.
7. Указать нужные скриншоты и их статус в screenshot-manifest.json.

Кнопки и поля не описываются изолированно. Например, "Ответственный" объясняется через ответственность за результат, а не как поле формы; "Наблюдатели" - через информирование без размывания ответственности; "Автоматизация" - через регламент отдела и проверяемые последствия.

Аудитории

Аудитория	Что ей важно в задачах	Как писать
Владелец бизнеса	Управляемость, прозрачность ответственности, контроль сроков, история решений	Показывать, как задачи превращают договоренности в проверяемую работу
Руководитель отдела	Очередь работы, загрузка людей, просрочка, приемка, повторяемые процессы	Давать практические срезы, проверки и правила контроля
Сотрудник	Что сделать, где взять материалы, у кого уточнить, как показать готовность	Объяснять порядок работы в карточке и признаки хорошего результата
Администратор процесса	Шаблоны, правила, защитные проверки, права на изменение регламентов	Писать про ответственность за процесс, а не про техническую настройку

Текущий срез покрытия

Раздел задач уже можно использовать как основу для первой волны перевода, но перед этим нужно явно разделять три уровня готовности:

• переводить первой волной - статья уже объясняет пользовательский сценарий, содержит практики и имеет хотя бы базовый RU-скриншот;
• дополнить перед переводом - статья полезна, но ей не хватает одного важного состояния, схемы или скриншота;
• не переводить пока - сценарий еще не оформлен в полноценную пользовательскую статью.

Зона	Статьи	Текущий уровень	Что сделать перед массовым переводом
Постановка задачи	create-task, details-context, participants, checklist, files	переводить первой волной	Добавить еще 1-2 скриншота для файлов и чек-листа при создании, если хотим закрыть создание максимально наглядно.
Карточка и исполнение	task-drawer, comments, activity-history, edit-task	переводить первой волной	Для мобильного сценария и readonly/нет доступа оставить отдельную вторую волну.
Контроль руководителя	list-views, time, activity-history, close-task	переводить первой волной	Скриншоты Kanban, колонок, bulk action и группировок можно доснять второй волной.
Приемка и закрытие	close-task, comments, checklist, files	переводить первой волной	Добавить короткую схему "исполнитель -> проверка -> возврат/закрытие" после стабилизации раздела.
Связи и контекст	relations, details-context	переводить первой волной	Позже добавить клиентский/CRM пример с безопасными демо-данными.
Шаблоны и автоматизация	templates-automation	переводить первой волной	Скриншоты регулярных задач, preview правила, guard editor и историю запусков доснять второй волной.
Ошибки, ограничения и права	errors-and-limits	переводить первой волной	Позже добавить скриншоты access denied, guard blocked, conflict и partial bulk.

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

Каталог поверхностей

ID	Поверхность	Route	Что нужно описать	Статус
tasks.surface.list	Рабочая область задач	/tasks	Поиск, фильтры, представления, группировки, экспорт, массовые действия	content-draft
tasks.surface.create	Создание задачи	/tasks?create=1	Постановка результата, участники, сроки, файлы, чек-лист, контекст	first-translation-ready
tasks.surface.drawer-view	Просмотр задачи в карточке	/tasks?taskId=<id>	Исполнение, обсуждение, контроль, файлы, чек-лист, время, связи	first-translation-ready
tasks.surface.drawer-edit	Редактирование задачи	/tasks?taskId=<id>&mode=edit	Изменение полей, участников, сроков, файлов, чек-листа и контекста	first-translation-ready
tasks.surface.page	Отдельная страница задачи	/tasks/:taskId	Та же карточка как самостоятельное рабочее пространство	draft
tasks.surface.automation-hub	Центр автоматизации	/automation	Входы в шаблоны, правила, регулярные задачи, CRM и защитные проверки	content-draft
tasks.surface.automation	Автоматизация задач	/tasks/automation	Правила, регулярные задачи, история, защитные проверки	content-draft
tasks.surface.automation-admin	Администрирование автоматизации	/tasks/automation/admin	Доступность возможностей, ограничения, служебные переключатели для администраторов	draft

Карта окон и блоков

Поверхность	Блоки на экране	Что должен понять читатель
Список задач	Верхняя панель, поиск, быстрые фильтры, сохраненные срезы, представления, таблица/карточки, группировки, колонки, экспорт, bulk mode, активные таймеры	Как собрать рабочий срез: "что горит", "что мое", "что по клиенту", "что нужно проверить"
Создание задачи	Название, описание, детали, участники, контекст, файлы, чек-лист, шаблон, создание связанной задачи	Как поставить задачу так, чтобы исполнитель мог начать без устных уточнений
Просмотр карточки	Header, статус, действия исполнения, детали, участники, файлы, чек-лист, комментарии, время, активность, связи	Как вести работу в одном месте и не терять решения между чатами
Редактирование карточки	Поля задачи, участники, сроки, контекст, файлы, чек-лист, ограничения прав	Когда править существующую задачу, а когда создать связанную
Комментарии	Лента, ответы, упоминания, файлы, реакции, состояние прочтения	Как фиксировать вопросы, решения и приемку результата
Время	План/факт, таймер, ручное время, история списаний	Как использовать время для планирования загрузки, а не для формальности
Связи	Родительские, дочерние, связанные задачи, CRM, документы, проекты	Как показать источник работы и зависимые обязательства
Автоматизация	Правила, шаблоны, регулярность, проверки, история	Как стандартизировать повторяемый процесс и проверить последствия
Администрирование	Доступы, возможности, включение/отключение служебных режимов	Как администратор процесса понимает, что доступно и почему действие ограничено

Каталог блоков

ID	Блок	Где встречается	Что раскрыть в статье
tasks.block.title-description	Название и описание	создание, просмотр, редактирование	Результат, контекст, критерии готовности, устойчивые договоренности
tasks.block.details	Детали задачи	создание, просмотр, редактирование	Статус, приоритет, срок, плановое время, предварительная оценка, проверка
tasks.block.participants	Участники	создание, просмотр, редактирование, фильтры	Постановщик, ответственный, соисполнители, наблюдатели, выбор людей
tasks.block.context	Рабочий контекст	создание, карточка, список	Проект, клиент, клиентский проект, рабочая группа, CRM, теги
tasks.block.files	Файлы	создание, карточка, чек-лист, комментарии	Загрузка, актуальная версия, доступы, preview, скачивание, связь с пунктом чек-листа
tasks.block.checklist	Чек-лист	создание, карточка, шаблон	Группы, пункты, вложенность, прогресс, вложения, нумерация, AI-черновик
tasks.block.comments	Комментарии	карточка	Вопросы, решения, приемка, упоминания, файлы, реакции, прочтение
tasks.block.activity	Активность и история	карточка, автоматизация	Кто что изменил, когда и почему это важно для контроля
tasks.block.status-execution	Статус и исполнение	карточка, список	В работу, готово, проверка, возврат, завершение, отмена, ограничения переходов
tasks.block.time	Время	карточка, список	Таймер, ручное время, план/факт, история, кто списал время
tasks.block.relations	Связи	карточка, создание из контекста	Родительская, дочерняя, связанная задача, CRM и документы
tasks.block.permissions	Права и ограничения	все поверхности	Что недоступно, почему, кто может изменить, что делать дальше
tasks.block.errors-limits	Ошибки и лимиты	все поверхности	Нет доступа, конфликт изменений, guard blocked, ошибка файла, retry
tasks.block.list-toolbar	Панель списка	список	Поиск, фильтры, пресеты, refresh, export, quick create
tasks.block.views	Представления	список	Таблица, Kanban, персональный Kanban, неделя, расписание по людям
tasks.block.columns	Колонки и сортировка	список	Какие поля показывать для работы, контроля и отчета
tasks.block.grouping	Группировки	список	По клиентам, по проектам, скрытые и пустые группы
tasks.block.bulk-actions	Массовые действия	список	Однотипное изменение нескольких задач и проверка частичного результата
tasks.block.automation-rules	Правила автоматизации	автоматизация	Событие, условие, действие, preview, запуск, история
tasks.block.recurring	Регулярные задачи	автоматизация	Шаблон, расписание, владелец, дубли, ручной запуск
tasks.block.operation-guards	Защитные проверки	автоматизация, admin	Что запрещаем, почему и какое исправление видит пользователь

Сценарии, которые должны быть покрыты

Сценарий	Где описывать	Что обязательно объяснить	Проверка результата
Создать задачу	tasks/create-task.md	Минимально достаточная задача, роль ответственного, срок, контекст, файлы и чек-лист	Задача появилась, ее можно открыть, участники понимают результат
Создать задачу из шаблона	tasks/templates-automation.md, tasks/create-task.md	Шаблон ускоряет повторяемый процесс, но требует проверки текущего контекста	Ненужные пункты и участники удалены до создания
Назначить участников	tasks/participants.md	Один ответственный, осознанные соисполнители и наблюдатели	Ответственность не размыта, нужные люди видят задачу
Уточнить детали и контекст	tasks/details-context.md	Срок, приоритет, проект, клиент, теги, предварительная оценка	Задачу можно найти в нужном срезе и принять по критериям
Прикрепить файлы	tasks/files.md	Файл нужен для выполнения или проверки, версия актуальна, доступы есть	Участники могут открыть или скачать материал
Разбить работу на чек-лист	tasks/checklist.md	Пункты проверяемые, группы отражают этапы, вложения относятся к шагу	Прогресс показывает реальное движение работы
Обсудить и зафиксировать решение	tasks/comments.md	Комментарий должен оставлять след для всех участников	Решение видно в карточке без поиска в личных чатах
Запустить или списать время	tasks/time.md	Таймер и ручное время нужны для план/факт и загрузки	История времени объясняет, кто и сколько работал
Вернуть, принять или закрыть задачу	tasks/close-task.md	Закрытие означает проверенный результат, возврат требует конкретного комментария	Статус соответствует реальному состоянию результата
Связать задачи и сущности	tasks/relations.md	Связь нужна для зависимости, источника или продолжения работы	Родительские и дочерние обязательства не теряются
Найти задачи и собрать срез	tasks/list-views.md	Поиск, фильтры, сохраненные срезы, группировки, колонки	Срез отвечает на рабочий вопрос руководителя или сотрудника
Подготовить отчет или экспорт	tasks/list-views.md	Перед экспортом нужно настроить фильтр и колонки	Файл содержит нужный набор задач и полей
Выполнить массовое изменение	tasks/list-views.md	Bulk mode подходит только для однотипных решений	Частичные ошибки видны и разобраны отдельно
Настроить регулярный процесс	tasks/templates-automation.md	Шаблон, расписание, владелец, дубли и срок	Новые задачи появляются ожидаемо и не создают шум
Включить правило автоматизации	tasks/templates-automation.md	Условие, область действия, действие и preview последствий	История показывает, что правило сделало
Настроить защитную проверку	tasks/templates-automation.md	Проверка защищает процесс и объясняет пользователю исправление	Пользователь понимает, что нужно добавить или изменить
Разобрать ошибку или ограничение	tasks/errors-and-limits.md	Нет доступа, конфликт, guard, файл, лимит, повторная попытка	Пользователь знает, кто может помочь и что проверить

Детализация поверхностей

tasks.surface.list

Назначение: рабочая область для поиска, контроля и массовой обработки задач.

Описать окна и режимы:

• список задач;
• список с группировкой по клиентам;
• список с группировкой по проектам;
• Kanban по статусам;
• персональный Kanban;
• недельное расписание;
• расписание по людям;
• режим массовых действий;
• активные таймеры над списком.

Описать элементы управления:

• поиск по номеру, названию, клиенту, проекту или описанию;
• быстрые фильтры: активные, мои, с моим участием, по отделу, непрочитанные, просроченные, без ответственного, приоритетные, на неделю, требующие оценки, все;
• расширенные фильтры: статус, приоритет, ответственный, постановщик, проект, клиент, срок, дата создания, дата обновления;
• сохраненные срезы;
• переключатель представлений;
• настройки колонок;
• сортировка;
• экспорт;
• обновление;
• быстрое создание;
• массовый выбор и массовое изменение.

Описать состояния:

• первый экран загружается;
• список обновляется после изменения фильтра;
• задач нет из-за фильтра;
• задач нет вообще;
• все группы скрыты;
• экспорт выполняется;
• bulk mode доступен только в списке;
• массовое действие выполнено частично;
• часть задач недоступна для изменения из-за прав или статуса.

Хорошие практики:

• начинать с рабочего вопроса: "что просрочено", "что на мне", "что по клиенту", "что на проверке";
• сохранять только повторяемые срезы;
• не смешивать фильтр и группировку: фильтр выбирает задачи, группировка раскладывает выбранное;
• перед экспортом включать только нужные колонки;
• массовые действия применять только там, где решение одинаковое для всех выбранных задач.

Нужные скриншоты:

• tasks.list.filters-light-desktop - список с фильтрами;
• tasks.kanban.light-desktop - Kanban;
• tasks.schedule.light-desktop - расписание;
• tasks.block.bulk-actions.partial-result - частичный результат массового действия.

Backlog скриншотов после первой волны: меню представлений, настройки колонок, группировка по клиентам, пустой список, mobile filters, активные таймеры.

tasks.surface.create

Назначение: поставить задачу так, чтобы результат, ответственность и контекст были понятны до начала работы.

Описать блоки:

• название и описание результата;
• срок, приоритет, плановое время, предварительная оценка, необходимость проверки;
• проект, клиент, клиентский проект, рабочая группа, теги;
• постановщик, ответственный, соисполнители, наблюдатели;
• файлы и документы;
• чек-лист;
• создание из шаблона, родительской задачи или CRM-контекста.

Описать элементы управления:

• поле названия;
• rich editor описания;
• date/time picker срока;
• переключатели проверки и предварительной оценки;
• people picker по ролям;
• выбор проекта и клиента;
• загрузка файлов;
• добавление пунктов и групп чек-листа;
• выбор шаблона;
• сохранение и отмена.

Описать состояния:

• пустая форма;
• выбран шаблон;
• есть обязательные поля;
• файл выбран, но задача еще не создана;
• пункт чек-листа имеет вложение до сохранения;
• сотрудник недоступен для назначения;
• создание выполняется;
• ошибка сохранения.

Хорошие практики:

• формулировать название через результат, а не действие "посмотреть" или "разобраться";
• назначать одного ответственного за исполнение;
• добавлять наблюдателей только при реальной потребности в контексте;
• прикладывать только актуальные материалы;
• использовать чек-лист для проверяемых шагов;
• перед созданием из шаблона удалить все, что не относится к текущей задаче.

Нужные скриншоты:

• tasks.create-task.light-desktop - полная форма создания;
• tasks.create-task.files-light-desktop - файлы при создании;
• tasks.create-task.checklist-light-desktop - чек-лист при создании;
• tasks.participants.roles-light-desktop - роли участников.

Backlog скриншотов после первой волны: создание из шаблона, ошибка обязательного поля, недоступный сотрудник, мобильное создание.

tasks.surface.drawer-view

Назначение: основное рабочее пространство задачи, где команда выполняет работу, обсуждает вопросы и принимает результат.

Описать блоки:

• header: номер, название, статус, уведомления, копирование ссылки, создание дочерней или связанной задачи;
• детали: статус, приоритет, срок, план/факт, проверка, предварительная оценка, проект и клиент;
• участники;
• файлы;
• чек-лист;
• комментарии;
• время;
• активность и история;
• связи.

Описать элементы управления:

• действия исполнения: взять в работу, завершить, отправить на проверку, принять, вернуть, отменить;
• изменение статуса и приоритета, если доступно;
• запуск, пауза и остановка таймера;
• добавление комментария и файлов;
• отметка пунктов чек-листа;
• цитирование пункта чек-листа в комментарий;
• добавление связи;
• переход к связанному документу, CRM-сущности или задаче.

Описать состояния:

• карточка загружается;
• задача доступна только для чтения;
• действие заблокировано защитной проверкой;
• статус нельзя изменить без обязательной оценки, результата или файла;
• комментарии загружаются постранично;
• файл недоступен;
• таймер уже запущен;
• связь скрыта из-за доступа;
• произошел конфликт изменений.

Хорошие практики:

• вести обсуждение в задаче, а не только в личных чатах;
• менять статус только после реального изменения состояния работы;
• возвращать задачу на доработку с конкретным критерием исправления;
• использовать чек-лист как контроль результата;
• фиксировать причину изменения срока;
• создавать связанную задачу, если появился новый самостоятельный результат.

Нужные скриншоты:

• tasks.drawer.view.light-desktop - полная карточка;
• tasks.drawer.view.light-mobile - карточка на мобильной ширине;
• tasks.view.comments-light-desktop - комментарии;
• tasks.view.checklist-light-desktop - чек-лист;
• tasks.files.view.light-desktop - файлы;
• tasks.block.time.summary - время;
• tasks.relations.view.light-desktop - связи;
• tasks.activity.light-desktop - активность.

Backlog скриншотов после первой волны: guard blocked, readonly карточка, active timer, return-to-work comment, hidden relation.

tasks.surface.drawer-edit

Назначение: изменить задачу, не потеряв управленческий смысл и историю договоренностей.

Описать блоки:

• редактирование названия и описания;
• изменение срока, приоритета, проверки и предварительной оценки;
• изменение проекта, клиента, рабочей группы и тегов;
• изменение участников;
• управление файлами;
• редактирование чек-листа;
• сохранение или отмена изменений.

Описать состояния:

• поле сохраняется;
• изменение запрещено правами;
• другой пользователь уже изменил задачу;
• выбранный сотрудник больше недоступен;
• файл удаляется или загружается;
• есть несохраненные изменения.

Хорошие практики:

• править задачу, если уточняется тот же результат;
• создавать связанную или дочернюю задачу, если появился новый результат;
• не менять ответственного молча, если работа уже началась;
• объяснять важные изменения в комментарии;
• проверять, что новые участники получили нужный контекст.

Нужные скриншоты:

• tasks.edit.drawer.default - редактирование задачи;
• tasks.drawer.edit.light-mobile - редактирование на мобильной ширине.

Backlog скриншотов после первой волны: конфликт изменений, запрет редактирования, несохраненные изменения.

tasks.block.participants

Назначение: закрепить ответственность и правильно распределить участие.

Описать роли:

• постановщик формулирует результат и принимает работу;
• ответственный ведет исполнение;
• соисполнители помогают выполнить части работы;
• наблюдатели следят за контекстом и получают изменения.

Описать элементы управления:

• поиск сотрудника;
• выбор из отделов;
• выбранные участники;
• удаление участника;
• состояние недоступного кандидата;
• аватар, имя и роль.

Описать практики:

• один основной ответственный;
• не добавлять наблюдателей "на всякий случай";
• соисполнителей добавлять только при понятной зоне участия;
• при смене ответственного объяснять причину в комментарии;
• проверять участников после создания из шаблона.

Нужные скриншоты: tasks.participants.roles-light-desktop.

tasks.block.files

Назначение: дать участникам материалы для выполнения и проверки результата.

Описать виды файлов:

• файлы задачи;
• вложения комментариев;
• вложения пунктов чек-листа;
• документы и ссылки на хранилище;
• итоговые материалы для приемки.

Описать элементы управления:

• dropzone и выбор файла;
• карточка файла;
• preview изображения или документа;
• скачать один файл;
• скачать все файлы;
• удалить файл, если разрешено;
• перейти к файлу в диске;
• фильтр по источнику файла.

Описать состояния:

• файлов нет;
• файл выбран, но не прикреплен;
• идет загрузка;
• загрузка не удалась;
• файл недоступен по правам;
• несколько файлов готовы к ZIP;
• задача read-only.

Хорошие практики:

• прикладывать только материалы, без которых нельзя выполнить или проверить задачу;
• итоговый файл сопровождать комментарием о готовности к приемке;
• доказательства по шагу прикреплять к пункту чек-листа;
• проверять доступы и актуальность версии;
• не превращать карточку в склад.

Нужные скриншоты:

• tasks.files.view.light-desktop;
• tasks.create-task.files-light-desktop.

Backlog скриншотов после первой волны: upload error, image preview, checklist-file filter, readonly empty state.

tasks.block.checklist

Назначение: разложить результат на проверяемые шаги и показать движение работы.

Описать элементы:

• общий прогресс;
• root-пункты без группы;
• группы этапов;
• вложенность пунктов;
• нумерация;
• приоритет пункта;
• вложения пункта;
• действия строки: выполнить, добавить, переместить, вложить, прикрепить, удалить, процитировать;
• AI-черновик чек-листа, если доступен.

Описать состояния:

• чек-лист пуст;
• есть группы и вложенные пункты;
• пункт сохраняется;
• выполнение пункта откатывается из-за ошибки;
• вложение загружается;
• действие недоступно из-за прав;
• AI-черновик требует проверки человеком.

Хорошие практики:

• пункт должен быть коротким и проверяемым;
• группы использовать как этапы процесса;
• не дублировать описание задачи в чек-листе;
• важные доказательства прикреплять к конкретному пункту;
• включать нумерацию для длинных процессов;
• AI-черновик всегда пересматривать перед применением.

Нужные скриншоты:

• tasks.view.checklist-light-desktop;
• tasks.create-task.checklist-light-desktop.

Backlog скриншотов после первой волны: группировка и нумерация, action toolbar, attachment lightbox, sync error, AI preview.

tasks.block.comments

Назначение: сохранить рабочую переписку, вопросы, решения и приемку в карточке задачи.

Описать элементы управления:

• поле комментария;
• форматирование;
• упоминание сотрудника;
• вложения;
• ответ или цитирование;
• реакция;
• редактирование и удаление, если разрешено;
• загрузка старых комментариев;
• отметки прочтения.

Описать состояния:

• комментариев нет;
• комментарий отправляется;
• файл прикрепляется;
• комментарий нельзя редактировать;
• ошибка отправки;
• есть непрочитанные изменения.

Хорошие практики:

• фиксировать итог устной договоренности;
• задавать вопрос конкретному участнику через упоминание;
• просить приемку отдельным комментарием;
• при возврате на доработку писать конкретный критерий;
• не хранить важные решения только в личных чатах.

Нужные скриншоты: tasks.view.comments-light-desktop.

tasks.block.time

Назначение: показать план/факт по задаче и помочь руководителю планировать загрузку.

Описать элементы:

• плановое время;
• фактически списанное время;
• активный таймер;
• ручное добавление времени;
• история записей;
• время по сотрудникам.

Описать состояния:

• времени еще нет;
• таймер запущен;
• таймер остановлен;
• ручная запись сохраняется;
• запись нельзя изменить;
• есть расхождение плана и факта.

Хорошие практики:

• использовать время для анализа загрузки и планирования;
• не запускать таймер без понимания задачи;
• исправлять случайно оставленный таймер;
• смотреть фактическое время при оценке похожих будущих задач.

Нужные скриншоты: tasks.block.time.summary.

tasks.block.relations

Назначение: показать зависимости и источник работы.

Описать виды связей:

• родительская задача;
• дочерняя задача;
• связанная задача;
• проект;
• клиент и CRM-сущность;
• документ.

Описать практики:

• дочернюю задачу создавать для самостоятельного результата;
• связанную задачу использовать для зависимости или продолжения;
• не закрывать исходную задачу, если внутри нее остались новые обязательства;
• связь должна помогать понять контекст, а не просто увеличивать список.

Нужные скриншоты: tasks.relations.view.light-desktop.

tasks.surface.automation-hub

Назначение: дать руководителю или владельцу процесса понятный вход в автоматизацию.

Описать блоки:

• правила задач;
• регулярные задачи;
• шаблоны;
• CRM-автоматизация, если связана с задачами;
• workflow;
• защитные проверки;
• быстрые переходы к настройке и истории.

Хорошие практики:

• начинать с описанного процесса, а не с кнопки "автоматизировать";
• назначать владельца для каждого важного правила или шаблона;
• периодически пересматривать неиспользуемые правила.

Нужные скриншоты: tasks.surface.automation.hub.

tasks.surface.automation

Назначение: стандартизировать повторяемую работу отдела и сделать автоматические действия проверяемыми.

Описать вкладки:

• правила автоматизации;
• регулярные задачи и шаблоны;
• защитные проверки;
• история выполнений;
• история внутри конкретной задачи.

Описать правила автоматизации:

• название правила;
• область действия;
• событие запуска;
• условия;
• действие;
• preview последствий;
• ручной запуск;
• включение и отключение;
• история.

Описать регулярные задачи:

• шаблон;
• владелец процесса;
• расписание;
• часовой пояс;
• срок новой задачи;
• политика дублей;
• ручной запуск;
• журнал созданных задач.

Описать защитные проверки:

• какое действие ограничивается;
• при каком условии;
• какое сообщение увидит пользователь;
• кто может изменить проверку.

Описать состояния:

• нет прав на просмотр;
• правило выключено;
• preview показывает, что запуск невозможен;
• ручной запуск выполняется;
• регулярная задача не создана из-за дубля;
• история показывает ошибку;
• пользователь видит понятное ограничение в карточке.

Хорошие практики:

• правило должно быть понятно по названию;
• preview обязателен перед включением важного правила;
• автоматизация не должна скрыто менять ответственного, срок или статус;
• если действие может вызвать вопрос, добавлять комментарий или понятную запись в истории;
• регулярный процесс должен иметь владельца;
• защитная проверка должна объяснять, что исправить.

Нужные скриншоты:

• tasks.surface.automation.rules;
• tasks.surface.automation.admin;

Backlog скриншотов после первой волны: recurring list, rule preview, guard editor, automation history, drawer automation history.

tasks.surface.automation-admin

Назначение: показать администратору процесса, какие возможности автоматизации доступны и какие ограничения включены.

Описать только пользовательски видимое:

• доступна ли настройка правил;
• доступна ли регулярность;
• доступны ли защитные проверки;
• включена ли временная остановка автоматизации;
• какие действия требуют прав администратора;
• что делать, если возможность недоступна.

Не описывать внутренние причины, технические флаги и backend-диагностику. Если интерфейс показывает техническое сообщение, в публичной документации нужно объяснить его как пользовательское ограничение: "обратитесь к администратору LadVen OS" или "проверьте права на управление автоматизацией".

Нужные скриншоты: tasks.surface.automation.admin.

Состояния, которые нельзя забыть

Состояние	Где встречается	Как объяснять
Пусто	список, файлы, комментарии, чек-лист, связи, история	Почему данных нет и какой следующий разумный шаг
Загрузка	список, карточка, файлы, комментарии, сотрудники	Что пользователь должен дождаться перед действием
Сохранение	создание, редактирование, комментарий, время, чек-лист	Что уже отправлено и почему нельзя нажимать повторно
Успех	создание, файл, комментарий, статус, automation run	Как проверить, что результат появился
Нет доступа	задача, файл, правило, участник, связь	Кто может дать доступ и что можно сделать сейчас
Ограничение процесса	закрытие, смена статуса, назначение, запуск правила	Какое условие нужно выполнить для продолжения
Конфликт	одновременное редактирование, устаревшие данные	Как обновить данные и не потерять важное изменение
Частичный успех	bulk actions, массовое изменение, автоматизация	Что применилось, что не применилось и как разобрать остаток
Ошибка файла	upload, download, preview, ZIP	Что проверить: размер, доступ, соединение, актуальность файла
Непрочитанное	комментарии, активность, уведомления	Как вернуться к новым решениям и изменениям

План статей

Статья	Основное покрытие	Статус	Что еще проверить
tasks/create-task.md	создание, описание, детали, участники, контекст, файлы, чек-лист	first-translation-ready	Доснять отдельные состояния файлов и чек-листа при создании.
tasks/details-context.md	детали, срок, приоритет, проект, клиент, теги, критерии готовности	first-translation-ready	Позже добавить CRM/клиентский пример с демо-данными.
tasks/task-drawer.md	карточка задачи как рабочее пространство	first-translation-ready	Отдельно закрыть readonly и guard blocked.
tasks/edit-task.md	редактирование, сохранение, права, конфликт изменений	first-translation-ready	Второй волной добавить конфликт изменений и запрет редактирования.
tasks/participants.md	роли, people picker, ответственность, ограничения назначения	first-translation-ready	Проверить, достаточно ли показан выбор из отделов.
tasks/checklist.md	чек-лист, прогресс, группы, вложенность, файлы пунктов	first-translation-ready	Доснять группировку, нумерацию и вложения пунктов.
tasks/files.md	файлы задачи, preview, download, итоговые материалы, доступы	first-translation-ready	Доснять upload error, preview и ZIP.
tasks/comments.md	обсуждение, упоминания, файлы, решения, приемка	first-translation-ready	Доснять mention menu, unread marker и attachment progress.
tasks/activity-history.md	события, изменения, уведомления, история автоматизации	first-translation-ready	Позже добавить фильтр/подгрузку старых событий, если появится в UI.
tasks/list-views.md	список, фильтры, срезы, представления, экспорт, bulk	first-translation-ready	Доснять Kanban, настройки колонок, bulk partial result и группировки второй волной.
tasks/close-task.md	выполнение, проверка, возврат, завершение, отмена	first-translation-ready	Добавить схему приемки после финальной редакции.
tasks/time.md	таймер, ручное время, план/факт, история	first-translation-ready	Доснять manual time modal и конфликт таймера.
tasks/relations.md	родительские, дочерние, связанные задачи, CRM, документы	first-translation-ready	Позже добавить связи с CRM и документом.
tasks/templates-automation.md	шаблоны, регулярные задачи, правила, проверки, история	first-translation-ready	Доснять recurring, rule preview, guard editor и историю запусков второй волной.
tasks/errors-and-limits.md	нет доступа, guard blocked, конфликт, лимиты, retry	first-translation-ready	Позже добавить скриншоты access denied, guard blocked, conflict и partial bulk.

Статус first-translation-ready означает, что страницу уже можно переводить как первую рабочую версию. Это не финальное покрытие навсегда: после перевода русская версия продолжит расширяться, а новые блоки будут попадать в локализацию следующими волнами.

Скриншоты первой волны

Эти id уже должны быть заведены в screenshot-manifest.json. Они покрывают минимальный публичный набор для русской версии и план локализации на остальные языки.

Screenshot ID	Что показывает	Статья
tasks.create-task.light-desktop	Форма создания задачи	tasks/create-task.md
tasks.create-task.files-light-desktop	Файлы при создании	tasks/create-task.md
tasks.create-task.checklist-light-desktop	Чек-лист при создании	tasks/create-task.md
tasks.participants.roles-light-desktop	Роли участников	tasks/participants.md
tasks.details-context.view.light-desktop	Детали и рабочий контекст	tasks/details-context.md
tasks.drawer.view.light-desktop	Полная карточка задачи	tasks/task-drawer.md
tasks.drawer.view.light-mobile	Карточка на мобильной ширине	tasks/task-drawer.md
tasks.edit.drawer.default	Редактирование задачи	tasks/edit-task.md
tasks.drawer.edit.light-mobile	Редактирование на мобильной ширине	tasks/edit-task.md
tasks.files.view.light-desktop	Файлы в существующей задаче	tasks/files.md
tasks.view.comments-light-desktop	Комментарии в задаче	tasks/comments.md
tasks.view.checklist-light-desktop	Чек-лист в существующей задаче	tasks/checklist.md
tasks.activity.light-desktop	Активность и история	tasks/activity-history.md
tasks.block.time.summary	План/факт и история времени	tasks/time.md
tasks.relations.view.light-desktop	Связи задачи	tasks/relations.md
tasks.list.filters-light-desktop	Список задач с фильтрами	tasks/list-views.md
tasks.kanban.light-desktop	Kanban-представление	tasks/list-views.md
tasks.schedule.light-desktop	Расписание задач	tasks/list-views.md
tasks.block.bulk-actions.partial-result	Частичный результат bulk action	tasks/list-views.md
tasks.surface.automation.hub	Центр автоматизации	tasks/templates-automation.md
tasks.surface.automation.rules	Правила автоматизации задач	tasks/templates-automation.md
tasks.surface.automation.admin	Администрирование автоматизации	tasks/templates-automation.md

Перед добавлением скриншота в статью нужно проверить, что id есть в screenshot-manifest.json для всех локалей. Если скриншот пока не снят, локали должны иметь статус planned; если временно нельзя снять, нужен статус blocked с причиной.

Backlog скриншотов

Эти состояния нужны для полного покрытия, но их можно заводить в manifest постепенно, когда соответствующая статья доходит до публикации:

• список: настройки колонок, меню представлений, пустой результат, группировка по клиентам, группировка по проектам, mobile filters, active timers;
• создание: выбор шаблона, недоступный ответственный, ошибка обязательного поля, pending-файлы;
• карточка: readonly, guard blocked, active timer, return-to-work, hidden relation;
• чек-лист: AI preview, вложения пункта, sync error, group numbering, mobile row actions;
• файлы: upload error, image lightbox, ZIP download, readonly empty;
• комментарии: mention menu, attachment progress, edit denied, unread marker;
• время: manual time modal, edit time entry, timer conflict;
• автоматизация: recurring list, recurring edit, rule preview, guard editor, history filtered by task, drawer automation history;
• ошибки: access denied, conflict, partial bulk, file unavailable, automation blocked.

Приоритет следующих визуализаций

После базовых схем create-task и close-task, а также текущей волны по checklist и participants, следующие визуализации нужно выбирать по управленческой ценности:

Приоритет	Страница	Что визуализировать	Почему важно	Риск локализации
1	tasks/list-views.md	Kanban по статусам с накоплением в На проверке	Руководитель видит узкое место процесса, сотрудник понимает поток работы	Длинные названия статусов и колонок в de, kk, ky
2	tasks/list-views.md	Недельное расписание с перегруженным днем	Помогает увидеть риск срыва до дедлайна	Формат дат, начало недели, длина названий дней
3	tasks/time.md	План/факт, где факт превысил план и есть объяснение	Владельцу бизнеса видно влияние задач на бюджет и загрузку	Форматы времени и подписи риска
4	tasks/list-views.md	Частичный результат массового действия	Показывает, что bulk action требует проверки результата	Причины ошибок должны быть человеческими, не техническими
5	tasks/templates-automation.md	Регулярная задача: шаблон, расписание, владелец, дубли	Показывает стандартизацию повторяемой работы без ручного контроля	Дни недели, SLA и длинные правила
6	tasks/templates-automation.md, tasks/errors-and-limits.md	Защитная проверка перед закрытием или сменой статуса	Объясняет ограничения как защиту результата, а не бюрократию	Нельзя оставлять Forbidden / Guard failed вместо пользовательского текста
7	tasks/relations.md	Родительская задача, дочерние задачи, CRM, документ, клиент	Помогает не терять зависимости и источник обязательства	Термины родительская/дочерняя/связанная должны быть едины во всех локалях

План первой волны перевода

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

Локали первой волны:

• en;
• de;
• zh;
• es;
• fr;
• kk;
• ky.

Страницы первой волны:

• tasks.md;
• tasks/create-task.md;
• tasks/details-context.md;
• tasks/participants.md;
• tasks/task-drawer.md;
• tasks/edit-task.md;
• tasks/comments.md;
• tasks/activity-history.md;
• tasks/errors-and-limits.md;
• tasks/list-views.md;
• tasks/checklist.md;
• tasks/files.md;
• tasks/relations.md;
• tasks/time.md;
• tasks/close-task.md;
• tasks/templates-automation.md.

Текущий статус первой волны:

Локаль	Объем	Статус
en	все 16 страниц основного цикла задач	готово к первой публикации
de	все 16 страниц основного цикла задач	готово к первой публикации
es	все 16 страниц основного цикла задач	готово к первой публикации
fr	все 16 страниц основного цикла задач	готово к первой публикации
zh	все 16 страниц основного цикла задач	готово к первой публикации; details-context, list-views, errors-and-limits прошли отдельную cleanup-вычитку
kk	все 16 страниц основного цикла задач	готово к первой публикации; templates-automation усилена отдельным редакторским проходом
ky	все 16 страниц основного цикла задач	готово к первой публикации; templates-automation, checklist, close-task, comments, task-drawer и participants усилены редакторским проходом

Первая публикация дает каждому языку связный пользовательский маршрут: понять модуль задач, создать задачу, вести работу в карточке, разложить ее на чек-лист, обсудить и закрыть результат. Для ky крупные страницы с прежним смешением кыргызских и казахских формулировок уже прошли редакторский cleanup; дальше нужна обычная точечная вычитка терминов по мере расширения раздела.

Страницы, которые лучше переводить после дополнительного покрытия:

Пока таких страниц в основном цикле задач нет. Новые статьи второй волны стоит переводить после русской приемки и добавления в матрицу покрытия.

Правила перевода:

• переводить смысл, а не дословные формулировки;
• сохранять термин LadVen OS и объяснение "операционная система для бизнеса";
• не переводить имена screenshot id, путей, технических статусов manifest;
• локализовать UI-термины в соответствии с языком портала;
• сохранять структуру заголовков и ссылки между статьями;
• не добавлять новые факты, которых нет в русской версии;
• после перевода запускать npm run check и npm run build;
• скриншоты для других языков оставить planned, пока не сняты локализованные версии.

Минимальная проверка перевода:

Проверка	Что должно быть верно
Термины	Роль постановщика, ответственного, соисполнителя, наблюдателя и проверяющего переведена последовательно.
Смысл	Текст объясняет бизнес-процесс, а не превращается в техническую инструкцию.
Ссылки	Все внутренние ссылки ведут на существующие страницы.
Скриншоты	RU-скриншоты не подменяются фейковыми локалями; manifest сохраняет planned для остальных языков.
Структура	Заголовки, таблицы, списки и предупреждения не ломают Docusaurus build.

Карточка блока для автора

Перед написанием новой статьи или раздела заполнить эту карточку:

ID:
Поверхность:
Блок:
Кому полезен блок:
Какой рабочий вопрос решает:
Какие элементы управления видны:
Какие действия доступны:
Какие состояния нужно описать:
Какие ограничения или ошибки возможны:
Какая хорошая практика нужна:
Как пользователь проверит результат:
Какие скриншоты нужны:
Есть ли id в screenshot-manifest.json:
Связанные статьи:
Статус: draft | ready-for-content | content-ready | screenshots-ready | localized

Definition of Done

Статья по задачам считается готовой, когда:

• раскрывает все видимые блоки соответствующей поверхности;
• объясняет рабочий процесс, а не только кнопки;
• содержит практики для руководителя, сотрудника или владельца процесса;
• описывает пустые, ошибочные, ограниченные и успешные состояния;
• показывает, как проверить результат действия;
• не содержит приватных данных, внутренних URL и backend-деталей;
• использует скриншоты или planned id в screenshot-manifest.json;
• связана с соседними сценариями;
• после приемки русской версии имеет план локализации на все языки LadVen OS.