Покрытие документации по автоматизации
Эта карта нужна авторам документации LadVen OS, чтобы автоматизация была описана как единый сквозной модуль, а не разрозненные куски в задачах и CRM. Автоматизация в LadVen OS — это один центр (/automation) и три движка под ним: правила задач, CRM-роботы и бизнес-процессы (workflow), плюс два общих слоя — защитные проверки и шаблоны внешних сообщений, и входящий поток из форм.
Карта построена по образцу docs/admin/task-coverage.md и docs/admin/crm-coverage.md. Она внутренняя: это методология производства документации, а не публичная страница.
Цель покрытия
Документация по автоматизации должна отвечать на пять вопросов для каждой поверхности:
- Где пользователь находится: центр автоматизации, правила задач, CRM-роботы, процессы, защитные проверки, шаблоны, формы.
- Какой повторяемый процесс это стандартизирует.
- Какие триггеры, условия и действия доступны и что произойдёт после срабатывания.
- Какие состояния, ограничения и ошибки видит пользователь (выключено, preview не проходит, блокировка проверкой, частичный запуск, нет прав).
- Какие скриншоты нужны, чтобы сценарий был понятен без доступа к демо-стенду.
Писать нужно на языке процесса: событие, условие, действие, владелец правила, проверка перед включением, история запусков, регламент. Не писать про backend, очереди, внутренние коды и технические классы.
Срез актуальности
| Поле | Значение |
|---|---|
| Дата аудита | 2026-06-10 |
| Frontend commit аудита | 4f86c3ed |
| Область | Read-only каталог поверхностей, блоков, сценариев автоматизации и план подстраниц; публичные статьи ещё не написаны |
| Ограничение | Незакоммиченные изменения frontend — только draft-контекст. Перед написанием каждой статьи проверять актуальность поверхности |
Маршруты /tasks/workflows/* и /crm/workflows/* редиректят в общий /automation/workflows/* — workflow это одна поверхность, доступная из задач и CRM через ?module=.
Каталог поверхностей
| ID | Поверхность | Route | Что нужно описать | Статус |
|---|---|---|---|---|
auto.surface.hub | Центр автоматизации | /automation | Единый индекс всех правил, регулярных шаблонов, защитных проверок и процессов: фильтры, статусы, владелец, last-run, read-only vs управление, создание любого типа | first-translation-ready |
auto.surface.task-rules | Автоматизация задач | /tasks/automation (вкладки rules/guards/recurring/history) | Правила задач: триггеры событий, условия, действия, preview/запуск, включение | first-translation-ready |
auto.surface.recurring | Регулярные задачи | /tasks/automation?tab=recurring | Шаблон + расписание (частота/интервал/дни недели/старт), ручной запуск, дубли | first-translation-ready |
auto.surface.crm-robots | CRM-роботы | /crm/automation?kind=robots | Триггер → условия → упорядоченная цепочка действий, ветвление, расписание шага | first-translation-ready |
auto.surface.guards | Защитные проверки | /automation/operation-guards, /crm/automation?kind=guards | Проверка перед операцией: условие, блокирующее сообщение, подсветка | first-translation-ready |
auto.surface.workflows | Бизнес-процессы | /automation/workflows | Список шаблонов, инстансы, запуск/прерывание, «дела к запуску», ручные задания | first-translation-ready (страница workflows.md) |
auto.surface.workflow-editor | Редактор процесса | /automation/workflows/templates/:id/editor | Граф узлов/связей, валидация, симуляция, запуск, аудитория и режим выполнения | not-started |
auto.surface.workflow-instance | Инстанс процесса | /automation/workflows/instances/:id | Состояние, история шагов, прерывание с причиной | first-translation-ready |
auto.surface.manual-tasks | Ручные задания процесса | /automation/workflows/tasks | Входящие задания-шаги: выполнить/отменить | first-translation-ready |
auto.surface.message-templates | Шаблоны сообщений | /crm/email-templates | Шаблоны внешних сообщений с переменными для действия «отправить письмо», предпросмотр | first-translation-ready |
auto.surface.forms-intake | Входящий поток из форм | /crm/integrations/forms | Авто-создание работы из заявок формы в воронку/этап (кросс-ссылка на CRM forms-intake) | not-started |
Вход в навигации — единый пункт «Автоматизация» (группа инструментов), доступен по правам на автоматизацию.
Каталог блоков
| ID | Блок | Где встречается | Что раскрыть |
|---|---|---|---|
auto.block.rule | Правило | правила задач, CRM-роботы, hub | Триггер + условие + действие(я); включение; preview |
auto.block.trigger | Триггер | правила задач, роботы, workflow | Событие или ручной запуск; набор событий зависит от модуля |
auto.block.condition | Условие | роботы, проверки, узел-условие | Группы «и/или», from/to, режимы when |
auto.block.action | Действие | правила задач (одно), роботы (цепочка) | Большие наборы действий по модулям |
auto.block.action-chain | Цепочка действий | CRM-роботы | Порядок, перетаскивание, мета каждого шага |
auto.block.branch | Ветвление (если/иначе) | роботы, узел-условие | Глубина ограничена |
auto.block.schedule | Расписание/тайминг | регулярные задачи (RRULE), мета действия (задержка/в точное время), ожидание в workflow | |
auto.block.recurring-template | Регулярный шаблон | вкладка регулярных | Частота/интервал/дни/старт + шаблон задачи |
auto.block.guard | Защитная проверка | общая поверхность проверок, оба модуля | Блок перед операцией + сообщение-подсказка |
auto.block.workflow-node | Узел процесса | редактор | старт/действие/условие/ожидание/задание/событие/цикл/параллельно/переменные |
auto.block.workflow-edge | Связь процесса | редактор | Подписи: успех/иначе/цикл/готово |
auto.block.workflow-instance | Инстанс процесса | инстансы, список | Статус + история шагов |
auto.block.manual-task | Ручное задание | входящие задания | Выполнить/отменить |
auto.block.run-history | История запусков | вкладка истории, инстанс, сводки «дел к запуску» | Итоги: успешно/ошибка/пропущено/заблокировано |
auto.block.message-template | Шаблон сообщения | шаблоны | Переменные + предпросмотр |
auto.block.governance | Аудитория/режим выполнения/системный исполнитель | редактор, правило задачи | Поля управления по правам |
auto.block.preview | Preview/симуляция | правила задач, редактор | По праву на симуляцию |
Сценарии, которые должны быть покрыты
| Сценарий | Где описывать |
|---|---|
| Назначить ответственного при создании сделки (round-robin/наименее загруженный) | automation/crm-robots.md |
| Поставить задачу при входе сделки на этап | automation/crm-robots.md |
| Отправить письмо по шаблону при смене этапа | automation/crm-robots.md, automation/message-templates.md |
| Ветвление по сумме сделки | automation/crm-robots.md |
| Авто-статус/ответственный/срок/теги по событию задачи | automation/task-rules.md |
| Настроить регулярную задачу (недельный отчёт, месячный разбор) | automation/recurring-tasks.md |
| Защитная проверка перед закрытием/сменой этапа | automation/operation-guards.md |
| Построить и запустить процесс с ручным заданием | automation/workflows.md, automation/manual-tasks.md |
| Запустить «дела к запуску» и прочитать сводку | automation/workflow-instances.md |
| Разобрать запуск по истории шагов, прервать зависший процесс | automation/workflow-instances.md, automation/run-history-troubleshooting.md |
| Симуляция/dry-run перед включением; «заблокировано проверкой» | automation/task-rules.md, automation/workflows.md |
| Авто-создание работы из заявки формы | automation/forms-intake.md |
| Связать процесс из правила (composition) | automation/crm-robots.md, automation/workflows.md |
| Аудит всей автоматизации через центр | automation/hub.md |
План публичных статей (первая волна)
| Статья | Покрытие | Статус |
|---|---|---|
automation.md (обзор, уже есть) | Общий вход в автоматизацию | first-translation-ready |
automation/hub.md | Центр автоматизации: фильтры, статусы, владение, создание | first-translation-ready (RU + все локали + ar, 10.06.2026) |
automation/task-rules.md | Правила задач: триггеры, условия, действия, preview/запуск | first-translation-ready (RU + все локали + ar, 12.06.2026) |
automation/recurring-tasks.md | Регулярные задачи: шаблон, расписание, ручной запуск | first-translation-ready (RU + все локали + ar, 12.06.2026) |
automation/crm-robots.md | CRM-роботы: триггеры, условия, цепочка действий, ветвление, тайминг | first-translation-ready (RU + все локали + ar, 12.06.2026) |
workflows.md (уже есть, не дублируем) | Процессы: узлы/связи, аудитория, режим выполнения, симуляция/запуск | first-translation-ready (углублён: узлы/связи во всех локалях + ar, 12.06.2026; перенесён в сайдбар-категорию «Автоматизация») |
automation/workflow-instances.md | Инстансы: запуск, наблюдение, история, прерывание, «дела к запуску» | first-translation-ready (RU + все локали + ar, 12.06.2026) |
automation/manual-tasks.md | Ручные задания процесса: выполнить/отменить | first-translation-ready (RU + все локали + ar, 12.06.2026) |
automation/operation-guards.md | Защитные проверки: условия, блокирующие сообщения, валидация | first-translation-ready (RU + все локали + ar, 12.06.2026) |
automation/message-templates.md | Шаблоны внешних сообщений и действие отправки | first-translation-ready (RU + все локали + ar, 12.06.2026) |
automation/run-history-troubleshooting.md | Чтение итогов запуска, заблокировано/пропущено, типичные исправления | first-translation-ready (RU + все локали + ar, 12.06.2026) |
automation/permissions.md | Права и области: создание/управление правилами, регулярностью, проверками, процессами, симуляция, запуск дел | first-translation-ready (RU + все локали + ar, 12.06.2026) |
automation/forms-intake.md не дублируем — кросс-ссылаемся на crm/forms-intake.md. automation/workflows.md не заводим: страница процессов уже существует как workflows.md («Рабочие процессы») и перенесена в сайдбар-категорию «Автоматизация»; вместо дубля она углубляется (каталог узлов и подписи связей).
Каждая новая RU-статья требует counterpart во всех опубликованных локалях (en/de/zh/es/fr/kk/ky) для check:doc-pages и ar-counterpart по конвенции pending-локали. Локализация — волнами, с глоссарием из memory/translation-leak-lessons, со сверкой числа заголовков по всем 8 локалям перед коммитом.
Готовность к локализации и скриншотам
CRM-автоматизация i18n в основном выровнена недавним фронт-раскатом (operation-guards, workflow-list/instance, hub — локализованы; см. docs/admin/frontend-issues.md). Остаются открытыми: шаблоны сообщений (/crm/email-templates) — неймспейс crmEmailTemplatesPage не заведён в словари (русский фолбэк на всех локалях); граф редактора процесса — вероятный RTL-риск для ar, требует отдельной dir="rtl" проверки. Локализованные скриншоты этих поверхностей до фиксов не публикуются. Захват скриншотов автоматизации блокируется тем же чистым demo-контуром, что и задачи/CRM.
Definition of Done
Статья по автоматизации считается готовой, когда:
- раскрывает все видимые блоки соответствующей поверхности;
- объясняет, какой повторяемый процесс стандартизируется, а не только кнопки;
- содержит практики для администратора процесса и руководителя (владелец правила, preview перед включением, контроль через историю);
- описывает пустые, заблокированные, частичные и ошибочные состояния, включая права;
- показывает, как проверить, что автоматизация сделала ожидаемое;
- не содержит приватных данных, внутренних URL и backend-деталей;
- использует скриншоты или planned-id в
screenshot-manifest.json; - связана с соседними сценариями (задачи, CRM, формы);
- имеет counterpart во всех опубликованных локалях и
ar.