Раздел 16 · Архитектура и решения

Архитектурная автономия

middle-senior~45 мин

без входаВойди, чтобы отмечать прогресс, вести заметки и решать задачи в редакторе. войти

Архитектурная автономия

Сцена · вопрос висит три дня

Ты делаешь доставку для сервиса заказов. Нужно хранить статус доставки, и ты не уверен: отдельная таблица или колонка в заказах? Пишешь тимлиду. Тимлид на совещаниях, потом в отпуске на полдня, потом разбирает инцидент. Через три дня приходит ответ: «а ты сам как думаешь? Делай, как считаешь нужным».

Три дня ушли. Решение всё равно оказалось твоим. Оно было твоим с самого начала: таблица живёт внутри твоего модуля, её никто, кроме тебя, не читает, и поменять её через месяц стоит одной миграции.

А на соседнем этаже обратная история. Разработчик другой команды молча переименовал поле в событии, которое читают ещё три сервиса, потому что «так чище». Этот вопрос как раз стоило задать, и не тимлиду, а владельцу контракта. Но его никто не задал.

Две ошибки с противоположных сторон. Одни несут наверх решения, которые могли принять сами. Другие принимают решения, которые им не принадлежат. Архитектурная автономия это умение отличать одно от другого.

Карта урока · что заберёшь

  • Почему без права на маленькие решения архитектуре не научиться.
  • Type 1 и Type 2 решения у Безоса и что происходит, когда тяжёлый процесс гоняют для всего.
  • Границы владения: таблицы, модули, контракты, процессы, и как их записать.
  • Карту решений: моё, общее, чужое, и что делать с каждым.
  • Приём «верни решение владельцу» в обе стороны.
  • Путь от исполнения через понимание принципов к их авторству.
  • Как спрашивать ИИ, чтобы он был ментором, а не генератором среднего.

Без права на маленькие решения не научиться

Архитектурный навык растёт из пары «решение и его последствия». Принял решение, увидел, что из него вышло, скорректировал. Человек, который не принимает решений, не получает обратной связи и не учится, сколько бы книг про архитектуру он ни прочитал.

Вспомни два типа решений из письма Джеффа Безоса акционерам Amazon за 2015 год, которое разбирал урок про обратимые решения. Type 1, одностворчатые двери, необратимы или почти необратимы, и их принимают методично, медленно, с обсуждением. Type 2 таких большинство: это обратимые двустворчатые двери, и их можно и нужно принимать быстро, силами людей с хорошим суждением или малых групп. Ловушка растущей организации в том, что тяжёлый процесс Type 1 начинают применять почти ко всему, включая Type 2. Итог по Безосу: медлительность, бездумное избегание риска, мало экспериментов и меньше изобретений.

Та же ловушка работает внутри одной команды. Если каждая двустворчатая дверь идёт через тимлида, тимлид становится узким местом, а разработчики не учатся решать. Таблица статусов доставки из сцены это Type 2: обратимо, дёшево, внутри модуля. Три дня ожидания стоили дороже, чем любая ошибка в этом решении.

Ребекка Вирфс-Брок в статье 2011 года, которую мы разбирали в уроке про последний ответственный момент, добавляет довод с другой стороны: решения принимают ещё и затем, чтобы не блокировать других. Вопрос, который висит три дня, блокирует тебя. Решение, которое ты откладываешь, может блокировать соседнюю команду.

Границы владения

Решение принадлежит тому, кто владеет тем, что оно меняет. Звучит просто, пока не спросишь «а кто владеет этой таблицей?» и не получишь три разных ответа.

Владеть можно четырьмя видами вещей:

  • Таблицы и данные. Кто пишет, кто меняет схему, кто отвечает за качество данных. Таблица, в которую пишут два модуля, обычно не принадлежит никому.
  • Модули. Кто отвечает за внутреннее устройство и публичный интерфейс.
  • Контракты. API, схемы событий, форматы выгрузок. Кто имеет право их менять и по какой процедуре. Матрицу владения контрактами по типу API мы разбирали в уроке про API contract governance.
  • Процессы. Деплой, дежурство, релиз мобильного приложения, доступы.

Владение должно быть записано, иначе его нет. Самый дешёвый способ для кода это файл CODEOWNERS, который понимают GitHub и GitLab: шаблоны путей и владельцы, которых платформа сама зовёт ревьюером на изменения в этих путях.

# путь                   владелец
/src/orders/             @shop/orders-team
/src/billing/            @shop/billing-team
/schemas/events/         @shop/platform-team
/deploy/                 @shop/platform-team

Для таблиц и процессов хватит строки в handbook или таблицы в репозитории: что, кто владеет, кто решает обратимое, кто решает необратимое.

Здесь снова работает закон Конвея из первого урока раздела и урока про bus factor: организация команды уже принимает проектные решения. Для владения это значит, что его границы становятся границами системы. Если владение размыто, размыты и границы в коде, и решения на стыке принимает тот, кто первым дотянулся.

дальше после входа

Урок целиком открыт всем, кто вошёл. Войди по своему email, чтобы читать дальше.

Вход пока по приглашению. Если хочешь учиться, напиши Vassiliy.