Общая схема модуля событий

Что это за модуль

Модуль События — это процессный контур Structura. В нём настраиваются и запускаются маршруты, по которым проходят документы и задачи внутри проекта. Сам по себе модуль не хранит файлы документов — он управляет порядком действий: кто, когда и в какой роли должен принять решение, и куда документ пойдёт дальше.

Для рабочей документации модуль событий работает в паре с модулем РД. В РД лежит карточка документа и сами файлы, а в событиях — маршрут, по которому документ идёт от автора до утверждающего.

Где найти модуль

Открыть меню «Проекты СОД».
Выбрать проект.
В панели модулей проекта первым стоит модуль События.
По умолчанию открывается раздел «Маршруты процессов». Рядом с заголовком есть кнопка Открыть кабинет для перехода в личный кабинет событий.

Базовый URL: /sod/projects/<id>/events/cabinet (раздел переключается параметрами просмотра).

Из чего состоит модуль

В модуле два главных раздела:

Маршруты процессов — настройка шаблонов маршрутов. Здесь администратор задаёт, какие этапы проходит документ и кто отвечает за каждый этап.
Кабинет событий — личный кабинет пользователя: входящие задачи по моим ролям, мои процессы, история действий.

Дополнительно есть операционный (ops) контур того же кабинета — он нужен координаторам для общего обзора по проекту, а не для своих задач.

Основные сущности

Шаблон маршрута — это сохранённая настройка процесса: какой тип события, какие этапы и кто участвует в каждом этапе. Шаблон не привязан к конкретному документу — это «правила игры», по которым запускаются процессы.

Процесс (экземпляр маршрута) — конкретный запуск маршрута для конкретного объекта (например, для конкретного загруженного пакета документации). Из одного шаблона можно запустить много процессов.

Этап — отдельный шаг маршрута, на котором решение должен принять определённый участник или группа участников.

Задача этапа — приглашение для конкретного участника принять решение на этапе. Один этап может породить несколько задач — для каждого назначенного участника.

Решение по задаче — результат действия участника. Например, передать дальше, вернуть на доработку, согласовать, утвердить.

История процесса — журнал всех значимых событий по процессу: запуск, открытие этапа, создание задач, принятие решений, переходы и завершение.

Какие типы событий бывают

Тип события определяет, в какой модуль уходит запущенный процесс. На текущий момент основной тип, который активно используется — «Документация» (внутренний код rd_upload). Шаблон такого типа управляет жизненным циклом загрузки и согласования рабочей документации.

В будущем в системе могут появляться другие типы событий (например, согласование смет, актов исполнительной документации). Тип события задаётся при создании шаблона маршрута в поле «Тип события».

Какие этапы есть у маршрута документации

Для типовых документационных маршрутов используется фиксированный набор из четырёх этапов:

Этап (внутренний код)	Что происходит на этапе	Кто отвечает
Загрузка (`author`)	Автор оформляет загрузку: выбирает комплект и документ из реестра, прикрепляет PDF и исходный файл, отправляет в работу	Автор
Валидация (`validator`)	Валидатор проверяет загруженный пакет: автоматическая обработка PDF, сопоставление с предыдущей версией, простановка QR на каждый изменённый лист, отправка на согласование	Валидатор
Согласование (`reviewer`)	Согласующий принимает решения по каждому листу пакета и передаёт пакет на утверждение	Согласующий
Утверждение (`approver`)	Утверждающий принимает финальные решения по листам, завершает процесс и инициирует публикацию	Утверждающий

Каждый этап в шаблоне маршрута имеет свой список участников. У этапов согласования и утверждения дополнительно настраивается правило кворума: требовать решение всех назначенных или достаточно минимально заданного количества.

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

Статус	Что означает
В работе (`active`)	Процесс запущен, идёт по этапам
Согласовано (`approved`)	Процесс завершён положительно: все этапы пройдены, последний участник принял утверждение
Возвращено (`returned`)	Процесс возвращён назад автору (или на предыдущий этап) для доработки
Отменено (`cancelled`)	Процесс остановлен без финального результата

Текущий этап процесса (Загрузка / Валидация / Согласование / Утверждение) показывается отдельно от статуса.

Виды событий в истории процесса

В журнале процесса (история) встречаются такие записи:

Процесс запущен — момент создания экземпляра по шаблону.
Этап открыт — система перевела процесс на новый этап и создала задачи для участников.
Создана задача — на этапе появилась задача для конкретного участника.
Принято решение — участник принял решение по своей задаче.
Этап завершён — все необходимые решения собраны, этап закрылся.
Процесс согласован — последний этап утверждения закрыт положительно.
Процесс возвращён — участник вернул процесс назад.
Процесс отменён — процесс остановлен без завершения.

История пишется автоматически; пользователь не может её редактировать вручную.

Связь с модулем РД

Для процессов типа «Документация» граница между модулями такая:

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

Когда участник работает в кабинете событий по своей задаче, система переводит его в нужный экран модуля РД: автор уходит на форму загрузки, валидатор и согласующий с утверждающим — на экран маршрута пакета документации, согласование листов идёт через карточку согласования или прямо в batch-экране.

Подробнее см. страницу «Интеграция РД и модуля событий» и «Сквозная цепочка процесса по РД».

Кому какие действия доступны

Роль пользователя	Что может делать в модуле
Администратор проекта	Создавать и редактировать шаблоны маршрутов, активировать и деактивировать их, добавлять и убирать участников этапов, видеть ops-вкладку кабинета. Может запустить процесс от своего имени в аварийной ситуации (но в обычной работе — не запускает).
Автор, указанный в шаблоне на этапе «Загрузка»	Только этот пользователь может нажать «Запустить процесс» по шаблону. У других пользователей кнопка не отображается.
Назначенный участник этапа (валидатор, согласующий, утверждающий)	Видеть свои задачи в кабинете, открывать карточку процесса, переходить в предметный экран модуля РД для принятия решения
Прочие пользователи проекта	Просматривать общий список процессов и историю (без права принимать решения и без права запускать процессы)

⚠️ Роль «координатор» — это не должность в системе. В Structura нет отдельной роли «координатор», которая может запускать процессы за авторов. Когда в документации встречается слово «координация» — это про экран-дашборд «Координация» (см. Координация рабочей документации), куда заходят руководители проекта, нормоконтроль и инженеры ПТО для общего обзора. Запускать процессы — задача автора шаблона.

Куда двигаться дальше

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

События и процессы — про маршрут и процесс на верхнем уровне.
Создание шаблона маршрута — как настроить новый маршрут.
Запуск и повторный запуск процесса — как запустить процесс по шаблону.
Структура маршрута согласования — детальная анатомия этапов.
Кабинет событий и реестр процессов — личный кабинет и операционная вкладка.
Сквозная цепочка процесса по РД — как маршрут и модуль РД работают вместе.
Страницы по ролям: Автор, Валидатор, Согласующий, Утверждающий.
Статусы процессов и типовые ошибки.

Визуальные материалы (добавим на следующем шаге)

Скриншот: панель модулей проекта, модуль «События» выделен первым.
Скриншот: главный экран «Маршруты процессов» с таблицей шаблонов и кнопкой «Открыть кабинет».
Скриншот: карточка процесса (drawer) с этапом, статусом и историей.
Схема: связь модуля «События» и модуля «РД» на уровне сущностей.