← Назад к блогу

Практика системного анализа · 4 минуты

Два справочника, один обмен: как проверять соответствие кодов без догадок

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

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

Разные уровни детализации

Вымышленный магазин передаёт канал заказа в отчётность. В источнике есть WEB, APP и SHOP. Приёмник различает ONLINE и OFFLINE. Владелец отчёта принимает учебное решение D1: WEB и APP входят в ONLINE, SHOP входит в OFFLINE. Интеграция не запускалась.

Код источникаКод назначенияРешениеОснование
WEBONLINEПреобразоватьD1, сайт
APPONLINEПреобразоватьD1, приложение
SHOPOFFLINEПреобразоватьD1, магазин
OTHERНет парыОтложить запись на уточнениеD2, неизвестный код
ПустоНет парыОшибка входаD3, поле обязательно

OTHER и пустое поле требуют разных действий. Первое может означать новый вариант поставщика; второе нарушает входной контракт. Если обе строки превратить в OFFLINE по умолчанию, отчёт останется формально полным, но изменит смысл.

Обратный путь не следует из прямого

Из ONLINE нельзя восстановить WEB или APP. Если приёмник позднее отправляет данные обратно, нужно сохранить исходный код рядом с нормализованным либо явно признать потерю детализации. Не стоит придумывать обратную пару ONLINE → WEB ради симметричной таблицы.

Совпадение подписи тоже не гарантирует совпадение кода. Допустим, поставщик вводит PARTNER_APP с подписью «Приложение». В отчётности партнёрский канал может иметь отдельную трактовку. До решения владельца он проходит ветку D2, даже если модель уверенно предлагает ONLINE.

Проверка по набору

Возьмём пять записей: WEB, APP, SHOP, OTHER и пустую. Ожидаем две строки ONLINE, одну OFFLINE, одну отложенную и одну ошибку. Затем проверяем ключи каждой категории, чтобы равные счётчики не скрыли перепутанные записи.

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

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

Отличие сущностей от названий разобрано в словаре терминов, а последствия смены значений для потребителей — в миграции enum.

Вопросы по справочникам

Одинаковые подписи разрешают сопоставить коды?

Нет. Нужны значение кода, контекст и подтверждённая пара.

Допустимо соответствие многие к одному?

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

Что делать с неизвестным кодом?

Следовать явной ветке. По D2 обработчик откладывает запись до уточнения.

Чем неизвестное значение отличается от пустого?

Неизвестное значение присутствует, но для него нет пары. Пустое нарушает обязательность поля.

Можно ли использовать новую таблицу для истории?

Только по согласованному правилу пересчёта. Само изменение таблицы такого разрешения не даёт.

Автор: Иннокентий Бодров, автор Аналитической мастерской.