The Architecture Definition Document is the deliverable container for the core architectural artifacts created during a project and for important related information. The Architecture Definition Document spans all architecture domains (Business, Data, Application, and Technology) and also examines all relevant states of the architecture (Baseline, Transition, and Target).
Определение архитектуры Architecture Definition
На какой вопрос отвечает «Где лежит единый источник правды по всем аспектам архитектуры проекта и её эволюции?»
Это единый документ, который собирает в себе все основные результаты проектной работы по архитектуре. Он описывает систему по всем направлениям — от бизнес-процессов до технологий — и показывает её состояние на трёх этапах: как было, как меняется и как должно быть в итоге.
Аналогия Похоже на полный комплект чертежей дома, где на одном листе собраны планы этажей, схемы электрики и описание материалов, а также указаны варианты «как есть», «в процессе ремонта» и «готовый результат».
Разобраться
Зачем это нужно
Нужен, чтобы все участники видели согласованную картину системы целиком, а не разрозненные фрагменты. Это основа для проверки соответствия и передачи знаний между командами.
Применить
Когда это нужно, а когда нет
Когда нужно
- При завершении этапа проектирования, когда нужно зафиксировать итоговое состояние системы.
- Когда требуется передать проектную документацию следующему этапу или другой команде.
- При аудите или проверке соответствия архитектуры утвержденным стандартам.
Когда не нужно
- Для оперативного согласования мелких изменений — лучше использовать запрос на изменение.
- Когда нужно описать только один домен (например, только данные) без связи с остальными — достаточно отдельного артефакта.
- Для текущего мониторинга исполнения — здесь нужна модель управления реализацией.
Типичные ошибки
- 01Считать этот документ живым, постоянно меняющимся файлом, хотя он фиксирует состояние на конкретный момент времени.
- 02Игнорировать переходные состояния, описывая только исходную и целевую архитектуры, что скрывает риски миграции.
- 03Разделять описание по доменам в разные файлы, теряя целостность картины, которую дает единый контейнер.
Сверить с первоисточниками
Что говорят стандарты
Определения из источников с переводом и ссылкой на раздел. Категория показывает назначение каждого подхода.
С чем связано
Связи понятия и его место в структуре подхода.
Phase A
Связанные понятия
Понятия, которые обычно смотрят рядом с этим.
Опишите архитектуру своей компании в Storm
Реестр процессов, архитектурное рабочее пространство, связи между системами и процессами — те самые артефакты, только про вашу организацию.
Это же в StormАрхитектура систем и интеграцийРеестр процессовКарта бизнес-способностей