Перейти к содержанию

Шаблоны и каталог

🚧 Draft. Скелет по стандарту index.md §4 / _meta/_TEMPLATE.ru.md.

Два механизма переиспользования: Templates (3 уровня — workflow / chain / project, one-click clone из production с анонимизацией и переменными) и Workflow Definition Catalog (instance-wide publish/install — шов между developer и manager).

1. Что это и зачем

TODO — Module Library (connectors/tools/workflow_template/chain_template/project_template/policy_template — простой реестр без maturity lifecycle); 3 уровня шаблонов; Catalog + Install (latest-by-default, install collision → 409 + rename).

2. Роли и доступ

TODO — manage_templates (owner/admin); catalog:manage (publish/archive — admin/owner); catalog:install (manager+); engineer готовит content шаблонов в коде.

3. Где это в Console

TODO — раздел Templates (список, применить шаблон, настроить переменные/анонимизацию, auto-map коннекторов); раздел Catalog (instance-wide определения, Install в проект, версии).

4. Концепции (mental model)

TODO — module_catalog.config_schema (configure-time params для UI/валидации) vs content (сериализуемое тело модуля: connector defaults / tool spec / template body); auto-mapping required_connectors → реальные connector instances проекта по типу (один кандидат → авто; несколько → выбор; нет → «требуется подключить»); install vs template (instance-wide catalog vs project-level clone).

5. Флоу: пошаговые сценарии

TODO — «применить workflow template в проект»; «создать проект из project template»; «опубликовать определение в Catalog» (admin/owner); «установить из Catalog» (manager — catalog:install); «обновить установленное определение до новой версии».

6. Справочник опций

TODO — поля ModuleCatalogEntry; параметры анонимизации; переменные; collision policy.

7. Жизненный цикл и обслуживание

TODO — версии в Catalog; archive entry; что происходит с уже установленными при новой версии.

8. Траблшутинг

TODO — «install 409» → имя занято, rename; «auto-map не нашёл коннектор» → нет usable инстанса нужного типа (см. Connectors-Credentials §8); «анонимизация не убрала X» → правило не покрывает поле.

9. Ограничения и инварианты

TODO — секреты НЕ переносятся в шаблонах/clone (только references/placeholders); Catalog publish/install через CommandEnvelope + audit; шаблон не обходит publish-time валидацию определения.

10. Связанные мануалы и каноны