О чём речь

Поля в карточках носят коды вида «UF_CRM_16». Что в них лежит и зачем, знает только тот, кто их заводил, и его давно нет.

Часть настроек правили прямо на рабочем портале, без тестового контура. Что именно меняли в прошлый раз, не восстановить.

Переносы между порталами делали без ключей соответствия. Связи между сущностями держатся на совпадении названий, и они рвутся при первом переименовании.

Как это устроено

Правили быстро и не записывали. Задача была сделать, а не задокументировать, и это нормальный ход событий на внедрении.

Идентификаторы не переименовываются. Код поля создаётся один раз и живёт навсегда, поэтому человеческое имя и системный код расходятся навсегда.

Тестового контура не было. Проверять было негде, поэтому проверяли на живом.

Что с этим делать

  1. Инвентаризация полей

    Выгружаем все поля с кодами и подписываем, что в них лежит и кто читает.

  2. Инвентаризация настроек

    Роботы, правила, права, интеграции — с указанием, зачем каждое.

  3. Тестовый контур

    Отдельный портал, где прогоняем правку до продуктива.

Где ошибаются

Переименование не меняет код

Название поля можно сделать понятным, код останется прежним, и это нормально.

Документация устаревает быстрее портала

Единственный надёжный источник — сам портал и люди, которые им пользуются.

Миграция без ключей соответствия — потеря связей

Повторять её на новом переезде нельзя, лучше сразу строить сопоставление по внешним идентификаторам.

Что проверить у себя

Составьте карту того, что есть в портале, — без правок, только описание.

  • поля с кодами и назначением
  • роботы, правила и бизнес-процессы
  • интеграции и кто за них отвечает

Пока карты нет, каждая правка — разгадывание: непонятно, что сломается, если тронуть настройку.

Собрать такой порядок в портале можно в типовом внедрении — от одного процесса до запуска отдела продаж.