Репозиторий кода: зачем заказчику Git и что в нём должно быть

Репозиторий — это хранилище кода с полной историей изменений: кто, когда и что поменял. Для заказчика он важен по трём причинам: это ваш главный актив — код, за который вы заплатили; по истории видно, идёт ли работа; без репозитория смена подрядчика превращается в раскопки на сервере. Репозиторий должен быть на аккаунте компании в GitHub, GitLab, GitFlic или на своём сервере, а подрядчику выдаётся доступ. В нём хранится код и инструкции, но не пароли и не данные клиентов.

Что такое Git простыми словами

Git — система, которая хранит каждую версию кода. Разработчик сохраняет изменения порциями — коммитами — с коротким описанием: «добавил поле ИНН в форму заказа». Любую версию можно восстановить, любое изменение — посмотреть и отменить. Подробное руководство есть в бесплатной книге Pro Git на русском, но заказчику достаточно понимать смысл.

Репозиторий — папка с кодом и его историей. Его хранят на сервисе вроде GitHub, GitLab или российского GitFlic либо на собственном сервере.

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

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

Защита от споров. История показывает, что сделано и когда. Это доказательство в спорах о сроках и объёме.

Смена команды. Новый подрядчик получает доступ к репозиторию и через день-два может работать. Без него — восстанавливает проект по файлам с сервера.

Безопасность. Если сайт взломали, по репозиторию видно, какие файлы на сервере отличаются от исходных.

Что должно быть в репозитории

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

Как оформить

1. Создайте аккаунт или организацию на выбранном сервисе на корпоративную почту.
2. Создайте репозиторий и добавьте подрядчика с правами записи.
3. Включите двухфакторный вход для всех участников.
4. Попросите подрядчика переносить туда код с первого дня, а не «в конце проекта».
5. Договоритесь, что рабочий сайт выкладывается из репозитория, а не правкой файлов на сервере.

Если вам важно хранить код в России, используйте российский сервис или свой сервер с GitLab или Gitea.

Как проверить активность разработки

Даже не читая код, вы можете увидеть:

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

Попросите подрядчика показать один раз, где это смотреть. Это пять минут.

Репозиторий и безопасность

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

Ветки и выкладка

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

• то, что в основной ветке, — то, что на сайте;
• незаконченные задачи не попадают на сайт случайно;
• можно вернуть сайт к любой предыдущей версии.

Передача проекта

При завершении проекта или смене подрядчика проверьте:

1. Код в репозитории совпадает с тем, что работает на сервере.
2. По README другой разработчик может развернуть проект.
3. Все доступы прежнего подрядчика к репозиторию сняты или ограничены.
4. Секреты, которые знал прежний подрядчик, сменены.
5. Права на код переданы по договору.

Сколько это стоит

Сам репозиторий на большинстве сервисов бесплатен для небольших команд. Платить приходится за дополнительные возможности: больше участников, автоматическую сборку, хранилище. Свой сервер с GitLab или Gitea обойдётся в стоимость небольшого VPS и время на администрирование. Работа подрядчика по переносу кода в репозиторий и настройке выкладки из него — от нескольких часов для простого сайта до 1–2 дней для приложения с автоматической сборкой.

Если репозитория нет

Попросите подрядчика создать его сейчас и перенести текущий код с сервера. Это 1–3 часа работы. Если подрядчик недоступен, но у вас есть доступ к серверу, новая команда может скачать код с сервера и создать репозиторий сама. История изменений в этом случае начнётся с нуля, но дальше вы будете защищены.