ОбязательноWeb

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

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

Опубликовано Проверено Изменено

Плохо

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

Хорошо

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

Почему это важно

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

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

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

Требования

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

Кто что делает

Человек

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

AI-агент

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

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

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

Как проверить у себя

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

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