Читать фреймворк вам не нужно. Нужно другое: понимать, какие именно сведения отсутствуют и превращают маленькое изменение в инцидент на созвоне, к которому вы не готовились. Ниже пакет для приёмки продукта, который вы не строили. Это не замена творческому брифу на новую кампаннию.
Агентство говорит, что сайт работает на Laravel и правка небольшая, поэтому дата остаётся прежней. Вы находитесь на принимающей стороне: технического директора у вас нет, прежний разработчик перестал отвечать, а человек, который впервые откроет этот код, у вас появился только на прошлой неделе. Он открывает проект накануне даты: отдельной среды нет, пароль от продакшена затерялся в старом чате. Правка затрагивает оплату, хотя в брифе об этом ни слова. В базе лежат записи нескольких заказчиков, и никто не объяснял, так ли это задумано. Дальше на созвоне звучит обычный вопрос, и отвечать на него приходится вам. Если в работу входит новая страница или новый сценарий, приложите бриф, с которого разработчик может начать. Пользуйтесь обоими материалами, когда к старому приложению добавляется новая задача. Пользуйтесь этим, когда код уже работает там, куда заходят ваши клиенты. Всё это стоит проверить до релиза, а не после.
1. Где на самом деле начинается сюрприз на продакшене
Обычно у вас есть то, что показало агентство: тексты, макет, список страниц. Настоящий риск живёт в другом месте. Это репозиторий, к которому вам не дали доступа, сервер, за который кто-то другой платит, и задачи, которые запускаются ночью без участия человека. Фраза «у нас Laravel» объясняет разработчику форму кода и ничего не говорит о том, какая ветка сейчас на сайте, есть ли копия для проверки и какой шаг способен списать деньги.
Вторая половина проблемы: дата. Её назвали, глядя на видимую часть работы, на обещание, которое агентство дало вам. Разработчик сталкивается со скрытой частью вечером перед релизом. Самый быстрый способ удержать дату это попробовать изменение прямо на живом сайте. Выглядит это как собранность и дисциплина. На деле тестом становятся настоящие заказы ваших клиентов. О том, что проверка шла на живых заказах, вы узнаёте на созвоне, когда заказ уже ушёл.
Если проверять негде, кроме продакшена, скажите об этом в первом же сообщении и сдвиньте дату до того, как кто-то начнёт править боевой сервер. Ту же мысль с позиции владельца я разбирал в материале о том, почему отсутствие отдельной среды не повод править на живом сайте. Пока вы это не написали, дата остаётся обещанием, которое нельзя проверить. И проверить его некому.
Сначала запишите разрыв между тем, что вы уже знаете, и тем, чего не знаете. Только потом называйте дату. Не раньше.
2. Владельцы доступов важнее пересланных паролей
Принимая чужой Laravel, вы пока не контролируете ничего. Код, хостинг, домен, платежи и почта остаются у прежнего исполнителя. Часть этого может не перейти к вам даже после оплаты, потому что аккаунты остались у подрядчика, который исчез. Разработчик не может работать без доступа. А продакшен-секреты не должны приходить в переписке, где обсуждают макет.
Системы нужно назвать по именам: репозиторий, хостинг, домен, платежи, почта, очередь, задача по расписанию. Напротив каждой укажите, кто может выдать доступ, а кто может его отозвать, и проследите, чтобы это был человек, который отвечает вам, а не тому, кто уже ушёл. Доступ выдавайте через аккаунты, которые можно закрыть. Пароль от продакшена, платёжный ключ или копию базы не отправляйте в чат. И не вкладывайте их в бриф. Пусть лучше разработчик подождёт, чем секрет разойдётся по переписке.
Копия реальных клиентских данных на чьём-то ноутбуке не делает проверку безопаснее. Это просто ещё одно место, где данные могут утечь. Отдельная среда и полная копия данных на ноутбуке это не одно и то же, и путать их не стоит.
Когда вы принимаете проект целиком, положите этот список рядом с чек-листом передачи Laravel, по которому пройдёт разработчик. Ваша часть работы: прийти с уже названными владельцами. Передайте список дальше, а не держите его в голове. Чек-лист не должен начинаться с пустого ящика.
3. Отдельную среду или её отсутствие нужно назвать прямо
Именно этот факт обычно всплывает слишком поздно. Разработчик спрашивает, где проверять изменение, и честный ответ: только на живом сайте, а дата завтра. Скажите это в первый день, письменно, и агентству, и разработчику. Отсутствие среды не ваша вина. А вот притворяться, что она есть, до вечера перед релизом, превращает вашу дату в чужой инцидент. Имя человека, который в этот момент говорит с агентством, стоит определить заранее.
Если отдельная среда всё-таки есть, описывайте её прямо: адрес, чьим аккаунтом она открывается и откуда в ней данные, из восстановленной копии или из учебного набора. Учебный набор не покажет ошибку, которая зависит от настоящего заказа. Восстановленная копия считается рабочей только если её кто-то уже восстанавливал, а если этого не было, честный статус звучит как «не проверено», а не как «бэкапы есть».
4. Назовите сценарии, которые могут навредить бизнесу
Описать это можно, не открывая код. Какой клик списывает деньги? Какая форма создаёт заявку или запись, по которой вы потом считаете отчёт? Какая ночная задача отправляет письма, пересобирает файл или списывает сумму повторно? Что из этого прежний разработчик называл хрупким? Ответы нужны по одному предложению на пункт, а не на весь разговор.
Если ответа нет, изменение пока не маленькое. Маленьким оно становится после того, как вы назвали соседей правки. До этого у вас есть только обещание и тревога. Второе разговаривать с агентством сложнее, чем первое.
Если приложением пользуются несколько ваших заказчиков, скажите об этом прямо. Правка на внутренней странице может показать одному заказчику строки другого, а ночная задача отправит файл не тому адресату. Как именно разделены данные, решать вам не нужно. Нужно сказать разработчику, что разделение есть и что его снова придётся проверить. Где такие места ломаются чаще всего, я разбирал в материале о смешении чужих данных в общем продукте. И ещё одно: несколько заказчиков в одном приложении это не один клиент, у которого просто много данных.
Унаследованная система, в которой уже есть проблемы, сначала приводится в порядок, и только потом получает новые функции. Если этот Laravel достался вам наполовину сломанным, не ставьте стабилизацию и запуск новой функции на одну пятницу. Скажите агентству и заказчикам, в каком порядке идёт работа. На втором созвоне такой разговор выглядит надёжнее, чем на первом, где оба дела смешали в одну дату. И ещё раз: сначала чиним, потом добавляем.
5. Сначала проверка на копии, потом отдельная выкладка
Ваша проверка означает, что проверки из пакета уже прошли не на живом сайте, и хотя бы одну из них вы посмотрели сами. Разработчик показывает оплату, создание заявки или ближайшую безопасную замену этого шага. Вы сверяете не впечатление, а конкретный результат с тем, что было записано заранее. Своими глазами увидьте хотя бы один критичный сценарий.
После этого продакшен становится отдельным событием: названное время, названный ответственный, повторная проверка важного сценария уже после выкладки. Это не место для первой попытки. И не момент, когда вы оба одновременно узнаёте, как система ведёт себя на самом деле. Согласуйте время заранее, а не в день выкладки. И назначьте того, кто проверит.
Пароли в такую заметку не кладут. Скриншоты с приватными данными в общий канал тоже. Передача, которая спасла дату ценой утечки, ничего не предотвратила. Она просто поменяла сюрприз местами: вместо сбоя в продакшене вы получаете письмо от заказчика.
Когда подключать разработчика ещё до даты
Подключайте разработчика до того, как дата зафиксирована, если правка задевает оплаты, общую базу нескольких заказчиков или систему, которую вы не можете описать своими словами. То же самое касается любого случая, где отдельная среда не подтверждена. Разработчик, которого зовут после слов «почти всё готово», получает сюрприз вместе с вами. И начинается всё не с кода, а с разговора о том, кому принадлежит этот код. Такой разговор лучше провести в первый же день.
Я беру на себя техническую часть такой приёмки: что теперь под вашим контролем, где можно безопасно проверить изменение, какие сценарии способны навредить, и саму реализацию. Услуги закрывают и отдельный проект, и постоянную работу над Laravel и backend-системами, у которых уже есть пользователи. Проекты показывают тип продуктов, в которые такая приёмка обычно попадает, а услуга передачи Laravel-проекта описывает, как выглядит первая неделя. Напишите мне, если нужен разработчик, который примет проект за вас: пришлите список систем и владельцев доступа, статус отдельной среды и дату, которую вы уже назвали или ещё держите. Доступы можно будет передать позже, когда работа начнётся.