Новое в журнале. Поддержка legacy-кода: своя команда или аутсорс
Практика и проекты

Поддержка legacy-кода: своя команда или аутсорс

Аутсорс выигрывает, когда в команде не хватает рук или экспертизы в старом стеке; своя команда — когда есть контекст кодовой базы и выделенное на это время; а чаще всего рабочая схема — гибрид: аудит и пилотный тикет снаружи, дальнейшая поддержка внутри.

20 ноября 20269 мин чтенияПрактикам
Поддержка legacy-кода: своя команда или аутсорс
3 сигналакогда решение склоняется в сторону своей команды
1 пилоттикет до подписания контракта на весь объём работы

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

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

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

Почему legacy-код — это отдельное решение, а не просто ещё одна задача в спринте

Обычную задачу можно просто поставить в бэклог и отдать любому разработчику с нужным стеком. С legacy-кодом так не получается: страшные релизы, скрытые зависимости между модулями и бизнес-логика, которая нигде не задокументирована, превращают любую, даже маленькую правку в расследование. Решение «кто это делает» нужно принимать осознанно — до того, как задача попадёт в спринт, а не по ходу работы.

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

Когда справится своя команда

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

Есть разработчик, который понимает бизнес-правила, зашитые в код

Если в команде остался человек, который помнит, зачем в коде стоит именно такое условие, а не просто может его прочитать, — это главный актив при работе с legacy. Такой контекст невозможно быстро передать стороннему подрядчику: его собирают месяцами реального сопровождения проекта.

Объём работы предсказуем и укладывается в текущую загрузку

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

Риск простоя от «забрали время у продукта» ниже риска потери контекста

Если выделить на legacy пару часов разработчика в неделю не критично для роадмапа, а передача задачи на сторону означает объяснять чужому человеку то, что своя команда и так знает, — выгоднее оставить работу внутри, даже если формально это немного замедлит основной продукт.

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

Обратная ситуация тоже встречается регулярно, и у неё тоже есть конкретные признаки, а не общее ощущение «надоело».

Нет свободных рук, а задача горит

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

В стеке технология, которой в команде никто не владеет

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

Нужен независимый аудит со стороны перед большим решением

Перед решением «рефакторить или переписывать с нуля» бывает полезен взгляд человека без эмоциональной привязанности к коду — он честнее оценит реальное состояние системы, чем команда, которая писала этот код сама.

Гибридный сценарий: аудит и пилот снаружи, поддержка внутри

Своя команда и подрядчик разбирают legacy-код параллельно

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

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

Как проверить подрядчика именно под legacy-задачу

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

Просит ли аудит или пилотный тикет перед фикс-прайсом

Если подрядчик готов назвать точную стоимость и срок на весь рефакторинг, даже не взглянув на код, — это сигнал, что оценка строится на угадывании, а не на реальном понимании объёма скрытой работы.

Спрашивает про тестовое покрытие и как будет тестировать изменения без него

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

Даёт ли read-only доступ на разведку до подписания

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

Красные флаги при выборе аутсорс-подрядчика

  • Фикс-прайс на весь рефакторинг без предварительного аудита кодовой базы.
  • Обещание «перепишем быстрее и дешевле», прозвучавшее раньше, чем подрядчик увидел хотя бы часть кода.
  • Нет вопросов про бизнес-логику, зашитую в код, — только про стек технологий.
  • Требование полного доступа и передачи инфраструктуры вместо доступа разработчика к репозиторию заказчика.
  • Отказ от пилотного тикета под предлогом «это замедлит проект».

Частые вопросы

Что считается legacy-кодом?

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

Можно ли совмещать аутсорс и свою команду на одном проекте?

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

Сколько времени занимает аудит перед решением?

От нескольких дней до двух недель в зависимости от размера кодовой базы — этого обычно достаточно, чтобы оценить тестовое покрытие, скрытые зависимости и реальный объём работы, не беря на себя обязательств по полному контракту.

Чем аутсорс рефакторинга отличается от аутсорса новой разработки?

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

Как не потерять контроль над кодовой базой при работе с подрядчиком?

Репозиторий и инфраструктура остаются у заказчика, подрядчик получает доступ, а не владение; код-ревью со стороны своей команды сохраняется на каждый пул-реквест; а read-only доступ на разведку до подписания контракта показывает, насколько подрядчик вообще готов работать прозрачно.

Что делать, если подрядчик предлагает переписать всё с нуля?

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

Код, который не стыдно передать

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

Случайный разбор