Заметки
Как не сломать приложение при обновлении портала
Чаще всего после обновления ломается место, где приложение опиралось на детали интерфейса портала: CSS-класс, внутренний объект или элемент DOM. Поддерживаемый REST-метод и случайно найденная функция в собранном JavaScript — разные по устойчивости зависимости.
Составьте короткий список таких связей в своём приложении. Для REST запишите используемые методы и поля; для встройки — код placement и параметры контекста; для коробочной части — классы и события модулей.
После обновления достаточно сначала пройти путь пользователя целиком: открыть приложение, прочитать карточку, выполнить изменение и увидеть результат. Если этот путь падает, уже есть конкретная точка для сравнения версий.
Собственный DOM-код лучше держать в одном адаптере, а не размазывать по приложению. Тогда изменение разметки портала потребует одной локальной правки.