@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,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'
|