@seafteam/seaf-archtool-core-plugin-suite 2026.29.0-rc-test.6
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/LICENSE +201 -0
- package/NOTICE +27 -0
- package/documentation/arch/aspects.yaml +81 -0
- package/documentation/arch/components/browser.yaml +51 -0
- package/documentation/arch/components/examples/context.yaml +37 -0
- package/documentation/arch/components/examples/order.yaml +92 -0
- package/documentation/arch/components/examples/payment.yaml +92 -0
- package/documentation/arch/components/examples/root.yaml +42 -0
- package/documentation/arch/components/front.yaml +309 -0
- package/documentation/arch/components/gitlab.yaml +81 -0
- package/documentation/arch/components/plantuml.yaml +57 -0
- package/documentation/arch/components/root.yaml +36 -0
- package/documentation/arch/components/user.yaml +41 -0
- package/documentation/arch/components/web.yaml +39 -0
- package/documentation/arch/contexts.yaml +99 -0
- package/documentation/arch/forms.yaml +36 -0
- package/documentation/arch/namespaces.yaml +43 -0
- package/documentation/arch/root.yaml +43 -0
- package/documentation/arch/rules.yaml +91 -0
- package/documentation/arch/technologies.yaml +84 -0
- package/documentation/dochub.yaml +32 -0
- package/documentation/docs/conception/archdistrib.puml +38 -0
- package/documentation/docs/conception/archeco.puml +11 -0
- package/documentation/docs/conception/archeco_proc.puml +29 -0
- package/documentation/docs/conception/archver.puml +24 -0
- package/documentation/docs/conception/facade.puml +20 -0
- package/documentation/docs/conception/introduction.md +144 -0
- package/documentation/docs/conception/mindmap.puml +55 -0
- package/documentation/docs/conception/root.yaml +66 -0
- package/documentation/docs/manual/aspects.md +37 -0
- package/documentation/docs/manual/backend/api.yaml +664 -0
- package/documentation/docs/manual/backend/search-implementation.md +190 -0
- package/documentation/docs/manual/backend/search.yaml +495 -0
- package/documentation/docs/manual/clickstream-setup.md +50 -0
- package/documentation/docs/manual/components.md +45 -0
- package/documentation/docs/manual/config/deployment.md +337 -0
- package/documentation/docs/manual/context_source.puml +17 -0
- package/documentation/docs/manual/contexts.md +200 -0
- package/documentation/docs/manual/datasets.md +120 -0
- package/documentation/docs/manual/docs/AI_TABLE_INTEGRATION.md +81 -0
- package/documentation/docs/manual/docs/asyncapi.md +63 -0
- package/documentation/docs/manual/docs/bpmn.md +122 -0
- package/documentation/docs/manual/docs/charts.md +371 -0
- package/documentation/docs/manual/docs/docs.md +76 -0
- package/documentation/docs/manual/docs/drawio_intro.md +397 -0
- package/documentation/docs/manual/docs/editable_table/menu.yaml +5 -0
- package/documentation/docs/manual/docs/editable_table/root.yaml +9 -0
- package/documentation/docs/manual/docs/editable_table/step_0_base/menu.yaml +6 -0
- package/documentation/docs/manual/docs/editable_table/step_0_base/root.yaml +3 -0
- package/documentation/docs/manual/docs/editable_table/step_0_base/table.yaml +396 -0
- package/documentation/docs/manual/docs/editable_table/step_0_base/template.md +404 -0
- package/documentation/docs/manual/docs/editable_table/step_1_acquaintance/menu.yaml +5 -0
- package/documentation/docs/manual/docs/editable_table/step_1_acquaintance/root.yaml +3 -0
- package/documentation/docs/manual/docs/editable_table/step_1_acquaintance/table.yaml +136 -0
- package/documentation/docs/manual/docs/editable_table/step_1_acquaintance/template.md +247 -0
- package/documentation/docs/manual/docs/editable_table/step_2_parameterization/data/pets.yaml +23 -0
- package/documentation/docs/manual/docs/editable_table/step_2_parameterization/data/root.yaml +2 -0
- package/documentation/docs/manual/docs/editable_table/step_2_parameterization/menu.yaml +34 -0
- package/documentation/docs/manual/docs/editable_table/step_2_parameterization/root.yaml +4 -0
- package/documentation/docs/manual/docs/editable_table/step_2_parameterization/table.yaml +36 -0
- package/documentation/docs/manual/docs/editable_table/step_2_parameterization/template_root.md +110 -0
- package/documentation/docs/manual/docs/editable_table/step_2_parameterization/template_table.md +3 -0
- package/documentation/docs/manual/docs/editable_table/step_3_headers/menu.yaml +6 -0
- package/documentation/docs/manual/docs/editable_table/step_3_headers/root.yaml +2 -0
- package/documentation/docs/manual/docs/editable_table/step_3_headers/template.md +300 -0
- package/documentation/docs/manual/docs/editable_table/step_4_editing/data/data.yaml +10 -0
- package/documentation/docs/manual/docs/editable_table/step_4_editing/data/root.yaml +2 -0
- package/documentation/docs/manual/docs/editable_table/step_4_editing/examples/auto_imports/data/data_column_1.yaml +3 -0
- package/documentation/docs/manual/docs/editable_table/step_4_editing/examples/auto_imports/data/root.yaml +2 -0
- package/documentation/docs/manual/docs/editable_table/step_4_editing/examples/auto_imports/menu.yaml +6 -0
- package/documentation/docs/manual/docs/editable_table/step_4_editing/examples/auto_imports/root.yaml +4 -0
- package/documentation/docs/manual/docs/editable_table/step_4_editing/examples/auto_imports/table.yaml +52 -0
- package/documentation/docs/manual/docs/editable_table/step_4_editing/examples/auto_imports/template.md +117 -0
- package/documentation/docs/manual/docs/editable_table/step_4_editing/examples/root.yaml +2 -0
- package/documentation/docs/manual/docs/editable_table/step_4_editing/menu.yaml +6 -0
- package/documentation/docs/manual/docs/editable_table/step_4_editing/root.yaml +5 -0
- package/documentation/docs/manual/docs/editable_table/step_4_editing/table.yaml +116 -0
- package/documentation/docs/manual/docs/editable_table/step_4_editing/template.md +231 -0
- package/documentation/docs/manual/docs/editable_table/step_5_styles/examples/base_example/data.yaml +30 -0
- package/documentation/docs/manual/docs/editable_table/step_5_styles/examples/base_example/menu.yaml +5 -0
- package/documentation/docs/manual/docs/editable_table/step_5_styles/examples/base_example/root.yaml +4 -0
- package/documentation/docs/manual/docs/editable_table/step_5_styles/examples/base_example/table.yaml +122 -0
- package/documentation/docs/manual/docs/editable_table/step_5_styles/examples/base_example/template.md +276 -0
- package/documentation/docs/manual/docs/editable_table/step_5_styles/examples/hiding_columns/data.yaml +11 -0
- package/documentation/docs/manual/docs/editable_table/step_5_styles/examples/hiding_columns/menu.yaml +5 -0
- package/documentation/docs/manual/docs/editable_table/step_5_styles/examples/hiding_columns/root.yaml +4 -0
- package/documentation/docs/manual/docs/editable_table/step_5_styles/examples/hiding_columns/table.yaml +40 -0
- package/documentation/docs/manual/docs/editable_table/step_5_styles/examples/hiding_columns/template.md +59 -0
- package/documentation/docs/manual/docs/editable_table/step_5_styles/examples/root.yaml +3 -0
- package/documentation/docs/manual/docs/editable_table/step_5_styles/menu.yaml +5 -0
- package/documentation/docs/manual/docs/editable_table/step_5_styles/root.yaml +4 -0
- package/documentation/docs/manual/docs/editable_table/step_5_styles/table.yaml +35 -0
- package/documentation/docs/manual/docs/editable_table/step_5_styles/template.md +142 -0
- package/documentation/docs/manual/docs/editable_table/step_6_errors/examples/data_errors/data.yaml +40 -0
- package/documentation/docs/manual/docs/editable_table/step_6_errors/examples/data_errors/menu.yaml +5 -0
- package/documentation/docs/manual/docs/editable_table/step_6_errors/examples/data_errors/root.yaml +4 -0
- package/documentation/docs/manual/docs/editable_table/step_6_errors/examples/data_errors/table.yaml +77 -0
- package/documentation/docs/manual/docs/editable_table/step_6_errors/examples/data_errors/template.md +146 -0
- package/documentation/docs/manual/docs/editable_table/step_6_errors/examples/root.yaml +2 -0
- package/documentation/docs/manual/docs/editable_table/step_6_errors/menu.yaml +5 -0
- package/documentation/docs/manual/docs/editable_table/step_6_errors/root.yaml +3 -0
- package/documentation/docs/manual/docs/editable_table/step_6_errors/template.md +3 -0
- package/documentation/docs/manual/docs/editable_table/template.md +24 -0
- package/documentation/docs/manual/docs/examples/asyncapi.yaml +77 -0
- package/documentation/docs/manual/docs/examples/asyncapi_template.json +11 -0
- package/documentation/docs/manual/docs/examples/autors.yaml +30 -0
- package/documentation/docs/manual/docs/examples/bpmn.xml +44 -0
- package/documentation/docs/manual/docs/examples/cat.jpg +0 -0
- package/documentation/docs/manual/docs/examples/charts-bar.yaml +61 -0
- package/documentation/docs/manual/docs/examples/charts-bubble.yaml +47 -0
- package/documentation/docs/manual/docs/examples/charts-doughnut.yaml +42 -0
- package/documentation/docs/manual/docs/examples/charts-line.yaml +55 -0
- package/documentation/docs/manual/docs/examples/charts-pie.yaml +37 -0
- package/documentation/docs/manual/docs/examples/charts-polararea.yaml +54 -0
- package/documentation/docs/manual/docs/examples/charts-radar.yaml +50 -0
- package/documentation/docs/manual/docs/examples/charts-scatter.yaml +48 -0
- package/documentation/docs/manual/docs/examples/charts.yaml +91 -0
- package/documentation/docs/manual/docs/examples/contexts.jsonata +8 -0
- package/documentation/docs/manual/docs/examples/date-picker-example.md +5 -0
- package/documentation/docs/manual/docs/examples/example.html +2 -0
- package/documentation/docs/manual/docs/examples/example.puml +17 -0
- package/documentation/docs/manual/docs/examples/example.yaml +53 -0
- package/documentation/docs/manual/docs/examples/ext-schema.yaml +3 -0
- package/documentation/docs/manual/docs/examples/inlinemeta.md +25 -0
- package/documentation/docs/manual/docs/examples/markaper.yaml +225 -0
- package/documentation/docs/manual/docs/examples/mermaid.mmd +32 -0
- package/documentation/docs/manual/docs/examples/openapi_template.json +16 -0
- package/documentation/docs/manual/docs/examples/pizza-collaboration.xml +383 -0
- package/documentation/docs/manual/docs/examples/sa-anim.yaml +209 -0
- package/documentation/docs/manual/docs/examples/sa-complex-hide-boundary.yaml +94 -0
- package/documentation/docs/manual/docs/examples/sa-complex-hide-leaves.yaml +94 -0
- package/documentation/docs/manual/docs/examples/sa-complex-hide-title.yaml +98 -0
- package/documentation/docs/manual/docs/examples/sa-complex.yaml +92 -0
- package/documentation/docs/manual/docs/examples/sa-gravity.yaml +104 -0
- package/documentation/docs/manual/docs/examples/sa-group.yaml +93 -0
- package/documentation/docs/manual/docs/examples/sa-physical-connection.yaml +79 -0
- package/documentation/docs/manual/docs/examples/sa-query.jsonata +74 -0
- package/documentation/docs/manual/docs/examples/sa-symbol.yaml +72 -0
- package/documentation/docs/manual/docs/examples/sa-through-objects.yaml +46 -0
- package/documentation/docs/manual/docs/examples/sa-without-tips.yaml +43 -0
- package/documentation/docs/manual/docs/examples/showcases.jsonata +5 -0
- package/documentation/docs/manual/docs/examples/smartants_.yaml +160 -0
- package/documentation/docs/manual/docs/examples/table.yaml +341 -0
- package/documentation/docs/manual/docs/examples/template.puml +6 -0
- package/documentation/docs/manual/docs/examples/test.jsonata +3 -0
- package/documentation/docs/manual/docs/examples/toc/2header.md +8 -0
- package/documentation/docs/manual/docs/examples/toc/custom-toc-place-dup.md +37 -0
- package/documentation/docs/manual/docs/examples/toc/custom-toc-place.md +35 -0
- package/documentation/docs/manual/docs/examples/toc/root.yaml +38 -0
- package/documentation/docs/manual/docs/examples/toc/test.md +160 -0
- package/documentation/docs/manual/docs/gigachat/agents/aigena/menu.yaml +5 -0
- package/documentation/docs/manual/docs/gigachat/agents/aigena/root.yaml +2 -0
- package/documentation/docs/manual/docs/gigachat/agents/aigena/template.md +25 -0
- package/documentation/docs/manual/docs/gigachat/agents/menu.yaml +5 -0
- package/documentation/docs/manual/docs/gigachat/agents/react/gigachat.yaml +59 -0
- package/documentation/docs/manual/docs/gigachat/agents/react/menu.yaml +5 -0
- package/documentation/docs/manual/docs/gigachat/agents/react/root.yaml +3 -0
- package/documentation/docs/manual/docs/gigachat/agents/react/template.md +138 -0
- package/documentation/docs/manual/docs/gigachat/agents/root.yaml +5 -0
- package/documentation/docs/manual/docs/gigachat/agents/simple/gigachat.yaml +14 -0
- package/documentation/docs/manual/docs/gigachat/agents/simple/menu.yaml +5 -0
- package/documentation/docs/manual/docs/gigachat/agents/simple/root.yaml +3 -0
- package/documentation/docs/manual/docs/gigachat/agents/simple/template.md +113 -0
- package/documentation/docs/manual/docs/gigachat/agents/template.md +62 -0
- package/documentation/docs/manual/docs/gigachat/menu.yaml +5 -0
- package/documentation/docs/manual/docs/gigachat/root.yaml +4 -0
- package/documentation/docs/manual/docs/gigachat/settings/menu.yaml +5 -0
- package/documentation/docs/manual/docs/gigachat/settings/root.yaml +2 -0
- package/documentation/docs/manual/docs/gigachat/settings/template.md +51 -0
- package/documentation/docs/manual/docs/gigachat/template.md +38 -0
- package/documentation/docs/manual/docs/images/cloud.png +0 -0
- package/documentation/docs/manual/docs/images/component.png +0 -0
- package/documentation/docs/manual/docs/images/system.png +0 -0
- package/documentation/docs/manual/docs/images/user.png +0 -0
- package/documentation/docs/manual/docs/markaper.md +278 -0
- package/documentation/docs/manual/docs/markdown.md +148 -0
- package/documentation/docs/manual/docs/mermaid.md +43 -0
- package/documentation/docs/manual/docs/network.md +117 -0
- package/documentation/docs/manual/docs/plantuml.md +28 -0
- package/documentation/docs/manual/docs/root.yaml +736 -0
- package/documentation/docs/manual/docs/seaf2drawio/examples/basic.yaml +13 -0
- package/documentation/docs/manual/docs/seaf2drawio/examples/diff.yaml +123 -0
- package/documentation/docs/manual/docs/seaf2drawio/examples/example_seaf_data.yaml +1689 -0
- package/documentation/docs/manual/docs/seaf2drawio/examples/root.yaml +5 -0
- package/documentation/docs/manual/docs/seaf2drawio/examples/templates.yaml +55 -0
- package/documentation/docs/manual/docs/seaf2drawio/examples/transformation.yaml +19 -0
- package/documentation/docs/manual/docs/seaf2drawio/object_description.md +35 -0
- package/documentation/docs/manual/docs/seaf2drawio/root.yaml +12 -0
- package/documentation/docs/manual/docs/seaf2drawio/seaf2drawio.md +118 -0
- package/documentation/docs/manual/docs/smartants.md +583 -0
- package/documentation/docs/manual/docs/svg_inline.md +66 -0
- package/documentation/docs/manual/docs/swagger.md +52 -0
- package/documentation/docs/manual/docs/tables.md +264 -0
- package/documentation/docs/manual/docs/templates/example.drawio +43 -0
- package/documentation/docs/manual/docs/templates/test.svg +79 -0
- package/documentation/docs/manual/docs/templates.md +361 -0
- package/documentation/docs/manual/docs/toc.md +137 -0
- package/documentation/docs/manual/entities/bstages.md +43 -0
- package/documentation/docs/manual/entities/bundle.md +105 -0
- package/documentation/docs/manual/entities/entities.md +727 -0
- package/documentation/docs/manual/entities/images/id_errors.png +0 -0
- package/documentation/docs/manual/entities/images/landspace.jpeg +0 -0
- package/documentation/docs/manual/entities/images/menu-single.jpeg +0 -0
- package/documentation/docs/manual/entities/images/menu-tree.jpeg +0 -0
- package/documentation/docs/manual/entities/images/object_select.png +0 -0
- package/documentation/docs/manual/entities/images/problems.png +0 -0
- package/documentation/docs/manual/entities/images/select_inter.png +0 -0
- package/documentation/docs/manual/entities/images/stages.jpg +0 -0
- package/documentation/docs/manual/entities/images/suggests.png +0 -0
- package/documentation/docs/manual/entities/intro.md +73 -0
- package/documentation/docs/manual/entities/rules.md +35 -0
- package/documentation/docs/manual/functions/example.yaml +50 -0
- package/documentation/docs/manual/functions/functions.md +51 -0
- package/documentation/docs/manual/functions/root.yaml +39 -0
- package/documentation/docs/manual/images/jbps1.1.png +0 -0
- package/documentation/docs/manual/images/jbps1.png +0 -0
- package/documentation/docs/manual/images/jbps2.png +0 -0
- package/documentation/docs/manual/images/vsc1.png +0 -0
- package/documentation/docs/manual/imports.md +59 -0
- package/documentation/docs/manual/introduction.md +38 -0
- package/documentation/docs/manual/jsonata.md +268 -0
- package/documentation/docs/manual/plugin-settings.md +134 -0
- package/documentation/docs/manual/plugins/interface.md +226 -0
- package/documentation/docs/manual/plugins/introduction.md +256 -0
- package/documentation/docs/manual/plugins/root.yaml +51 -0
- package/documentation/docs/manual/role-model.md +80 -0
- package/documentation/docs/manual/root-cluster-import.md +82 -0
- package/documentation/docs/manual/root.yaml +199 -0
- package/documentation/docs/manual/rules/exceptions.md +20 -0
- package/documentation/docs/manual/rules/exreason.md +3 -0
- package/documentation/docs/manual/rules/root.yaml +58 -0
- package/documentation/docs/manual/rules/rules.md +8 -0
- package/documentation/docs/manual/rules/standard.md +3 -0
- package/documentation/docs/manual/rules/validators.md +109 -0
- package/documentation/docs/manual/technologies.md +49 -0
- package/documentation/docs/root.yaml +32 -0
- package/documentation/docs/sequence.puml +48 -0
- package/documentation/docs/welcome.md +3 -0
- package/documentation/entities/extentions/entity.yaml +136 -0
- package/documentation/entities/extentions/templates/people.md +4 -0
- package/documentation/entities/interactions/entity.yaml +412 -0
- package/documentation/entities/interactions/templates/blank.puml +18 -0
- package/documentation/entities/interactions/templates/bpmn.xml +59 -0
- package/documentation/entities/interactions/templates/tree.puml +11 -0
- package/documentation/entities/root.yaml +33 -0
- package/documentation/root.yaml +37 -0
- package/metamodel/dochub/entities/aspects/base.yaml +73 -0
- package/metamodel/dochub/entities/aspects/blank.yaml +65 -0
- package/metamodel/dochub/entities/aspects/components.yaml +52 -0
- package/metamodel/dochub/entities/aspects/contexts.yaml +57 -0
- package/metamodel/dochub/entities/aspects/docs.yaml +51 -0
- package/metamodel/dochub/entities/aspects/hierarchy.yaml +80 -0
- package/metamodel/dochub/entities/aspects/root.yaml +9 -0
- package/metamodel/dochub/entities/aspects/summary.yaml +64 -0
- package/metamodel/dochub/entities/aspects/templates/components.md +5 -0
- package/metamodel/dochub/entities/aspects/templates/hierarchy.puml +5 -0
- package/metamodel/dochub/entities/aspects/templates/summary.md +9 -0
- package/metamodel/dochub/entities/aspects/templates/tree.puml +5 -0
- package/metamodel/dochub/entities/aspects/tree.yaml +37 -0
- package/metamodel/dochub/entities/components/base.yaml +97 -0
- package/metamodel/dochub/entities/components/blank.yaml +64 -0
- package/metamodel/dochub/entities/components/contexts.yaml +55 -0
- package/metamodel/dochub/entities/components/docs.yaml +50 -0
- package/metamodel/dochub/entities/components/hierarchy.yaml +84 -0
- package/metamodel/dochub/entities/components/index.yaml +17 -0
- package/metamodel/dochub/entities/components/root.yaml +8 -0
- package/metamodel/dochub/entities/components/summary.yaml +58 -0
- package/metamodel/dochub/entities/components/symbol.yaml +113 -0
- package/metamodel/dochub/entities/components/templates/hierarchy.puml +5 -0
- package/metamodel/dochub/entities/components/templates/summary.md +8 -0
- package/metamodel/dochub/entities/components/templates/tree.puml +5 -0
- package/metamodel/dochub/entities/components/tree.yaml +38 -0
- package/metamodel/dochub/entities/contexts/base.yaml +197 -0
- package/metamodel/dochub/entities/contexts/plantuml.yaml +241 -0
- package/metamodel/dochub/entities/contexts/root.yaml +5 -0
- package/metamodel/dochub/entities/contexts/smartants.yaml +177 -0
- package/metamodel/dochub/entities/contexts/templates/template.puml +183 -0
- package/metamodel/dochub/entities/contexts/templates/tree.puml +5 -0
- package/metamodel/dochub/entities/contexts/tree.yaml +39 -0
- package/metamodel/dochub/entities/documents/base.yaml +73 -0
- package/metamodel/dochub/entities/documents/blank.yaml +28 -0
- package/metamodel/dochub/entities/documents/root.yaml +3 -0
- package/metamodel/dochub/entities/root.yaml +5 -0
- package/metamodel/dochub/functions/root.yaml +2 -0
- package/metamodel/dochub/functions/tools.yaml +46 -0
- package/metamodel/dochub/root.yaml +24 -0
- package/metamodel/dochub/rules/root.yaml +2 -0
- package/metamodel/dochub/rules/validators.yaml +144 -0
- package/metamodel/dochub/samples/01_components.yaml +23 -0
- package/metamodel/dochub/samples/02_contexts.yaml +23 -0
- package/metamodel/dochub/samples/03_documents.yaml +10 -0
- package/metamodel/dochub/samples/root.yaml +4 -0
- package/metamodel/dochub/samples/test.puml +17 -0
- package/metamodel/dochub.yaml +5 -0
- package/metamodel/docs/welcome.md +39 -0
- package/metamodel/root.yaml +8 -0
- package/package.json +29 -0
- package/plugin.html +1961 -0
|
@@ -0,0 +1,583 @@
|
|
|
1
|
+
# SmartAnts
|
|
2
|
+
|
|
3
|
+
Это продвинутый инструмент презентации архитектуры. Он позволяет не только наглядно
|
|
4
|
+
визуализировать ландшафт, но и проигрывать анимационные сценарии, которые помогают широкому кругу
|
|
5
|
+
пользователей вникать в архитектурный замысел.
|
|
6
|
+
|
|
7
|
+
**ВНИМАНИЕ:** Это Beta версия. Она интенсивно развивается. В ее работе может возникать неоптимальность
|
|
8
|
+
построения ландшафта или прокладки маршрутов связей.
|
|
9
|
+
|
|
10
|
+
## Простейшее представление
|
|
11
|
+
|
|
12
|
+
```yaml
|
|
13
|
+
...
|
|
14
|
+
archtool.smartants.examples.simple:
|
|
15
|
+
location: SEAF.ArchTool/Руководство/Документы/Представления/01 Простой пример
|
|
16
|
+
autor: R.Piontik
|
|
17
|
+
type: smartants # Тип документа
|
|
18
|
+
source: # Задаем константные данные для генерации диаграммы
|
|
19
|
+
header: # Заголовок диаграммы
|
|
20
|
+
title: вторизация # Текст заголовка
|
|
21
|
+
style: # Стили заголовка
|
|
22
|
+
color: "#fbaaaa"
|
|
23
|
+
font-size: 22px
|
|
24
|
+
font-weight: 800
|
|
25
|
+
config: # Конфигурируем расположение элементов на диаграмме
|
|
26
|
+
distance: 120 # Дистанция между элементами
|
|
27
|
+
trackWidth: 24 # Ширина дорожек (треков)
|
|
28
|
+
nodes: # Определяем элементы диаграммы
|
|
29
|
+
system: # Идентификатор элемента. Определяем иерархию при отображении диаграммы
|
|
30
|
+
title: Система # Название компонента
|
|
31
|
+
symbol: system # Символ (примитив) которым будет представлен элемент на диаграмме
|
|
32
|
+
user:
|
|
33
|
+
title: Пользователь
|
|
34
|
+
symbol: user
|
|
35
|
+
links: # Связи между компонентами
|
|
36
|
+
- from: user # Откуда будет прокладываться маршрут
|
|
37
|
+
to: system # Куда
|
|
38
|
+
title: Логин и пароль # Описание маршрута
|
|
39
|
+
style: "->" # Направление маршрута <- / -> / <->
|
|
40
|
+
link: "/docs/dochub.swagger" # Ссылка перехода при клике на надпись
|
|
41
|
+
- from: system
|
|
42
|
+
to: user
|
|
43
|
+
title: JWT токен
|
|
44
|
+
style: "->"
|
|
45
|
+
link: "/docs/dochub.swagger"
|
|
46
|
+
...
|
|
47
|
+
```
|
|
48
|
+
Результат генерации:
|
|
49
|
+
|
|
50
|
+

