Вайбкодер без опыта: как сдать первый рабочий прототип
Вы открываете прототип брони переговорной на собеседовании. В календаре свободно десять утра. Интервьюер просит открыть второе окно и нажать «Забронировать» одновременно с ним. Если оба окна покажут успех, красивый календарь придётся отложить и выяснить, кому досталась комната. Если бронь получит один человек, а второй сразу увидит, что время занято, у вас есть результат, который можно проверить прямо на встрече.
Для первого отклика соберите такую демонстрацию вокруг одного сценария. Дайте ссылку на проверенный коммит и README с командами запуска, критериями приёмки и тестом на одновременную бронь. Коротко укажите, что предложила модель и что вы проверили сами. В вакансиях по вайбкодингу ищите задачи, где нужно довести прототип до передачи команде.
Согласуйте, кому достаётся переговорная
Возьмём учебный пример. Офис-менеджер ведёт бронь комнаты «Кедр» в общем чате. Два сотрудника могут спросить про десять утра почти одновременно и оба решить, что переговорная за ними. Вы предлагаете страницу на один рабочий день. В ней есть получасовые слоты, две заранее созданные тестовые учётные записи и кнопка бронирования. Дату на стенде задаёт набор тестовых данных. Часовой пояс комнаты фиксируете как московский, чтобы при просмотре из другого пояса десять утра в календаре по-прежнему означали десять утра в офисе.
Уточните у того, кто принимает работу, что означает слово «досталась». В чате менеджер может ориентироваться на время первого сообщения. В прототипе вы предлагаете другое проверяемое правило: слот получает пользователь, чья бронь первой успешно сохранится в базе. Скорость реакции человека и порядок, в котором браузеры получат ответы, на это правило не влияют. Если менеджеру нужна очередь по времени подачи, договоритесь об этом до генерации кода. Понадобится определить, где фиксируется порядок обращений и что считается моментом подачи. Простого ограничения на одну бронь для такой договорённости мало.
В учебном примере принимающая сторона согласна с правилом первой успешно сохранённой брони. Запишите критерии в README. Для всех трёх сценариев используйте один тестовый день. Перед каждым очищайте брони в тестовой базе, сохраняя расписание. Зафиксируйте календарную дату теста. После полуночи «на сегодня» укажет на другой день, для которого в тестовой базе может не быть расписания.
| Сценарий | Действие | Результат на экране | Проверка записи |
|---|---|---|---|
| Свободное время | Анна выбирает 10:00 | Анна видит подтверждение | У слота одна бронь Анны |
| Одновременный выбор | Анна и Борис выбирают 10:00 | Один видит подтверждение, второй видит сообщение о занятом времени | У слота одна бронь победителя |
| Разное время | Анна выбирает 10:00, Борис выбирает 10:30 | Оба видят подтверждение | В базе две брони в разных слотах |
В 10:30 первый интервал заканчивается, а второй начинается. Бронь с 10:00 до 11:00 заняла бы оба: их пришлось бы сохранять одной транзакцией и при конфликте откатывать целиком. Запишите в карточке проекта: «Бронирование на 30 минут, одна комната, один день. Отмену, повторяющиеся встречи и бронирование нескольких интервалов оставили за рамками демонстрации».
Поручите модели реализацию правила и проверьте миграцию
Для учебного проекта хватит веб-страницы, обработчика и PostgreSQL. Заранее заведите в расписании по одному слоту с собственным идентификатором на каждый получасовой интервал комнаты. В таблице броней храните пользователя и обязательный slot_id (NOT NULL) с внешним ключом на слот. Примените UNIQUE (slot_id) в базе, куда пишет приложение. Тогда у одного слота может быть максимум одна бронь. Обработчик возвращает 201 после успешного COMMIT. Конфликт по ограничению слота даёт 409 и сообщение «Это время уже занято. Выберите другой слот».
Если модель предложила сначала прочитать доступность, а затем вставить бронь, разберите промежуток между операциями. Оба запроса могут увидеть свободный слот до любой вставки. Без ограничения в таком случае обе записи могут сохраниться. Предварительная проверка годится для быстрого ответа при повторном выборе, а от дублей защищает база. Если связь с базой потерялась во время фиксации, сообщите, что подтверждение получить не удалось: исход записи может быть ещё неизвестен.
Если браузер Анны потерял связь после отправки запроса, покажите «Результат бронирования пока неизвестен. Обновите календарь». Найденную при обновлении бронь Анны пометьте как её собственную. Если слот пока свободен, исходный запрос ещё может выполняться. Если добавите повтор, передавайте тот же ключ идемпотентности и храните на сервере результат операции по этому ключу.
В задаче для модели задайте место изменения и признаки готовности. «Добавь миграцию: обязательный slot_id с внешним ключом и ограничением уникальности в таблице броней. Верни 409 при конфликте именно этого ограничения, а 201 отправь после фиксации. Добавь интеграционный тест на двух пользователей с отдельными соединениями и общей тестовой базой. Список слотов оставь прежним».
Проверку начните с миграции. Поднимите пустую тестовую базу по README и убедитесь, что ограничение появилось именно в ней после запуска миграций. Декларация в модели ORM сама по себе не подтверждает состояние базы. Если вы уже сохранили учебные данные с дублями, миграция с новым ограничением может остановиться. На одноразовом стенде пересоздайте базу и заново загрузите слоты. Для базы, которую кто-то уже использует, сначала согласуйте, какую из существующих броней сохранять. Удалять записи по догадке модели опасно для людей, которые собирались прийти в комнату.
Сохраните в репозитории небольшой коммит с миграцией и обработкой конфликта. На собеседовании по нему удобно показать, что именно защищает бронь и откуда берётся сообщение в браузере.
Сведите два запроса на одном слоте
Для показа в браузере откройте два изолированных контекста Playwright. Анна и Борис входят отдельно, после чего оба видят свободный «Кедр» на 10:00. Запустите оба клика без ожидания результата первого. В окне победителя появляется подтверждение, второе окно показывает занятое время и обновляет список слотов. Перезагрузите первую страницу. Подтверждённая бронь должна сохраниться. Запишите, что увидел каждый участник, и покажите запись в базе, где пользователь совпадает с тем, кого подтвердил интерфейс.
Два клика могут уйти почти одновременно, а сервер обработает их по очереди. Для интеграционного теста отправьте два запроса от разных пользователей к одному экземпляру приложения. На отдельных соединениях с общей тестовой базой доведите оба запроса до тестовой точки перед вставкой, после чтения доступности, если оно есть. Отпустите оба запроса, когда оба достигли точки. Задайте тайм-аут. Чтобы проверить именно ожидание в PostgreSQL, проведите отдельный прогон: удержите первую вставку в открытой транзакции, запустите вторую, дождитесь признака ожидания в базе и зафиксируйте первую.
Начните со свободного слота. Если в управляемом прогоне Анна первой фиксирует бронь, ждите 201 у Анны, 409 у Бориса и одну строку с Анной. Если её вставка откатывается, ожидающий запрос Бориса может сохранить бронь и получить 201. В прогоне без заданного порядка сверяйте ответы и владельца единственной строки: им должен быть получатель 201. Строка в базе сама по себе не выявит два ответа 201. Подтверждение и сообщение о конфликте проверьте отдельно в браузере.
Потом верните стенд в исходное состояние и повторите прогон с разными слотами. Анна выбирает 10:00, Борис выбирает 10:30. При исправной записи ждите два ответа 201 и две строки с разными slot_id. Если один запрос получил 409, проверьте ограничение и данные из браузера. Интерфейс мог показать два времени, но передать один идентификатор. Если два запроса к одному слоту оба получили 201, приёмку останавливаете, даже когда один экран исправится после обновления.
В учебном тесте на свободном слоте при успешной фиксации первой вставки ожидаются
201, 409 и одна бронь. Принимающий повторяет тест из чистой копии со свежей тестовой базой и загруженным расписанием.
Дайте принимающему запустить бронь без вашей помощи
Представьте, что после показа прототип забирает разработчик, который не видел вашей переписки с моделью. Попросите его открыть репозиторий в отдельной папке, поднять проект по README и занять «Кедр». Пока он запускает команды, оставьте подсказки при себе. Если он останавливается на шаге «настройте окружение», выясните, какой переменной или команды ему не хватает. Впишите её туда, где без неё останавливается запуск. Повторите прогон с чистой тестовой базой, чтобы убедиться, что старт не зависит от остатков предыдущей установки.
Для передачи подготовьте небольшой комплект, который принимающий сможет проверить за один сеанс.
- В инструкции запуска укажите версии среды, команды запуска базы и приложения, порядок миграций и команду заполнения тестовыми слотами. Рядом положите
.env.exampleс именами переменных и безопасными значениями для локального стенда. - В разделе про проверку дайте команду запуска теста одновременной брони и ожидаемый результат. Укажите, как сбросить именно тестовую базу. Если сброс удаляет записи, пусть из текста и команды будет ясно, к какой базе они обращаются.
- В карте проекта укажите, где лежат обработчик брони, миграция с ограничением и сценарий Playwright. Рядом запишите, где меняется часовой пояс комнаты и откуда берётся тестовый день.
- К версии для передачи приложите короткую запись приёмки. Укажите коммит, на котором прошли проверки, и какие сценарии принимающий повторил. Отметьте открытые пункты, например запрос на отмену брони, чтобы новый разработчик мог обсудить его с офис-менеджером.
Учётные записи на стенде заведены для показа. Руководство Making prototypes объясняет, как выбрать прототип для проверки идеи и почему его код требует доработки перед эксплуатацией. Зафиксируйте эту границу в брифе. Если офис-менеджер попросит дать доступ всему офису завтра, сначала согласуйте, кто отвечает за вход сотрудников и что случится с рабочими бронями при перезапуске или восстановлении базы.
Офис-менеджер может попросить оставить на общем экране только отметку «Занято», а имя владельца показывать ему одному. В запись передачи тогда добавьте проверку для двух ролей. «Борис видит, что 10:00 занято. Офис-менеджер видит, что слот у Анны». Так разработчик сможет оценить доработку и проверит, что имя отсутствует и в ответе сервера для Бориса.
Приложите к отклику результат, который можно повторить
В отклике дайте ссылку на репозиторий и назовите проверку, которую покажете первой. Если выполнили учебный прогон, подойдёт такая строка. «Собрал прототип брони переговорной с помощью ИИ. На учебном стенде проверил два запроса к одному свободному слоту: получил одно подтверждение и один конфликт, сверил владельца единственной записи. В репозитории есть миграция, тест и инструкция запуска». Укажите, кто проверил запуск по README. Участие коллеги описывайте после того, как он повторит проверку или примет проект.
Решите заранее, что откроете, если демонстрационный стенд окажется недоступен. Приготовьте локальный запуск и сохранённый вывод теста с указанием коммита. На встрече откройте миграцию и объясните, почему одного отключения кнопки после клика мало. Оно действует в одном окне, тогда как пользователи работают в разных сессиях. Затем покажите, что проверяет тест, и назовите часть работы, которую сделали лично. Например: «Модель написала первый обработчик. Я увидел разрыв между чтением и записью, сформулировал правило для базы и проверил его двумя запросами». По такому рассказу можно задать вопросы о конкретном коде. Если собираете портфолио из нескольких проектов, сопоставьте эти доказательства с тем, как показать инженерную работу AI-разработчика.
Перед отправкой откройте публичный репозиторий без входа в GitHub. Для закрытого проверьте, что интервьюер принял приглашение с нужной учётной записи. Сверьте коммит в записи приёмки с версией по ссылке. Если после прогона вы поменяли миграцию, тестовые данные или обработчик, повторите запуск и обновите запись.