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

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