# Перенос сайтов и админок

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

## Оглавление

- [Пошаговый перенос сайта и админки](#migration-playbook)
- [Инвентаризация исходного сайта](#migration-source-inventory)
- [Карта полей и преобразований](#migration-field-mapping)
- [Повторяемый импорт и перенос изменений](#migration-repeatable-import)
- [Сверка исходника и результата импорта](#migration-data-reconciliation)
- [Сохранение адресов при переносе сайта](#migration-url-continuity)
- [Функции сайта и замечания сохраняются при переносе](#migration-feature-parity)
- [Изолированный стенд для переноса](#migration-preview-isolation)
- [Переключение сайта и восстановление записей](#migration-cutover-recovery)
- [Передача перенесённого сайта владельцу](#migration-handoff)
- [Независимость перенесённого сайта от старого движка](#migration-legacy-independence)

<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)

---

<a id="migration-source-inventory"></a>

# Инвентаризация исходного сайта

## Коротко

До работы зафиксируйте, что существует на исходном сайте, где хранится, кто им управляет и какие данные разрешено переносить.

## Плохо

```text
Поставили движок другого магазина.
Посмотрели главную и sitemap.
Справочники, цены и формы восстановили по догадке.
```

## Хорошо

```text
Точка отсчёта: снимок A, область «каталог».
URL: sitemap + обход + CMS.
Товары, варианты, документы, формы и админка
описаны с источником и статусом проверки.
Условия по спорной цене ждут подтверждения.
```

## Почему

Сайт состоит из адресов, данных, прав и поведения. Sitemap не видит черновики, цены в админке и пути после отправки формы. Движок похожего проекта ускоряет сборку, но его данные и бизнес-правила принадлежат другому сайту.

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

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

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

- Начните с режима чтения. Запишите исходный и целевой адреса, цель, окружения, полномочия, владельца решений и время снимка. При переносе контента другого проекта используйте только согласованные источники и материалы.
- Сведите sitemap, обход внутренних ссылок, отчёты входящих URL и выгрузку CMS/БД, если доступны. Охватите вложенные разделы, фильтры, страницы вне меню, товары, справочники, старые адреса, изображения, видео, файлы и ссылки внутри HTML/JSON.
- Снимите сценарии на телефоне и компьютере. Учтите гостя, клиента, сотрудника, ограничения доступности, поиск по точному коду, формы, корзину, оплату, заявки, уведомления, фоновый обмен и редакторские действия.
- Для каждого класса фактов назовите источник и способ сверки. Например, финансовый факт подтверждает журнал операций, а видимый текст — опубликованная страница. Конфликт значений становится отдельной строкой расхождений с владельцем.
- Помечайте сведения как подтверждённые, предполагаемые, согласованное решение или пробел. Задайте охват каждой проверки. Если подключение недоступно, продолжите независимые шаги и зафиксируйте блокировку зависимого шага.
- Сохраните защищённые исходные копии и ревизии. В доступные всей команде отчёты поместите агрегаты и обезличенные образцы. Не передавайте рабочие ключи, дампы и клиентские данные в публичный Git или общедоступные артефакты.

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

В магазине есть публичная карточка, два ценовых предложения и PDF паспорта. Карточку инвентаризируют по URL, оба предложения — по записям источника, документ — по связи с товаром. Права и отчётность фиксируют отдельным сценарием.

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

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

## Человек

Определяет источники, доступы, область и допустимые исключения. Утверждает решение при конфликте.

## Агент

Снимает инвентарь в режиме чтения и привязывает каждый факт к свидетельству.

## Источники

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

Уровень: Обязательно. Опубликовано: 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/source-inventory.md)

---

<a id="migration-field-mapping"></a>

# Карта полей и преобразований

## Коротко

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

## Плохо

```text
Прайс стал текстом.
Цены округлили до копеек до умножения.
Пустой остаток стал нулём.
Пропавшему бренду придумали название.
```

## Хорошо

```text
Строка тарифа → формат × тираж × отделка.
Цена за штуку: точное decimal + валюта.
«По запросу» — отдельное состояние.
Неизвестная связь → запись на разбор.
Исходный ключ и причина сохранены.
```

## Почему

Новая схема может выглядеть аккуратно и при этом изменить стоимость, срок или условия продажи. Тип и значение нужно сравнивать вместе с бизнес-смыслом.

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

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

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

- Запишите для каждой колонки или свойства: сущность и поле источника, целевой путь, ключ, тип, кратность, обязательность, единицы, шкалу, допустимые значения, преобразование, проверку и политику отклонения.
- Различайте `null`, пустой текст, ноль, недоступность, цену «по запросу», неизвестную связь, скрытие и удаление. Объединяйте состояния только по согласованному контракту.
- В справочниках сопоставляйте по устойчивому идентификатору. Совпадение названий само по себе недостаточно. При неоднозначности отложите связь, сохраните исходный ключ и попросите владельца принять решение.
- Переносите тарифные сетки как данные. Сохраните строки, колонки, единицы, диапазоны, минимумы, точность, ячейки «по запросу», примечания и основания расчёта. Цену за единицу и сумму за тираж сверяйте раздельно. В интерфейсе и калькуляторе используйте общий тариф.
- Для дат различайте календарный день и момент времени, сохраняйте контекст зоны. Для денег установите точность исходного тарифа и явно задайте точку округления расчёта. Для HTML и медиа сохраняйте подписи, порядок, доступность и связи с объектами.
- Данные исходника не получают по догадке новый статус «Архив», «В наличии» или «Цена устарела». Фиксируйте сомнение и показывайте согласованное состояние. Пример или демоданные маркируйте и держите отдельно.

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

Цена печати за один экземпляр задана с тремя десятичными знаками. Импорт сохраняет точный тариф, а итог округляет по правилам расчёта после умножения на тираж. У другой комбинации остаётся «По запросу» и отдельная заявка.

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

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

## Человек

Подтверждает семантику полей и правила обработки неполных данных.

## Агент

Агент сверяет карту со схемой, строит преобразование и проверяет исключения.

## Источники

- [PostgreSQL — числовые типы](https://www.postgresql.org/docs/current/datatype-numeric.html)
- [PostgreSQL — изоляция транзакций](https://www.postgresql.org/docs/current/transaction-iso.html)

Уровень: Обязательно. Опубликовано: 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/field-mapping.md)

---

<a id="migration-repeatable-import"></a>

# Повторяемый импорт и перенос изменений

## Коротко

Импорт запускается на зафиксированном снимке, сохраняет соответствия ключей и выдерживает повтор или перезапуск. Для работающего источника отдельно переносите изменения после снимка.

## Плохо

```text
Импортировали напрямую.
Обрыв на середине, глобально очистили цель.
Повтор создал новые товары и письма.
```

## Хорошо

```text
Снимок S, карта полей v3, dry run.
source + type + source_id → target_id.
Пакет и checkpoint сохранены атомарно.
Повтор без изменений → 0 записей.
Дельта после S сверена до переключения.
```

## Почему

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

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

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

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

- Укажите одну ревизию кода, снимка, справочников и карты полей. Зафиксируйте входные хеши и ключи. Явно ограничьте область записей, которые разрешено менять.
- Сделайте dry run, который считает вставки, обновления, пропуски, удаления и конфликты без записи эффекта. Выполните маленький тестовый пакет в изолированной цели и сверьте результат перед полным прогоном.
- Используйте стабильный уникальный ключ источника или защищённую таблицу соответствий. Сначала загрузите справочники и родители, затем дочерние и связи, либо разрешите зависимости отдельным проходом. Атомарно подтверждайте пакет и позицию продолжения.
- Версионируйте преобразования. Повтор той же версии на том же входе даёт то же состояние. Новые ручные правки защищены сравнением версии и политикой конфликта. Не превращайте отсутствие в неполной выгрузке в удаление.
- Ограничьте пакет, параллелизм и тайм-ауты. Очередь повторов конечна. Запишите ошибки по ключам, обеспечьте повтор проблемной партии. Письма, платежи и вебхуки в тестовом импорте отключены или направлены в тестовые контуры.
- Дельту применяйте по стабильному курсору или журналу событий в согласованном порядке. Учтите удаления, одинаковое время изменений и поздние записи. Если условия непрерывного переноса не подтверждены, согласуйте паузу и выполните новый согласованный снимок.

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

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

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

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

## Человек

Утверждает, какие изменения цели разрешено перезаписывать и когда переносится дельта.

## Агент

Реализует dry run, журнал, стабильные ключи, возобновление и сравнение результатов.

## Источники

- [PostgreSQL — снимок базы и восстановление](https://www.postgresql.org/docs/current/backup-dump.html)
- [PostgreSQL — изоляция транзакций](https://www.postgresql.org/docs/current/transaction-iso.html)
- [PostgreSQL — INSERT и ON CONFLICT](https://www.postgresql.org/docs/current/sql-insert.html)

Уровень: Обязательно. Опубликовано: 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/repeatable-import.md)

---

<a id="migration-data-reconciliation"></a>

# Сверка исходника и результата импорта

## Коротко

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

## Плохо

```text
В обеих базах 1000 строк — готово.
Отсутствующий артикул замещён дублем.
Общая сумма совпала из-за двух ошибок.
```

## Хорошо

```text
Список ключей и состояния сравниваются.
Пропуск, дубль и чужой ключ видны отдельно.
Суммы сверены по валюте и статусу.
У каждого исключения есть решение.
```

## Почему

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

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

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

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

- Соберите ожидаемый и фактический наборы стабильных ключей. Отдельно проверьте лишние, отсутствующие и дубли. Сведите разбивку по типу, состоянию публикации, разделу, валюте, периоду и источнику тогда, когда они влияют на результат.
- Сверьте типизированные значения и связи. Используйте полный дифф или контрольные хеши канонической формы с раскрытием несовпавших строк. Не меняйте порядок элементов, если он несёт смысл.
- Проверьте ссылочную целостность и крайние случаи: многоуровневый раздел, вариант без остатка, две цены, добавочный документ, многозначное свойство, скрытая запись, удаление и исторический адрес. Проверяйте байты или декодирование медиа и целевой доступ, а не только наличие URL.
- Для заказов сравните снимки позиций, суммы, скидки, валюты, оплаты, возвраты, итог долга и идентификаторы операций. Разделяйте заказы и платежи. Финансовый разрыв или исчезнувший заказ блокирует коммерческое переключение до разбора.
- Ведите отчёт по каждому отклонению: ожидаемое, фактическое, свидетельство, причина, решение, владелец и статус. Неподтверждённый источник даёт непроверенную область, а не зелёный результат.
- Повторите сверку после изменения импорта и после финальной дельты на согласованных точках во времени. Данные админки, публичного представления и индекса сверяйте по версии публикации.

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

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

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

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

## Человек

Принимает исключения и подтверждает допустимость переключения по итогам сверки.

## Агент

Агент сравнивает ключи, поля, связи, суммы и версии. Фиксирует расхождения с доказательствами.

## Источники

- [PostgreSQL — изоляция транзакций](https://www.postgresql.org/docs/current/transaction-iso.html)
- [PostgreSQL — ограничения](https://www.postgresql.org/docs/current/ddl-constraints.html)

Уровень: Обязательно. Опубликовано: 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/data-reconciliation.md)

---

<a id="migration-url-continuity"></a>

# Сохранение адресов при переносе сайта

## Коротко

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

## Плохо

```text
Адреса пересобраны из новых названий.
Все старые URL → главная.
Хлебные крошки ведут на старый сайт.
Sitemap содержит технический стенд.
```

## Хорошо

```text
/catalog/item-a → тот же товар.
Исторический URL → 301 → товар 200.
Удалённая страница без замены → 410.
Внутренние ссылки и canonical → новые цели.
```

## Почему

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

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

При смене движка, структуры адресов, домена или хостинга. Если URL и содержание сохранены, перенос на другой сервер не требует массовых редиректов.

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

- Составьте таблицу `старый URL → цель → класс → ожидаемый статус → canonical`. Включите URL из sitemap, источника, внутренних ссылок, внешних ссылок и наблюдаемого трафика. Сопоставляйте по объекту и смыслу, сохраняя вложенность и действующие адреса категорий, документов и вариантов.
- Для постоянной замены используйте серверный постоянный редирект на подходящую страницу. Учитывайте разницу 301/308 для методов. Не переносите POST и платёжные callback на другой адрес по правилам редиректов страниц без проверки контракта.
- Не отправляйте неизвестные или удалённые URL на главную. Реальный 404/410 выбирается по смыслу. Технические страницы старого шаблона обрабатывайте по явному списку; случайное отсутствие настоящей карточки остаётся дефектом.
- Оставьте значимые параметры, в том числе выбранный вариант, фильтр, пагинацию или параметры заявки по контракту. Перезапишите внутренние ссылки в HTML, структурированных полях, хлебных крошках и связанных карточках. Внешние ссылки сохраняйте, если они по-прежнему нужны.
- У canonical, внутренних переходов и sitemap есть одна согласованная цель. В sitemap помещайте только разрешённые индексируемые URL. Preview, черновики, перенаправления и закрытые записи исключаются.
- Пройдите весь реестр ограниченным темпом. Проверка оценивает первый ответ без перехода, конечную страницу, отсутствие цикла, тип сущности, видимый контент и ссылки.

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

У типографии товар и таблица открываются на старом адресе раздела. Историческая подстраница перенаправляется прямо на этот товар. Значимая ссылка на расчёт передаёт параметры тиража в новый адрес по явному контракту.

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

- Откройте прямой старый URL карточки, вложенного раздела и файла. Сверьте статус, цепочку и фактическую сущность.
- Полностью обойдите реестр и выдайте список неожиданного 404/410, цепочек, дублей canonical, ошибок и ссылок на старый хост.
- Перейдите из хлебных крошек и из содержимого карточки на мобильном и настольном экране.

## Человек

Утверждает удаление, объединения URL и смысл перенаправлений.

## Агент

Агент строит карту и проверяет статусы, конечные объекты, внутренние ссылки и индексирование.

## Источники

- [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)
- [RFC 9110 — перенаправления HTTP](https://www.rfc-editor.org/rfc/rfc9110.html#section-15.4)

Уровень: Обязательно. Опубликовано: 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/url-continuity.md)

---

<a id="migration-feature-parity"></a>

# Функции сайта и замечания сохраняются при переносе

## Коротко

Сопоставьте старые и новые пользовательские сценарии. Изменения дизайна проверяйте вместе с сохранением данных, меню, действий и всех согласованных замечаний.

## Плохо

```text
Главная выглядит новее, сайт вернул 200.
Исчезли прайс, сравнение и баннеры.
Форма открылась. Получение заявки не проверили.
```

## Хорошо

```text
F-12 — открыть прайс → выбрать тираж → расчёт.
Старая и новая цена сверены по ячейкам.
F-18 — заявка сохранилась, есть квитанция.
Баннеры сохранены, указатели изменены по задаче.
```

## Почему

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

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

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

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

- Перенесите замечания, обещания и пользовательские поправки в единый реестр: ID, экран или сквозной сценарий, роль, размер окна, исходное поведение, ожидаемое изменение, ответственный и свидетельство. Последнее решение переопределяет предыдущую неоднозначную формулировку.
- Сравните все URL по автоматизируемым признакам. Действия в браузере сгруппируйте по общим шаблонам и сценариям, добавьте все уникальные и критические случаи. Статус 200 и скриншот первого экрана подтверждают только соответствующую проверку.
- Проверяйте каталог от верхнего уровня до последнего вложенного раздела, точный поиск и подсказки, табличный прайс, варианты и наличие, файлы, галерею и сценарии избранного, сравнения, корзины, кабинета и повторного заказа, если они существовали.
- Различайте сохранение данных и изменение управления. Замена стрелок карусели не удаляет баннеры. Перенос формы не меняет назначение кнопки и контекст обращения. Заявка по услуге или акции хранит её ID, выбранные параметры и источник, даже если пользователь меняет черновик общего расчёта.
- Проверьте ширину проекта, длинные реальные заголовки, светлую/тёмную темы при наличии, экранную клавиатуру, простой переход без JavaScript там, где обещан, и альтернативу автоматической подгрузке. Важная цена и действие доступны. Демонстрационные элементы шаблона не попадают в витрину клиента.
- Проверьте финальный эффект в безопасном окружении: запись данных, показ в нужной роли, тестовая квитанция провайдера. Факт записи, постановка в очередь и подтверждённая доставка получают разные статусы.

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

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

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

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

## Человек

Принимает изменения функций и приоритеты. Подтверждает, что сохранено поведение важных сценариев.

## Агент

Агент сравнивает источник и целевой сайт по трассируемым сценариям, проверяет эффекты и закрывает замечания по одному.

## Источники

- [Playwright — проверки состояния страницы](https://playwright.dev/docs/test-assertions)
- [Google Search Central — перенос с изменением URL](https://developers.google.com/search/docs/crawling-indexing/site-move-with-url-changes)

Уровень: Обязательно. Опубликовано: 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/feature-parity.md)

---

<a id="migration-preview-isolation"></a>

# Изолированный стенд для переноса

## Коротко

Разверните новую версию на согласованном адресе с отдельной областью записи. Рабочий сайт и внешние получатели защищены от пробных действий.

## Плохо

```text
Стенд использует старую БД и SMTP.
При проверке пришло настоящее письмо.
Целевой виртуальный хост оказался боевым.
```

## Хорошо

```text
Разрешённый хост: preview.example.
БД, медиа, индекс и очередь отдельные.
Email и платежи в тестовом контуре.
Рабочий адрес и настройки сверены.
```

## Почему

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

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

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

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

- Запишите разрешённые origin, окружение, ревизию, хранилища и операции. Перед каждой записью или выпуском автоматически сверяйте фактическую цель. При отсутствии проверки прекратите операцию записи.
- Привяжите отдельные базы или явно изолированные пространства имён, аккаунты, cookie, сессии, медиа, индексы и ключи доступа. Содержимое другого проекта и его фоновые задачи не должны переходить вместе с движком.
- Запретите или перенаправьте реальные исходящие эффекты на отдельного тестового получателя. Учитывайте SMTP, SMS, чат, CRM, аналитику, вебхуки, оплаты, планировщики и производственные ключи. Явно проверьте, что вспомогательные задачи тоже изолированы.
- Для закрытого стенда используйте контроль доступа. `noindex` помогает исключить публичный preview из выдачи и не служит авторизацией. Публичные ссылки, canonical, уведомления и верификация домена не должны присваивать стенду идентичность production.
- Маркируйте тестовые операции в данных и админке, ведите реестр созданных объектов. Очистка ограничивается этими объектами и сохраняет обязательный аудит.
- Сверьте действующий origin и рабочую конфигурацию до и после выпуска стенда. Переключение основного URL — отдельная согласованная операция.

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

Магазин переносится на новый движок. У проверяющих отдельный URL, тестовая база и кабинет. Тестовую корзину оформляют до сохранённого заказа, а уведомление попадает в тестовую очередь. Боевой магазин остаётся доступным посетителям.

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

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

## Человек

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

## Агент

Агент проверяет назначение и изоляцию, проводит тесты в разрешённой среде и фиксирует эффект.

## Источники

- [Google Search Central — смена хостинга с сохранением URL](https://developers.google.com/search/docs/crawling-indexing/site-move-no-url-changes)
- [OWASP — управление секретами](https://cheatsheetseries.owasp.org/cheatsheets/Secrets_Management_Cheat_Sheet.html)

Уровень: Обязательно. Опубликовано: 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/preview-isolation.md)

---

<a id="migration-cutover-recovery"></a>

# Переключение сайта и восстановление записей

## Коротко

Переключайте трафик после приёмки, проверки восстановления и финальной сверки. Откат должен учитывать записи, созданные уже на новом сайте.

## Плохо

```text
Переключили домен сразу после сборки.
Бэкап ни разу не восстановили.
При сбое вернули старый код и потеряли заказы.
```

## Хорошо

```text
Есть проверенное восстановление.
Старые записи заморожены на окно дельты.
Новая цель сверена. Автор записи один.
Откат включает новые заказы и заявки.
```

## Почему

Смена DNS, прокси и файлов обратима сама по себе. Состояние заказов, оплат и уведомлений меняется отдельно. Возврат приложения без плана для новых событий может потерять операции или повторить эффект.

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

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

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

- Привяжите приёмку к конкретной ревизии приложения, снимку и дельте данных, карте URL, параметрам окружения и процедуре выпуска. Назначьте ответственного, окно, максимальный допустимый простой и потерю данных, критерии остановки.
- Проверьте резерв кода, БД, файлов, конфигурации и необходимых ключевых метаданных. Восстановите согласованный набор в отдельное место и сверяйте выборку и контрольные итоги. Файл резерва сам по себе проверку не закрывает.
- Выберите режим финальной дельты. Для активных данных определите единственного владельца записи на каждом этапе, поставьте понятную границу событий и корректно обработайте заявки и оплаты на переходе. При паузе записи покажите управляемое состояние пользователю.
- Переключайте только согласованные маршруты и службы. Учитывайте сохранённый DNS ответ, TLS, маршруты callback, ссылки, старые соединения, доступ к админке и разрешение индексации production. Проверяйте фактический внешний адрес, включая разные сети там, где это важно.
- Пройдите контрольные сценарии сразу после переключения. Проверьте версии, URL, запись, чтение, поиск, права, очереди, дельту и документированные тесты провайдеров. Следите за ошибками и ресурсами по согласованному времени.
- До допуска записей определите способ возврата новых заказов, обращений и оплат. При откате остановите параллельные записи, сохраните новые события, восстановите владельца записи и сверку. Если обратный перенос не предусмотрен, заранее определите безопасное окно или план исправления вперёд.

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

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

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

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

## Человек

Принимает решение о переключении, допустимых потерях и способе возврата данных.

## Агент

Агент репетирует шаги, сверяет источник и цель и собирает свидетельства перехода.

## Источники

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

Уровень: Обязательно. Опубликовано: 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/cutover-recovery.md)

---

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

# Передача перенесённого сайта владельцу

## Коротко

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

## Плохо

```text
В отчёте написано «сайт готов».
Ссылка на закрытый стенд и нет админки.
Проверку очереди назвали доставкой.
Стоимость и окно правок пропущены.
```

## Хорошо

```text
Владелец открыл сайт и админку.
Роль и путь входа проверены.
Исходный домен всё ещё на старой версии.
Срок и объём правок сверены с договорённостью.
```

## Почему

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

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

Перед показом стенда, сдачей новой версии и сменой владельца. Формулировки, сумма и сроки зависят от условий проекта.

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

- Разделите рабочие и демонстрационные адреса. Укажите сайт, админку, документацию и текущую ревизию. Опишите, где действует новая версия, кто управляет доменом и что нужно выполнить до переключения.
- Передайте роль и способ входа индивидуально. Секреты идут через согласованный защищённый канал. Проверьте приглашение или тестовый вход получателя в согласованных пределах. Укажите, как восстановить доступ и кому сообщить о проблеме.
- Дайте короткие инструкции для повседневных задач: изменить публичный контент и SEO, опубликовать черновик, увидеть заявку или заказ, обновить цену, восстановить версию и добавить сотрудника по правам, если это входит в роль.
- Покажите, что перенесено и проверено, на каких средах и состояниях. Различайте локальную проверку, результат на целевом сайте, создание записи, отправку и подтверждение доставкой. Перечислите оставшиеся проверки с владельцем.
- Используйте понятное клиенту описание. Когда требуется, включите согласованную стоимость, что добавилось к исходному объёму, по чьей инициативе, какие изменения входят в период правок и когда он начинается. Условия сверяйте с договорённостью.
- Передавайте оператору отдельно внутренний комплект: версия, карта URL, данные и исключения, результаты тестов, резерв, откат, интеграции и владелец поддержки.

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

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

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

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

## Человек

Подтверждает доступы, итоговый объём, договорённости и момент сдачи.

## Агент

Агент проверяет ссылки, фиксирует подтверждения и готовит понятный рабочий комплект.

## Источники

- [Google Search Central — смена хостинга с сохранением URL](https://developers.google.com/search/docs/crawling-indexing/site-move-no-url-changes)
- [OWASP — передача и хранение секретов](https://cheatsheetseries.owasp.org/cheatsheets/Secrets_Management_Cheat_Sheet.html)

Уровень: Обязательно. Опубликовано: 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/handoff.md)

---

<a id="migration-legacy-independence"></a>

# Независимость перенесённого сайта от старого движка

## Коротко

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

## Плохо

```text
React выводит iframe старого сайта.
Тексты и цены зашиты в шаблон.
Фотографии и поиск читают старый хост.
Проверили только 200 на главной.
```

## Хорошо

```text
Публичные маршруты UI → API → своя БД.
Медиа сохранены в целевом хранилище.
Для источника существует отдельный импорт.
Старый хост недоступен: сценарии работают.
В переходном режиме маршруты явно разделены.
```

## Почему

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

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

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

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

- Для каждого публичного и административного маршрута укажите владельца рендера, источник данных, API, медиа и разрешённые внешние зависимости. Отдельно опишите маршрут импорта.
- Используйте согласованную изолированную БД, индекс и медиахранилище. Редактируемые поля, связи, цены, SEO и страницы принадлежат модели проекта. Движок исходного шаблона служит основой для компонентов, схема и контент определяются источником задачи.
- Отслеживайте зависимости в SSR, сетевых запросах браузера, стилях, ссылках, JSON, медиа, фоновых задачах и формах. Переходы на согласованные внешние карты, платежи и документы учитывайте отдельно.
- Любой временный прокси имеет явный охват, владельца, условия выключения и тест. Если требование запрещает runtime-fallback к старой CMS, проверьте отсутствие любых её чтений при обычной работе.
- Отключите доступ к изолированной копии старого источника и пройдите маршруты, поиск, медиа, вход, типовое редактирование и безопасную запись. Сверьте реальные ревизии и сетевые зависимости.
- Если переезжает публичная часть, сохраните область неизменяемой админки и её контракты. Если переезжает админка, проверяйте сохранение операторских сценариев отдельно.

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

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

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

- Откройте прямой URL в чистой сессии при отключённом источнике. Проверьте HTML, медиа, сеть и данные карточки.
- Измените тестовую запись в новой админке и проверьте проекцию. Переопубликация движка для значения поля не требуется.
- Проверьте объявленные зоны переходной архитектуры по карте URL. Каждое обращение к legacy объяснено.

## Человек

Утверждает разрешённые зависимости, область замены и срок перехода.

## Агент

Агент инвентаризирует зависимости, выносит импорт из runtime и доказывает независимость целевого сценария.

## Источники

- [Martin Fowler — постепенная замена приложения](https://martinfowler.com/bliki/StranglerFigApplication.html)
- [Google Search Central — перенос хостинга](https://developers.google.com/search/docs/crawling-indexing/site-move-no-url-changes)

Уровень: Обязательно. Опубликовано: 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/legacy-independence.md)
