Помилка перша: написання специфікації замість речення
Люди, яких раніше обпалило погане програмне забезпечення, часто відкривають білдер і одразу пишуть абзац. Система оцінювання, одиниці виміру, офлайн-режим, кольорова схема — все виписано заздалегідь, ще до першої відповіді. Це відчувається як відповідальний підхід. Насправді ні. Білдер читає ваше одне речення, робить висновок про те, що ви, ймовірно, маєте на увазі, і повертається з планом приблизно за п'ятнадцять секунд — "журнал тренувань для скелелазів" перетворюється на журнал сесій, вигляд відстеження складності та дашборд, з булдерінговою шкалою V за замовчуванням і маршрутами YDS, тому що це те, що використовує більшість скелелазів. Він показує вам, що обрав, прямо в плані, щоб ви могли виправити це одним рядком, якщо ви виняток. Написання абзацу заздалегідь не пропускає цей крок. Ви все одно отримуєте план, все одно маєте його прочитати, і тепер ви витратили три хвилини, друкуючи обмеження, які план і так би вам показав — у порядку, який справді має значення для вашої побудови.
План — це не форма з полями для заповнення. Це проза, і ви відповідаєте прозою. "Насправді зроби французьку шкалу складності, я в Європі" — це повноцінна правка. Так само як і "додай поле для напарника/страхувальника, я лазаю з різними людьми". Кожна правка перегенеровує план, а не саму побудову — ви керуєте до того, як почнеться дорога частина, а не перезапускаєте її. Затвердження цього плану — остання дія, яку від вас вимагається. Все, що далі, — це генерація та перевірка.
Помилка друга: спостереження за стрічкою, як за завислим терміналом
Побудова виконується на сервері, і тут майже завжди хвилювання — хибна тривога: хтось дивиться на тиху стрічку активності дві хвилини і вирішує, що вона зависла. Це не так — вона просто на етапі, який не видає видимий результат щосекунди, і стрічка позначає, на якому саме етапі ви знаходитесь, саме з цієї причини. Ви можете повністю закрити вкладку. Процес не живе у вашому браузері.
Те, чого варто насправді очікувати, сильно залежить від форми проєкту. Журнал скелелазіння — кілька сторінок, локальна модель даних, жодних звернень до зовнішнього API — вкладається менш ніж у три хвилини, що типово для всього, що по суті "зафіксуй це, побудуй графік того, покажи мені список". Щойно побудові потрібен справжній бекенд, автентифікація, база даних зі зв'язками, фонові завдання — ви дивитесь на вісім-дванадцять хвилин, тому що тепер є генерація й міграція схеми, а перевірка проходить ще раз, уже для серверного коду, а не лише розмітки. Ігри ще повільніші, бо потребують генерації ассетів: спрайти, звукові ефекти, іноді другий візуальний прохід, якщо перша спроба виглядає не так у потрібному розмірі показу. А нативне пакування — реальний встановлюваний APK, а не веб-перегляд, обгорнутий у оболонку — передається справжньому інструментарію. Gradle, підписування, все це. Сам цей крок може додати п'ять-десять хвилин поверх усього іншого, і це той етап, де тиха стрічка означає, що інструментарій робить свою інструментарну справу, а не те, що щось зламалося.
Чесна ціна цієї моделі в тому, що ви втрачаєте миттєвий, посимвольний фідбек від спостереження за тим, як код з'являється в редакторі. Натомість ви отримуєте систему, яка переживає сон вашого ноутбука й обрив wifi, яку можна перевірити з телефону, яка продовжує працювати незалежно від того, чи стежите ви за нею. Для дев'яностосекундної побудови цей компроміс майже непомітний. Для дванадцятихвилинної побудови бекенду це різниця між нянченням термінала і кавою.
Помилка третя: плутати згенероване з готовим
Це найдорожча помилка. Побудова, яка швидко завершилась і не була перевірена, — це не завершена побудова, а чернетка, яка випадково працює — і саме розрив між цими двома речами й дає більшості швидких сайт-білдерів погану репутацію: вони випускають форми без санітизації і кнопки, до яких неможливо дістатися з клавіатури. Перш ніж ця платформа назве щось готовим, окремі агенти-перевіряльники переглядають це: код, безпеку, посилання, SEO, доступність і відповідність затвердженому вами плану. Це справді окремий прохід, а не той самий агент, що перечитує власний результат і киває головою.
Перевірка безпеки шукає нудні речі, які насправді кусають людей у продакшені: API-ключ, закомічений у клієнтський код, форму, що приймає введення без санітизації, ендпоінт, що довіряє ID користувача, наданому клієнтом, замість того, щоб отримувати його з сесії. Перевірка доступності — не лінтер, який можна заглушити коментарем — вона перевіряє реальні коефіцієнти контрастності й те, чи можна дістатися до інтерактивних елементів клавіатурою.
Відповідність плану — це те, що найбільше недооцінюють. Прохід генерації може непомітно втратити щось, що ви просили — скажімо, те поле для напарника/страхувальника з вашої правки плану — на третьому файлі побудови, депріоритезоване без будь-якого свідомого рішення про це. Перевірка відповідності перечитує ваш затверджений план проти фактичного результату і знаходить прогалину. Коли вона щось знаходить, виправлення застосовується й перевіряється автоматично; ви не отримуєте список справ — ви отримуєте або виправлення, якого ніколи не бачите, або взагалі нічого поганого. Механіку того, що перевіряє кожен верифікатор і що відбувається, якщо щось двічі поспіль провалюється, описано в статті Як побудови перевіряють самі себе. Єдине, що варто винести з цього розділу: готово означає пройшло перевірку, а не згенеровано. Сплутайте ці твердження — і рано чи пізно ви випустите відкритий ключ або недоступну кнопку.
Що ви отримаєте, якщо уникнете всіх трьох помилок
- Робочий продукт у справжньому попередньому перегляді, яким можна клацати — фактичний запущений екземпляр із підключеними вашими даними, а не скріншот того, як це виглядатиме.
- Прикріплений до нього ланцюжок чату, де "зроби заголовок темнішим і додай сторінку статистики" створює версію два поряд із версією один. Стара версія не зникає; вона залишається як запасний варіант, поки нова займає живий попередній перегляд.
- Кнопки, які щось роблять: опублікувати наживо, завантажити код, зібрати нативні інсталятори, відправити в магазин. Не спливаючі вікна з апсейлом, замасковані під кнопки.
Та кнопка "завантажити код" варта окремої уваги, бо саме вона відрізняє інструмент, якому можна довірити щось реальне, від того, що годиться лише для одноразових прототипів. Якщо код справді ваш і його можна забрати — читабельна структура файлів, жодної екзотичної прив'язки понад ту, що ви самі просили, — тоді платформі доводиться постійно заслуговувати на вашу наступну сесію, а не жити за рахунок того, що ви вже застрягли всередині неї.
