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

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