Проверить и сохранить черновик аналитики

Перед началом

Нужен установленный AGL Studio с поддержкой локального сохранения черновиков, открытый проект .agl и черновик агента в том же чате. Для просмотра и восстановления уже подготовленного черновика внешний сервер и повторный запрос агенту не требуются. Создание нового черновика использует выбранного исполнителя и обычное согласие на передачу контекста. Пользователь должен иметь право читать проект и записывать локальные данные приложения; запись принятых файлов требует доступа к папке проекта.

Что нажимать

1. Выберите режим «Аналитика» и нужный «Этап аналитики». Откройте тот чат проекта, в котором агент подготовил предложение.
2. На доске «Черновик агента» нажмите «Предпросмотр» у нужной строки. Для новой записи доступны все предложенные поля; для изменённой — значения «Было» и «Будет».
3. При наличии разверните «Подробное описание», «Диаграмма», «Диаграмма процесса» или «Связанный файл». Встроенные и связанные AGL-схемы и BPMN отображаются до принятия. Для схем доступны масштаб, «Подробные описания элементов (N)» с полным авторским текстом каждого элемента и «Исходный текст диаграммы». Открытие предпросмотра не принимает запись и не генерирует недостающие файлы.
4. Дождитесь сообщения «Черновики сохранены на этом устройстве · восстановятся после перезапуска.» После закрытия и повторного запуска откройте тот же проект и чат: подробные поля, встроенные схемы/BPMN и предложенные тексты документов восстановятся.
5. Снимите отметки с изменений, которые пока не готовы принять. Нажмите «Принять выбранные (N)». Studio сначала проверит пути и версии выбранных файлов, запишет вложения в docs/analytics, затем применит выбранные допустимые записи. Неотмеченные строки, конфликты и ещё не принятые тексты останутся на доске вместе с описаниями и схемами; их файлы не создаются.
6. Сохраните принятые записи через «Сохранить» / Cmd/Ctrl+S. Если требуется, используйте «Файл» → «Сохранить как…». Перед перезапуском снова дождитесь сообщения о сохранённых черновиках. После запуска принятые записи будут в проекте, а оставшиеся изменения — на проверке.

Увеличить скриншот

1 2 3 4

1. Черновики сохранены на этом устройстве
2. Предпросмотр оставшегося изменения BP-QA-2
3. Встроенная BPMN до принятия
4. Полное подробное описание

Полные тексты элементов доступны под связанной схемой в разделе «Подробные описания элементов (N)».

Увеличить скриншот

1 2 3

1. Связанный файл внутри папки проекта
2. Предпросмотр диаграммы с масштабом 50%
3. Подробные описания всех элементов

Готовность «Сбора информации»

В режиме «Аналитика» выберите «Этап аналитики» → «Сбор информации». Список «Материалы» и автоматическая проверка «Зарегистрированы исходные материалы» учитывают одинаковые типы записей: mind map (mind_map), макеты (wireframe) и Vision & Scope (vision_scope). Наличие BPMN, BRD, SRS или требований другого этапа не завершает сбор информации.

Если таких материалов нет, индикатор показывает 0/1, а список — «Записей: 0» и «Записей пока нет». Нажмите «Добавить запись», выберите тип материала и заполните его поля. После регистрации первого материала проверка станет 1/1; удаление последнего вернёт 0/1. Сохраните изменения кнопкой «Сохранить» или Cmd/Ctrl+S. Для записи в проект нужен доступ к его папке; перед перезапуском сохраните .agl.

Дробь — число выполненных проверок готовности, а не количество материалов. Поиск скрывает несовпадающие строки, но не меняет готовность: при неожиданно пустом результате очистите «Поиск по записям…». Не создавайте фиктивный материал ради индикатора; зарегистрируйте реальный исходный документ.

Увеличить скриншот

1 2 3

1. Сбор информации · 0/1
2. Записей: 0
3. Добавить запись

Готовность остальных этапов

Автоматическая проверка «каждый/все» выполняется только при наличии хотя бы одной соответствующей записи. В полностью пустой модели все 14 этапов показывают ноль выполненных автоматических пунктов; ручные отметки не заменяют недостающие записи.

• «Системные требования»: пункт «У каждого NFR есть метрика и целевое значение» требует хотя бы один NFR и заполненные поля у каждого. Без FR/NFR этап показывает 0/3; зарегистрированный SRS сам по себе не создаёт требования.
• «Передача в разработку»: пункт «Приоритетные требования имеют критерии приёмки» требует хотя бы одно требование с приоритетом high или critical и критерии для каждого. При отсутствии требований и UC показано 0/3.
• «Готовность»: RACI проверяет все UC и процессы, отображаемые в матрице. Для каждой задачи нужен ровно один A. Задача без назначения, два ответственных или только старые ссылки на удалённые задачи не закрывают этот пункт.

Удаление последней подходящей записи снова снимает автоматическую отметку. Не создавайте фиктивные данные ради полной дроби. При неожиданном результате проверьте тип записи, приоритет, метрику и целевое значение NFR, связи критериев приёмки и столбцы RACI. Права администратора и подключение к серверу для расчёта не нужны.

Частичная готовность сохраняется: процесс без владельца даёт 1/2 в «Бизнес-процессах», а зарегистрированное ТЗ — 1/2 в «Готовности», если RACI ещё не заполнена. Это выполненные отдельные проверки, а не завершённый этап.

Увеличить скриншот

1 2 3

1. Передача в разработку · 0/3
2. Системные требования · 0/3
3. Записей: 0

Как отображается BPMN

