Вам не треба вміти читати фреймворк, щоб провести ці два тижні. Треба інше: розуміти, які саме відсутні факти перетворюють невелике завдання на інцидент під час дзвінка, до якого ви не готувалися. Далі не креативний бриф для нової кампанії, а матеріал для приймання продукту, який ви не будували.
Агенція каже, що сайт працює на Laravel і правка невелика, тож дата лишається тією, що вже озвучена. Ви тут на стороні, яка приймає: технічного директора у вас немає, попередній розробник перестав відповідати, а людина, яка відкриє цей код уперше, у вас з’явилася тиждень тому. Вона відкриває його напередодні дати. Окремого середовища немає, а пароль від продакшену загублено в старому чаті. Зміна зачіпає оплату, хоча про це в брифі немає ні слова. У базі лежать записи кількох замовників, і ніхто не пояснив, чи так і має бути. А потім на дзвінку приходить звичайне запитання, і цього разу відповідати доведеться вам. Якщо робота включає нову сторінку або новий сценарій, додайте бриф, з якого розробник може почати. Користуйтеся обома матеріалами, коли до старого застосунку додається нове замовлення. Користуйтеся цим текстом, коли код уже крутиться там, куди заходять ваші клієнти.
1. Де насправді починається сюрприз на продакшені
Зазвичай у вас є те, що показала агенція: тексти, макет, список сторінок, а ризик лежить в іншому місці: у репозиторії, до якого вам не дали доступу, на сервері, за який хтось інший платить, і в задачах, що запускаються вночі без людини. Фраза «у нас Laravel» пояснює розробникові форму коду й не каже нічого про те, яка гілка зараз на сайті, чи є копія для перевірки та який крок може списати гроші.
Другу половину проблеми створює дата. Її назвали, дивлячись на видиму частину роботи, на обіцянку, яку агенція дала вам. Розробник стикається з прихованою частиною ввечері перед релізом. І найшвидший спосіб втримати дату це спробувати зміну прямо на живому сайті. Виглядає це як зібраність, а насправді тестом стають ваші справжні замовлення.
Якщо перевіряти ніде, окрім продакшену, це треба написати в першому ж повідомленні й пересунути дату до того, як хтось почне редагувати бойовий сервер. Те саме з боку власника я розбирав у матеріалі чому відсутність окремого середовища не означає, що можна правити наживо. Поки це не написано, дата лишається обіцянкою, яку неможливо перевірити.
Спершу запишіть, що ви вже знаєте і чого не знаєте. І вже потім називайте дату.
2. Власники доступів важливіші за переслані паролі
Приймаючи чужий Laravel, ви ще нічого не контролюєте: код, хостинг, домен, платежі й пошта залишаються в руках попереднього виконавця. Частина цих речей може не перейти до вас навіть після оплати, бо акаунти залишилися в підрядника, який зник. Розробник не може працювати без доступу. Секрети продакшену не мають приходити в листуванні, де обговорюють макет.
Назвіть системи поіменно: репозиторій, хостинг, домен, платежі, пошта, черга, задача за розкладом. Навпроти кожної позначте, хто може видати доступ, а хто може його відкликати, і переконайтеся, що це людина, яка відповідає вам, а не тому, хто вже пішов. Давайте доступ через акаунти, які можна закрити. Пароль від продакшену, платіжний ключ або копію бази не надсилайте в чат. І не вкладайте їх у бриф.
Друге середовище з повною копією реальних замовників на чиємусь ноутбуці не стає безпечнішим тестом. Це просто ще одне місце, де дані можуть витекти. Якщо під перевіркою мають на увазі такий ноутбук, про це треба сказати вголос.
Коли ви приймаєте проєкт повністю, покладіть цей список поруч із чек-листом передачі Laravel, яким пройде розробник, якого ви наймете. Ваша частина роботи: прийти з уже названими власниками. Тоді цей чек-лист не почнеться з порожньої пошти.
3. Окреме середовище або його відсутність треба назвати прямо
Цей факт найчастіше виринає надто пізно. Розробник питає, де перевіряти зміну, а чесна відповідь така: тільки на живому сайті, причому дата завтра. Скажіть про це в перший день, письмово, і агенції, і розробникові. Відсутність середовища не ваша провина, тож приписувати її собі не варто.
Якщо окреме середовище все ж є, описуйте його без туману: адреса, чиїм акаунтом воно відкривається, чи звідти в ньому дані. Це відновлена копія чи навчальний набір? Навчальний набір не покаже помилку, яка залежить від справжнього замовлення. Відновлена копія рахується робочою лише тоді, коли її вже хтось відновлював. Якщо цього не було, чесний статус «не перевірено», а не заспокійливе «бекапи є».
4. Назвіть сценарії, які можуть нашкодити бізнесу
Описати це можна й без відкриття коду. Який клік списує гроші? Яка форма створює заявку або запис, за яким ваша команда рахує звіт? Яка нічна задача надсилає лист, перебирає файл або може повторити дію вдруге? Який із цих кроків попередній розробник називав крихким?
Якщо відповіді немає, зміна ще не є маленькою. Маленькою вона стає після того, як ви назвали сусідів правки. До того у вас є лише обіцянка й тривога.
Якщо застосунком користуються кілька ваших замовників, скажіть про це прямо. Правка на внутрішній сторінці може показати одному замовникові рядки іншого, а нічна задача надішле файл не тому одержувачу. Як саме розділені дані, вирішувати вам не треба. Треба сказати розробникові, що розділення є і що його доведеться перевірити ще раз. Де такі місця ламаються найчастіше, я писав у матеріалі де в спільному продукті найчастіше змішуються чужі дані.
Система, яка вже має проблеми, спершу має стати на ноги, і тільки потім отримує нові функції. Якщо цей Laravel достався вам наполовину зламаним, не ставте стабілізацію та запуск нової функції на одну п’ятницю. Скажіть агенції й замовникам, у якому порядку йде робота.
5. Спершу перевірка на копії, потім окрема викладка
Ваша перевірка означає, що перевірки з пакета вже пройшли не на живому сайті, і хоча б одну з них ви побачили самі. Розробник показує оплату, створення заявки або найближчу безпечну заміну цього кроку. Ви звіряєте не враження, а конкретний результат із тим, що було записано раніше.
Після цього продакшен стає окремою подією з названим часом і відповідальною людиною. Це не місце для першої спроби. Це не момент, коли ви обоє одночасно дізнаєтеся, як система поводиться насправді. Погодьте час заздалегідь, а не в день викладки.
Паролі в таку нотатку не кладуть, і приватні замовницькі дані не потрапляють у скриншот, який ви кидаєте в канал. Передача, що врятувала дату ціною витоку, нічого не уникла. Вона просто підмінила один сюрприз іншим.
Коли підключати розробника ще до дати
Підключайте розробника ще до того, як дата зафіксована, якщо зміна зачіпає оплати, спільну базу кількох замовників або систему, яку ви не можете описати. Те саме стосується будь-якої ситуації, де окреме середовище не підтверджене. Розробника, якого кликають після слів «там майже все готово», чекає той самий сюрприз, що й вас. Це поганий початок, і його можна уникнути.
Я беру на себе технічну частину такого приймання: що тепер під вашим контролем, де можна безпечно перевірити зміну, які сценарії можуть нашкодити, і саму реалізацію. Послуги охоплюють і окремий проєкт, і постійну роботу над Laravel та backend-системами, у яких уже є користувачі. Роботи показують тип продуктів, у які таке приймання зазвичай і потрапляє. Послуга передачі Laravel-проєкту описує, як виглядає перший тиждень. Якщо потрібен розробник, який візьме проєкт на себе, напишіть мені: надішліть список систем і власників доступу, статус окремого середовища та дату, яку ви вже назвали або ще стримуєте.