Как передать кодовую базу новой команде разработки?

#Репозиторий

Самая простая часть — и та, которую чаще всего делают так, что тихо теряется что-то важное.

1. Передавайте организацию, а не репозиторий

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

   Именно в этих артефактах новая команда находит, почему решение было принято. Они стоят дороже большей части документации, которую пишут взамен.

2. Требуйте полную историю

   Не zip и не схлопнутый первый коммит. Если первый коммит в полученной истории — «initial import», спросите, куда делись предшествующие годы.

3. Проверьте, нет ли других репозиториев

   Мобильное приложение, внутренняя библиотека, инфраструктура как код, отдельная админка, конвейер данных. Спросите прямо, а не считайте, что показанный вам — это всё.

4. Дайте права владельца двум своим людям

   Не одному. Организация с единственным владельцем — та же точка отказа, от которой вы избавляетесь, только в другой одежде.

5. Просмотрите историю на секреты

   Доступы, закоммиченные и потом удалённые, остаются в истории. Прежде чем расширять доступ, проверьте — и поменяйте всё найденное: с момента попадания это читал каждый, у кого есть клон.

#Среды и секреты

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

Среды. Собирайте список из консоли облака, а не из разговора. Забытые — и есть весь смысл упражнения, а старый стенд с копией продакшен-данных — это одновременно проблема безопасности и неожиданная строка расходов.

Секреты. Описывайте их по имени и назначению, а не по значению: для чего нужна каждая переменная, что ломается без неё и где лежит настоящее значение. Значения передаются отдельно, по каналу, который не хранит ни одна из команд, и после передачи меняются все до единого.

PAYMENT_PROVIDER_KEY
  Что       Аутентифицирует нас у платёжного провайдера
  Владелец  Аккаунт компании у провайдера (finance@)
  Смена     Панель провайдера → API keys → roll
  Ломает    Все платежи картой, немедленно
  Значение  Не в этом документе. Смотри хранилище компании.

#Неделя показа

Самая ценная часть любой передачи кодовой базы — и та, которую чаще всего заменяют презентацией.

Отведите неделю, в которую принимающая команда сама делает четыре вещи, а уходящая доступна, но не ведёт за руку:

1. Поднять систему локально по одной только письменной инструкции. Каждый шаг, о котором пришлось спросить, — это правка в инструкцию.
2. Выкатить пустяковое настоящее изменение в продакшен, по настоящему процессу.
3. Откатить его, по настоящей процедуре отката.
4. Развернуть бэкап во временную среду и убедиться, что данные пригодны.

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

#Что находится вне репозитория

Спросите об этом явно. Именно эта категория выдаёт сюрпризы на третий месяц.

• Задачи по расписанию на сервере. Crontab, в который никто не заглядывал с момента написания.
• Облачные ресурсы, созданные руками. Функция, правило на бакете, очередь, триггер по расписанию — созданные в консоли и не упомянутые в коде нигде.
• Скрипты на чьей-то машине. Месячный отчёт, правка данных, помощник для выкатки.
• Настройки в панели провайдера. Адреса вебхуков, шаблоны писем, платёжные правила, фича-флаги.
• Ручные процессы. Человек, который каждый понедельник что-то выгружает и отправляет партнёру письмом.

Ничего из этого не появится в анализе кода — поэтому анализ и сообщает о них как об открытых вопросах, а не делает вид, что их нет. Спросить уходящую команду прямо, этими же словами, быстрее любого другого способа.

#Смена доступов, в правильном порядке

Делайте это в такой последовательности и ни в какой другой:

1. Установите владение каждым аккаунтом — на чью личность он оформлен?
2. Перенесите всё, что оформлено на человека или подрядчика. Часть этого занимает дни.
3. Создайте и проверьте собственные админские пути входа, с восстановлением на ящики компании.
4. И только потом меняйте каждый доступ, который уходящая команда могла видеть, и убирайте их личный доступ.

#Что идёт не так

#Чего это не покрывает