Тут ИИ меня реально заменил. Теперь я цензор картинок. Трудовую прикладываю)
Картинок насобирать теперь не проблема, хоть сто. Но! Подвох — теперь это всё вычитывать надо, по стрелочке. На схеме под постом кусок того самого первого прогона ИИ: сократил для телефона, две правки пометил красным. Ещё косяки там есть. Что найдёте?)
Нейронка рисует мне сиквенсы, ER, C4 и другие типовые диаграммы на PlantUML и Mermaid: классы, состояния, активности, блок-схемы. А я сижу такой: это убери, это добавь, ещё это докинь.
Словами объяснить схему быстрее, чем самому отлаживать синтаксис PlantUML. Делаю так: кидаю агенту 2–3 старые диаграммы, документ с названиями систем и говорю, что нарисовать. Если агент видит код проекта, часть вызовов сам найдёт. Но участников и связи всё равно проверяю глазами.
Вот конвенция, которую я собрал уже после первого прогона. Часть оформления утащил из рабочего шаблона; вы хоть своё с нуля придумайте:
Вот мои .puml/скрины и документ с именами систем.
Нарисуй [сценарий] в PlantUML.
- Имена систем бери дословно из документа; неизвестное пометь ?.
- Группируй участников через box ... end box.
- Возьми skinparam из образцов. Новые системы пометь <<new>>:
skinparam sequenceParticipantBackgroundColor<<new>> #FFE1D6
- Запрос: метод и путь. Ответ: статус и результат.
- Верни .puml, таблицу вызовов и вопросы по допущениям.
- Отрендери схему и проверь синтаксис.
Синтаксис PlantUML теперь можно не запоминать. Хочешь подсветить новые сервисы, разложить системы по контурам и получить таблицу вызовов — пишешь это словами. Агент собирает
.puml и картинку. Руками тоже можно. А зачем)Если нужна строгая BPMN под импорт или своя редкая нотация — лучше профильный редактор или руками. А типовые схемы для доки ИИ уже рисует отлично.
Скиньте коллеге, который тоже устал гуглить синтаксис PlantUML)
@analyst_exe