@qingflow-tech/qingflow-cli 1.1.61 → 1.1.62-beta.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 (95) hide show
  1. package/README.md +3 -3
  2. package/package.json +2 -1
  3. package/pyproject.toml +4 -1
  4. package/skills/qingflow-cli/SKILL.md +112 -3
  5. package/skills/qingflow-cli/reference/QINGFLOW_CLI_BUILDER_CHARTS_WORKFLOW.md +1 -1
  6. package/skills/qingflow-cli/reference/QINGFLOW_CLI_BUILDER_PORTAL_WORKFLOW.md +6 -258
  7. package/skills/qingflow-cli/reference/builder/20-build-complete-system.md +2 -2
  8. package/skills/qingflow-cli/reference/builder/30-schema-fields.md +22 -5
  9. package/skills/qingflow-cli/reference/builder/70-portal.md +111 -36
  10. package/skills/qingflow-cli/reference/builder/reference/app-delivery-sop.md +3 -3
  11. package/skills/qingflow-cli/reference/examples/portal/portal_apply_v1alpha1.example.json +100 -0
  12. package/skills/qingflow-cli/reference/examples/portal/portal_sections_all_types.example.json +22 -6
  13. package/src/qingflow_mcp/app_form_compat.py +3 -0
  14. package/src/qingflow_mcp/app_form_validator.py +89 -20
  15. package/src/qingflow_mcp/builder_facade/app_form.py +629 -112
  16. package/src/qingflow_mcp/builder_facade/models.py +213 -15
  17. package/src/qingflow_mcp/builder_facade/portals_schema.py +397 -0
  18. package/src/qingflow_mcp/builder_facade/schemas/app_form/manifest.json +15 -1
  19. package/src/qingflow_mcp/builder_facade/schemas/app_form/v1alpha1/complete.json +112 -38
  20. package/src/qingflow_mcp/builder_facade/schemas/app_form/v1alpha1/fields/address.json +31 -8
  21. package/src/qingflow_mcp/builder_facade/schemas/app_form/v1alpha1/fields/ai_content_classification.json +146 -0
  22. package/src/qingflow_mcp/builder_facade/schemas/app_form/v1alpha1/fields/ai_content_extraction.json +146 -0
  23. package/src/qingflow_mcp/builder_facade/schemas/app_form/v1alpha1/fields/ai_content_generation.json +146 -0
  24. package/src/qingflow_mcp/builder_facade/schemas/app_form/v1alpha1/fields/ai_document_parsing.json +146 -0
  25. package/src/qingflow_mcp/builder_facade/schemas/app_form/v1alpha1/fields/ai_image_generation.json +146 -0
  26. package/src/qingflow_mcp/builder_facade/schemas/app_form/v1alpha1/fields/ai_image_recognition.json +146 -0
  27. package/src/qingflow_mcp/builder_facade/schemas/app_form/v1alpha1/fields/ai_machine_translation.json +146 -0
  28. package/src/qingflow_mcp/builder_facade/schemas/app_form/v1alpha1/fields/ai_text_summary.json +146 -0
  29. package/src/qingflow_mcp/builder_facade/schemas/app_form/v1alpha1/fields/amount.json +6 -10
  30. package/src/qingflow_mcp/builder_facade/schemas/app_form/v1alpha1/fields/attachment.json +33 -10
  31. package/src/qingflow_mcp/builder_facade/schemas/app_form/v1alpha1/fields/code_block.json +6 -10
  32. package/src/qingflow_mcp/builder_facade/schemas/app_form/v1alpha1/fields/data_relation.json +11 -18
  33. package/src/qingflow_mcp/builder_facade/schemas/app_form/v1alpha1/fields/date.json +4 -8
  34. package/src/qingflow_mcp/builder_facade/schemas/app_form/v1alpha1/fields/date_duration.json +146 -0
  35. package/src/qingflow_mcp/builder_facade/schemas/app_form/v1alpha1/fields/datetime.json +4 -8
  36. package/src/qingflow_mcp/builder_facade/schemas/app_form/v1alpha1/fields/department.json +6 -10
  37. package/src/qingflow_mcp/builder_facade/schemas/app_form/v1alpha1/fields/email.json +4 -8
  38. package/src/qingflow_mcp/builder_facade/schemas/app_form/v1alpha1/fields/embed_field.json +146 -0
  39. package/src/qingflow_mcp/builder_facade/schemas/app_form/v1alpha1/fields/image_select.json +146 -0
  40. package/src/qingflow_mcp/builder_facade/schemas/app_form/v1alpha1/fields/link.json +4 -8
  41. package/src/qingflow_mcp/builder_facade/schemas/app_form/v1alpha1/fields/location.json +146 -0
  42. package/src/qingflow_mcp/builder_facade/schemas/app_form/v1alpha1/fields/long_text.json +4 -8
  43. package/src/qingflow_mcp/builder_facade/schemas/app_form/v1alpha1/fields/member.json +6 -10
  44. package/src/qingflow_mcp/builder_facade/schemas/app_form/v1alpha1/fields/multi_select.json +4 -8
  45. package/src/qingflow_mcp/builder_facade/schemas/app_form/v1alpha1/fields/number.json +6 -10
  46. package/src/qingflow_mcp/builder_facade/schemas/app_form/v1alpha1/fields/ocr.json +146 -0
  47. package/src/qingflow_mcp/builder_facade/schemas/app_form/v1alpha1/fields/phone.json +4 -8
  48. package/src/qingflow_mcp/builder_facade/schemas/app_form/v1alpha1/fields/q_linker.json +8 -12
  49. package/src/qingflow_mcp/builder_facade/schemas/app_form/v1alpha1/fields/relation.json +73 -15
  50. package/src/qingflow_mcp/builder_facade/schemas/app_form/v1alpha1/fields/rich_text.json +146 -0
  51. package/src/qingflow_mcp/builder_facade/schemas/app_form/v1alpha1/fields/single_choice.json +4 -8
  52. package/src/qingflow_mcp/builder_facade/schemas/app_form/v1alpha1/fields/single_select.json +4 -8
  53. package/src/qingflow_mcp/builder_facade/schemas/app_form/v1alpha1/fields/subtable.json +90 -29
  54. package/src/qingflow_mcp/builder_facade/schemas/app_form/v1alpha1/fields/text.json +4 -8
  55. package/src/qingflow_mcp/builder_facade/schemas/app_form/v1alpha1/formula.json +43 -0
  56. package/src/qingflow_mcp/builder_facade/schemas/app_form/v1alpha1/summary.json +27 -19
  57. package/src/qingflow_mcp/builder_facade/schemas/portals/manifest.json +59 -0
  58. package/src/qingflow_mcp/builder_facade/schemas/portals/v1alpha1/complete.json +1397 -0
  59. package/src/qingflow_mcp/builder_facade/schemas/portals/v1alpha1/components/carousel.json +193 -0
  60. package/src/qingflow_mcp/builder_facade/schemas/portals/v1alpha1/components/chart.json +643 -0
  61. package/src/qingflow_mcp/builder_facade/schemas/portals/v1alpha1/components/favourite.json +203 -0
  62. package/src/qingflow_mcp/builder_facade/schemas/portals/v1alpha1/components/filter.json +331 -0
  63. package/src/qingflow_mcp/builder_facade/schemas/portals/v1alpha1/components/grid.json +265 -0
  64. package/src/qingflow_mcp/builder_facade/schemas/portals/v1alpha1/components/link.json +131 -0
  65. package/src/qingflow_mcp/builder_facade/schemas/portals/v1alpha1/components/task.json +199 -0
  66. package/src/qingflow_mcp/builder_facade/schemas/portals/v1alpha1/components/text.json +123 -0
  67. package/src/qingflow_mcp/builder_facade/schemas/portals/v1alpha1/components/view.json +196 -0
  68. package/src/qingflow_mcp/builder_facade/schemas/portals/v1alpha1/summary.json +800 -0
  69. package/src/qingflow_mcp/builder_facade/schemas/views/v1alpha1/complete.json +1 -1
  70. package/src/qingflow_mcp/builder_facade/schemas/views/v1alpha1/details/display.json +1 -1
  71. package/src/qingflow_mcp/builder_facade/schemas/views/v1alpha1/summary.json +1 -1
  72. package/src/qingflow_mcp/builder_facade/service.py +1367 -92
  73. package/src/qingflow_mcp/cli/commands/builder.py +120 -5
  74. package/src/qingflow_mcp/cli/formatters.py +11 -0
  75. package/src/qingflow_mcp/cli/main.py +90 -2
  76. package/src/qingflow_mcp/cli/permission_gate.py +59 -0
  77. package/src/qingflow_mcp/cloud_context.py +16 -1
  78. package/src/qingflow_mcp/entity_permissions.py +10 -0
  79. package/src/qingflow_mcp/permission_catalog.json +1210 -0
  80. package/src/qingflow_mcp/public_surface.py +69 -8
  81. package/src/qingflow_mcp/response_trim.py +2 -1
  82. package/src/qingflow_mcp/server.py +12 -6
  83. package/src/qingflow_mcp/server_app_builder.py +43 -10
  84. package/src/qingflow_mcp/server_app_user.py +9 -5
  85. package/src/qingflow_mcp/server_cloud.py +43 -7
  86. package/src/qingflow_mcp/session_store.py +14 -1
  87. package/src/qingflow_mcp/solution/compiler/icon_utils.py +73 -0
  88. package/src/qingflow_mcp/solution/executor.py +5 -2
  89. package/src/qingflow_mcp/tool_catalog.py +388 -0
  90. package/src/qingflow_mcp/tool_catalog_i18n.py +184 -0
  91. package/src/qingflow_mcp/tool_policy.py +191 -0
  92. package/src/qingflow_mcp/tools/ai_builder_tools.py +118 -20
  93. package/src/qingflow_mcp/tools/portal_tools.py +4 -54
  94. package/src/qingflow_mcp/tools/portal_writer.py +59 -0
  95. package/src/qingflow_mcp/tools/solution_tools.py +2 -0
