@seafteam/seaf-archtool-core-plugin-suite 2026.29.0-rc.1

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.
Files changed (298) hide show
  1. package/LICENSE +201 -0
  2. package/NOTICE +27 -0
  3. package/documentation/arch/aspects.yaml +81 -0
  4. package/documentation/arch/components/browser.yaml +51 -0
  5. package/documentation/arch/components/examples/context.yaml +37 -0
  6. package/documentation/arch/components/examples/order.yaml +92 -0
  7. package/documentation/arch/components/examples/payment.yaml +92 -0
  8. package/documentation/arch/components/examples/root.yaml +42 -0
  9. package/documentation/arch/components/front.yaml +309 -0
  10. package/documentation/arch/components/gitlab.yaml +81 -0
  11. package/documentation/arch/components/plantuml.yaml +57 -0
  12. package/documentation/arch/components/root.yaml +36 -0
  13. package/documentation/arch/components/user.yaml +41 -0
  14. package/documentation/arch/components/web.yaml +39 -0
  15. package/documentation/arch/contexts.yaml +99 -0
  16. package/documentation/arch/forms.yaml +36 -0
  17. package/documentation/arch/namespaces.yaml +43 -0
  18. package/documentation/arch/root.yaml +43 -0
  19. package/documentation/arch/rules.yaml +91 -0
  20. package/documentation/arch/technologies.yaml +84 -0
  21. package/documentation/dochub.yaml +32 -0
  22. package/documentation/docs/conception/archdistrib.puml +38 -0
  23. package/documentation/docs/conception/archeco.puml +11 -0
  24. package/documentation/docs/conception/archeco_proc.puml +29 -0
  25. package/documentation/docs/conception/archver.puml +24 -0
  26. package/documentation/docs/conception/facade.puml +20 -0
  27. package/documentation/docs/conception/introduction.md +144 -0
  28. package/documentation/docs/conception/mindmap.puml +55 -0
  29. package/documentation/docs/conception/root.yaml +66 -0
  30. package/documentation/docs/manual/aspects.md +37 -0
  31. package/documentation/docs/manual/backend/api.yaml +664 -0
  32. package/documentation/docs/manual/backend/search-implementation.md +190 -0
  33. package/documentation/docs/manual/backend/search.yaml +495 -0
  34. package/documentation/docs/manual/clickstream-setup.md +50 -0
  35. package/documentation/docs/manual/components.md +45 -0
  36. package/documentation/docs/manual/config/deployment.md +337 -0
  37. package/documentation/docs/manual/context_source.puml +17 -0
  38. package/documentation/docs/manual/contexts.md +200 -0
  39. package/documentation/docs/manual/datasets.md +120 -0
  40. package/documentation/docs/manual/docs/AI_TABLE_INTEGRATION.md +81 -0
  41. package/documentation/docs/manual/docs/asyncapi.md +63 -0
  42. package/documentation/docs/manual/docs/bpmn.md +122 -0
  43. package/documentation/docs/manual/docs/charts.md +371 -0
  44. package/documentation/docs/manual/docs/docs.md +76 -0
  45. package/documentation/docs/manual/docs/drawio_intro.md +397 -0
  46. package/documentation/docs/manual/docs/editable_table/menu.yaml +5 -0
  47. package/documentation/docs/manual/docs/editable_table/root.yaml +9 -0
  48. package/documentation/docs/manual/docs/editable_table/step_0_base/menu.yaml +6 -0
  49. package/documentation/docs/manual/docs/editable_table/step_0_base/root.yaml +3 -0
  50. package/documentation/docs/manual/docs/editable_table/step_0_base/table.yaml +396 -0
  51. package/documentation/docs/manual/docs/editable_table/step_0_base/template.md +404 -0
  52. package/documentation/docs/manual/docs/editable_table/step_1_acquaintance/menu.yaml +5 -0
  53. package/documentation/docs/manual/docs/editable_table/step_1_acquaintance/root.yaml +3 -0
  54. package/documentation/docs/manual/docs/editable_table/step_1_acquaintance/table.yaml +136 -0
  55. package/documentation/docs/manual/docs/editable_table/step_1_acquaintance/template.md +247 -0
  56. package/documentation/docs/manual/docs/editable_table/step_2_parameterization/data/pets.yaml +23 -0
  57. package/documentation/docs/manual/docs/editable_table/step_2_parameterization/data/root.yaml +2 -0
  58. package/documentation/docs/manual/docs/editable_table/step_2_parameterization/menu.yaml +34 -0
  59. package/documentation/docs/manual/docs/editable_table/step_2_parameterization/root.yaml +4 -0
  60. package/documentation/docs/manual/docs/editable_table/step_2_parameterization/table.yaml +36 -0
  61. package/documentation/docs/manual/docs/editable_table/step_2_parameterization/template_root.md +110 -0
  62. package/documentation/docs/manual/docs/editable_table/step_2_parameterization/template_table.md +3 -0
  63. package/documentation/docs/manual/docs/editable_table/step_3_headers/menu.yaml +6 -0
  64. package/documentation/docs/manual/docs/editable_table/step_3_headers/root.yaml +2 -0
  65. package/documentation/docs/manual/docs/editable_table/step_3_headers/template.md +300 -0
  66. package/documentation/docs/manual/docs/editable_table/step_4_editing/data/data.yaml +10 -0
  67. package/documentation/docs/manual/docs/editable_table/step_4_editing/data/root.yaml +2 -0
  68. package/documentation/docs/manual/docs/editable_table/step_4_editing/examples/auto_imports/data/data_column_1.yaml +3 -0
  69. package/documentation/docs/manual/docs/editable_table/step_4_editing/examples/auto_imports/data/root.yaml +2 -0
  70. package/documentation/docs/manual/docs/editable_table/step_4_editing/examples/auto_imports/menu.yaml +6 -0
  71. package/documentation/docs/manual/docs/editable_table/step_4_editing/examples/auto_imports/root.yaml +4 -0
  72. package/documentation/docs/manual/docs/editable_table/step_4_editing/examples/auto_imports/table.yaml +52 -0
  73. package/documentation/docs/manual/docs/editable_table/step_4_editing/examples/auto_imports/template.md +117 -0
  74. package/documentation/docs/manual/docs/editable_table/step_4_editing/examples/root.yaml +2 -0
  75. package/documentation/docs/manual/docs/editable_table/step_4_editing/menu.yaml +6 -0
  76. package/documentation/docs/manual/docs/editable_table/step_4_editing/root.yaml +5 -0
  77. package/documentation/docs/manual/docs/editable_table/step_4_editing/table.yaml +116 -0
  78. package/documentation/docs/manual/docs/editable_table/step_4_editing/template.md +231 -0
  79. package/documentation/docs/manual/docs/editable_table/step_5_styles/examples/base_example/data.yaml +30 -0
  80. package/documentation/docs/manual/docs/editable_table/step_5_styles/examples/base_example/menu.yaml +5 -0
  81. package/documentation/docs/manual/docs/editable_table/step_5_styles/examples/base_example/root.yaml +4 -0
  82. package/documentation/docs/manual/docs/editable_table/step_5_styles/examples/base_example/table.yaml +122 -0
  83. package/documentation/docs/manual/docs/editable_table/step_5_styles/examples/base_example/template.md +276 -0
  84. package/documentation/docs/manual/docs/editable_table/step_5_styles/examples/hiding_columns/data.yaml +11 -0
  85. package/documentation/docs/manual/docs/editable_table/step_5_styles/examples/hiding_columns/menu.yaml +5 -0
  86. package/documentation/docs/manual/docs/editable_table/step_5_styles/examples/hiding_columns/root.yaml +4 -0
  87. package/documentation/docs/manual/docs/editable_table/step_5_styles/examples/hiding_columns/table.yaml +40 -0
  88. package/documentation/docs/manual/docs/editable_table/step_5_styles/examples/hiding_columns/template.md +59 -0
  89. package/documentation/docs/manual/docs/editable_table/step_5_styles/examples/root.yaml +3 -0
  90. package/documentation/docs/manual/docs/editable_table/step_5_styles/menu.yaml +5 -0
  91. package/documentation/docs/manual/docs/editable_table/step_5_styles/root.yaml +4 -0
  92. package/documentation/docs/manual/docs/editable_table/step_5_styles/table.yaml +35 -0
  93. package/documentation/docs/manual/docs/editable_table/step_5_styles/template.md +142 -0
  94. package/documentation/docs/manual/docs/editable_table/step_6_errors/examples/data_errors/data.yaml +40 -0
  95. package/documentation/docs/manual/docs/editable_table/step_6_errors/examples/data_errors/menu.yaml +5 -0
  96. package/documentation/docs/manual/docs/editable_table/step_6_errors/examples/data_errors/root.yaml +4 -0
  97. package/documentation/docs/manual/docs/editable_table/step_6_errors/examples/data_errors/table.yaml +77 -0
  98. package/documentation/docs/manual/docs/editable_table/step_6_errors/examples/data_errors/template.md +146 -0
  99. package/documentation/docs/manual/docs/editable_table/step_6_errors/examples/root.yaml +2 -0
  100. package/documentation/docs/manual/docs/editable_table/step_6_errors/menu.yaml +5 -0
  101. package/documentation/docs/manual/docs/editable_table/step_6_errors/root.yaml +3 -0
  102. package/documentation/docs/manual/docs/editable_table/step_6_errors/template.md +3 -0
  103. package/documentation/docs/manual/docs/editable_table/template.md +24 -0
  104. package/documentation/docs/manual/docs/examples/asyncapi.yaml +77 -0
  105. package/documentation/docs/manual/docs/examples/asyncapi_template.json +11 -0
  106. package/documentation/docs/manual/docs/examples/autors.yaml +30 -0
  107. package/documentation/docs/manual/docs/examples/bpmn.xml +44 -0
  108. package/documentation/docs/manual/docs/examples/cat.jpg +0 -0
  109. package/documentation/docs/manual/docs/examples/charts-bar.yaml +61 -0
  110. package/documentation/docs/manual/docs/examples/charts-bubble.yaml +47 -0
  111. package/documentation/docs/manual/docs/examples/charts-doughnut.yaml +42 -0
  112. package/documentation/docs/manual/docs/examples/charts-line.yaml +55 -0
  113. package/documentation/docs/manual/docs/examples/charts-pie.yaml +37 -0
  114. package/documentation/docs/manual/docs/examples/charts-polararea.yaml +54 -0
  115. package/documentation/docs/manual/docs/examples/charts-radar.yaml +50 -0
  116. package/documentation/docs/manual/docs/examples/charts-scatter.yaml +48 -0
  117. package/documentation/docs/manual/docs/examples/charts.yaml +91 -0
  118. package/documentation/docs/manual/docs/examples/contexts.jsonata +8 -0
  119. package/documentation/docs/manual/docs/examples/date-picker-example.md +5 -0
  120. package/documentation/docs/manual/docs/examples/example.html +2 -0
  121. package/documentation/docs/manual/docs/examples/example.puml +17 -0
  122. package/documentation/docs/manual/docs/examples/example.yaml +53 -0
  123. package/documentation/docs/manual/docs/examples/ext-schema.yaml +3 -0
  124. package/documentation/docs/manual/docs/examples/inlinemeta.md +25 -0
  125. package/documentation/docs/manual/docs/examples/markaper.yaml +225 -0
  126. package/documentation/docs/manual/docs/examples/mermaid.mmd +32 -0
  127. package/documentation/docs/manual/docs/examples/openapi_template.json +16 -0
  128. package/documentation/docs/manual/docs/examples/pizza-collaboration.xml +383 -0
  129. package/documentation/docs/manual/docs/examples/sa-anim.yaml +209 -0
  130. package/documentation/docs/manual/docs/examples/sa-complex-hide-boundary.yaml +94 -0
  131. package/documentation/docs/manual/docs/examples/sa-complex-hide-leaves.yaml +94 -0
  132. package/documentation/docs/manual/docs/examples/sa-complex-hide-title.yaml +98 -0
  133. package/documentation/docs/manual/docs/examples/sa-complex.yaml +92 -0
  134. package/documentation/docs/manual/docs/examples/sa-gravity.yaml +104 -0
  135. package/documentation/docs/manual/docs/examples/sa-group.yaml +93 -0
  136. package/documentation/docs/manual/docs/examples/sa-physical-connection.yaml +79 -0
  137. package/documentation/docs/manual/docs/examples/sa-query.jsonata +74 -0
  138. package/documentation/docs/manual/docs/examples/sa-symbol.yaml +72 -0
  139. package/documentation/docs/manual/docs/examples/sa-through-objects.yaml +46 -0
  140. package/documentation/docs/manual/docs/examples/sa-without-tips.yaml +43 -0
  141. package/documentation/docs/manual/docs/examples/showcases.jsonata +5 -0
  142. package/documentation/docs/manual/docs/examples/smartants_.yaml +160 -0
  143. package/documentation/docs/manual/docs/examples/table.yaml +341 -0
  144. package/documentation/docs/manual/docs/examples/template.puml +6 -0
  145. package/documentation/docs/manual/docs/examples/test.jsonata +3 -0
  146. package/documentation/docs/manual/docs/examples/toc/2header.md +8 -0
  147. package/documentation/docs/manual/docs/examples/toc/custom-toc-place-dup.md +37 -0
  148. package/documentation/docs/manual/docs/examples/toc/custom-toc-place.md +35 -0
  149. package/documentation/docs/manual/docs/examples/toc/root.yaml +38 -0
  150. package/documentation/docs/manual/docs/examples/toc/test.md +160 -0
  151. package/documentation/docs/manual/docs/gigachat/agents/aigena/menu.yaml +5 -0
  152. package/documentation/docs/manual/docs/gigachat/agents/aigena/root.yaml +2 -0
  153. package/documentation/docs/manual/docs/gigachat/agents/aigena/template.md +25 -0
  154. package/documentation/docs/manual/docs/gigachat/agents/menu.yaml +5 -0
  155. package/documentation/docs/manual/docs/gigachat/agents/react/gigachat.yaml +59 -0
  156. package/documentation/docs/manual/docs/gigachat/agents/react/menu.yaml +5 -0
  157. package/documentation/docs/manual/docs/gigachat/agents/react/root.yaml +3 -0
  158. package/documentation/docs/manual/docs/gigachat/agents/react/template.md +138 -0
  159. package/documentation/docs/manual/docs/gigachat/agents/root.yaml +5 -0
  160. package/documentation/docs/manual/docs/gigachat/agents/simple/gigachat.yaml +14 -0
  161. package/documentation/docs/manual/docs/gigachat/agents/simple/menu.yaml +5 -0
  162. package/documentation/docs/manual/docs/gigachat/agents/simple/root.yaml +3 -0
  163. package/documentation/docs/manual/docs/gigachat/agents/simple/template.md +113 -0
  164. package/documentation/docs/manual/docs/gigachat/agents/template.md +62 -0
  165. package/documentation/docs/manual/docs/gigachat/menu.yaml +5 -0
  166. package/documentation/docs/manual/docs/gigachat/root.yaml +4 -0
  167. package/documentation/docs/manual/docs/gigachat/settings/menu.yaml +5 -0
  168. package/documentation/docs/manual/docs/gigachat/settings/root.yaml +2 -0
  169. package/documentation/docs/manual/docs/gigachat/settings/template.md +51 -0
  170. package/documentation/docs/manual/docs/gigachat/template.md +38 -0
  171. package/documentation/docs/manual/docs/images/cloud.png +0 -0
  172. package/documentation/docs/manual/docs/images/component.png +0 -0
  173. package/documentation/docs/manual/docs/images/system.png +0 -0
  174. package/documentation/docs/manual/docs/images/user.png +0 -0
  175. package/documentation/docs/manual/docs/markaper.md +278 -0
  176. package/documentation/docs/manual/docs/markdown.md +148 -0
  177. package/documentation/docs/manual/docs/mermaid.md +43 -0
  178. package/documentation/docs/manual/docs/network.md +117 -0
  179. package/documentation/docs/manual/docs/plantuml.md +28 -0
  180. package/documentation/docs/manual/docs/root.yaml +736 -0
  181. package/documentation/docs/manual/docs/seaf2drawio/examples/basic.yaml +13 -0
  182. package/documentation/docs/manual/docs/seaf2drawio/examples/diff.yaml +123 -0
  183. package/documentation/docs/manual/docs/seaf2drawio/examples/example_seaf_data.yaml +1689 -0
  184. package/documentation/docs/manual/docs/seaf2drawio/examples/root.yaml +5 -0
  185. package/documentation/docs/manual/docs/seaf2drawio/examples/templates.yaml +55 -0
  186. package/documentation/docs/manual/docs/seaf2drawio/examples/transformation.yaml +19 -0
  187. package/documentation/docs/manual/docs/seaf2drawio/object_description.md +35 -0
  188. package/documentation/docs/manual/docs/seaf2drawio/root.yaml +12 -0
  189. package/documentation/docs/manual/docs/seaf2drawio/seaf2drawio.md +118 -0
  190. package/documentation/docs/manual/docs/smartants.md +583 -0
  191. package/documentation/docs/manual/docs/svg_inline.md +66 -0
  192. package/documentation/docs/manual/docs/swagger.md +52 -0
  193. package/documentation/docs/manual/docs/tables.md +264 -0
  194. package/documentation/docs/manual/docs/templates/example.drawio +43 -0
  195. package/documentation/docs/manual/docs/templates/test.svg +79 -0
  196. package/documentation/docs/manual/docs/templates.md +361 -0
  197. package/documentation/docs/manual/docs/toc.md +137 -0
  198. package/documentation/docs/manual/entities/bstages.md +43 -0
  199. package/documentation/docs/manual/entities/bundle.md +105 -0
  200. package/documentation/docs/manual/entities/entities.md +727 -0
  201. package/documentation/docs/manual/entities/images/id_errors.png +0 -0
  202. package/documentation/docs/manual/entities/images/landspace.jpeg +0 -0
  203. package/documentation/docs/manual/entities/images/menu-single.jpeg +0 -0
  204. package/documentation/docs/manual/entities/images/menu-tree.jpeg +0 -0
  205. package/documentation/docs/manual/entities/images/object_select.png +0 -0
  206. package/documentation/docs/manual/entities/images/problems.png +0 -0
  207. package/documentation/docs/manual/entities/images/select_inter.png +0 -0
  208. package/documentation/docs/manual/entities/images/stages.jpg +0 -0
  209. package/documentation/docs/manual/entities/images/suggests.png +0 -0
  210. package/documentation/docs/manual/entities/intro.md +73 -0
  211. package/documentation/docs/manual/entities/rules.md +35 -0
  212. package/documentation/docs/manual/functions/example.yaml +50 -0
  213. package/documentation/docs/manual/functions/functions.md +51 -0
  214. package/documentation/docs/manual/functions/root.yaml +39 -0
  215. package/documentation/docs/manual/images/jbps1.1.png +0 -0
  216. package/documentation/docs/manual/images/jbps1.png +0 -0
  217. package/documentation/docs/manual/images/jbps2.png +0 -0
  218. package/documentation/docs/manual/images/vsc1.png +0 -0
  219. package/documentation/docs/manual/imports.md +59 -0
  220. package/documentation/docs/manual/introduction.md +38 -0
  221. package/documentation/docs/manual/jsonata.md +268 -0
  222. package/documentation/docs/manual/plugin-settings.md +134 -0
  223. package/documentation/docs/manual/plugins/interface.md +226 -0
  224. package/documentation/docs/manual/plugins/introduction.md +256 -0
  225. package/documentation/docs/manual/plugins/root.yaml +51 -0
  226. package/documentation/docs/manual/role-model.md +80 -0
  227. package/documentation/docs/manual/root-cluster-import.md +82 -0
  228. package/documentation/docs/manual/root.yaml +199 -0
  229. package/documentation/docs/manual/rules/exceptions.md +20 -0
  230. package/documentation/docs/manual/rules/exreason.md +3 -0
  231. package/documentation/docs/manual/rules/root.yaml +58 -0
  232. package/documentation/docs/manual/rules/rules.md +8 -0
  233. package/documentation/docs/manual/rules/standard.md +3 -0
  234. package/documentation/docs/manual/rules/validators.md +109 -0
  235. package/documentation/docs/manual/technologies.md +49 -0
  236. package/documentation/docs/root.yaml +32 -0
  237. package/documentation/docs/sequence.puml +48 -0
  238. package/documentation/docs/welcome.md +3 -0
  239. package/documentation/entities/extentions/entity.yaml +136 -0
  240. package/documentation/entities/extentions/templates/people.md +4 -0
  241. package/documentation/entities/interactions/entity.yaml +412 -0
  242. package/documentation/entities/interactions/templates/blank.puml +18 -0
  243. package/documentation/entities/interactions/templates/bpmn.xml +59 -0
  244. package/documentation/entities/interactions/templates/tree.puml +11 -0
  245. package/documentation/entities/root.yaml +33 -0
  246. package/documentation/root.yaml +37 -0
  247. package/metamodel/dochub/entities/aspects/base.yaml +73 -0
  248. package/metamodel/dochub/entities/aspects/blank.yaml +65 -0
  249. package/metamodel/dochub/entities/aspects/components.yaml +52 -0
  250. package/metamodel/dochub/entities/aspects/contexts.yaml +57 -0
  251. package/metamodel/dochub/entities/aspects/docs.yaml +51 -0
  252. package/metamodel/dochub/entities/aspects/hierarchy.yaml +80 -0
  253. package/metamodel/dochub/entities/aspects/root.yaml +9 -0
  254. package/metamodel/dochub/entities/aspects/summary.yaml +64 -0
  255. package/metamodel/dochub/entities/aspects/templates/components.md +5 -0
  256. package/metamodel/dochub/entities/aspects/templates/hierarchy.puml +5 -0
  257. package/metamodel/dochub/entities/aspects/templates/summary.md +9 -0
  258. package/metamodel/dochub/entities/aspects/templates/tree.puml +5 -0
  259. package/metamodel/dochub/entities/aspects/tree.yaml +37 -0
  260. package/metamodel/dochub/entities/components/base.yaml +97 -0
  261. package/metamodel/dochub/entities/components/blank.yaml +64 -0
  262. package/metamodel/dochub/entities/components/contexts.yaml +55 -0
  263. package/metamodel/dochub/entities/components/docs.yaml +50 -0
  264. package/metamodel/dochub/entities/components/hierarchy.yaml +84 -0
  265. package/metamodel/dochub/entities/components/index.yaml +17 -0
  266. package/metamodel/dochub/entities/components/root.yaml +8 -0
  267. package/metamodel/dochub/entities/components/summary.yaml +58 -0
  268. package/metamodel/dochub/entities/components/symbol.yaml +113 -0
  269. package/metamodel/dochub/entities/components/templates/hierarchy.puml +5 -0
  270. package/metamodel/dochub/entities/components/templates/summary.md +8 -0
  271. package/metamodel/dochub/entities/components/templates/tree.puml +5 -0
  272. package/metamodel/dochub/entities/components/tree.yaml +38 -0
  273. package/metamodel/dochub/entities/contexts/base.yaml +197 -0
  274. package/metamodel/dochub/entities/contexts/plantuml.yaml +241 -0
  275. package/metamodel/dochub/entities/contexts/root.yaml +5 -0
  276. package/metamodel/dochub/entities/contexts/smartants.yaml +177 -0
  277. package/metamodel/dochub/entities/contexts/templates/template.puml +183 -0
  278. package/metamodel/dochub/entities/contexts/templates/tree.puml +5 -0
  279. package/metamodel/dochub/entities/contexts/tree.yaml +39 -0
  280. package/metamodel/dochub/entities/documents/base.yaml +73 -0
  281. package/metamodel/dochub/entities/documents/blank.yaml +28 -0
  282. package/metamodel/dochub/entities/documents/root.yaml +3 -0
  283. package/metamodel/dochub/entities/root.yaml +5 -0
  284. package/metamodel/dochub/functions/root.yaml +2 -0
  285. package/metamodel/dochub/functions/tools.yaml +46 -0
  286. package/metamodel/dochub/root.yaml +24 -0
  287. package/metamodel/dochub/rules/root.yaml +2 -0
  288. package/metamodel/dochub/rules/validators.yaml +144 -0
  289. package/metamodel/dochub/samples/01_components.yaml +23 -0
  290. package/metamodel/dochub/samples/02_contexts.yaml +23 -0
  291. package/metamodel/dochub/samples/03_documents.yaml +10 -0
  292. package/metamodel/dochub/samples/root.yaml +4 -0
  293. package/metamodel/dochub/samples/test.puml +17 -0
  294. package/metamodel/dochub.yaml +5 -0
  295. package/metamodel/docs/welcome.md +39 -0
  296. package/metamodel/root.yaml +8 -0
  297. package/package.json +28 -0
  298. package/plugin.html +1963 -0
