Как проверить миграции базы данных после вайбкодинга?

Как проверить миграции базы данных после вайбкодинга?

Начните с тестовой копии сайта: восстановите в ней резервную копию базы, примените изменения и проверьте товары, заказы и оформление покупки. Миграция базы данных — это инструкция, которая меняет её структуру или содержимое при обновлении сайта. После вайбкодинга такую инструкцию нужно проверять отдельно от внешнего вида страниц. Ниже разберём, что поручить ИИ, какие результаты запросить у разработчика и при каких ошибках остановить выпуск обновления. Этот порядок поможет проверить сохранность данных до изменений на рабочем сайте.

Почему сайт открывается, а заказы уже работают неправильно?

ИИ добавил поле к товару, изменил статусы заказов или перенёс цены в другую таблицу. Страница при этом открывается без ошибок. Но старые записи могут не соответствовать новым правилам: у товара пропадает цена, заказ теряет позиции, фильтр перестаёт находить часть каталога.

Успешный запуск миграции означает, что база выполнила инструкции без ошибки. Сохранность смысла данных он не подтверждает. Например, перенос суммы заказа в новое поле требует проверки самой суммы, валюты и округления. Для магазина с ценами в BYN важно убедиться, что обновление не изменило денежные значения.

Начните с вопроса к ИИ: «Какие изменения в этой задаче затрагивают базу данных? Перечисли таблицы и поля, объясни влияние на существующие записи. Отдельно отметь удаление данных, переименование и изменение типов. Пока ничего не запускай». Ответ сверяйте с файлами миграций: объяснение в чате не заменяет просмотр инструкций.

Роль ИИ как помощника, который требует проверки бизнес-логики, разбирает материал «ИИ в бэкенд-разработке: как ускорить работу без рисков» (Qmedia). Для миграций этот принцип означает конкретную границу: ИИ готовит изменения, а ответственный за выпуск проверяет их на копии базы.

Как подготовить тестовую копию перед миграцией?

Попросите разработчика подготовить отдельную среду, где ошибка не затронет рабочий магазин. Копия должна воспроизводить важные условия: версию базы, настройки приложения и текущую структуру таблиц. На пустой базе миграция может пройти, хотя на накопленных заказах она завершится ошибкой.

  1. Сохраните исходное состояние. Нужны резервная копия базы и версия кода, которая с ней работает.
  2. Восстановите резервную копию в отдельной тестовой базе. Проверьте, что восстановление завершилось и сайт читает записи.
  3. Проверьте подключение тестового приложения. Оно должно обращаться только к тестовой базе, без доступа к рабочей.
  4. Отключите реальные внешние действия. Тестовый заказ не должен запускать оплату, отправку уведомлений или передачу задания на доставку.
  5. Зафиксируйте исходные показатели. Сохраните количество товаров и заказов, контрольные суммы и примеры записей для сравнения.

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

Отдельно проверьте настройки доступа. Если ИИ скопировал конфигурацию рабочего сайта вместе с подключениями, тестовая среда рискует обратиться к рабочим сервисам. Для этой части пригодится проверка API-ключей после вайбкодинга с Claude Code. Пароль от рабочей базы тестовому приложению не нужен.

Что проверить после применения миграции на копии?

Запускайте тот же набор миграций, который планируете применить при выпуске. Сохраните журнал выполнения и список изменений. Если разработчик вручную исправляет тестовую базу, эти исправления нужно включить в воспроизводимый процесс и заново проверить на свежей копии.

Сначала сравните данные до и после. Одинаковое количество записей полезно, но недостаточно: миграция могла сохранить строки и перепутать связи между ними. Поэтому проверяйте и общие показатели, и конкретные заказы.

  • Товары: сохранились артикулы, цены и остатки; варианты товара относятся к нужным карточкам.
  • Заказы: сохранились состав, суммы и статусы; старые заказы открываются в панели управления.
  • Связи: каждая позиция заказа относится к нужному заказу; перенос данных не создал лишние дубли.
  • Значения по умолчанию: новые поля получили ожидаемые значения, а пустые значения не скрывают ошибку переноса.
  • Ограничения базы: правила уникальности и обязательные поля соответствуют логике сайта, включая старые записи.

Если обновление намеренно меняет количество записей, заранее опишите ожидаемый результат. Например, перенос вариантов товара в отдельную таблицу изменит её наполнение. Разработчик должен объяснить, как каждая исходная запись связана с результатом, и показать проверку этой связи.

Затем пройдите покупку на тестовом сайте: найдите товар, добавьте его в корзину и оформите заказ без реального списания денег. Откройте заказ в панели управления, измените статус и проверьте итоговую сумму. Отдельно откройте заказ, который появился до миграции: новый код должен читать и старые данные.

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

Как подготовить обновление и возврат к рабочей версии?

До выпуска согласуйте, какие изменения означают остановку. Пропавшие позиции заказа, необъяснимое изменение сумм и ошибки оформления покупки — причины отложить обновление. Даже если главная страница и каталог выглядят как прежде.

План возврата должен учитывать совместимость кода и базы. Возврат старых файлов приложения не поможет, если миграция уже удалила поле, которое старый код использует. Обратная миграция тоже не гарантирует восстановление содержимого: создать пустой столбец заново и вернуть прежние значения — разные задачи.

Для изменений с удалением данных обсудите поэтапный выпуск. Сначала приложение получает новую структуру и переносит данные, затем разработчик проверяет результат. Удаление старых полей выполняют отдельно, когда они больше не нужны рабочему коду и плану возврата. Такой порядок требует проверки совместимости на каждом этапе.

Уточните, что будет с заказами во время обновления. Если сайт продолжает принимать их, восстановление старой резервной копии исключит записи, которые появились позже. Поэтому разработчик должен заранее выбрать режим обновления: временно приостановить запись либо подготовить и проверить способ сохранить новые операции.

В задание на техническую проверку включите конкретные результаты: журнал миграции, сравнение данных, результаты тестового заказа и порядок восстановления. Такой набор подходит и для внутреннего разработчика, и для отдельной проверки после вайбкодинга. Если правки затрагивают много участков приложения, сначала полезно ограничить объём рефакторинга с Claude Code, чтобы не смешивать перестройку кода с переносом данных.

Типичные ошибки при проверке миграций

  • Проверять только пустую базу. Исправление: повторить запуск на тестовой копии с существующими товарами и заказами.
  • Считать отсутствие ошибок доказательством сохранности данных. Исправление: сравнить показатели и проверить связи внутри конкретных заказов.
  • Разрешать ИИ запускать команды без проверки подключения. Исправление: подтвердить адрес тестовой базы и ограничить доступ к рабочей среде.
  • Считать обратную миграцию полноценной страховкой. Исправление: проверить восстановление резервной копии вместе с совместимой версией приложения.
  • Менять файлы миграций после теста и сразу выпускать обновление. Исправление: повторить проверку итогового набора на свежей копии.

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