@@ -0,0 +1,203 @@
1
+ {
2
+ "$schema": "https://json-schema.org/draft/2020-12/schema",
3
+ "$id": "https://qingflow.com/schemas/builder/portals/v1alpha1/components/favourite.json",
4
+ "title": "Qingflow Builder Portals Section · favourite (v1alpha1)",
5
+ "portalFavouriteSectionDescription": "门户收藏组件(favourite)的详细配置专项 Schema。获取命令:qingflow builder portal schema --schema-kind favourite(MCP: portal_schema(schema_kind=\"favourite\"))。本 Schema 校验 sections[] 中单个 favourite 区块(自包含,可直接交给 JSON Schema 校验器);后端 DashComponentInfo.type=7。整门户声明走 summary/complete 档。",
6
+ "$defs": {
7
+ "Position": {
8
+ "type": "object",
9
+ "additionalProperties": false,
10
+ "positionShapeDescription": "网格位置。PC 是 24 列网格(cols≤24),mobile 是 6 列网格(cols≤6);同行组件共享同一 y 与 rows,一行 cols 合计 24。mobile 可省略(缺省与 pc 同布局)。平铺别名 pc_x/pc_y/pc_w/pc_h、mobile_* 也接受(x/y 与 w/h/cols/rows 混写均认),归一为本结构。标准行高:指标卡 rows=5、BI 图表 rows=7、数据视图 rows=11、业务入口 rows=4。",
11
+ "properties": {
12
+ "pc": {
13
+ "$ref": "#/$defs/PositionDetail"
14
+ },
15
+ "mobile": {
16
+ "$ref": "#/$defs/PositionDetail"
17
+ }
18
+ }
19
+ },
20
+ "PositionDetail": {
21
+ "type": "object",
22
+ "additionalProperties": false,
23
+ "positionDetailShapeDescription": "单端位置:x=列偏移、y=行偏移、cols=占宽、rows=占高。",
24
+ "properties": {
25
+ "x": {
26
+ "type": [
27
+ "integer",
28
+ "null"
29
+ ],
30
+ "minimum": 0
31
+ },
32
+ "y": {
33
+ "type": [
34
+ "integer",
35
+ "null"
36
+ ],
37
+ "minimum": 0
38
+ },
39
+ "cols": {
40
+ "type": [
41
+ "integer",
42
+ "null"
43
+ ],
44
+ "minimum": 1
45
+ },
46
+ "rows": {
47
+ "type": [
48
+ "integer",
49
+ "null"
50
+ ],
51
+ "minimum": 1
52
+ }
53
+ },
54
+ "x-backend": "DashPosition.pc / DashPosition.mobile"
55
+ },
56
+ "FavouriteConfig": {
57
+ "type": "object",
58
+ "additionalProperties": false,
59
+ "favouriteConfigShapeDescription": "收藏组件配置。",
60
+ "properties": {
61
+ "show_title": {
62
+ "type": "boolean",
63
+ "default": true,
64
+ "favouriteShowTitleShapeDescription": "是否显示收藏标题。别名 beingShowTitle。",
65
+ "x-backend": "ComponentFavouriteConfig.beingShowTitle"
66
+ },
67
+ "enabled": {
68
+ "type": "boolean",
69
+ "favouriteEnabledShapeDescription": "收藏组件是否启用。别名 beingUsing。",
70
+ "x-backend": "ComponentFavouriteConfig.beingUsing"
71
+ },
72
+ "items": {
73
+ "type": "array",
74
+ "favouriteItemsShapeDescription": "收藏条目(用户级收藏为主,声明面预置初始条目;ordinal 缺省按数组顺序)。",
75
+ "items": {
76
+ "$ref": "#/$defs/FavouriteItem"
77
+ },
78
+ "x-backend": "ComponentFavouriteConfig.items(ComponentFavouriteItemInfo)"
79
+ }
80
+ }
81
+ },
82
+ "FavouriteItem": {
83
+ "type": "object",
84
+ "additionalProperties": false,
85
+ "required": [
86
+ "title"
87
+ ],
88
+ "favouriteItemShapeDescription": "单个收藏条目。",
89
+ "properties": {
90
+ "title": {
91
+ "type": "string",
92
+ "favouriteItemTitleShapeDescription": "条目标题。",
93
+ "x-backend": "ComponentFavouriteItemInfo.title"
94
+ },
95
+ "item_type": {
96
+ "type": "integer",
97
+ "favouriteItemTypeShapeDescription": "条目类型。别名 type。",
98
+ "x-backend": "ComponentFavouriteItemInfo.type"
99
+ },
100
+ "link_key": {
101
+ "type": "string",
102
+ "favouriteItemLinkKeyShapeDescription": "目标资源 key(应用/门户 key)。",
103
+ "x-backend": "ComponentFavouriteItemInfo.linkKey"
104
+ },
105
+ "link_id": {
106
+ "type": "integer",
107
+ "favouriteItemLinkIdShapeDescription": "目标资源 id。",
108
+ "x-backend": "ComponentFavouriteItemInfo.linkId"
109
+ },
110
+ "icon_url": {
111
+ "type": "string",
112
+ "favouriteItemIconShapeDescription": "条目图标 url。别名 iconUrl。",
113
+ "x-backend": "ComponentFavouriteItemInfo.iconUrl"
114
+ },
115
+ "jump_mode": {
116
+ "type": "integer",
117
+ "favouriteItemJumpModeShapeDescription": "跳转方式。",
118
+ "x-backend": "ComponentFavouriteItemInfo.jumpMode"
119
+ },
120
+ "ordinal": {
121
+ "type": "integer",
122
+ "favouriteItemOrdinalShapeDescription": "排序序号。",
123
+ "x-backend": "ComponentFavouriteItemInfo.ordinal"
124
+ }
125
+ }
126
+ },
127
+ "Section": {
128
+ "type": "object",
129
+ "additionalProperties": false,
130
+ "required": [
131
+ "title",
132
+ "source_type",
133
+ "favourite"
134
+ ],
135
+ "properties": {
136
+ "title": {
137
+ "type": "string",
138
+ "minLength": 1,
139
+ "sectionTitleShapeDescription": "组件标题(渲染在组件头部)。",
140
+ "x-backend": "组件标题(DashChartInfo.title / gridConfig.gridTitle 等)"
141
+ },
142
+ "source_type": {
143
+ "const": "favourite",
144
+ "sourceTypeConstDescription": "组件类型固定为 favourite(收藏);后端 type 整数见 x-backend。",
145
+ "x-backend": "DashComponentInfo.type(favourite)"
146
+ },
147
+ "role": {
148
+ "type": "string",
149
+ "roleShapeDescription": "组件角色标注(编排辅助,如 metric=指标卡;影响布局预设的排布与行高)。别名 zone/section_role。"
150
+ },
151
+ "position": {
152
+ "$ref": "#/$defs/Position"
153
+ },
154
+ "style_config": {
155
+ "type": "object",
156
+ "styleConfigSectionDescription": "组件级样式(受控键集;键白名单以 ws40013 dataset 实测形态校准,未经校准的键会被拒绝)。别名 dash_style_config/dashStyleConfigBO。",
157
+ "x-backend": "DashComponentInfo.dashStyleConfigBO(DashStyleConfigBO)"
158
+ },
159
+ "favourite": {
160
+ "$ref": "#/$defs/FavouriteConfig",
161
+ "favouritePropDescription": "收藏配置(必填)。"
162
+ }
163
+ }
164
+ }
165
+ },
166
+ "$ref": "#/$defs/Section",
167
+ "x-qingflow-detail-query": {
168
+ "currentKind": "favourite",
169
+ "tool": "portal_schema",
170
+ "cli": "qingflow builder portal schema --schema-kind favourite",
171
+ "argument": "schema_kind",
172
+ "detailQueryDescription": "本文件是 收藏组件的自包含专项 Schema(内联全部引用定义,可独立交给 JSON Schema 校验器)。chart/view/grid/filter/text/link/carousel/task/favourite 各组件专项 Schema分别经 qingflow builder portal schema --schema-kind <类型> 获取。整门户声明用 qingflow builder portal schema --schema-kind summary|complete 获取;回读既有门户用 qingflow builder portal get --dash-key K --schema-kind complete。",
173
+ "readSources": {
174
+ "chartIds": "已有图表 id 用 chart 面读取;内联创建直接在 chart 键声明。",
175
+ "viewKeys": "视图唯一键用 qingflow builder views get --app-key APP 回读。"
176
+ }
177
+ },
178
+ "examples": [
179
+ {
180
+ "title": "常用入口",
181
+ "source_type": "favourite",
182
+ "position": {
183
+ "pc": {
184
+ "x": 12,
185
+ "y": 11,
186
+ "cols": 12,
187
+ "rows": 8
188
+ }
189
+ },
190
+ "favourite": {
191
+ "show_title": true,
192
+ "items": [
193
+ {
194
+ "title": "设备台账",
195
+ "item_type": 1,
196
+ "link_key": "APP_KEY_DEVICE",
197
+ "jump_mode": 1
198
+ }
199
+ ]
200
+ }
201
+ }
202
+ ]
203
+ }
@@ -0,0 +1,331 @@
1
+ {
2
+ "$schema": "https://json-schema.org/draft/2020-12/schema",
3
+ "$id": "https://qingflow.com/schemas/builder/portals/v1alpha1/components/filter.json",
4
+ "title": "Qingflow Builder Portals Section · filter (v1alpha1)",
5
+ "portalFilterSectionDescription": "门户筛选组件(filter)的详细配置专项 Schema。获取命令:qingflow builder portal schema --schema-kind filter(MCP: portal_schema(schema_kind=\"filter\"))。本 Schema 校验 sections[] 中单个 filter 区块(自包含,可直接交给 JSON Schema 校验器);后端 DashComponentInfo.type=6。整门户声明走 summary/complete 档。",
6
+ "$defs": {
7
+ "Position": {
8
+ "type": "object",
9
+ "additionalProperties": false,
10
+ "positionShapeDescription": "网格位置。PC 是 24 列网格(cols≤24),mobile 是 6 列网格(cols≤6);同行组件共享同一 y 与 rows,一行 cols 合计 24。mobile 可省略(缺省与 pc 同布局)。平铺别名 pc_x/pc_y/pc_w/pc_h、mobile_* 也接受(x/y 与 w/h/cols/rows 混写均认),归一为本结构。标准行高:指标卡 rows=5、BI 图表 rows=7、数据视图 rows=11、业务入口 rows=4。",
11
+ "properties": {
12
+ "pc": {
13
+ "$ref": "#/$defs/PositionDetail"
14
+ },
15
+ "mobile": {
16
+ "$ref": "#/$defs/PositionDetail"
17
+ }
18
+ }
19
+ },
20
+ "PositionDetail": {
21
+ "type": "object",
22
+ "additionalProperties": false,
23
+ "positionDetailShapeDescription": "单端位置:x=列偏移、y=行偏移、cols=占宽、rows=占高。",
24
+ "properties": {
25
+ "x": {
26
+ "type": [
27
+ "integer",
28
+ "null"
29
+ ],
30
+ "minimum": 0
31
+ },
32
+ "y": {
33
+ "type": [
34
+ "integer",
35
+ "null"
36
+ ],
37
+ "minimum": 0
38
+ },
39
+ "cols": {
40
+ "type": [
41
+ "integer",
42
+ "null"
43
+ ],
44
+ "minimum": 1
45
+ },
46
+ "rows": {
47
+ "type": [
48
+ "integer",
49
+ "null"
50
+ ],
51
+ "minimum": 1
52
+ }
53
+ },
54
+ "x-backend": "DashPosition.pc / DashPosition.mobile"
55
+ },
56
+ "FilterConfig": {
57
+ "type": "object",
58
+ "additionalProperties": false,
59
+ "required": [
60
+ "rules"
61
+ ],
62
+ "filterConfigShapeDescription": "筛选组件配置。rules 必须非空——后端读面(DashSvcImpl#getComponentFilter)按筛选组(dash_filter_group 行)反查筛选组件,空规则的 filter 组件行虽会写入但读面枚举不到,表现为「apply 成功、回读缺该组件」。规则键集为后端持久化键受控透传(filterGroupName/filterGroupConfig/filterItemName/dftJudgeType/dftJudgeValue/filterCondition 系);声明键 que/judge 会被后端写链静默丢弃(落库只剩 filterItemName,前端筛选条件为空),模型层已阻断。",
63
+ "properties": {
64
+ "graphs": {
65
+ "type": "array",
66
+ "filterGraphsShapeDescription": "受筛选作用的图表引用(可省略:后端按 filterCondition 聚合派生 graphList,回读的 graphs 可能按绑定条数展开,非真实重复)。",
67
+ "items": {
68
+ "$ref": "#/$defs/FilterGraphRef"
69
+ },
70
+ "x-backend": "ComponentFilter.graphList(GraphVO.graphKey/graphName/graphType)"
71
+ },
72
+ "rules": {
73
+ "type": "array",
74
+ "minItems": 1,
75
+ "filterRulesShapeDescription": "筛选规则组(至少 1 组)。组键:filterGroupName(组名,必填)、filterGroupConfig(组内筛选项列表);项键为后端持久化键:filterItemName、dftJudgeType、dftJudgeValue、filterCondition[](字段绑定)。代理键 filterGroupId/filterItemId 为后端自增位移键,读写两侧均剔除,不要携带;声明键 que/judge 会被后端静默丢弃,模型层已阻断。",
76
+ "items": {
77
+ "$ref": "#/$defs/FilterRuleGroup"
78
+ },
79
+ "x-backend": "ComponentFilter.filterConfig(List<FilterConfig>)"
80
+ }
81
+ }
82
+ },
83
+ "FilterGraphRef": {
84
+ "type": "object",
85
+ "additionalProperties": false,
86
+ "filterGraphRefShapeDescription": "受筛选作用的图表引用;chart_key 或 chart_name 至少一个。",
87
+ "anyOf": [
88
+ {
89
+ "required": [
90
+ "chart_key"
91
+ ]
92
+ },
93
+ {
94
+ "required": [
95
+ "chart_name"
96
+ ]
97
+ }
98
+ ],
99
+ "properties": {
100
+ "chart_key": {
101
+ "type": "string",
102
+ "filterGraphKeyShapeDescription": "图表 key。别名 chartKey/graphKey。",
103
+ "x-backend": "GraphVO.graphKey"
104
+ },
105
+ "chart_name": {
106
+ "type": "string",
107
+ "filterGraphNameShapeDescription": "图表名称。别名 graphName。",
108
+ "x-backend": "GraphVO.graphName"
109
+ }
110
+ }
111
+ },
112
+ "FilterRuleGroup": {
113
+ "type": "object",
114
+ "required": [
115
+ "filterGroupName"
116
+ ],
117
+ "filterRuleGroupShapeDescription": "筛选规则组。组内筛选项走 filterGroupConfig;其余后端键受控透传。",
118
+ "properties": {
119
+ "filterGroupName": {
120
+ "type": "string",
121
+ "filterRuleGroupNameShapeDescription": "组名称(读面渲染为分组标题)。",
122
+ "x-backend": "FilterConfig.filterGroupName"
123
+ },
124
+ "filterGroupConfig": {
125
+ "type": "array",
126
+ "filterRuleGroupItemsShapeDescription": "组内筛选项(绑定字段与默认条件)。",
127
+ "items": {
128
+ "$ref": "#/$defs/FilterRuleItem"
129
+ },
130
+ "x-backend": "FilterConfig.filterGroupConfig(List<FilterGroupConfig>)"
131
+ }
132
+ }
133
+ },
134
+ "FilterRuleItem": {
135
+ "type": "object",
136
+ "required": [
137
+ "filterItemName"
138
+ ],
139
+ "filterRuleItemShapeDescription": "单个筛选项,必须用后端持久化键:filterItemName + dftJudgeType/dftJudgeValue(默认条件) + filterCondition[](字段绑定,每条绑定一张目标图表/视图)。历史文档的声明键 que{queId}/judge{judgeType,judgeValues} 不被后端 FilterGroupConfig DTO 识别,写入即被静默丢弃——落库只剩 filterItemName,前端筛选条件渲染为空;模型层已阻断,不要携带。",
140
+ "properties": {
141
+ "filterItemName": {
142
+ "type": "string",
143
+ "filterRuleItemNameShapeDescription": "筛选项名称。",
144
+ "x-backend": "FilterGroupConfig.filterItemName"
145
+ },
146
+ "dftJudgeType": {
147
+ "type": [
148
+ "integer",
149
+ "null"
150
+ ],
151
+ "dftJudgeTypeShapeDescription": "默认判断符;2=包含(文本筛选项实测可用)。",
152
+ "x-backend": "FilterGroupConfig.dftJudgeType"
153
+ },
154
+ "dftJudgeValue": {
155
+ "type": "array",
156
+ "dftJudgeValueShapeDescription": "默认筛选值列表;不希望预过滤写 []。",
157
+ "x-backend": "FilterGroupConfig.dftJudgeValue"
158
+ },
159
+ "filterCondition": {
160
+ "type": "array",
161
+ "filterConditionListShapeDescription": "字段绑定列表:每个条目把筛选项绑定到一张目标图表(graphType=CHART)或视图(graphType=VIEW);作用于 N 张图表就写 N 条。",
162
+ "items": {
163
+ "$ref": "#/$defs/FilterCondition"
164
+ },
165
+ "x-backend": "FilterGroupConfig.filterCondition"
166
+ },
167
+ "filterType": {
168
+ "type": [
169
+ "string",
170
+ "integer",
171
+ "null"
172
+ ],
173
+ "filterTypeShapeDescription": "筛选展示类型(后端键,可空;缺省 null 实测可正常落库)。",
174
+ "x-backend": "FilterGroupConfig.filterType"
175
+ }
176
+ }
177
+ },
178
+ "FilterCondition": {
179
+ "type": "object",
180
+ "required": [
181
+ "queId",
182
+ "chartKey"
183
+ ],
184
+ "filterConditionShapeDescription": "筛选项与一张目标图表/视图的字段绑定(后端持久化键,实测落库形态)。",
185
+ "properties": {
186
+ "queId": {
187
+ "type": "integer",
188
+ "conditionQueIdShapeDescription": "目标应用字段 queId(builder app get fields 读取)。",
189
+ "x-backend": "FilterCondition.queId"
190
+ },
191
+ "queType": {
192
+ "type": "integer",
193
+ "conditionQueTypeShapeDescription": "字段类型编码:text=2、long_text=3、date/datetime=4、member=5、email=6、phone=7、number/amount=8、boolean=10、single_select=11、multi_select=12、attachment=13、subtable=18、q_linker=20、address=21、department=22、relation=25、code_block=26。",
194
+ "x-backend": "FilterCondition.queType"
195
+ },
196
+ "queTitle": {
197
+ "type": "string",
198
+ "conditionQueTitleShapeDescription": "字段显示名。",
199
+ "x-backend": "FilterCondition.queTitle"
200
+ },
201
+ "queOriginType": {
202
+ "type": "integer",
203
+ "conditionQueOriginTypeShapeDescription": "来源字段类型,一般同 queType。",
204
+ "x-backend": "FilterCondition.queOriginType"
205
+ },
206
+ "chartKey": {
207
+ "type": "string",
208
+ "conditionChartKeyShapeDescription": "目标图表 key(门户回读 chart_ref.chart_id / QingBI 图表 bi id);绑定视图时为视图 viewgraph_key。",
209
+ "x-backend": "FilterCondition.chartKey"
210
+ },
211
+ "biFieldId": {
212
+ "type": "string",
213
+ "conditionBiFieldIdShapeDescription": "BI 字段 ID,格式 \"<app_key>:<queId>\"。",
214
+ "x-backend": "FilterCondition.biFieldId"
215
+ },
216
+ "chartName": {
217
+ "type": "string",
218
+ "conditionChartNameShapeDescription": "目标图表显示名。",
219
+ "x-backend": "FilterCondition.chartName"
220
+ },
221
+ "graphType": {
222
+ "type": "string",
223
+ "conditionGraphTypeShapeDescription": "绑定目标类型:CHART(图表)/VIEW(视图)。",
224
+ "x-backend": "FilterCondition.graphType"
225
+ },
226
+ "dateType": {
227
+ "type": "integer",
228
+ "conditionDateTypeShapeDescription": "date/datetime 字段补充键(date=0/datetime=1)。",
229
+ "x-backend": "FilterCondition.dateType"
230
+ }
231
+ }
232
+ },
233
+ "Section": {
234
+ "type": "object",
235
+ "additionalProperties": false,
236
+ "required": [
237
+ "source_type",
238
+ "config"
239
+ ],
240
+ "properties": {
241
+ "title": {
242
+ "type": "string",
243
+ "sectionTitleShapeDescription": "组件标题(可选)。存量筛选组件合法无标题——后端筛选组件无标题存储,提取产物不带 title,不要合成(如「组件 N」)。",
244
+ "x-backend": "组件标题(筛选组件无标题存储;其余组件见 DashChartInfo.title / gridConfig.gridTitle 等)"
245
+ },
246
+ "source_type": {
247
+ "const": "filter",
248
+ "sourceTypeConstDescription": "组件类型固定为 filter(筛选);后端 type 整数见 x-backend。",
249
+ "x-backend": "DashComponentInfo.type(filter)"
250
+ },
251
+ "role": {
252
+ "type": "string",
253
+ "roleShapeDescription": "组件角色标注(编排辅助,如 metric=指标卡;影响布局预设的排布与行高)。别名 zone/section_role。"
254
+ },
255
+ "position": {
256
+ "$ref": "#/$defs/Position"
257
+ },
258
+ "style_config": {
259
+ "type": "object",
260
+ "styleConfigSectionDescription": "组件级样式(受控键集;键白名单以 ws40013 dataset 实测形态校准,未经校准的键会被拒绝)。别名 dash_style_config/dashStyleConfigBO。",
261
+ "x-backend": "DashComponentInfo.dashStyleConfigBO(DashStyleConfigBO)"
262
+ },
263
+ "config": {
264
+ "$ref": "#/$defs/FilterConfig",
265
+ "filterConfigPropDescription": "筛选配置(必填,rules 至少 1 组)。"
266
+ }
267
+ }
268
+ }
269
+ },
270
+ "$ref": "#/$defs/Section",
271
+ "x-qingflow-detail-query": {
272
+ "currentKind": "filter",
273
+ "tool": "portal_schema",
274
+ "cli": "qingflow builder portal schema --schema-kind filter",
275
+ "argument": "schema_kind",
276
+ "detailQueryDescription": "本文件是 筛选组件的自包含专项 Schema(内联全部引用定义,可独立交给 JSON Schema 校验器)。chart/view/grid/filter/text/link/carousel/task/favourite 各组件专项 Schema分别经 qingflow builder portal schema --schema-kind <类型> 获取。整门户声明用 qingflow builder portal schema --schema-kind summary|complete 获取;回读既有门户用 qingflow builder portal get --dash-key K --schema-kind complete。",
277
+ "readSources": {
278
+ "chartIds": "已有图表 id 用 chart 面读取;内联创建直接在 chart 键声明。",
279
+ "viewKeys": "视图唯一键用 qingflow builder views get --app-key APP 回读。"
280
+ }
281
+ },
282
+ "examples": [
283
+ {
284
+ "source_type": "filter",
285
+ "position": {
286
+ "pc": {
287
+ "x": 0,
288
+ "y": 0,
289
+ "cols": 24,
290
+ "rows": 3
291
+ }
292
+ },
293
+ "config": {
294
+ "rules": [
295
+ {
296
+ "filterGroupName": "区域",
297
+ "filterGroupConfig": [
298
+ {
299
+ "filterItemName": "城市",
300
+ "dftJudgeType": 2,
301
+ "dftJudgeValue": [],
302
+ "filterCondition": [
303
+ {
304
+ "queId": 123456,
305
+ "queType": 2,
306
+ "queTitle": "城市",
307
+ "queOriginType": 2,
308
+ "chartKey": "CHART_KEY_1001",
309
+ "biFieldId": "APP_KEY_1:123456",
310
+ "chartName": "故障类型分布",
311
+ "graphType": "CHART"
312
+ },
313
+ {
314
+ "queId": 123456,
315
+ "queType": 2,
316
+ "queTitle": "城市",
317
+ "queOriginType": 2,
318
+ "chartKey": "CHART_KEY_1002",
319
+ "biFieldId": "APP_KEY_1:123456",
320
+ "chartName": "区域销量分布",
321
+ "graphType": "CHART"
322
+ }
323
+ ]
324
+ }
325
+ ]
326
+ }
327
+ ]
328
+ }
329
+ }
330
+ ]
331
+ }