Architecture·production

IAM.Solution / AGL

Architecture-as-Code, AGL DSL, диаграммы, генерация и MCP-инструменты.

Landing Приложение

Ключевые возможности

  • Enterprise, Solution, System и Software уровни
  • AGL DSL и генерация архитектурных артефактов
  • CLI, Web и MCP-интеграции для IDE/агентов

Пошаговые инструкции

Сценарии

Начинайте с результата: откройте сценарий, подготовьте prerequisites, выполните шаги и проверьте признаки успеха.

01 Создать архитектурный проект и построить диаграмму из AGLТекстовая модель проходит validation и воспроизводимо генерирует диаграмму.
Для кого
Архитектор
Результат
Текстовая модель проходит validation и воспроизводимо генерирует диаграмму.

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

  • Workspace
  • Scope архитектуры
  • Соглашение об identifiers

Шаги

  1. Создайте проектВыберите Enterprise/Solution/System/Software level и repository path.
  2. Добавьте AGL modelОпишите actors, systems, containers/components и relations со стабильными id.
  3. Запустите validationИсправьте unresolved references, duplicate ids и недопустимые зависимости.
  4. Сгенерируйте viewВыберите viewpoint/layout, проверьте подписи и сохраните source рядом с artifact.
Как проверить результат

Повторная генерация из commit даёт эквивалентную структуру без ручной правки диаграммы.

Если не работает

Если layout нестабилен, закрепите viewpoint/ordering, не редактируйте только экспорт.

02 Провести review архитектуры и экспортировать артефактыЗамечания связаны с элементами модели, а экспорт содержит актуальную version/provenance.
Для кого
Architecture board
Результат
Замечания связаны с элементами модели, а экспорт содержит актуальную version/provenance.

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

  • Validated AGL project
  • Reviewers и decision criteria
  • Target export formats

Шаги

  1. Создайте review snapshotЗафиксируйте commit/model version и набор views.
  2. Соберите комментарииПривязывайте замечание к element id/relation, а не к координатам картинки.
  3. Обновите modelВнесите решения в AGL и ADR, затем повторите validation.
  4. ЭкспортируйтеСформируйте SVG/PNG/PDF и manifest с commit/version.
Как проверить результат

Экспорт и manifest ссылаются на тот же validated commit и набор views.

Если не работает

При расхождении экспорта очистите generation cache и проверьте pinned renderer version.

Разделы приложения

Открыть подробное руководство

Для каждого экрана приложения подготовлена отдельная страница с кнопками, безопасными примерами значений, CLI/API и восстановлением по кодам ошибок.

Открыть подробное руководство →

Роль в экосистеме

IAM.Solution реализует Architecture-as-Code поверх AGL: архитектура хранится как текстовая модель, проходит проверку и порождает согласованные представления. Подход связывает enterprise, solution, system и software уровни без ручного расхождения диаграмм и документации.

Рабочий процесс

  1. Описать элементы, связи и views в AGL DSL.
  2. Запустить parse/validation и устранить ошибки модели.
  3. Сгенерировать диаграммы и документные представления.
  4. Обсудить изменение через diff исходного текста.
  5. Использовать CLI, Web или MCP в выбранном инженерном процессе.

Контракты и инструменты

Web-приложение подходит для просмотра и редактирования, CLI — для локальной автоматизации и CI, API — для интеграции, MCP — для архитектурных агентов. Сгенерированные артефакты считаются производными: source of truth остаётся версионируемая AGL-модель.

Governance

Validation проверяет синтаксис, ссылки и правила модели до публикации. Изменения проходят обычный review с автором и историей. Генеративный помощник может предложить структуру, но не обходит архитектурные ограничения и не публикует изменения без явного принятия.

Связь с IAM

Модельные вызовы можно направлять через IAM.Router, инспектировать через IAM.Secure, а инструменты предоставлять агентам через IAM.Core.