Версия источника: 93129dd470a134cabdf15a353da6633362f2b0fe
Синхронизировано: 2026-11-19T04:53:50.014Z
Источник: https://github.com/sergey-from-riders/vibecoding-base/tree/93129dd470a134cabdf15a353da6633362f2b0fe

<a id="migration-playbook"></a>

# Пошаговый перенос сайта и админки

## Коротко

Используйте маршрут от исходного снимка до приёмки. У каждого этапа есть вход, ожидаемый результат, проверка и условие перехода. Инструкцию можно скачать в Markdown и дать агенту вместе с адресами и полномочиями.

## Плохо

```text
Возьми похожий движок, пересобери сайт.
Посмотри главную и запусти импорт.
Если сборка прошла, переключи домен.
В отчёте всё готово.
```

## Хорошо

```text
Источник — каталог S, цель — стенд T.
Сначала — инвентарь, поля, URL, сценарии.
Затем — пробный импорт, сверка, приёмка.
Боевой переход — по согласованному допуску.
Каждый шаг подтверждён артефактом.
```

## Почему

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

## Когда применять

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

### Требования

- Одна строка журнала на проверяемое утверждение. Отдельно ведите работающие факты, предположения, решения владельца и пробелы. Статусы `pass`, `fail`, `blocked`, `not-run`, `not-applicable` должны соответствовать свидетельству. При изменении исходника или сборки перепроверьте затронутые пункты.
- Начинайте в режиме чтения. Зафиксируйте источник, цель, объём, автора записи, выданные права и принятые исключения. Отсутствие пароля, данных или ответа не разрешает угадывать. Сначала ищите подтверждение в согласованных источниках, затем обозначьте блокировку конкретного зависимого шага.
- Переносите один минимальный сквозной сценарий на изолированный стенд перед полным импортом. После проверки увеличивайте объём. Сначала доказательства целостности и соответствия, затем согласованные изменения оформления.
- Используйте артефакты из таблицы этапов ниже. Это имена для переноса состояния между исполнителями; формат CSV, Markdown или JSON выбирает проект. Храните приватные данные и секреты в закрытом контуре.
- Проверяйте результат на той версии и среде, которую принимают. При конфликте используйте журнал решений. Свежая поправка к функции меняет её критерий, а остальные согласованные сценарии остаются в матрице.
- Публикация стенда и боевой переход имеют разные допуски. Шаги после переключения включают контроль данных, фактический внешний результат и передачу владельцу.

### Входные данные

