Добавлен прототип примера Widgets

Author: rpiontik

dochub.yaml

@@ -1,6 +1,7 @@
 imports:
-  # Пример создания метамодели для описания в нотации C4 Model
-  - src/C4Model/dochub.yaml
+# Пример создания метамодели для описания в нотации C4 Model
+#  - src/C4Model/dochub.yaml
+# Пример создания метамодели для описания в нотации C4 Model
 #  - src/validator_example/dochub.yaml
 #  - src/business_entity_management/dochub.yaml
 #  - src/sequences_entity_example/dochub.yaml

src/widgets/README.md

@@ -0,0 +1,39 @@
+# Пример встраивания виджетов в предстваления стандартных сущностей 
+
+**Цель примера:** Познакомить с возможностями расширения представлений 
+стандартных сущностей.
+
+# Суть примера
+В примере демонстрируется возможность по расширению стандартных сущностей. 
+Создаются виджеты, которые встраиваются в представления Aspects и Component.
+
+Результат рендеринга описанной архитектуры уровня L2:
+
+![L2](./images/l2.png)
+
+Сгенерированное представление уровня L1:
+
+![L2](./images/l1.png)
+
+## Файловая структура примера
+* components - данные архитектуры для рендеринга
+  * components.yaml - компоненты уровня L2
+  * root.yaml - корневой манифест данных архитектуры
+* contexts - архитектурные контакты;
+  * l1.yaml - манифест контекста уровня L1
+  * l2.yaml - манифест контекста уровня L2
+  * root.yaml - корневой манифест контекстов
+* images - картинки для настоящей документации
+* dochub.yaml - корневой манифест примера
+
+## Использование
+В меню плагина DocHub выберите пункты "L1" или "L2"
+
+![Меню](./images/menu.png)
+
+Вносите изменения в данные архитектуры в файлах каталога [components/](./components). 
+Наблюдайте изменения в рендеринге плагина DocHub.
+
+## Задания для практики
+* Добавьте определения направления связей между компонентами L1 уровня;
+* Реализуйте дрилдаун компонентов L1 в L2.

src/widgets/aspects.yaml

@@ -0,0 +1,20 @@
+# Описываем акрхитектурные компоненты
+components:
+  user:
+    entity: actor
+    title: Пользователь
+    links:
+      - id: frontend
+  frontend:
+    entity: component
+    title: Приложение
+    links:
+      - id: backend
+  backend:
+    entity: Бэкенд
+    title: Сервер приложения
+    links:
+      - id: database
+  database:
+    entity: database
+    title: База данных

src/widgets/components.yaml

@@ -0,0 +1,7 @@
+imports:
+  # Подключаем расширения сущностей
+  - entities/root.yaml
+  # Подключаем компоненты
+  - components.yaml
+  # Подключаем аспекты
+  - aspects.yaml

src/widgets/dochub.yaml

@@ -0,0 +1,4 @@
+# Подключаем расширения сущностей
+imports:
+  - aspects.yaml
+  - components.yaml