Блог

Архитектура, которую можно прочитать без разработчика

Заказчику не нужна диаграмма ради диаграммы. Нужна страница, по которой понятно, где данные и кто за что отвечает.

Архитектуру часто прячут в голове команды. Через полгода никто не помнит, почему очередь стоит именно здесь и почему отчёт считается ночью, а не по кнопке. Мы оставляем одну страницу: из каких частей состоит система, где лежат данные, какие внешние сервисы подключены и что будет, если один из них встанет. Без слоёв UML и без слов, которые нужны только автору схемы. Такая страница нужна не для защиты решения. Она нужна, чтобы следующий человек — ваш разработчик или наш — менял продукт, а не восстанавливал его по переписке.