Перенос дел из сделок в цепочку смарт-процессов Bitrix24

Юридическая компания вела дела по взысканию в обычных воронках сделок, где делопроизводство, работа юротдела и исполнение смешивались в одной карточке. Процесс переводили на цепочку смарт-процессов «делопроизводство → юротдел → исполнение» — и сотни живых дел нужно было перенести целиком, с документами и историей.

Коробочный портал в работе, откатить массовую запись нечем; у разных сценариев свои наборы полей и списков, а штатное хранение файловых полей на портале было повреждено — файлы при обычном сохранении терялись молча.

• Общий движок миграции вместо копипасты под каждый сценарий: чтение источника, стадии, поля, файлы, запись и отчёт — сценарий задаётся только конфигом
• Лестница безопасного запуска: --inspect-fields для составления карты полей, --dry-run с полным предпросмотром записи, --run и отдельный verify после прогона
• Сопоставление списков между сущностями сначала по XML_ID, затем по тексту значения; все промахи и отброшенные значения пишутся в лог
• Нормализация дат любого формата и копирование файлов с сохранением имён; при повреждённом хранении — прямая запись и обязательная сверка после сохранения
• Перекрёстные комментарии в таймлайне «исходная сделка ↔ новый элемент», чтобы любой юрист нашёл историю дела в два клика; починка файлов по логу прогона
• Копирование между смарт-процессами по вебхуку из робота Bitrix24: 4 профиля маршрутов, доступ по токену с проверкой через hash_equals