Архитектурное описание ArchitecturalDescription
Простыми словами
ArchitecturalDescription (описание архитектуры) — рабочий продукт, которым выражают архитектуру интересующей системы. В UAF это не папка с диаграммами, а элемент метамодели с самым длинным в домене списком атрибутов: тринадцать полей, среди которых утверждающий орган, архитектор, создающая организация, дата завершения, назначение, выводы, рекомендации, использованные инструменты и методология, статус и версия. Отдельно стоит логический атрибут toBe: он говорит, описывает ли документ существующую архитектуру или будущую, то есть различает as-is и to-be прямо в метамодели, без отдельных элементов. Описание связано с View (составляющие его виды), с Viewpoint, с Architecture (отношения describedBy и expresses) и само с собой через ArchitecturalReference. Ошибка — путать ArchitecturalDescription с Architecture: первое — документ, второе — то, что документом выражают.
Примеры
Стандарт разводит их явно: описание есть рабочий продукт для выражения архитектуры некоторой системы интереса, а Architecture — абстрактный тип, представляющий архитектуру как таковую. Между ними на схеме две встречные роли: describedBy и expresses.
UAF DMM 1.3, разд. 9.1.2 — описания ArchitecturalDescription (рис. 9-38) и Architecture (рис. 9-39), роли describedBy и expresses
Назначение вида Summary & Overview стандарт формулирует как сводку уровня руководства в единообразной форме, позволяющую быстро сверяться и сравнивать архитектуры между собой. Тринадцать полей и есть эта единообразная форма — карточка документа, а не его содержание.
UAF DMM 1.3, разд. 8.1.2 — определение вида Summary & Overview; разд. 9.1.2 — перечень атрибутов ArchitecturalDescription
ArchitecturalDescription перечислен в девяти видах: во всех аспектах Architecture Management (виды Architecture Views, Architecture, Architecture Status, Architecture Roadmap) и в Summary & Overview. Это самый частый элемент домена.
UAF DMM 1.3, разд. 8.1.1 и 8.1.2 — списки Elements видов домена Architecture Management и вида Summary & Overview
Определение из первоисточника
дословная выпискаAn Architecture Description is a work product used to express the Architecture of some System Of Interest. It provides executive-level summary information about the architecture description in a consistent form to allow quick reference and comparison between architecture descriptions -- It includes assumptions, constraints, and limitations that may affect high-level decisions relating to an architecture-based work program.
Рабочий продукт, выражающий архитектуру некоторой рассматриваемой системы. Даёт сводную информацию уровня руководства в единообразной форме для быстрого обращения и сравнения архитектурных описаний; включает допущения, ограничения и лимиты, способные повлиять на решения высокого уровня по архитектурной программе работ.
Основные параметры
Атрибуты этой сущности по справочнику источника.
- approvalAuthority : String[*] — Someone or something that has the authority to approve the ArchitecturalDescription.
- architect : String[*] — Someone responsible for the creation of ArchitecturalDescription.
- assumptionAndConstraint : String[*] — Any assumptions, constraints, and limitations contained in the ArchitecturalDescription, including those affecting deployment, communications performance, information assurance environments, etc.
- creatingOrganization : String[*] — The organization responsible for creating the ArchitecturalDescription.
- dateCompleted : String[0..1] — Date that the ArchitecturalDescription was completed.
- methodologyUsed : String[*] — Name of the documented methodology that will be or has been used in describing the architecture.
- purpose : String[*] — Explains the need for the Architecture, what it will demonstrate, the types of analyses that will be applied to it, who is expected to perform the analyses, what decisions are expected to be made on the basis of each form of analysis, who is expected to make those decisions, and what actions are expected to result.
- recommendations : String[*] — States the recommendations that have been developed based on the architecture effort. Examples include recommended system implementations, and opportunities for technology insertion.
- status : String[*] — State of the architecture description in terms of its development, baselining, activity (e.g., active or inactive), or some other factor of importance.
- summaryOfFindings : String[*] — Summarizes the findings that have been developed so far. This may be updated several times during the development of the ArchitecturalDescription.
- toBe : Boolean[1] — Indicates whether the ArchitecturalDescription represents an Architecture that exists or will exist in the future.
- toolsUsed : String[*] — Identifies any tools used to develop the ArchitecturalDescription as well as file names and formats if appropriate.
- version : String[*] — Identifier that indicates the particular edition or revision of the architecture description.
Связи
Исходящие
- Обобщение — таксономическое отношение «частное → общее»MeasurableElement
Связанные понятия
Опишите архитектуру своей компании в Storm
Реестр процессов, архитектурное рабочее пространство, связи между системами и процессами — те самые артефакты, только про вашу организацию.
Это же в StormАрхитектура систем и интеграцийРеестр процессовКарта бизнес-способностей