Pull to refresh

Документирование архитектуры: введение (remastered)

Reading time2 min
Views7.4K


Прочел статью Документирование архитектуры: введение и решил описать изложенное с другим подходом.

Диаграммы не буду расписывать в текст, попробуйте прочесть их на языке Archimate. Представьте, что вы расшифровываете египетское иероглифическое письмо. Вот подсказка — набор символов для расшифровки Summary of Language Notation

Описание мотивации и стратегии


Напомню введенное ранее мной определение:
Архитектура – это проектное решение, которое набор проектных решений организует в Систему, соответствующую целевому назначению.

Значит нужно определится с целевым назначением системы. Напрямую цели и требования нам не заданы, но можно рассмотреть всё более масштабно используя подход JTBD.


Слой бизнеса и слой приложений


Допустим, что «Человек» из имеющихся альтернатив выбрал информационный продукт «Блог».
Продукт цифровой, поэтому слой бизнеса (функциональная архитектура) и слой приложений (прикладная архитектура) можно стыковать сразу.


При этом сервисы «Комментирование» и «Управление комментариями» пока не будут использоваться, так как модерация требует ресурсов времени.

Технологический слой (технологическая архитектура)


Для ведения блогов есть много платформ, «с нуля» ничего реализовывать не нужно. Для выбора конкретной платформы нужно на основании требований (которые, увы, не заданы) составить сравнительную таблицу. Можно дополнить ее другими критериями. Тут я думаю всё понятно. Допустим выбрали Ghost CMS, Apache HTTP Server и MySQL.


Теперь нужно разместить это всё в какой-нибудь инфраструктуре, которую тоже выберем по соответствующим критериям. Пусть будет GCP.


Резюме


Ну вот как бы и всё. Да, я понимаю, что мало объяснений.
Какие могут возникнуть вопросы:
1) Можно ли разместить всю информацию на одном изображении?
Ответ: Да, если требуется проконтролировать связанность. Но нужно соблюдать баланс и аккуратно стыковать слои (бизнес, прикладной и технологический и др.). Чем меньше различных диаграмм вы создадите, тем меньше вероятность получить рассогласование. Чем больше элементов на диаграмме, тем сложнее понять смысл. Поэтому нужен баланс.
2) Можно ли использовать концепцию Viewpoint?
Ответ: Да, но следите чтобы диаграммы (Views) непротиворечиво стыковались друг с другом, иначе потом придется согласовывать людей, которые прочли ваши диаграммы. см. п. 1)
Tags:
Hubs:
Total votes 12: ↑9 and ↓3+9
Comments10

Articles