Понимайте свой программный продукт
1ADK vs Structurizr
1ADK помогает владельцу разобраться в существующей архитектуре, даже если команда ещё не описала её как модель: изучить компоненты, проверить основания и сохранить вопросы.
Изучите компоненты и связи, найденные при анализе проекта.Проверьте, на какой источник ссылается вывод о компоненте.Увидьте новые компоненты и связи при сравнении анализов.
Понимание проекта не должно ждать готовой модели.
Чтобы описать архитектуру, сначала нужно выяснить, как устроена система. 1ADK даёт владельцу доступ к результатам такого исследования: карте, реестру интерфейсов, основаниям выводов и истории. Вы можете обсуждать проект с техническим специалистом, не изучая язык описания диаграмм.
01
Что вы получаете с 1ADK
Начинайте без архитектурного репозитория
Ваш кодовый агент исследует существующий проект. 1ADK организует результат, даже если до этого никто не поддерживал отдельную архитектурную модель.
Участвуйте в обсуждении без написания модели
Изучайте компоненты, раскрывайте связи и задавайте вопросы по находкам. Для этого не нужно редактировать DSL — специальный текстовый язык описания архитектуры.
Различайте изменение и уточнение
Сравнение анализов помогает отделить новое в системе от сведений, которые удалось установить только сейчас. Это важно, когда документацию восстанавливают параллельно с разработкой.
02
От карты — к предметному разговору
Пример
Продукт куплен, а архитектуру ещё предстоит восстановить
Допустим, новая команда получила код и неполную диаграмму. Ей нужно подготовить модель по своим стандартам, а владельцу — понять состояние проекта уже сейчас.
Что показывает 1ADK
Анализ находит компоненты, внешние сервисы и задачу экспорта. Источник каждого обоснованного вывода доступен для проверки; неизвестный получатель выгрузки остаётся вопросом.
Владелец может обсуждать состав системы и недостающие сведения до завершения архитектурной документации. Команда получает материал для построения модели.
03
Что меняется в вашей работе
| Задача | 1ADK | Structurizr |
|---|---|---|
| Источник модели | Результаты исследования реализации вашим кодовым агентом. | Архитектура, описанная в текстовой модели, например Structurizr DSL. |
| Работа владельца | Изучать карту, проверять основания и обсуждать вопросы. | Читать диаграммы, подготовленные из поддерживаемой командой модели. |
| Неустановленные сведения | Сохраняются рядом с находками как открытые вопросы. | Могут быть описаны командой в модели и документации. |
| История | Различия между результатами анализов системы. | Версии текстовой модели и её представлений. |
04
1ADK и Structurizr в одном процессе
1ADK помогает исследовать реализацию и сохранить основания. Structurizr позволяет выразить согласованную архитектуру как текстовую модель и строить из неё разные диаграммы. Используйте результаты 1ADK при подготовке и проверке модели; её написание остаётся отдельной задачей.
Вопросы о работе с 1ADK
Нет. Вы изучаете карту и пояснения. C4 — способ показывать архитектуру на разных уровнях детализации, а DSL — язык для её текстового описания; владеть им для работы с 1ADK не требуется.
Git показывает изменения файлов, в том числе файлов архитектурной модели. 1ADK сопоставляет найденные компоненты, связи и сведения о системе — это удобно для обсуждения результата на уровне проекта.
Да. Сначала проверьте находки и уточните вопросы в 1ADK. Затем архитектор может использовать эти сведения, чтобы описать модель на Structurizr DSL.
Названия продуктов и товарные знаки принадлежат их владельцам. 1ADK не связан с указанными компаниями.
Узнайте, что есть в вашем проекте.
Первый анализ и одно обновление бесплатны. Ваш кодовый агент исследует проект; 1ADK получает структурированное описание, а не исходные файлы. Изучите карту, проверьте основания и сравните результаты.
Без доступа к репозиторию. Без загрузки исходного кода. Без банковской карты.