Визуальный просмотрщик маршрутов (Kaoto) ======================================== **Визуальный просмотрщик Camel DSL** — встроенный в интерфейс Citeck редактор на базе `Kaoto `_, который показывает Camel-маршрут в виде наглядной схемы (канвас) рядом с текстовым YAML. Формат маршрута и его исполнение в ``ecos-integrations`` не меняются — это тот же Camel YAML DSL, что и в текстовой форме. .. note:: В текущей версии просмотрщик работает в режиме **только чтение** (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) и средством канареечной раскатки: его можно включить точечно на нужном стенде. Доведение режима визуального редактирования до продакшн-готовности ведётся отдельно.