Нормализуйте на границе
Имена полей, идентификаторы, пробелы, даты и категориальные значения нужно нормализовать при входе. Внутренняя логика не должна постоянно угадывать значение поля.
Имена полей
Идентификаторы
Даты и единицы
Контролируемые значения
Разделяйте отсутствие, ошибку и дубликат
Эти состояния требуют разных решений. Отсутствующий email может идти на проверку; неверный account ID — блокировать поток; дубликат события — стать idempotent no-op.
Отчёт о пропусках
Ошибки валидации
Ключ дубликата
Статус проверки
Не стирайте доказательства
Сохраняйте исходный ввод, сводку преобразований и отклонённые записи. Прослеживаемость превращает отладку из догадки в управляемую проверку.
Ссылка на источник
Сводка изменений
Отклонённые строки
Время обработки
Только затем подключайте назначение
Когда граница ясна, повторы API и синхронизацию можно проектировать безопасно. Система назначения получает записи известной структуры.
Schema mapping
Idempotency key
Ограниченные повторы
Маршрут оповещения
Очистка данных — не косметическая подготовка. Это часть архитектуры интеграции.