|
|
51
|
+
|
|
52
|
+
Обратите внимание, что вы можете взаимодействовать в диаграммой. Мышкой кликните по любому элементу и вы увидите
|
|
53
|
+
как по дорожкам "побегут муравьи", которые наглядно продемонстрируют направления связей компонентов.
|
|
54
|
+
|
|
55
|
+
Клик по надписи дорожке приведет к переходу на связанный документ. URL может быть любым.
|
|
56
|
+
|
|
57
|
+
Слева вверху находится Toolbar, который предоставляет дополнительные функции по взаимодействию с диаграммой.
|
|
58
|
+
Например, воспользовавшись кнопкой "Экспорт в Excalidraw" вы можете выгрузить диаграмму в редактор [Excalidraw](https://excalidraw.com/)
|
|
59
|
+
для последующей дополнительной обработки с целью встраивания в презентацию, например, в PowerPoint.
|
|
60
|
+
|
|
61
|
+
Клик на кнопке "Свернуть связи в жгуты" приведет к упрощению диаграммы. Останется только одна связь, наглядно демонстрирующая о наличии
|
|
62
|
+
взаимодействия объектов, но скрывающая детали. Это очень удобно для анализа обширных ландшафтов с большим количеством связей.
|
|
63
|
+
|
|
64
|
+
Есть возможность указать цвет связей:
|
|
65
|
+
|
|
66
|
+
```yaml
|
|
67
|
+
...
|
|
68
|
+
archtool.smartants.examples.simple:
|
|
69
|
+
...
|
|
70
|
+
links: # Связи между компонентами
|
|
71
|
+
- from: user
|
|
72
|
+
to: system
|
|
73
|
+
title: Логин и пароль
|
|
74
|
+
style: "-[#ff0000]->" # Указывается цвет линии через RGB
|
|
75
|
+
link: "/docs/dochub.swagger"
|
|
76
|
+
- from: system
|
|
77
|
+
to: user
|
|
78
|
+
title: JWT токен
|
|
79
|
+
style: "-[#green]->" # Указывается цвет линии через alias
|
|
80
|
+
link: "/docs/dochub.swagger"
|
|
81
|
+
...
|
|
82
|
+
```
|
|
83
|
+
|
|
84
|
+
Результат:
|
|
85
|
+
|
|
86
|
+

|
|
87
|
+
|
|
88
|
+
## Отображение элементов с иерархией
|
|
89
|
+
|
|
90
|
+
Добавим на диаграмму домены. Пользователь будет помещаться во внешней среде, а система во внутренней.
|
|
91
|
+
|
|
92
|
+
```yaml
|
|
93
|
+
...
|
|
94
|
+
archtool.smartants.examples.domains:
|
|
95
|
+
location: SEAF.ArchTool/Руководство/Документы/SmartAnts/02 Зонирование диаграммы
|
|
96
|
+
autor: R.Piontik
|
|
97
|
+
type: smartants
|
|
98
|
+
source:
|
|
99
|
+
config:
|
|
100
|
+
distance: 120
|
|
101
|
+
trackWidth: 24
|
|
102
|
+
nodes:
|
|
103
|
+
inside: # Определим домены
|
|
104
|
+
title: Внутренняя среда
|
|
105
|
+
background: lightgreen # добавим фон области
|
|
106
|
+
opacity: 0.3 # и прозрачность фона
|
|
107
|
+
outside:
|
|
108
|
+
title: Внешняя среда
|
|
109
|
+
inside.system: # Добавим в идентификатор принадлежность к домену "inside"
|
|
110
|
+
title: Система
|
|
111
|
+
symbol: system
|
|
112
|
+
outside.user: # Аналогично для пользователя добавим домен "outside"
|
|
113
|
+
title: Пользователь
|
|
114
|
+
symbol: user
|
|
115
|
+
links:
|
|
116
|
+
- from: outside.user # Модифицируем идентификаторы в связях
|
|
117
|
+
to: inside.system
|
|
118
|
+
title: Логин и пароль
|
|
119
|
+
style: "->"
|
|
120
|
+
- from: inside.system
|
|
121
|
+
to: outside.user
|
|
122
|
+
title: JWT токен
|
|
123
|
+
style: "->"
|
|
124
|
+
...
|
|
125
|
+
```
|
|
126
|
+
|
|
127
|
+
В результате, система и пользователь будут помещены в области отображающие их принадлежность доменам.
|
|
128
|
+
|
|
129
|
+

|
|
130
|
+
|
|
131
|
+
|
|
132
|
+
## Интерактивное взаимодействия с диаграммой
|
|
133
|
+
|
|
134
|
+
Главной супер-силой "умных муравьев" является умение отвечать на вопрос: "Что здесь происходит?".
|
|
135
|
+
Для того, чтобы посмотреть на нее в деле, усложним диаграмму. В этот раз разместим данные для
|
|
136
|
+
построения диаграммы в [отдельном файле](https://gitverse.ru/seafteam/seaf-archtool-core/content/master/public/documentation/docs/manual/docs/examples/sa-complex.yaml).
|
|
137
|
+
|
|
138
|
+
```yaml
|
|
139
|
+
...
|
|
140
|
+
archtool.smartants.examples.complex:
|
|
141
|
+
location: SEAF.ArchTool/Руководство/Документы/SmartAnts/02 Сложная диаграмма
|
|
142
|
+
autor: R.Piontik
|
|
143
|
+
type: smartants
|
|
144
|
+
source: examples/sa-complex.yaml # Данные для диаграммы расположены в файле
|
|
145
|
+
...
|
|
146
|
+
```
|
|
147
|
+
|
|
148
|
+
Результат:
|
|
149
|
+

|
|
150
|
+
|
|
151
|
+
Диаграмма выглядит сложной. Для ее разъяснения кликните мышкой, например, на "API шлюз".
|
|
152
|
+
Будут подсвечен и анимирован весь его интеграционный ландшафт.
|
|
153
|
+
|
|
154
|
+
Удерживайте "SHIFT" и выбирайте другие объекты на диаграмме. Тем самым расширяя поле анализа.
|
|
155
|
+
|
|
156
|
+
## Управление заголовками областей и элементов
|
|
157
|
+
|
|
158
|
+
В диаграммах SmartAnts используются svg представление элементов.
|
|
159
|
+
Поэтому не всегда красиво и функционально использовать текстовые подписи для областей и элементов.
|
|
160
|
+
Для этого используются следующие настройки:
|
|
161
|
+
|
|
162
|
+
**hideBoundaryTitles** - выключить заголовки у областей:
|
|
163
|
+
```yaml
|
|
164
|
+
...
|
|
165
|
+
config:
|
|
166
|
+
distance: 80
|
|
167
|
+
trackWidth: 18
|
|
168
|
+
hideBoundaryTitles: true
|
|
169
|
+
...
|
|
170
|
+
```
|
|
171
|
+
|
|
172
|
+
Результат на примере сложной диаграммы:
|
|
173
|
+

|
|
174
|
+
|
|
175
|
+
**hideLeafTitles** - выключить заголовки у элементов:
|
|
176
|
+
```yaml
|
|
177
|
+
...
|
|
178
|
+
config:
|
|
179
|
+
distance: 80
|
|
180
|
+
trackWidth: 18
|
|
181
|
+
hideLeafTitles: true
|
|
182
|
+
...
|
|
183
|
+
```
|
|
184
|
+
|
|
185
|
+
Результат на примере сложной диаграммы:
|
|
186
|
+

|
|
187
|
+
|
|
188
|
+
**hideTitle** - индивидуально выключить заголовок у элемента или области:
|
|
189
|
+
Рамку для областей можно отключить параметром - **hideBorder**:
|
|
190
|
+
```yaml
|
|
191
|
+
...
|
|
192
|
+
# Внешняя среда
|
|
193
|
+
outside:
|
|
194
|
+
title: Внешняя среда
|
|
195
|
+
hideBorder: true
|
|
196
|
+
...
|
|
197
|
+
# Внутренняя среда
|
|
198
|
+
inside:
|
|
199
|
+
title: Внутренняя среда
|
|
200
|
+
hideTitle: true
|
|
201
|
+
...
|
|
202
|
+
inside.postgres: # База данных для хранения бизнес-данных
|
|
203
|
+
title: Основная БД
|
|
204
|
+
symbol: database
|
|
205
|
+
hideTitle: true
|
|
206
|
+
...
|
|
207
|
+
```
|
|
208
|
+
|
|
209
|
+
Результат на примере сложной диаграммы:
|
|
210
|
+

|
|
211
|
+
|
|
212
|
+
## Управление сеткой расположения элементов
|
|
213
|
+
|
|
214
|
+
По умолчанию элементы SmartAnts располагаются на холсте произвольно.
|
|
215
|
+
Благодаря конфигурации сетки и разметке элементов тегами можно управлять расположением объектов
|
|
216
|
+
Например:
|
|
217
|
+
|
|
218
|
+
```yaml
|
|
219
|
+
...
|
|
220
|
+
config:
|
|
221
|
+
grid:
|
|
222
|
+
- row:
|
|
223
|
+
- col: app
|
|
224
|
+
- col: user
|
|
225
|
+
- row:
|
|
226
|
+
- col: default
|
|
227
|
+
...
|
|
228
|
+
nodes:
|
|
229
|
+
# Первый уровень
|
|
230
|
+
third-level.second-level.first-level:
|
|
231
|
+
title: 1-ый уровень
|
|
232
|
+
tag: default
|
|
233
|
+
third-level.second-level.first-level.user:
|
|
234
|
+
title: Пользователь
|
|
235
|
+
symbol: user
|
|
236
|
+
third-level.second-level.first-level.application:
|
|
237
|
+
title: AndroidApp
|
|
238
|
+
symbol: system
|
|
239
|
+
tag: app
|
|
240
|
+
|
|
241
|
+
# Второй уровень
|
|
242
|
+
third-level.second-level:
|
|
243
|
+
title: 2-ой уровень
|
|
244
|
+
tag: user
|
|
245
|
+
...
|
|
246
|
+
```
|
|
247
|
+
Получаем такую схему:
|
|
248
|
+

|
|
249
|
+
|
|
250
|
+
## Анимированные сценарии
|
|
251
|
+
|
|
252
|
+
В некоторых случаях, для разъяснения смысла диаграммы, необходимо рассказать пользователю
|
|
253
|
+
историю о том, что на ней изображено. Это задачу решают анимированные сценарии.
|
|
254
|
+
|
|
255
|
+
Добавим к диаграмме сценарий ее разъяснения ([содержимое файла](https://gitverse.ru/seafteam/seaf-archtool-core/content/master/public/documentation/docs/manual/docs/examples/sa-anim.yaml?line=95)):
|
|
256
|
+
```yaml
|
|
257
|
+
...
|
|
258
|
+
# Анимация
|
|
259
|
+
animation:
|
|
260
|
+
# Здесь создаем именованные действия, которы будут доступны в сценариях
|
|
261
|
+
actions:
|
|
262
|
+
hello: # Идентификатор действия
|
|
263
|
+
- action: info # Информировать пользователя. Доступны: clean / info / focus-node / focus-neighbors
|
|
264
|
+
text: Давай я объясню как здесь все устроено # Текст, который будет выводиться пользователю
|
|
265
|
+
focus-user:
|
|
266
|
+
- action: focus-node # Установить фокус на объекте диаграммы
|
|
267
|
+
target: outside.user # RegEx выражение определяющее с какими идентификаторами будут выделены элементы диаграммы
|
|
268
|
+
- action: info # Одно действие может иметь пакет команд, которые будут выполнены последовательно
|
|
269
|
+
text: Это пользователь, которому мы предоставляем услугу
|
|
270
|
+
focus-frontend:
|
|
271
|
+
- action: focus-node
|
|
272
|
+
target: outside.application
|
|
273
|
+
- action: info
|
|
274
|
+
text: Для этого он использует приложение для Android
|
|
275
|
+
focus-apigateway:
|
|
276
|
+
- action: focus-node # Здесь просим выделить всех соседей
|
|
277
|
+
target: inside.apigateway # По маске
|
|
278
|
+
- action: info
|
|
279
|
+
text: Все запросы из приложений поступают в шлюз
|
|
280
|
+
focus-apigateway-neighbors:
|
|
281
|
+
- action: focus-neighbors # Подсвечиваем всех соседей
|
|
282
|
+
target: inside.apigateway # Шлюза
|
|
283
|
+
- action: info
|
|
284
|
+
text: Шлюз маршрутизирует запросы в нужные системы
|
|
285
|
+
focus-backend:
|
|
286
|
+
- action: focus-node
|
|
287
|
+
target: inside.backend
|
|
288
|
+
- action: info
|
|
289
|
+
text: Вся бизнес-логика реализуется здесь
|
|
290
|
+
focus-database:
|
|
291
|
+
- action: focus-node
|
|
292
|
+
target: inside.postgres
|
|
293
|
+
- action: info
|
|
294
|
+
text: В этой базе данных хранится вся бизнес-информация
|
|
295
|
+
focus-sso:
|
|
296
|
+
- action: focus-node
|
|
297
|
+
target: inside.sso
|
|
298
|
+
- action: info
|
|
299
|
+
text: Для авторизации используется отдельный сервис
|
|
300
|
+
focus-redis:
|
|
301
|
+
- action: focus-node
|
|
302
|
+
target: inside.redis
|
|
303
|
+
- action: info
|
|
304
|
+
text: Активные сессии пользователей хранятся в этой базе
|
|
305
|
+
bay:
|
|
306
|
+
- action: info
|
|
307
|
+
text: Теперь ты знаешь все.
|
|
308
|
+
clean:
|
|
309
|
+
- action: clean # Отчистить действия
|
|
310
|
+
target: ".*" # выполненные над всеми объектами на диаграмме
|
|
311
|
+
# Из заранее описанных действий создаются сценарии
|
|
312
|
+
scenarios:
|
|
313
|
+
case1: # Идентификатор сценария
|
|
314
|
+
title: Объясни мне, что здесь? # Название сценария для пользователя
|
|
315
|
+
steps: # Шаги
|
|
316
|
+
- action: hello # Идентификатор действия
|
|
317
|
+
delay: 2000 # Длительность шага в миллисекундах
|
|
318
|
+
voice: true # Признак голосовой подсказки. Переход на следующий шаг не происходит пока не будет завершен синтез речи
|
|
319
|
+
- action: focus-user
|
|
320
|
+
delay: 2000
|
|
321
|
+
voice: true
|
|
322
|
+
- action: clean
|
|
323
|
+
- action: focus-frontend
|
|
324
|
+
delay: 2000
|
|
325
|
+
voice: true
|
|
326
|
+
- action: clean
|
|
327
|
+
- action: focus-apigateway
|
|
328
|
+
delay: 2000
|
|
329
|
+
voice: true
|
|
330
|
+
- action: focus-apigateway-neighbors
|
|
331
|
+
delay: 2000
|
|
332
|
+
voice: true
|
|
333
|
+
- action: clean
|
|
334
|
+
- action: focus-backend
|
|
335
|
+
delay: 2000
|
|
336
|
+
voice: true
|
|
337
|
+
- action: clean
|
|
338
|
+
- action: focus-database
|
|
339
|
+
delay: 2000
|
|
340
|
+
voice: true
|
|
341
|
+
- action: clean
|
|
342
|
+
- action: focus-sso
|
|
343
|
+
delay: 2000
|
|
344
|
+
voice: true
|
|
345
|
+
- action: clean
|
|
346
|
+
- action: focus-redis
|
|
347
|
+
delay: 2000
|
|
348
|
+
voice: true
|
|
349
|
+
- action: clean
|
|
350
|
+
- action: bay
|
|
351
|
+
delay: 2000
|
|
352
|
+
voice: true
|
|
353
|
+
...
|
|
354
|
+
```
|
|
355
|
+
|
|
356
|
+

|
|
357
|
+
|
|
358
|
+
Слева вверху диаграммы теперь есть выпадающий список со сценариями. Выберите нужный и нажмите кнопку "Play".
|
|
359
|
+
|
|
360
|
+
## Кастомные символы
|
|
361
|
+
|
|
362
|
+
В базовом наборе есть ограниченное количество символов:
|
|
363
|
+
|
|
364
|
+
| User | cloud | system | component |
|
|
365
|
+
|--------------------------|----------------------------|------------------------------| -----------------------------------|
|
|
366
|
+
|  |  |  |  |
|
|
367
|
+
|
|
368
|
+
Но при необходимости его можно без труда расширить.
|
|
369
|
+
|
|
370
|
+
```yaml
|
|
371
|
+
# Здесь определяются кастомные символы
|
|
372
|
+
symbols:
|
|
373
|
+
cat: > # Идентификатор символа
|
|
374
|
+
<g xmlns="http://www.w3.org/2000/svg">
|
|
375
|
+
...
|
|
376
|
+
здесь код SVG
|
|
377
|
+
...
|
|
378
|
+
</g>
|
|
379
|
+
nodes:
|
|
380
|
+
my-symbol:
|
|
381
|
+
title: Мой символ
|
|
382
|
+
symbol: cat
|
|
383
|
+
```
|
|
384
|
+
Исходник файла [здесь](https://gitverse.ru/seafteam/seaf-archtool-core/content/master/public/documentation/docs/manual/docs/examples/sa-symbol.yaml?line=32). Результат:
|
|
385
|
+
|
|
386
|
+

|
|
387
|
+
|
|
388
|
+
|
|
389
|
+
В Интернет есть масса каталогов SVG изображений, которыми вы можете воспользоваться для создания собственных символов.
|
|
390
|
+
Например [этот](https://freesvg.org/). Для адаптации изображений (размеров и т.п.) также существуют [сервисы](https://www.iloveimg.com/).
|
|
391
|
+
|
|
392
|
+
|
|
393
|
+
## Генерация диаграмм из данных
|
|
394
|
+
|
|
395
|
+
Еще одной супер-силой "умных муравьев" является способность автоматически генерировать диаграммы из данных архитектуры.
|
|
396
|
+
|
|
397
|
+
```yaml
|
|
398
|
+
...
|
|
399
|
+
archtool.smartants.examples.simple-query:
|
|
400
|
+
location: SEAF.ArchTool/Руководство/Документы/SmartAnts/06 Простой запрос к данным
|
|
401
|
+
autor: R.Piontik
|
|
402
|
+
type: smartants
|
|
403
|
+
source: >
|
|
404
|
+
(
|
|
405
|
+
/* Определяем фильтр для компонентов архитектуры */
|
|
406
|
+
$matcher := /^[a-zA-Z]*\.[a-zA-Z]*$/i;
|
|
407
|
+
/* Генерируем структуру для диаграммы */
|
|
408
|
+
{
|
|
409
|
+
/* Формируем ноды из компонентов */
|
|
410
|
+
"nodes": $merge(components.$spread().(
|
|
411
|
+
/* Получаем идентификатор компонента */
|
|
412
|
+
$id := $keys()[0];
|
|
413
|
+
/* Если идентификатор компонента удовлетворяет фильтру, создаем ноду */
|
|
414
|
+
$matcher($id) ? {
|
|
415
|
+
/* Отсекаем домен верхнего уровня для исключения отображения компонентов в иерархии */
|
|
416
|
+
$split($id, ".")[1]: {
|
|
417
|
+
"title": *.title,
|
|
418
|
+
/* Преобразуем entity компонентов в понятные диаграмме символы actor -> user */
|
|
419
|
+
"symbol": *.entity = "actor" ? "user" : *.entity
|
|
420
|
+
}
|
|
421
|
+
}
|
|
422
|
+
|
|
423
|
+
))
|
|
424
|
+
}
|
|
425
|
+
)
|
|
426
|
+
...
|
|
427
|
+
```
|
|
428
|
+
|
|
429
|
+

|
|
430
|
+
|
|
431
|
+
В результате, мы получили сильно упрощенный аналог диаграммы [L1](/architect/contexts/archtool).
|
|
432
|
+
А также на диаграмме есть ошибка. Они возникает из-за того, что компонент "Документы" не имеет символа.
|
|
433
|
+
|
|
434
|
+
Следующий запрос устраняет эту проблему ([исходник](https://gitverse.ru/seafteam/seaf-archtool-core/content/master/public/documentation/docs/manual/docs/examples/sa-query.jsonata)):
|
|
435
|
+
```json
|
|
436
|
+
(
|
|
437
|
+
/* Определяем константы */
|
|
438
|
+
$rowHeight := 18;
|
|
439
|
+
$fontHeight := 16;
|
|
440
|
+
$fontWidth := 10;
|
|
441
|
+
$padding := 8;
|
|
442
|
+
/* Определяем фильтр для компонентов архитектуры */
|
|
443
|
+
$matcher := /^[a-zA-Z]*\.[a-zA-Z]*$/i;
|
|
444
|
+
/* Сохраняем ссылку на корень манифеста */
|
|
445
|
+
$manifest := $;
|
|
446
|
+
/* Готовим список нод */
|
|
447
|
+
$nodes := $merge(components.$spread().(
|
|
448
|
+
$id := $split($keys()[0], ".")[1];
|
|
449
|
+
$matcher($keys()[0]) ? {
|
|
450
|
+
$id: {
|
|
451
|
+
"title": *.title,
|
|
452
|
+
/* Для каждого элемента будет свой символ кроме "actor" */
|
|
453
|
+
"symbol":
|
|
454
|
+
*.entity = "actor" ? "user"
|
|
455
|
+
: *.aspects ? "symbol-" & $id : "component",
|
|
456
|
+
/* Получаем список аспектов */
|
|
457
|
+
"aspects": *.aspects.(
|
|
458
|
+
$aspect := $lookup($manifest.aspects, $);
|
|
459
|
+
{
|
|
460
|
+
"title": $aspect.title,
|
|
461
|
+
"id": $
|
|
462
|
+
}
|
|
463
|
+
),
|
|
464
|
+
/* Получаем список связей */
|
|
465
|
+
"links": *.links[$matcher(id)].{
|
|
466
|
+
|
|
467
|
+
"from": $id,
|
|
468
|
+
"to": $split(id, ".")[1],
|
|
469
|
+
"style": direction,
|
|
470
|
+
"title": title
|
|
471
|
+
}
|
|
472
|
+
}
|
|
473
|
+
}
|
|
474
|
+
));
|
|
475
|
+
/* Готовим символы */
|
|
476
|
+
$symbols := $merge($nodes.$spread().(
|
|
477
|
+
$id := "symbol-" & $keys()[0];
|
|
478
|
+
/* Определяем количество аспектов для вычисления высоты символа */
|
|
479
|
+
$aspectCount := $count(*.aspects);
|
|
480
|
+
/* Определяем максимальную длину текста для вычисления ширины символа */
|
|
481
|
+
$maxTitle := $max(*.aspects.($length($.title)));
|
|
482
|
+
/* Вычисляем размеры символа */
|
|
483
|
+
$width := $maxTitle ? $maxTitle * $fontWidth + $padding * 2 : 64; /* Умножаем на ширину символа */
|
|
484
|
+
$height := ($aspectCount + 1) * $rowHeight + $padding * 2; /* Умножаем на высоту строки */
|
|
485
|
+
{
|
|
486
|
+
$id: /* Генерируем символ */
|
|
487
|
+
"<g>"
|
|
488
|
+
/* Создаем контейнер */
|
|
489
|
+
& "<rect width=" & $width & " height=" & $height & " fill=\"#eee\" stroke=\"#222\" rx=3 />"
|
|
490
|
+
/* Заполняем аспектами */
|
|
491
|
+
& $join($map(*.aspects, function($v, $i) {
|
|
492
|
+
"<a href=\"/architect/aspects/" & $v.id & "\" >"
|
|
493
|
+
& "<text x=6 y=" & ($i * $rowHeight + $padding + $rowHeight) & " style=\"font-size:" & $fontHeight & "\" fill=\"blue\">" & $v.title & "</text>"
|
|
494
|
+
& "</a>"
|
|
495
|
+
}))
|
|
496
|
+
& "</g>"
|
|
497
|
+
}
|
|
498
|
+
));
|
|
499
|
+
{
|
|
500
|
+
"config": {
|
|
501
|
+
"distance": 130,
|
|
502
|
+
"trackWidth": 24,
|
|
503
|
+
"lineWidthLimit": 2 # Лимит толщиный жгута
|
|
504
|
+
},
|
|
505
|
+
"symbols": $symbols,
|
|
506
|
+
"nodes": $nodes,
|
|
507
|
+
"links": $nodes.*.links
|
|
508
|
+
}
|
|
509
|
+
)
|
|
510
|
+
```
|
|
511
|
+
|
|
512
|
+

|
|
513
|
+
|
|
514
|
+
|
|
515
|
+
## Физическая связь двух объектов (не интеграция)
|
|
516
|
+
|
|
517
|
+
Для отображения физического соединения двух объектов, например, брандмауэра и коммутатора/роутера используем вид связи "точка-точка". Через него также могут идти интеграционные потоки, но само по себе физическое соединение интеграцией не является.
|
|
518
|
+
|
|
519
|
+
```yaml
|
|
520
|
+
...
|
|
521
|
+
links:
|
|
522
|
+
...
|
|
523
|
+
- from: switch
|
|
524
|
+
to: firewall
|
|
525
|
+
style: "*-*" # Варианты использования *- / *-> / *-*
|
|
526
|
+
- from: firewall
|
|
527
|
+
to: router
|
|
528
|
+
style: "*-*"
|
|
529
|
+
- from: router
|
|
530
|
+
to: balancer
|
|
531
|
+
style: "-"
|
|
532
|
+
...
|
|
533
|
+
```
|
|
534
|
+
|
|
535
|
+
Результат генерации:
|
|
536
|
+
|
|
537
|
+

|
|
538
|
+
|
|
539
|
+
## Интеграция через несколько объектов
|
|
540
|
+
|
|
541
|
+
В случае, если есть необходимость показать связь начального и конечного объектов схемы без детализации на проходящих между ними цепочках интеграций, используем пунктирную линию. Например, связь между пользователем и БД.
|
|
542
|
+
|
|
543
|
+
```yaml
|
|
544
|
+
...
|
|
545
|
+
links:
|
|
546
|
+
- from: user
|
|
547
|
+
to: sso
|
|
548
|
+
style: "-"
|
|
549
|
+
- from: sso
|
|
550
|
+
to: apigateway
|
|
551
|
+
style: "-"
|
|
552
|
+
...
|
|
553
|
+
- from: apigateway
|
|
554
|
+
to: database
|
|
555
|
+
style: "..>" # Варианты использования .. / ..> / <..> / *.. / *..> / *..* / *..>
|
|
556
|
+
...
|
|
557
|
+
```
|
|
558
|
+
|
|
559
|
+
Результат генерации:
|
|
560
|
+
|
|
561
|
+

|
|
562
|
+
|
|
563
|
+
## Обоюдотупые стрелки (без наконечников)
|
|
564
|
+
|
|
565
|
+
Для обозначения связей между объектами, когда известно о наличии связи, но нет информации о ее направлении/зависимости.
|
|
566
|
+
|
|
567
|
+
```yaml
|
|
568
|
+
...
|
|
569
|
+
links:
|
|
570
|
+
- from: user
|
|
571
|
+
to: system1
|
|
572
|
+
style: "-" # Варианты использования - / --
|
|
573
|
+
...
|
|
574
|
+
- from: system3
|
|
575
|
+
to: database
|
|
576
|
+
style: "-"
|
|
577
|
+
...
|
|
578
|
+
```
|
|
579
|
+
|
|
580
|
+
Результат генерации:
|
|
581
|
+
|
|
582
|
+

|
|
583
|
+
|
|
@@ -0,0 +1,66 @@
|
|
|
1
|
+
# Шаблонизация SVG файлов
|
|
2
|
+
|
|
3
|
+
|
|
4
|
+
Оригинальный шаблон:
|
|
5
|
+

|
|
6
|
+
|
|
7
|
+
Результат применения данных к шаблону:
|
|
8
|
+
```yaml
|
|
9
|
+
docs:
|
|
10
|
+
dochub.plugins.svg_file:
|
|
11
|
+
title: Проверка svg
|
|
12
|
+
type: svg
|
|
13
|
+
location: SEAF.ArchTool/Руководство/Документы/SVG/Пример svg
|
|
14
|
+
template: templates/test.svg
|
|
15
|
+
source: >
|
|
16
|
+
(
|
|
17
|
+
{
|
|
18
|
+
"component1": "Название компонента 1",
|
|
19
|
+
"line1_text1": "Текст для стрелки"
|
|
20
|
+
}
|
|
21
|
+
)
|
|
22
|
+
```
|
|
23
|
+
|
|
24
|
+
Результат:
|
|
25
|
+
```
|
|
26
|
+

|
|
27
|
+
```
|
|
28
|
+
|
|
29
|
+

|
|
30
|
+
|
|
31
|
+
|
|
32
|
+
# Проверка заполнения параметров в шаблоне
|
|
33
|
+
|
|
34
|
+
Есть возможность проверять корректность заполнения шаблона. Например:
|
|
35
|
+
|
|
36
|
+
```yaml
|
|
37
|
+
dochub.plugins.svg_file_error:
|
|
38
|
+
title: Проверка svg
|
|
39
|
+
type: svg
|
|
40
|
+
template: templates/test.svg
|
|
41
|
+
source: >
|
|
42
|
+
(
|
|
43
|
+
{
|
|
44
|
+
"component1": "Название компонента 1",
|
|
45
|
+
"component2": "Название компонента 2"
|
|
46
|
+
}
|
|
47
|
+
)
|
|
48
|
+
```
|
|
49
|
+
|
|
50
|
+
В примере намеренно допущены ошибки:
|
|
51
|
+
1. Указан несуществующий в шаблоне параметр "component2";
|
|
52
|
+
2. Не указан необходимый параметр "line1_text1".
|
|
53
|
+
|
|
54
|
+
|
|
55
|
+
Для выполнения проверки указывается специальный параметр check=1.
|
|
56
|
+
|
|
57
|
+
```
|
|
58
|
+

|
|
59
|
+
```
|
|
60
|
+
|
|
61
|
+
В результате будет список не найденных параметров в самом шаблоне и в запросе:
|
|
62
|
+
|
|
63
|
+

|
|
64
|
+
|
|
65
|
+
|
|
66
|
+
|