Визуальный просмотрщик маршрутов (Kaoto)

Визуальный просмотрщик Camel DSL — встроенный в интерфейс Citeck редактор на базе Kaoto, который показывает Camel-маршрут в виде наглядной схемы (канвас) рядом с текстовым YAML. Формат маршрута и его исполнение в ecos-integrations не меняются — это тот же Camel YAML DSL, что и в текстовой форме.

Примечание

В текущей версии просмотрщик работает в режиме только чтение (read-only): редактирование выполняется в YAML, а канвас служит «живым превью». Полноценное визуальное редактирование (правка маршрута мышью на канвасе) выключено по умолчанию и включается отдельным флагом (см. ниже).

Как открыть

Просмотрщик открывается из журнала Camel DSL (раздел администрирования, рабочее пространство администратора) действием «Открыть в редакторе» над записью маршрута. Действие открывает страницу /v2/camel-dsl-editor?recordRef=<ссылка-на-маршрут> в новой вкладке Citeck.

Доступ к редактору соответствует существующей модели прав: запись маршрута читается и пишется через тот же источник integrations/camel-dsl и тот же Records API, что и текстовая форма; журнал доступен только участникам рабочего пространства администратора. Просмотрщик не предоставляет дополнительных прав.

Режимы отображения

В правом верхнем углу — переключатель режимов:

Визуальный — канвас на всю ширину (схема маршрута).
Сплит (режим по умолчанию) — слева канвас, справа YAML-редактор (Monaco).
YAML — только текстовый YAML-редактор.

В режиме только чтение по умолчанию открывается Сплит: вы правите маршрут в YAML, а схема слева перерисовывается автоматически (с небольшой задержкой) и отражает текущее содержимое.

Навигация «клик по схеме → строка YAML»

В режиме только чтение клик по узлу на канвасе подсвечивает соответствующую строку в YAML-редакторе и прокручивает к ней. Это помогает быстро находить место шага (from, to, choice и т. д.) в тексте маршрута. На канвасе отображается бейдж «просмотр (только чтение)».

Что недоступно в режиме только чтение

Поскольку канвас работает как превью, элементы визуального редактирования скрыты: верхний тулбар (New/Undo/Redo/Copy/Export), кнопка добавления шага «+», палитра компонентов (Open Catalog), контекстное меню узла, перетаскивание узлов и панель свойств. Доступны навигация по канвасу (масштаб, центрирование, авто-раскладка) и click-to-source. Все изменения маршрута вносятся в YAML.

Ограничения

Только чтение по умолчанию. Изменения вносятся через YAML; визуальная правка мышью выключена.
Откат к текстовой форме. Маршрут всегда можно отредактировать в стандартной форме записи Camel DSL (поле «Содержимое контекста», ACE-редактор) — она остаётся доступной и совместима по формату.
Размер бандла. Редактор подгружается лениво (~3–5 МБ) — при первом открытии возможна короткая загрузка.

Включение визуального редактирования

Полноценное визуальное редактирование (запись изменений с канваса обратно в YAML) управляется флагом ecos-config app/integrations$camel-visual-editing-enabled (тип BOOLEAN, по умолчанию false).

false (по умолчанию) — режим только чтение, описанный выше.
true — на канвасе становятся доступны палитра, добавление/перетаскивание шагов и панель свойств; изменения пишутся в YAML.

Флаг служит «выключателем» (kill-switch) и средством канареечной раскатки: его можно включить точечно на нужном стенде. Доведение режима визуального редактирования до продакшн-готовности ведётся отдельно.