Заполните [карточку переноса](https://github.com/sergey-from-riders/vibecoding-base/blob/main/templates/site-migration.md). Минимум: исходные и целевые адреса, тип переноса, политика доступа, данные и сценарии в области, дата снимка, согласованные исключения, кто принимает результат и на какие среды есть право записи. Исходный сайт, целевой стенд, боевой домен и среды внешних интеграций указываются раздельно.

### Порядок действий

1. **Установите границы.** Сверьте условия задачи, выбранную ветку, действующие адреса, владельца записи, внутренние и внешние контуры. Выпишите запреты и необходимые согласования. Результат — `scope.md`. Допуск к чтению есть явно. Несовпадающий адрес блокирует запись.
2. **Снимите исходное состояние.** Сведите CMS/БД, sitemap, внутренние ссылки, файлы, внешний трафик, интеграции, скриншоты, текущий список дефектов и редакторские задачи. Продолжайте обследование в разрешённых источниках при частичной недоступности. Результат — `inventory`, версии, отметки о полноте. Критичный неизвестный источник блокирует приёмку соответствующего набора.
3. **Опишите ожидаемое поведение.** Составьте `fields`, `urls`, `scenarios` и `gaps`. Для каждой сущности укажите свойства и источники, для каждого старого URL — ожидаемую цель, для каждого замечания — действие, ожидаемый эффект, свидетельство и охват. Команда утверждает спорные значения, права, исключения и изменения функций. Длинные поручения делите по проверяемым результатам.
4. **Подготовьте стенд и восстановление.** Сверьте конфигурацию и фактическое назначение записей. Защитите доступ, разделите данные и внешние эффекты, сохраните резерв и восстановите его в изолированное место. Результат — `environment-check` и `restore-check`. Пока цель или восстановление не подтверждены, ограничьтесь безопасными шагами.
5. **Пройдите минимальный путь.** Возьмите одну нетривиальную запись: родитель, зависимая сущность, медиа и сценарий, например товар с вариантами и тестовой заявкой. Сначала dry run, затем импорт, проверка редактирования, страницы, URL, поиска и наблюдаемого результата. Результат — `pilot`. Отладьте карту до массовой записи.
6. **Импортируйте полную область.** Зафиксируйте снимок и код. Ограничьте пакеты и параллелизм. Сохраните соответствия ключей, позицию и ошибки. Проверьте повтор и возобновление. Результат — `import-run` и `reconciliation`. Сравнивайте ключи, поля, связи, цены, суммы и медиа. Незакрытый критичный разрыв блокирует переключение.
7. **Проверьте сайт и админку.** Автоматически пройдите все известные URL в пределах бюджета. В браузере проверьте шаблоны, все нестандартные страницы и сквозные сценарии с реальными размерами окна, правами, отказами и свежими данными. Проверьте скорость в сравнении с исходным сценарием, сохранение функций и отсутствие запрещённых зависимостей от старого хоста. Результат — `acceptance` с конкретными доказательствами по ревизии. Выполните повторную проверку после исправлений.
8. **Подготовьте боевой переход.** Согласуйте окно, владельца, резерв, пороги остановки и возврат новых записей. Определите границу финальной дельты и одного автора боевой записи. Сверьте репетицию и текущую конфигурацию. Результат — `cutover-plan`. Для выкладки стенда достаточно допуска стенда. Боевой переход выполняется только с соответствующим полномочием.
9. **Переключите и подтвердите.** Перенесите финальные изменения, повторите сверку, переключите согласованный маршрут и проверьте извне версию, ключевые URL, чтение, запись, права, медиа, очередь, интеграции и индексирование. Следите за ошибками по согласованным порогам. Результат — `release-check`. При нарушении порога выполните согласованный откат или исправление вперёд, сохраняя новые данные.
10. **Передайте владельцу.** Дайте адреса и вход, повседневные сценарии, доказательства, основания исключений, сроки согласованных правок, открытые зависимости и контакт ответственного. Результат — `handoff`. В отчёте различите работающий стенд, боевую версию и подтверждённые внешние эффекты.

### Текст для запуска агента

```text
Перенеси сайт по инструкции migration.playbook выбранной ревизии.
Вход: [источник], [стенд], [боевой адрес], [разрешённые записи],
[область данных], [критичные сценарии], [ответственный].

Открой документы проекта, проверь ветку и окружение.
Заполни scope, inventory, fields, urls, scenarios, gaps.
Сохраняй исходное значение или фиксируй причину преобразования.
Отделяй подтверждённое, предположение, решение и пробел.
При недоступном входе пометь зависимый шаг blocked. Продолжи
независимые шаги. Не придумывай данные, функции и проверки.

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

На стенде: изоляция, восстановление, dry run, пробная запись,
полный импорт, сверка, браузерные сценарии и безопасные эффекты.
После исправления повтори проверки затронутых сценариев.
Боевой переход выполняй только при соответствующем допуске,
закрытых блокерах и согласованном возврате новых записей.

В финале укажи, какой адрес и ревизия проверены, что работает,
какие эффекты подтверждены и где остались открытые проверки.
```

### Разбор решений из проектов

В [разборе переносов](https://github.com/sergey-from-riders/vibecoding-base/blob/main/docs/migration-lessons.md) сопоставлены ранние ошибки, последующие исправления и правила, которые помогают их обнаружить. Начните с пары кейсов, близких к задаче, и добавьте их условия в `scenarios`.

## Пример применения

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

## Как проверить

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

## Человек

Задаёт границы и приоритеты, решает спорные факты, принимает исключения и разрешает переключение.

## Агент

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

## Источники

- [Google Search Central — перенос сайта с изменением URL](https://developers.google.com/search/docs/crawling-indexing/site-move-with-url-changes)
- [Google Search Central — смена хостинга без изменения URL](https://developers.google.com/search/docs/crawling-indexing/site-move-no-url-changes)
- [PostgreSQL — резервное копирование и восстановление](https://www.postgresql.org/docs/current/backup.html)
- [Playwright — проверки состояния страницы](https://playwright.dev/docs/test-assertions)

Уровень: Обязательно. Опубликовано: 2026-11-19. Проверено: 2026-11-19. Изменено: 2026-11-19.

[Исходный файл](https://github.com/sergey-from-riders/vibecoding-base/blob/93129dd470a134cabdf15a353da6633362f2b0fe/registry/standards/delivery/site-migration/rules/playbook.md)
