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

Новый разработчик получил архив с кодом, но рабочий сайт ведёт себя иначе, чем приложение из архива. Это неприятное начало передачи: неизвестно, какая версия обслуживает пользователей и какие изменения останутся за пределами нового проекта.
Переход к другой команде лучше начинать со сверки работающего состояния. Задача первого этапа проста: понять, что существует, как это воспроизвести и какие действия нужны для поддержки. Переписывать всё приложение или сразу добавлять крупную функцию для этого необязательно.
Передача завершена, когда новая команда может воспроизвести и поддерживать рабочий процесс, а владелец сохраняет контроль ресурсов.
Найдите связь между исходниками и рабочей версией
Попросите указать репозиторий, ветку и точную версию выпуска. Одного названия ветки мало: её содержимое меняется. Нужна возможность связать конкретный набор исходников с тем, что доступно пользователям, и с сохранённым результатом сборки.
Затем соберите проект по инструкции в отдельной среде. Это показывает, какие зависимости и настройки действительно необходимы. Если сборка возможна только на ноутбуке прежнего подрядчика, значит, часть процесса ещё не передана. Полезно обнаружить это до аварии, а не во время восстановления.
В документации GitLab о deployment выпуск отделён от исходного кода и связан с окружением. Даже если ваш проект использует другой инструмент, принцип остаётся полезным: должно быть понятно, какая версия куда выпущена и как проверить её работу.
Передавайте управляемые доступы, а не общий пароль
Составьте перечень ресурсов: репозиторий, домен, хостинг, хранилище файлов, почта, внешние подключения и магазины приложений, если они используются. Для каждого нужны владелец, назначение и способ восстановления доступа. Наличие доступа к коду не означает контроля над доменом или оплатой сервера.
Новая команда должна работать под своими учётными записями с нужными ролями. Это упрощает отзыв доступа и разбор действий. Пароли и ключи не помещают в документацию или переписку с большим числом участников; для них используют согласованное защищённое хранение.
Защита веток GitLab позволяет разделять право отправлять изменения и право включать их в основную ветку. Конкретные правила проекта нужно прочитать до первого push: в некоторых командах изменение основной ветки сразу запускает выпуск.
Снимите карту действующих сценариев
Не ограничивайтесь перечнем экранов. Пройдите путь пользователя: вход, основное действие, получение результата, ошибка и повтор. Для рабочего приложения важны накопленные данные, незавершённые операции и внешние ссылки, которыми люди уже пользуются.
Возьмём условный сервис заявок. В нём есть создание заявки, назначение исполнителя и акт выполненной работы. Новый дизайн карточки может выглядеть лучше, но потерять вложения или кнопку возврата на доработку. Поэтому перед изменениями фиксируют результат каждого действия и права ролей.
Попросите сотрудника показать сложный обычный случай. Например, заявка меняет исполнителя, работа принимается частично, файл загружается повторно. Такие ситуации часто раскрывают правила, которые никогда не были записаны в техническом задании.
Отделите найденный дефект от неизвестности
После первичного чтения кода легко составить длинный список замечаний. Но отсутствие комментария не доказывает ошибку, а непривычная архитектура не всегда требует переделки. Каждое существенное утверждение стоит привязать к наблюдаемому результату.
| Наблюдение | Что ещё выяснить | Полезный итог |
|---|---|---|
| Сборка не проходит | Версии инструментов и доступ к зависимостям | Воспроизводимая инструкция или точный сбой |
| Рабочий экран отличается | Версия выпуска и незакоммиченные правки | Карта расхождений |
| Неизвестна задача по расписанию | Кто запускает и что меняет | Владелец и безопасный способ проверки |
| Нет восстановления в инструкции | Существование копий и пробное восстановление | Проверенный порядок действий |
Так появляется план приёмки, а не эмоциональная оценка прежней команды. Для бизнеса важнее знать, что можно поддерживать сейчас и какая работа действительно нужна перед развитием.
Первый релиз должен проверить весь путь
Для первого изменения выберите небольшую полезную задачу с ограниченным влиянием: исправление подписи, понятная ошибка формы или отдельное поле без сложной миграции. Она позволит пройти ветку, проверку, сборку, выпуск и наблюдение за результатом.
Это не повод пропускать полноценную проверку. Даже маленькая задача должна подтвердить, что новая команда понимает способ развёртывания и может вернуть предыдущую версию приложения. Если затронуты данные, их восстановление обсуждают отдельно от отката кода.
После релиза проверьте основной сценарий и конкретное изменение под обычной ролью. Запишите версию, выполненные действия и ограничения. Такая запись делает следующий выпуск заметно понятнее, чем ещё один устный рассказ о том, как всё устроено.
Что должно остаться у владельца приложения
Полезный комплект передачи включает карту ресурсов, исходники, инструкцию запуска, схему выпуска, правила доступа, описание данных и список известных проблем. Для внешних подключений нужны назначение и ответственный, а не только адрес API.
Не требуйте идеальную документацию на весь проект до первого шага. Сначала закройте критичную цепочку: воспроизвести, изменить, проверить, выпустить, восстановить. Затем дополняйте знания по мере реальной работы. Важно, чтобы найденное не оставалось только у нового разработчика в голове.
Если планируете передать приложение в Aventra, начните с ссылки на репозиторий и описания рабочей задачи без секретов. По результатам первичного разбора можно согласовать границы приёмки и первую доработку. Переписывание с нуля имеет смысл обсуждать после этой проверки, когда видны ограничения существующей системы.
Частые вопросы
Нужен ли полный аудит перед любой правкой?
Не всегда. Объём проверки зависит от риска изменения. Но определить рабочую версию, способ сборки, доступы и путь выпуска нужно даже для небольшой задачи. Иначе невозможно уверенно связать правку с результатом у пользователей.
Можно ли продолжать работу по архиву без репозитория?
Иногда архив помогает восстановить проект, но сначала его сверяют с рабочей системой. История изменений и подтверждённая версия уменьшают неизвестность. Само наличие файлов ещё не доказывает полноту переданного приложения.
Что делать с замечаниями к старому коду?
Записывать их вместе с доказательством, влиянием и предложением проверки. Часть замечаний потребует исправления сразу, часть останется техническим долгом. Приоритет определяется пользовательским результатом, а не количеством непривычных решений.
Когда оправдано переписывание приложения?
Когда ограничения существующей системы подтверждены и сравнение показывает, что развитие обходится хуже альтернативы с учётом переноса данных и перехода пользователей. Одного впечатления от кода для такого решения недостаточно.