2024 09 04 sad
(093/100) SAD
Пора рассказать, что пару месяцев назад у меня сменилась позиция — теперь это архитектор. Перешёл на эту роль, потому что захотел разобраться, что именно здесь нужно делать, а мой подход всегда один — работать в полях.
Одновременно с этим в компании 4 месяца назад появился процесс архитектурного ревью. В нём был добавлен процесс ADRs (https://t.me/chernov_sharit/539), который начинает применяться, когда взаимодействие происходит на стыке двух и более сервисов. В результате стало возникать больше вопросов, чем ответов: насколько подробно описывать взаимодействие, нужна ли точность до структур, и главный вопрос — что делать, когда в документе представлено несколько решений?
Как итог, стало понятно, что нам скорее нужны полноценные документы по всем аспектам архитектуры, нежели краткий контекст принятого решения. Такие документы тоже существуют и называются Solution Architecture Document. Для них есть свои шаблоны для проработки. Среди популярных:
- Software Architecture Canvas — https://www.workingsoftware.dev/software-architecture-canvas/
- C4 model (нельзя полноценно считать) — https://c4model.com/
- Arc42 — https://arc42.org/overview
- ну и по хардкору ISO 42010.
Пробовали писать такие документы? В какой момент в системе они нужны?
P.s. В комментариях принимаются шутки о том, что писать такие документы - грустненько.
#марафон @chernov_sharit