Information associated with an ArchitecturalDescription, that supplements the standard set of tags used to summarize the Architecture. It states things like what methodology was used, notation, etc.
Метаданные архитектуры ArchitectureMetadata
На какой вопрос отвечает «По каким правилам и в каком формате составлено это архитектурное описание?»
Дополнительная информация, которая описывает сам архитектурный документ, а не его содержимое. Сюда входят сведения о выбранной методологии, используемой нотации и других условиях создания описания.
Аналогия Как титульный лист книги, где указаны автор, издательство и год, но не рассказывается о сюжете.
Разобраться
Зачем это нужно
Помогает читателю правильно интерпретировать диаграммы и тексты, зная контекст их создания. Делает процесс проектирования понятным для внешних аудиторов и коллег.
Применить
Когда это нужно, а когда нет
Когда нужно
- При передаче архитектурной документации новому исполнителю
- При использовании нестандартных или специфических нотаций
- При необходимости обосновать выбор конкретного подхода к проектированию
Когда не нужно
- Когда нужно описать бизнес-процессы или требования к работе системы
- Когда требуется указать технические характеристики компонентов системы
- Когда описываются организационные роли и ответственность команд
Типичные ошибки
- 01Смешивание метаданных с описанием самой архитектуры, например, перечислением сервисов.
- 02Игнорирование указания на методологию, что затрудняет понимание логики построения модели.
- 03Включение в метаданные данных о безопасности или местоположении, которые относятся к другим сущностям.
Сверить с первоисточниками
Что говорят стандарты
Определения из источников с переводом и ссылкой на раздел. Категория показывает назначение каждого подхода.
С чем связано
Связи понятия и его место в структуре подхода.
Управление архитектурой (Architecture Management)
- Обобщение — таксономическое отношение «частное → общее»Metadata
Связанные понятия
Понятия, которые обычно смотрят рядом с этим.
Опишите архитектуру своей компании в Storm
Реестр процессов, архитектурное рабочее пространство, связи между системами и процессами — те самые артефакты, только про вашу организацию.
Это же в StormАрхитектура систем и интеграцийГраф связей реестраРеестр процессов