Сквозная цепочка процесса по РД
Что важно понять в первую очередь
Маршрут по рабочей документации начинается не в реестре РД и не с загрузки файла, а в модуле «События» — с выбора готового шаблона маршрута и нажатия «Запустить процесс». Только после этого автор оказывается на форме загрузки.
То есть последовательность такая:
- В модуле «События» уже должен быть активный шаблон типа «Документация».
- Координатор или сам автор открывает этот шаблон и нажимает «Запустить процесс».
- Система отправляет инициатора на форму загрузки автора.
- Только после того, как форма загрузки заполнена и отправлена, процесс реально создаётся и пакет уходит на проверку.
Подробности шаблона см. Создание шаблона маршрута. Подробности запуска — Запуск и повторный запуск процесса.
Полная сквозная цепочка
| Шаг | Что происходит | Где это видно |
|---|---|---|
| 0 | В разделе «Маршруты процессов» создан и активирован шаблон с участниками всех четырёх этапов | Модуль «События» → «Маршруты процессов» |
| 1 | Координатор/автор нажимает «Запустить процесс» по шаблону | Та же таблица «Маршруты процессов», кнопка в строке шаблона |
| 2 | Система переводит инициатора на форму загрузки автора | URL /sod/projects/<id>/modules/working-docs/author/create-event?template_id=<id> |
| 3 | Автор выбирает комплект и документ из реестра, прикрепляет PDF и исходник, отправляет | Экран создания загрузки автора |
| 4 | Создаётся процесс и пакет (batch); первая задача автоматически уходит на этап «Валидация» | Журнал процесса; кабинет валидатора |
| 5 | Валидатор открывает пакет на экране маршрута пакета, проходит автоматическую обработку, сверяет листы с прошлой версией, штампует QR | Экран маршрута пакета документации |
| 6 | Валидатор нажимает «Отправить на согласование» в шапке страницы | Кнопка primary action в верхней части экрана пакета |
| 7 | Согласующие получают задачи. Каждый принимает по каждому листу решение «Согласовать» или «Дать замечание» (см. единый словарь). Когда условие кворума выполнено, согласующий нажимает «Передать на утверждение» | Экран маршрута пакета; per-sheet decisions |
| 8 | Утверждающие получают задачи. По каждому листу принимают одно из четырёх финальных решений (см. единый словарь). Завершают этап кнопкой «Завершить утверждение» | Тот же экран маршрута пакета |
| 9 | Запускается публикация: формируется опубликованный выпуск, документ становится виден в модуле РД | Working Docs Home, карточка «Актуальный выпуск» |
Кто и где работает на каждом этапе
| Этап | Роль | Точка входа в работу | Основной экран |
|---|---|---|---|
| Загрузка | Автор | Кабинет событий: задача «Загрузка». Альтернативно — переход из «Маршруты процессов» при запуске | Экран создания загрузки автора (author/create-event) |
| Валидация | Валидатор | Кабинет событий: задача «Валидация». Очередь валидатора (validator/queue) | Экран маршрута пакета документации (validator/batches/:batchId) |
| Согласование | Согласующий | Кабинет событий: задача «Согласование». Очередь согласующего (reviewer/queue) | Экран маршрута пакета (reviewer/batches/:batchId) |
| Утверждение | Утверждающий | Кабинет событий: задача «Утверждение». Очередь утверждающего (approver/queue) | Экран маршрута пакета (approver/batches/:batchId) |
Дополнительно для всех ролей доступны:
- модуль Координация — обзор замечаний и согласований по проекту;
- Карточка листа — для просмотра конкретного листа со всеми его версиями.
Как связаны модуль «События» и модуль «РД»
| Что хранит модуль «События» | Что хранит модуль «РД» |
|---|---|
| Шаблоны маршрутов и список участников | Реестр комплектов, документов и листов |
| Запущенные процессы (экземпляры) | Пакеты (batch) с их стадиями и листами |
| Задачи участников и их решения | Версии листов, история, артефакты |
| История переходов и решений по процессу | Замечания и согласования по листам |
| Кабинет событий и пресеты ролей | Координация, реестры согласований и замечаний, аналитика |
Граница простая: процесс и задачи живут в «Событиях», содержимое и состояние документа — в «РД». Эти две системы связаны идентификатором процесса и идентификатором пакета.
Что произойдёт при возврате на доработку
На любом этапе после загрузки участник может вернуть пакет автору. При этом:
- Текущий процесс получает статус «Возвращено».
- Открытые задачи на текущем этапе закрываются как «возвращено».
- Автор получает задачу на доработку.
- Когда автор подготовил исправленный PDF, он снова нажимает «Запустить процесс» по шаблону. Создаётся новый отдельный процесс, в котором страницы PDF становятся новыми ревизиями соответствующих листов.
- История старого процесса остаётся в системе как закрытая.
Это важно: возврат → доработка → следующий процесс, а не «продолжение того же». Чтобы вы могли проследить полную хронологию, в карточке листа модуля РД история собирается по всем процессам, через которые проходил лист.
Что является финальным результатом
Цепочка считается успешно завершённой, когда выполнены все три условия:
- процесс в модуле «События» в статусе «Согласовано»;
- в журнале процесса есть запись «Процесс согласован»;
- в модуле «РД» документ показан как опубликованный, в реестре листов виден актуальный выпуск с проштампованными PDF.
В целевой логике все три условия выполняются атомарно в момент завершения утверждения. Если первые два выполнены, а документ в модуле РД не виден — это технический инцидент; см. Статусы процессов и типовые ошибки.
Краткая шпаргалка по ролям
- Автор — оформляет загрузку и отвечает на замечания (см. РД в событиях: роль автора).
- Валидатор — проводит пакет через автоматическую обработку, штампует QR, отправляет на согласование (см. РД в событиях: роль валидатора).
- Согласующий — принимает per-sheet решения и передаёт на утверждение (см. РД в событиях: роль согласующего).
- Утверждающий — принимает финальные решения и завершает процесс (см. РД в событиях: роль утверждающего).
Визуальные материалы (добавим на следующем шаге)
- Схема: полная сквозная цепочка по этапам с переходами и возвратами.
- Схема: связь сущностей «События» ↔ «РД» (шаблон → процесс → пакет → листы → выпуск).
- Скриншот: переход из «Маршруты процессов» на форму загрузки автора.
- Скриншот: пакет на экране маршрута на стадии «Утверждено».