@@ -0,0 +1,190 @@
1
+ # Реализация поиска SEAF.ArchTool
2
+
3
+ Документ описывает реализацию трёхшагового поиска объектов в хранилище архитектуры SEAF.ArchTool: backend API, frontend компоненты, конфигурация и особенности работы.
4
+
5
+ ## Обзор архитектуры
6
+
7
+ Поиск реализован как трёхшаговая последовательность:
8
+
9
+ 1. **Шаг 1** — выбор сущности для поиска (или «Все» для полнотекстового поиска).
10
+ 2. **Шаг 2** — получение полей для фильтрации выбранной сущности.
11
+ 3. **Шаг 3** — выполнение поиска с фильтрами и получение результатов.
12
+
13
+ ```
14
+ ┌─────────────────┐ GET /searchable-entities ┌─────────────────┐
15
+ │ │ ───────────────────────► │ Список │
16
+ │ Frontend │ │ сущностей │
17
+ │ Search.vue │ ◄─────────────────────── │ (entities) │
18
+ └────────┬────────┘ └─────────────────┘
19
+ │
20
+ │ GET /entity-filters?choice=...
21
+ ▼
22
+ ┌─────────────────────┐ GET /rel-suggestions ┌─────────────────┐
23
+ │ FilterInput.vue │ ◄─────────────────── │ Поля фильтров │
24
+ │ (rel → autocomplete)│ │ (FilterField) │
25
+ └─────────┬───────────┘ └─────────────────┘
26
+ │
27
+ │ POST /search-run { choice, filters, searchQuery? }
28
+ ▼
29
+ ┌─────────────────┐ ┌─────────────────────┐
30
+ │ Результаты │ ◄─────────────────── │ Найденные │
31
+ │ v-data-table │ │ объекты (≤10 000) │
32
+ └─────────────────┘ └─────────────────────┘
33
+ ```
34
+
35
+ ## Конфигурация
36
+
37
+ ### Манифест плагина (seaf.yaml)
38
+
39
+ В корневом манифесте плагина можно ограничить список сущностей, по которым выполняется поиск:
40
+
41
+ ```yaml
42
+ search:
43
+ entities:
44
+ - id: kadzo.v2023.application.systems
45
+ - id: kadzo.v2023.integrations
46
+ dataset: kadzo.v2023.integrations
47
+ ```
48
+
49
+ - `id` — идентификатор сущности (обязателен).
50
+ - `dataset` — опциональный идентификатор датасета из `manifest.datasets`. Если не задан, данные берутся из озера (`manifest[id]`).
51
+ - Если `search.entities` не задан — используются все сущности с `schema`, `title` и данными в озере.
52
+ - Если задан — поиск выполняется только по указанным сущностям.
53
+
54
+ ### Данные в датасетах
55
+
56
+ Если для сущности указан `dataset`, объекты загружаются через драйвер датасетов (`releaseData`). Результат датасета **зеркалирует структуру озера**:
57
+
58
+ ```yaml
59
+ kadzo.v2023.application.systems:
60
+ ecogroup.system1:
61
+ title: ...
62
+ ecogroup.system2:
63
+ title: ...
64
+ ```
65
+
66
+ Поиск использует срез `datasetResult[id]` — тот же формат, что `manifest[id]` при хранении в озере.
67
+
68
+ Схемы сущностей (`manifest.entities[id].schema`) по-прежнему читаются из озера.
69
+
70
+ ### Модули загрузки данных
71
+
72
+ - **`search-config.mjs`** — парсинг `search.entities`, определение источника данных.
73
+ - **`search-data.mjs`** — `SearchDataProvider` с кэшем; `extractEntityObjects(source, entityId)` извлекает map объектов из озера или датасета.
74
+
75
+ ## Backend
76
+
77
+ ### Контроллер
78
+
79
+ **Файл:** `src/backend/controllers/search.mjs`
80
+
81
+ Регистрирует маршруты:
82
+
83
+ | Метод | Путь | Описание |
84
+ |-------|------|----------|
85
+ | GET | `/seaf-core/api/core/storage/search/searchable-entities` | Список сущностей для поиска |
86
+ | GET | `/seaf-core/api/core/storage/search/entity-filters` | Поля для фильтрации сущности |
87
+ | GET | `/seaf-core/api/core/storage/search/rel-suggestions` | Подсказки для полей типа rel |
88
+ | POST | `/seaf-core/api/core/storage/search/search-run` | Выполнение поиска |
89
+
90
+ ### Основные функции
91
+
92
+ - **`getSearchableEntities(manifest)`** — список сущностей для поиска с учётом `search.entities` (озеро или датасет).
93
+ - **`SearchDataProvider`** — загрузка данных сущности из озера или датасета с кэшированием.
94
+ - **`extractEntityObjects(source, entityId)`** — извлечение map объектов из озера/датасета.
95
+ - **`collectRelFields(fullSchema, choice, manifest)`** — поля-ссылки (`$ref` на `#/$rels/`) в схеме сущности.
96
+ - **`filterValue(params)`** — проверка объекта по массиву фильтров (логика AND).
97
+ - **`resolveRefTitles(manifest, relTarget, ids, entityDataMap?)`** — получение названий связанных объектов для фильтрации по rel (с учётом предзагруженных данных датасетов).
98
+ - **`buildSearchResultItem(...)`** — формирование элемента результата с полями `_sfa_key`, `_sfa_entity`, `company`, `title`, `description`, `card`.
99
+
100
+ ### Логика фильтрации
101
+
102
+ - Все фильтры объединяются по **AND**.
103
+ - Поддерживаемые операторы: `eq`, `gt`, `gte`, `lt`, `lte`, `contains`, `startsWith`, `endsWith`, `in`, `between`, `exists`.
104
+ - Для полей-ссылок (rel): поиск по title и aliases связанных объектов; операторы `contains`, `eq`, `startsWith`, `endsWith`, `exists`.
105
+ - Флаг `ignoreCase` — регистронезависимый поиск для строк.
106
+ - Флаг `not` — инвертирование условия.
107
+ - Лимит результатов: **10 000** (`SEARCH_RESULT_LIMIT`).
108
+
109
+ ### Режим «Все» (choice=__all__)
110
+
111
+ При `choice: '__all__'`:
112
+
113
+ - Фильтры не применяются (массив `filters` пустой).
114
+ - Используется `searchQuery` — слова ищутся в `title` и `description` объектов.
115
+ - Поиск выполняется по всем поисковым сущностям.
116
+
117
+ ## Frontend
118
+
119
+ ### Компоненты
120
+
121
+ **Search.vue** (`src/frontend/components/Search/Search.vue`)
122
+
123
+ - Загрузка сущностей (`/searchable-entities`).
124
+ - `SearchDataProvider` в non-backend режиме — загрузка датасетов через `datasets().releaseData()`.
125
+ - Переключатель сущностей (chips).
126
+ - Строка поиска (`searchQuery`).
127
+ - Панель фильтров (правая колонка).
128
+ - Таблица результатов (`v-data-table`).
129
+ - Построение массива фильтров: `buildFiltersArray()` — маппинг значений из `filters` в объекты `{ field, operator, value, ignoreCase }`.
130
+
131
+ **FilterInput.vue** (`src/frontend/components/Search/FilterInput.vue`)
132
+
133
+ - Один компонент на каждое поле фильтра.
134
+ - Типы полей и соответствующие элементы:
135
+ - `string` — `v-text-field`
136
+ - `number`, `integer` — `v-text-field` с `type="number"`
137
+ - `enum` — `v-select` по `enumValues`
138
+ - `rel` — `v-text-field` с автодополнением (`/rel-suggestions`)
139
+ - Для rel: debounce 300 мс при вводе, запрос подсказок по `relTarget` и `query`.
140
+
141
+ ### Последовательность вызовов
142
+
143
+ 1. При монтировании: `loadEntities()` → GET `/searchable-entities`.
144
+ 2. При выборе сущности (кроме «Все»): `loadFilterFields(choice)` → GET `/entity-filters?choice=...`.
145
+ 3. При вводе в поле типа rel: debounce → GET `/rel-suggestions?relTarget=...&query=...` (данные rel-сущности из озера или датасета по конфигу).
146
+ 4. При поиске (кнопка «Найти» или Enter): `performSearch()` → POST `/search-run` с `{ choice, filters, searchQuery }`.
147
+
148
+ ### Маппинг операторов (Search.vue)
149
+
150
+ | Тип поля | Оператор | Примечание |
151
+ |----------|----------|------------|
152
+ | string | `contains` | `ignoreCase: true` |
153
+ | rel | `contains` | `ignoreCase: true` |
154
+ | number, integer | `eq` | `value` приводится к Number |
155
+ | enum | `eq` | Значение как есть |
156
+
157
+ Текстовый запрос (`searchQuery`) при выборе конкретной сущности: первый строковый/enum-поле (title/name/label) — `contains` по `searchQuery`.
158
+
159
+ ## Схема сущности и поля для поиска
160
+
161
+ Поля для фильтрации извлекаются из JSON Schema сущности:
162
+
163
+ - **string, number, integer** — свойства с `type`.
164
+ - **enum** — свойства с `enum` (без `type` или с `type: string`).
165
+ - **rel** — свойства со ссылками `$ref: "#/$rels/entityId.subjectId"` (включая вложенные через `$defs`, `items`).
166
+
167
+ Для rel формат `relTarget` — `entityId.subjectId` (например, `kadzo.v2023.groups.groups`).
168
+
169
+ ## API спецификация
170
+
171
+ Полное описание эндпоинтов, схем запросов/ответов и примеров см. в:
172
+
173
+ - [Search API (OpenAPI)](/entities/docs/blank?dh-doc-id=archtool.backend.search)
174
+
175
+ ## Результаты поиска
176
+
177
+ Каждый элемент результата содержит:
178
+
179
+ | Поле | Описание |
180
+ |--------------|----------------------------------------|
181
+ | `_sfa_key` | Уникальный ключ объекта |
182
+ | `_sfa_entity`| Идентификатор сущности |
183
+ | `company` | Название организации (если есть) |
184
+ | `entityTitle`| Название типа сущности |
185
+ | `title` | Заголовок объекта |
186
+ | `description`| Описание |
187
+ | `card` | URL карточки (если есть presentation) |
188
+ | `...value` | Все остальные поля объекта |
189
+
190
+ Колонка «Компания» отображается в таблице, если `hasCompanies === true` в ответе `/first`.
@@ -0,0 +1,495 @@
1
+ openapi: 3.0.0
2
+ info:
3
+ title: Search Service API
4
+ version: 1.0.0
5
+ description: |
6
+ API трёхшагового поиска объектов в хранилище архитектуры SEAF.ArchTool.
7
+ Поиск состоит из: (1) выбор сущности, (2) получение полей для фильтрации, (3) выполнение поиска с фильтрами.
8
+
9
+ Реализация (backend, frontend, конфигурация): см. документ «Реализация поиска».
10
+
11
+ ## Особенности
12
+ * Все фильтры объединяются по логике **AND** (объект должен удовлетворять всем условиям)
13
+ * Поддержка различных типов данных (строки, числа, булевы значения, массивы)
14
+ * Поддержка полей-ссылок (rel) — фильтрация по названиям связанных сущностей
15
+ * Возможность отрицания условий через флаг `not`
16
+ * Регистронезависимый поиск для строковых операций
17
+
18
+ servers:
19
+ - url: http://localhost:3030
20
+ description: Локальный сервер SEAF.ArchTool
21
+ - url: https://{URL}
22
+ description: Production
23
+ variables:
24
+ URL:
25
+ default: localhost:3030
26
+
27
+ paths:
28
+ /seaf-core/api/core/storage/search/searchable-entities:
29
+ get:
30
+ summary: Получить список доступных сущностей для поиска
31
+ description: |
32
+ Первый шаг поиска. Возвращает список сущностей, по которым можно выполнять поиск,
33
+ и признак наличия организаций (companies) в манифесте.
34
+ Для сущностей с данными в датасете в ответе присутствует поле `dataset`.
35
+ operationId: searchFirst
36
+ tags:
37
+ - Search
38
+ responses:
39
+ '200':
40
+ description: Список сущностей и метаданные
41
+ content:
42
+ application/json:
43
+ schema:
44
+ $ref: '#/components/schemas/FirstResponse'
45
+ examples:
46
+ default:
47
+ summary: Стандартный ответ
48
+ value:
49
+ entities:
50
+ - key: __all__
51
+ title: Все
52
+ - key: kadzo.v2023.groups.groups
53
+ title: Группы
54
+ - key: kadzo.v2023.application.systems
55
+ title: Системы
56
+ dataset: kadzo.v2023.application.systems
57
+ hasCompanies: true
58
+ '503':
59
+ description: Сервис не готов (хранилище не инициализировано)
60
+
61
+ /seaf-core/api/core/storage/search/entity-filters:
62
+ get:
63
+ summary: Получить поля для фильтрации выбранной сущности
64
+ description: |
65
+ Второй шаг поиска. Для выбранной сущности возвращает список полей (атрибутов),
66
+ по которым можно строить фильтры: строковые, числовые, enum и поля-ссылки (rel).
67
+ При choice=__all__ возвращается пустой массив.
68
+ operationId: searchSecond
69
+ tags:
70
+ - Search
71
+ parameters:
72
+ - name: choice
73
+ in: query
74
+ required: true
75
+ description: Идентификатор сущности (key из ответа /first) или __all__
76
+ schema:
77
+ type: string
78
+ example: kadzo.v2023.application.systems
79
+ responses:
80
+ '200':
81
+ description: Список полей для фильтрации
82
+ content:
83
+ application/json:
84
+ schema:
85
+ type: array
86
+ items:
87
+ $ref: '#/components/schemas/FilterField'
88
+ examples:
89
+ entityFields:
90
+ summary: Поля сущности
91
+ value:
92
+ - key: title
93
+ title: Название
94
+ type: string
95
+ - key: description
96
+ title: Описание
97
+ type: string
98
+ - key: status
99
+ title: Статус
100
+ type: enum
101
+ enumValues: [active, draft, archived]
102
+ - key: owner
103
+ title: Владелец
104
+ type: rel
105
+ relTarget: kadzo.v2023.groups.groups
106
+ isArray: false
107
+ allEmpty:
108
+ summary: При choice=__all__
109
+ value: []
110
+ '400':
111
+ description: Отсутствует choice или у сущности нет схемы
112
+ content:
113
+ application/json:
114
+ schema:
115
+ $ref: '#/components/schemas/SearchError'
116
+ '503':
117
+ description: Сервис не готов
118
+
119
+ /seaf-core/api/core/storage/search/rel-suggestions:
120
+ get:
121
+ summary: Подсказки для полей-ссылок (autocomplete)
122
+ description: |
123
+ Возвращает варианты подстановки для полей типа rel при вводе в фильтр.
124
+ Ищет по title и aliases связанных объектов. Лимит 50 результатов.
125
+ Данные целевой сущности загружаются из озера или из датасета,
126
+ если для rel-target сущности задан `dataset` в `search.entities`.
127
+ operationId: relSuggestions
128
+ tags:
129
+ - Search
130
+ parameters:
131
+ - name: relTarget
132
+ in: query
133
+ required: true
134
+ description: Целевая сущность ссылки (entityId.subjectId, напр. kadzo.v2023.groups.groups)
135
+ schema:
136
+ type: string
137
+ example: kadzo.v2023.groups.groups
138
+ - name: query
139
+ in: query
140
+ required: false
141
+ description: Подстрока для поиска (регистронезависимый)
142
+ schema:
143
+ type: string
144
+ example: админ
145
+ responses:
146
+ '200':
147
+ description: Массив подсказок
148
+ content:
149
+ application/json:
150
+ schema:
151
+ type: array
152
+ items:
153
+ type: object
154
+ properties:
155
+ text:
156
+ type: string
157
+ description: Отображаемое название
158
+ value:
159
+ type: string
160
+ description: Значение для подстановки
161
+ example:
162
+ - text: Администраторы
163
+ value: Администраторы
164
+ - text: Админ-группа
165
+ value: Админ-группа
166
+ '400':
167
+ description: Отсутствует relTarget
168
+ content:
169
+ application/json:
170
+ schema:
171
+ $ref: '#/components/schemas/SearchError'
172
+ '503':
173
+ description: Сервис не готов
174
+
175
+ /seaf-core/api/core/storage/search/search-run:
176
+ post:
177
+ summary: Выполнить поиск по фильтрам
178
+ description: |
179
+ Третий шаг поиска. Выполняет поиск объектов выбранной сущности с применением фильтров.
180
+ При choice=__all__ поддерживается полнотекстовый поиск по searchQuery (слова ищутся в title и description).
181
+ Лимит результатов — 10 000.
182
+ Данные сущности и rel-target сущностей загружаются из озера или датасета по конфигу `search.entities`.
183
+ operationId: searchThird
184
+ tags:
185
+ - Search
186
+ requestBody:
187
+ required: true
188
+ content:
189
+ application/json:
190
+ schema:
191
+ $ref: '#/components/schemas/SearchRequest'
192
+ examples:
193
+ basicSearch:
194
+ summary: Простой поиск по одной сущности
195
+ value:
196
+ choice: "kadzo.v2023.application.systems"
197
+ filters:
198
+ - field: title
199
+ operator: contains
200
+ value: МИС
201
+ ignoreCase: true
202
+ complexSearch:
203
+ summary: Сложный поиск с несколькими условиями
204
+ value:
205
+ choice: "kadzo.v2023.application.systems"
206
+ filters:
207
+ - field: title
208
+ operator: contains
209
+ value: Система
210
+ ignoreCase: true
211
+ - field: status
212
+ operator: eq
213
+ value: active
214
+ - field: owner
215
+ operator: contains
216
+ value: Администраторы
217
+ searchAll:
218
+ summary: Поиск по всем сущностям (choice=__all__)
219
+ value:
220
+ choice: __all__
221
+ filters: []
222
+ searchQuery: МИС интеграция
223
+ responses:
224
+ '200':
225
+ description: Массив найденных объектов
226
+ content:
227
+ application/json:
228
+ schema:
229
+ $ref: '#/components/schemas/SearchResultArray'
230
+ examples:
231
+ systemsFound:
232
+ summary: Найденные системы
233
+ value:
234
+ - _sfa_key: kadzo.v2023.sys.emis
235
+ _sfa_entity: kadzo.v2023.application.systems
236
+ company: Kadzo
237
+ entityTitle: Системы
238
+ title: МИС ЭМИС
239
+ description: Медицинская информационная система
240
+ card: /entities/kadzo.v2023.application.systems/card?id=kadzo.v2023.sys.emis
241
+ '400':
242
+ description: Ошибка в запросе (отсутствует body/choice/filters, сущность не найдена или без схемы)
243
+ content:
244
+ application/json:
245
+ schema:
246
+ $ref: '#/components/schemas/SearchError'
247
+ examples:
248
+ missingChoice:
249
+ value:
250
+ error: 'request body must contains string attr "choice"'
251
+ missingFilters:
252
+ value:
253
+ error: 'request body must contains array attr "filters"'
254
+ entityNotFound:
255
+ value:
256
+ error: 'chosen entity not found'
257
+ '503':
258
+ description: Сервис не готов
259
+
260
+ components:
261
+ schemas:
262
+ SearchRequest:
263
+ type: object
264
+ required:
265
+ - choice
266
+ - filters
267
+ properties:
268
+ choice:
269
+ type: string
270
+ description: |
271
+ Идентификатор сущности (key из /first).
272
+ Спец. значение __all__ — поиск по всем сущностям (используется searchQuery).
273
+ example: "kadzo.v2023.application.systems"
274
+ filters:
275
+ type: array
276
+ description: |
277
+ Массив фильтров. Все фильтры объединяются по логике AND.
278
+ Для choice=__all__ может быть пустым.
279
+ items:
280
+ $ref: '#/components/schemas/Filter'
281
+ searchQuery:
282
+ type: string
283
+ description: |
284
+ Текстовый запрос для choice=__all__. Слова ищутся в title и description.
285
+ Не используется при выборе конкретной сущности.
286
+ example: "МИС интеграция"
287
+
288
+ Filter:
289
+ type: object
290
+ description: |
291
+ Примеры:
292
+ ---
293
+ Базовые фильтры:
294
+ - {"field": "age", "operator": "eq", "value": 25}
295
+ - {"field": "price", "operator": "gt", "value": 100}
296
+ - {"field": "count", "operator": "lte", "value": 50}
297
+ ---
298
+ Строковые фильтры:
299
+ - {"field": "name", "operator": "contains", "value": "john", "ignoreCase": true}
300
+ - {"field": "email", "operator": "startsWith", "value": "admin"}
301
+ - {"field": "code", "operator": "endsWith", "value": "XYZ", "not": true}
302
+ ---
303
+ Фильтры для массивов:
304
+ - {"field": "tags", "operator": "contains", "value": "important"}
305
+ - {"field": "status", "operator": "in", "value": ["active", "pending"]}
306
+ ---
307
+ Диапазонные фильтры:
308
+ - {"field": "price", "operator": "between", "value": [10, 100]}
309
+ - {"field": "date", "operator": "gt", "value": "2023-01-01"}
310
+ ---
311
+ Фильтры с отрицанием:
312
+ - {"field": "status", "operator": "eq", "value": "deleted", "not": true}
313
+ - {"field": "tags", "operator": "contains", "value": "spam", "not": true}
314
+ required:
315
+ - field
316
+ - operator
317
+ properties:
318
+ field:
319
+ type: string
320
+ description: Имя поля (атрибута) объекта, по которому применяется фильтр
321
+ example: "age"
322
+
323
+ operator:
324
+ type: string
325
+ description: |
326
+ Оператор сравнения. Доступные значения:
327
+
328
+ **Базовые операторы:**
329
+ * `eq` - равно (==)
330
+ * `gt` - больше (>)
331
+ * `gte` - больше или равно (>=)
332
+ * `lt` - меньше (<)
333
+ * `lte` - меньше или равно (<=)
334
+
335
+ **Строковые операторы:**
336
+ * `contains` - содержит подстроку (для строк) или элемент (для массивов)
337
+ * `startsWith` - начинается с подстроки
338
+ * `endsWith` - заканчивается подстрокой
339
+
340
+ **Операторы для множеств:**
341
+ * `in` - значение находится в списке допустимых значений
342
+ * `between` - значение находится в диапазоне [min, max] (для чисел)
343
+
344
+ **Специальные операторы:**
345
+ * `exists` - поле существует (не равно null/undefined)
346
+
347
+ ### Совместимость операторов с типами данных:
348
+ | Оператор | string | number | boolean | array | object |
349
+ |----------|--------|---------|---------|--------|--------|
350
+ | eq | ✅ | ✅ | ✅ | ✅ | ✅ |
351
+ | gt | ⚠️* | ✅ | ❌ | ❌ | ❌ |
352
+ | gte | ⚠️* | ✅ | ❌ | ❌ | ❌ |
353
+ | lt | ⚠️* | ✅ | ❌ | ❌ | ❌ |
354
+ | lte | ⚠️* | ✅ | ❌ | ❌ | ❌ |
355
+ | contains | ✅ | ⚠️** | ❌ | ✅ | ❌ |
356
+ | startsWith | ✅ | ❌ | ❌ | ❌ | ❌ |
357
+ | endsWith | ✅ | ❌ | ❌ | ❌ | ❌ |
358
+ | in | ✅ | ✅ | ✅ | ✅ | ✅ |
359
+ | between | ❌ | ✅ | ❌ | ❌ | ❌ |
360
+ | exists | ✅ | ✅ | ✅ | ✅ | ✅ |
361
+
362
+ *⚠️* - для строк числовые операторы сравнивают лексикографически (по алфавиту)
363
+ **⚠️** - для чисел contains работает через преобразование в строку
364
+ enum:
365
+ - eq
366
+ - gt
367
+ - gte
368
+ - lt
369
+ - lte
370
+ - contains
371
+ - startsWith
372
+ - endsWith
373
+ - in
374
+ - between
375
+ - exists
376
+ example: "gte"
377
+
378
+ value:
379
+ description: |
380
+ Значение для сравнения. Для exists можно не передавать.
381
+ * eq, gt, gte, lt, lte, contains, startsWith, endsWith — string | number | boolean
382
+ * in — массив допустимых значений
383
+ * between — массив [min, max]
384
+ oneOf:
385
+ - type: string
386
+ - type: number
387
+ - type: boolean
388
+ - type: array
389
+ items: {}
390
+ example: 30
391
+
392
+ not:
393
+ type: boolean
394
+ description: |
395
+ Флаг отрицания. Если `true`, условие инвертируется.
396
+ Например: `{"field": "status", "operator": "eq", "value": "deleted", "not": true}`
397
+ означает "статус НЕ равен deleted"
398
+ default: false
399
+ example: false
400
+
401
+ ignoreCase:
402
+ type: boolean
403
+ description: |
404
+ Флаг регистронезависимости для строковых операций.
405
+ Применяется только для операторов: `eq`, `contains`, `startsWith`, `endsWith`, `in`
406
+ Для остальных операторов игнорируется.
407
+ default: false
408
+ example: true
409
+
410
+ SearchResultArray:
411
+ type: array
412
+ description: Массив найденных объектов (лимит 10 000)
413
+ items:
414
+ $ref: '#/components/schemas/SearchResultItem'
415
+
416
+ SearchResultItem:
417
+ type: object
418
+ description: Элемент результата поиска
419
+ properties:
420
+ _sfa_key:
421
+ type: string
422
+ description: Уникальный ключ объекта
423
+ _sfa_entity:
424
+ type: string
425
+ description: Идентификатор сущности
426
+ company:
427
+ type: string
428
+ description: Название организации (если есть)
429
+ entityTitle:
430
+ type: string
431
+ description: Название типа сущности
432
+ title:
433
+ type: string
434
+ description: Заголовок объекта
435
+ description:
436
+ type: string
437
+ description: Описание
438
+ card:
439
+ type: string
440
+ description: URL карточки сущности (если есть presentation)
441
+ additionalProperties: true
442
+
443
+ FilterField:
444
+ type: object
445
+ description: Поле для построения фильтра (из /second)
446
+ properties:
447
+ key:
448
+ type: string
449
+ title:
450
+ type: string
451
+ type:
452
+ type: string
453
+ enum: [string, number, integer, enum, rel]
454
+ enumValues:
455
+ type: array
456
+ items:
457
+ type: string
458
+ description: Для type=enum
459
+ relTarget:
460
+ type: string
461
+ description: Для type=rel (entityId.subjectId)
462
+ isArray:
463
+ type: boolean
464
+ description: Для type=rel
465
+
466
+ FirstResponse:
467
+ type: object
468
+ properties:
469
+ entities:
470
+ type: array
471
+ items:
472
+ type: object
473
+ properties:
474
+ key:
475
+ type: string
476
+ example: __all__
477
+ title:
478
+ type: string
479
+ example: Все
480
+ dataset:
481
+ type: string
482
+ description: Идентификатор датасета (если данные сущности в датасете, а не в озере)
483
+ example: kadzo.v2023.application.systems
484
+ hasCompanies:
485
+ type: boolean
486
+ description: Есть ли организации в манифесте
487
+
488
+ SearchError:
489
+ type: object
490
+ properties:
491
+ error:
492
+ type: string
493
+ description: Сообщение об ошибке
494
+ example:
495
+ error: 'query param "choice" required'