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

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