Названия событий, шлюзов и объектов данных располагаются снаружи фигур и переносятся полностью. В круге или ромбе остаётся только BPMN-маркер: сообщение, таймер, ошибка или тип шлюза. Тип задачи обозначается пиктограммой; служебные строки вроде Service Task и Exclusive Gateway не перекрывают название.

На холсте, в библиотеке, предпросмотре AGL/BPMN, SVG и векторном PDF используются общие фигуры, BPMN-маркеры и расположение полных подписей. В PDF встроен шрифт для кириллицы; текст остаётся выделяемым. PNG получает ту же SVG-схему; BPMN XML сохраняет границы внешних подписей в BPMNDI. Автоматические ветви шлюза имеют разные выходы и обходят объекты. Заданные вручную порты и изгибы сохраняются.

Увеличить скриншот

1 2 3 4

1. Событие и полное название
2. Шлюз с внешним названием
3. Пиктограмма сервисной задачи
4. Вписать всё

Для чтения длинной схемы используйте кнопки масштаба в предпросмотре. Полный текст шага доступен в «Подробные описания элементов (N)». Если вручную проведённая линия пересекает объект, откройте диаграмму и исправьте её маршрут на холсте. Просмотр и масштабирование ничего не принимают и не меняют в очереди черновика.

Как проверить результат

После принятия процесса откройте его строку. В блоке «Артефакты записи» доступны «Открыть описание» и «Открыть BPMN», если агент передал соответствующее содержимое. Описание открывается с полным Markdown, BPMN — с локальным просмотром схемы и исходника. В блоке «Диаграмма процесса» должно быть «Файл найден в проекте.» и кнопка «Открыть диаграмму». На открытом BPMN-холсте выберите «Экспорт», затем SVG, PNG или PDF и укажите место сохранения. Сопоставьте полные названия, конверты событий, типы задач, символы шлюзов и стрелки с холстом. Для BP-n по умолчанию создаются docs/analytics/processes/BP-n-<вариант>.md, .agl и .bpmn; явные допустимые пути вложений сохраняются. Из переданного BPMN XML Studio локально делает редактируемую AGL-диаграмму, из AGL-диаграммы BPMN — XML. Если агент передал только ссылку на отсутствующий файл, Studio сохраняет черновик и просит передать исходник или восстановить файл. Экспорт изображения — отдельное действие.

Увеличить скриншот

1 2 3

1. PNG
2. SVG
3. PDF

JSON с "type":"agl-studio-selection" относится к копированию выбранных объектов через Cmd/Ctrl+C. Это данные буфера обмена для вставки в Studio; они не сохраняют диаграмму или документ на диск. Для записи проекта используйте «Сохранить», а для изображения — «Экспорт».

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

Локальная копия черновика не заменяет сохранение принятых записей в .agl и не синхронизируется между устройствами. Вложения выбранных записей и отдельно выбранные тексты документов записываются в проект при принятии. Изменения самих записей сохраните в .agl. Undo отменяет изменение записей, но не удаляет уже записанные файлы.

Сохранить только выбранные артефакты

Оставьте отметку у BP-1 и снимите её у BP-2. После «Принять выбранные» в папке docs/analytics/processes появятся только переданные для BP-1 описание и диаграммы. BP-2 останется на доске с полным содержимым. Для текстов документов есть отдельные отметки: принятие записи DOC без отметки текста не записывает его тело.

Увеличить скриншот

1 2 3 4

1. Открыть описание / Open description
2. Открыть BPMN / Open BPMN
3. Открыть диаграмму / Open diagram
4. BP-2 остался на проверке / BP-2 remains pending

Если не получилось

• При ошибке чтения/записи черновика сохранённая копия не очищается. Устраните причину, например нехватку места или отсутствие прав, и нажмите кнопку повтора в уведомлении.
• Если после запуска доски нет, проверьте исходный файл проекта и чат. Не запускайте генерацию заново, пока не проверите сохранённую копию и сообщение об ошибке восстановления.
• Если папка проекта не открыта, откройте её с правом записи и повторите принятие; автоматической загрузки файлов вместо записи в проект нет.
• Если существующий файл отличается, Studio остановит принятие до записи остальных файлов. Идентичный файл считается сохранённым; известная исходная версия заменяется только после проверки её содержимого. Внешние и ручные изменения не перезаписываются.
• Если запись прервалась, черновик остаётся. Уже записанные выбранные файлы сохраняются; после устранения ошибки повторите принятие: совпадающие файлы будут пропущены.
• Если частичное принятие оставляет ссылки на неотмеченные записи, Studio откажет в применении и сохранит черновик. Отметьте связанные изменения или снимите отметку со ссылающейся записи.
• Изменённые вами параллельно записи не перезаписываются: конфликт остаётся на проверке. Сопоставьте версии перед решением. «Отклонить черновик» удаляет всё оставшееся предложение из очереди восстановления.
• Отсутствующий связанный файл показывается как ошибка чтения; для предпросмотра нужен доступ к исходной папке проекта. Файлы не восстанавливаются выдуманной схемой.
• В установленной Studio ссылки docs/analytics/... поддерживаются и при открытии .agl из вложенной папки docs/analytics или docs/analytics/processes: совпадающая часть пути не дублируется. Список файлов, проверка существования, открытие на холсте и запись используют этот же путь. Файлы сохраняются в существующей папке, без вложенной копии docs/analytics. Доступ остаётся внутри уже открытой папки; для артефакта в соседней папке откройте корень проекта. В браузере используйте пути относительно выбранной папки.
• Связанные файлы читаются с диска и должны оставаться в проекте после перезапуска. Встроенные описания сохраняются в черновике. BPMN-процесс и контекст ArchiMate храните отдельными диаграммами и свяжите их в описании: предпросмотр не превращает элементы одной нотации в другую.