Архитектура ПО
Практическая рамка разбора архитектуры ПО
Архитектурный разбор, который не может назвать решение, которому он служит, — это экскурсия. Я пользуюсь коротким набором вопросов, на которых можно провалиться. Если система их проходит, мы спорим о вкусе. Если нет — есть последовательность. Это список, который я реально несу в репозиторий.
1. Ограничение
Какой провал обходится дорого: срок поставки, частота инцидентов, стоимость инфраструктуры, корректность или дата, которую нельзя сдвинуть? Если никто не отвечает, разбор станет спором о стеке. Остановлюсь и зафиксирую ограничение письменно, прежде чем рисовать квадраты.
2. Форма изменений
Где концентрируются diff? Если каждая фича трогает один и тот же модуль, нарезка на сервисы клонирует узкое место. Сначала разложите модуль. Границы сервисов — для независимо меняющихся причин, не для оргсхемы, которую вам хотелось бы иметь.
3. Контракты
Границы типизированы, версионированы и у них есть владелец? Неявный JSON между тремя командами — авария с лишними шагами. Когда на пути модель, требование жёстче: схемы и путь отклонения нужны вероятностным результатам больше, чем данным, сформированным человеком.
4. Отказ
Что будет, когда очередь, провайдер или модель ошибутся или исчезнут? «Пользователь повторит» — не дизайн. Идемпотентность, таймауты, poison-сообщения и человеческий путь — да. Читаю задачи и консьюмеры до того, как поверить диаграмме последовательности счастливого пути.
5. Эксплуатация
Может ли толковый новый инженер за полдня найти путь от HTTP-запроса до строки? Если ответ зависит от одного человека, у вас bus factor, а не архитектура. Логи и трассы, которые не отвечают «что случилось с этим id», — декорация.
6. Команда
Этот дизайн выживет, если платформенная команда, которой у вас нет, так и не появится? Рекомендовать Kubernetes, mesh и озеро данных продуктовой команде из шести человек — халатность. Порекомендую наименее сложную форму, которая выдерживает ограничение и численность.
Как я пишу результат
Записка к решению: контекст, что удалось проверить, варианты с компромиссами, рекомендация и то, чего мы сознательно не делаем. Диаграммы — только там, где они меняют решение. Диаграмма C4 на 40 блоков, которую никто не сопоставит с путём в репозитории, хуже, чем отсутствие диаграммы.
Если честный результат — «оставайтесь и потратьте бюджет рерайта на тесты и модуль, который реально болит», я так и напишу. Разбор — не прелюдия к продаже перестройки.
Выводы
- Назовите ограничение, иначе разбираете вкус.
- Идите за концентрацией изменений, не за оргсхемой.
- Считайте отказ и эксплуатацию вопросами первого класса, в том числе для компонентов с ИИ.
- Подгоняйте дизайн под команду, которая есть.
- Пишите решение, не постер.