К содержимому
Строить и менять

Менять осознанно

Дорого обходится не плохой код. Дорого обходятся изменения, сделанные без плана на случай, когда изменение пошло не так.

Что входит в категорию

Процедуры для опасных моментов

В каждой откат описан раньше, чем само изменение.

План реализации

Возможность, разложенная на шаги, которые разработчик может выполнить, а вы отметить, с вынесенными наверх решениями вместо закопанных.

План миграции

Миграция схемы или данных с порядком, обратимостью каждого шага и тем, что делать, если она встала на середине.

Настройка сервера и выкладки

Что поднимать, в каком порядке и какие части обязаны собираться с нуля.

CI/CD и откат

Конвейер, который умеет не пустить плохой релиз, и процедура отката, по которой человек реально может пройти в два часа ночи.

План рефакторинга

Что менять первым, как держать систему рабочей всё это время и где остановиться.

План интеграции

Платежи, KYC или любой внешний сервис: сценарии отказа, правила повторов и что делать, когда другая сторона лежит.

Как идёт процедура изменения

  1. Сначала разведка, потом устройство

    Что есть сейчас и что от этого зависит. План, написанный без этого, — это план для другой системы.

  2. Откат проектируется первым

    Если шаг необратим, это записано как ваше осознанное решение, а не обнаружено потом.

  3. Шаги, которые можно проверить

    У каждого шага написано, как понять, что он сработал. «Выложить и посмотреть» — не шаг.

  4. Проверка по факту

    Отдельное действие сверяет готовую работу с планом, и именно там находится большая часть сюрпризов.

Когда стоит планировать, а не просто начать

Перебор, если

Изменение маленькое и легко откатывается

Оно не трогает ни данные, ни деньги

Вы делаете прототип и собираетесь его выбросить

Стоит, если

Затрагиваются боевые данные или платежи

Отменить это потом будет дорого или невозможно

Реализовывать будет кто-то другой

Такие изменения вас уже обжигали

Выберите категорию под своё беспокойство

Опишите ситуацию своими словами и посмотрите процедуру — и её стоимость — до того, как что-то потратите.