@qingflow-tech/qingflow-cli 1.1.61-beta.3 → 1.1.61-beta.5

package/src/qingflow_mcp/builder_facade/schemas/portals/v1alpha1/components/favourite.json

@@ -0,0 +1,203 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://qingflow.com/schemas/builder/portals/v1alpha1/components/favourite.json",
+  "title": "Qingflow Builder Portals Section · favourite (v1alpha1)",
+  "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 档。",
+  "$defs": {
+    "Position": {
+      "type": "object",
+      "additionalProperties": false,
+      "positionShapeDescription": "网格位置。PC 是 24 列网格(cols≤24),mobile 是 6 列网格(cols≤6);同行组件共享同一 y 与 rows,一行 cols 合计 24。mobile 可省略(缺省与 pc 同布局)。平铺别名 pc_x/pc_y/pc_w/pc_h、mobile_* 也接受,归一为本结构。标准行高:指标卡 rows=5、BI 图表 rows=7、数据视图 rows=11、业务入口 rows=4。",
+      "properties": {
+        "pc": {
+          "$ref": "#/$defs/PositionDetail"
+        },
+        "mobile": {
+          "$ref": "#/$defs/PositionDetail"
+        }
+      }
+    },
+    "PositionDetail": {
+      "type": "object",
+      "additionalProperties": false,
+      "positionDetailShapeDescription": "单端位置:x=列偏移、y=行偏移、cols=占宽、rows=占高。",
+      "properties": {
+        "x": {
+          "type": [
+            "integer",
+            "null"
+          ],
+          "minimum": 0
+        },
+        "y": {
+          "type": [
+            "integer",
+            "null"
+          ],
+          "minimum": 0
+        },
+        "cols": {
+          "type": [
+            "integer",
+            "null"
+          ],
+          "minimum": 1
+        },
+        "rows": {
+          "type": [
+            "integer",
+            "null"
+          ],
+          "minimum": 1
+        }
+      },
+      "x-backend": "DashPosition.pc / DashPosition.mobile"
+    },
+    "FavouriteConfig": {
+      "type": "object",
+      "additionalProperties": false,
+      "favouriteConfigShapeDescription": "收藏组件配置。",
+      "properties": {
+        "show_title": {
+          "type": "boolean",
+          "default": true,
+          "favouriteShowTitleShapeDescription": "是否显示收藏标题。别名 beingShowTitle。",
+          "x-backend": "ComponentFavouriteConfig.beingShowTitle"
+        },
+        "enabled": {
+          "type": "boolean",
+          "favouriteEnabledShapeDescription": "收藏组件是否启用。别名 beingUsing。",
+          "x-backend": "ComponentFavouriteConfig.beingUsing"
+        },
+        "items": {
+          "type": "array",
+          "favouriteItemsShapeDescription": "收藏条目(用户级收藏为主,声明面预置初始条目;ordinal 缺省按数组顺序)。",
+          "items": {
+            "$ref": "#/$defs/FavouriteItem"
+          },
+          "x-backend": "ComponentFavouriteConfig.items(ComponentFavouriteItemInfo)"
+        }
+      }
+    },
+    "FavouriteItem": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "title"
+      ],
+      "favouriteItemShapeDescription": "单个收藏条目。",
+      "properties": {
+        "title": {
+          "type": "string",
+          "favouriteItemTitleShapeDescription": "条目标题。",
+          "x-backend": "ComponentFavouriteItemInfo.title"
+        },
+        "item_type": {
+          "type": "integer",
+          "favouriteItemTypeShapeDescription": "条目类型。别名 type。",
+          "x-backend": "ComponentFavouriteItemInfo.type"
+        },
+        "link_key": {
+          "type": "string",
+          "favouriteItemLinkKeyShapeDescription": "目标资源 key(应用/门户 key)。",
+          "x-backend": "ComponentFavouriteItemInfo.linkKey"
+        },
+        "link_id": {
+          "type": "integer",
+          "favouriteItemLinkIdShapeDescription": "目标资源 id。",
+          "x-backend": "ComponentFavouriteItemInfo.linkId"
+        },
+        "icon_url": {
+          "type": "string",
+          "favouriteItemIconShapeDescription": "条目图标 url。别名 iconUrl。",
+          "x-backend": "ComponentFavouriteItemInfo.iconUrl"
+        },
+        "jump_mode": {
+          "type": "integer",
+          "favouriteItemJumpModeShapeDescription": "跳转方式。",
+          "x-backend": "ComponentFavouriteItemInfo.jumpMode"
+        },
+        "ordinal": {
+          "type": "integer",
+          "favouriteItemOrdinalShapeDescription": "排序序号。",
+          "x-backend": "ComponentFavouriteItemInfo.ordinal"
+        }
+      }
+    },
+    "Section": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "title",
+        "source_type",
+        "favourite"
+      ],
+      "properties": {
+        "title": {
+          "type": "string",
+          "minLength": 1,
+          "sectionTitleShapeDescription": "组件标题(渲染在组件头部)。",
+          "x-backend": "组件标题(DashChartInfo.title / gridConfig.gridTitle 等)"
+        },
+        "source_type": {
+          "const": "favourite",
+          "sourceTypeConstDescription": "组件类型固定为 favourite(收藏);后端 type 整数见 x-backend。",
+          "x-backend": "DashComponentInfo.type(favourite)"
+        },
+        "role": {
+          "type": "string",
+          "roleShapeDescription": "组件角色标注(编排辅助,如 metric=指标卡;影响布局预设的排布与行高)。别名 zone/section_role。"
+        },
+        "position": {
+          "$ref": "#/$defs/Position"
+        },
+        "style_config": {
+          "type": "object",
+          "styleConfigSectionDescription": "组件级样式(受控键集;键白名单以 ws40013 dataset 实测形态校准,未经校准的键会被拒绝)。别名 dash_style_config/dashStyleConfigBO。",
+          "x-backend": "DashComponentInfo.dashStyleConfigBO(DashStyleConfigBO)"
+        },
+        "favourite": {
+          "$ref": "#/$defs/FavouriteConfig",
+          "favouritePropDescription": "收藏配置(必填)。"
+        }
+      }
+    }
+  },
+  "$ref": "#/$defs/Section",
+  "x-qingflow-detail-query": {
+    "currentKind": "favourite",
+    "tool": "portal_schema",
+    "cli": "qingflow builder portal schema --schema-kind favourite",
+    "argument": "schema_kind",
+    "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。",
+    "readSources": {
+      "chartIds": "已有图表 id 用 chart 面读取;内联创建直接在 chart 键声明。",
+      "viewKeys": "视图唯一键用 qingflow builder views get --app-key APP 回读。"
+    }
+  },
+  "examples": [
+    {
+      "title": "常用入口",
+      "source_type": "favourite",
+      "position": {
+        "pc": {
+          "x": 12,
+          "y": 11,
+          "cols": 12,
+          "rows": 8
+        }
+      },
+      "favourite": {
+        "show_title": true,
+        "items": [
+          {
+            "title": "设备台账",
+            "item_type": 1,
+            "link_key": "APP_KEY_DEVICE",
+            "jump_mode": 1
+          }
+        ]
+      }
+    }
+  ]
+}

package/src/qingflow_mcp/builder_facade/schemas/portals/v1alpha1/components/filter.json

@@ -0,0 +1,268 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://qingflow.com/schemas/builder/portals/v1alpha1/components/filter.json",
+  "title": "Qingflow Builder Portals Section · filter (v1alpha1)",
+  "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 档。",
+  "$defs": {
+    "Position": {
+      "type": "object",
+      "additionalProperties": false,
+      "positionShapeDescription": "网格位置。PC 是 24 列网格(cols≤24),mobile 是 6 列网格(cols≤6);同行组件共享同一 y 与 rows,一行 cols 合计 24。mobile 可省略(缺省与 pc 同布局)。平铺别名 pc_x/pc_y/pc_w/pc_h、mobile_* 也接受,归一为本结构。标准行高:指标卡 rows=5、BI 图表 rows=7、数据视图 rows=11、业务入口 rows=4。",
+      "properties": {
+        "pc": {
+          "$ref": "#/$defs/PositionDetail"
+        },
+        "mobile": {
+          "$ref": "#/$defs/PositionDetail"
+        }
+      }
+    },
+    "PositionDetail": {
+      "type": "object",
+      "additionalProperties": false,
+      "positionDetailShapeDescription": "单端位置:x=列偏移、y=行偏移、cols=占宽、rows=占高。",
+      "properties": {
+        "x": {
+          "type": [
+            "integer",
+            "null"
+          ],
+          "minimum": 0
+        },
+        "y": {
+          "type": [
+            "integer",
+            "null"
+          ],
+          "minimum": 0
+        },
+        "cols": {
+          "type": [
+            "integer",
+            "null"
+          ],
+          "minimum": 1
+        },
+        "rows": {
+          "type": [
+            "integer",
+            "null"
+          ],
+          "minimum": 1
+        }
+      },
+      "x-backend": "DashPosition.pc / DashPosition.mobile"
+    },
+    "FilterConfig": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "groups"
+      ],
+      "filterConfigShapeDescription": "筛选组件配置。筛选语义 raw/unstable,不建议作为主自动化路径;条件明细为受控透传(键集以 ws40013 dataset 实测形态定稿)。",
+      "properties": {
+        "graphs": {
+          "type": "array",
+          "filterGraphsShapeDescription": "筛选作用的图表引用(为空表示作用于全部图表)。",
+          "items": {
+            "$ref": "#/$defs/FilterGraphRef"
+          },
+          "x-backend": "ComponentFilter.graphList(GraphVO.graphKey/graphName/graphType)"
+        },
+        "groups": {
+          "type": "array",
+          "minItems": 1,
+          "filterGroupsShapeDescription": "筛选规则组。",
+          "items": {
+            "$ref": "#/$defs/FilterGroup"
+          },
+          "x-backend": "ComponentFilter.filterConfig(List<FilterConfig>)"
+        }
+      }
+    },
+    "FilterGraphRef": {
+      "type": "object",
+      "additionalProperties": false,
+      "filterGraphRefShapeDescription": "受筛选作用的图表引用;chart_key 或 chart_name 至少一个。",
+      "anyOf": [
+        {
+          "required": [
+            "chart_key"
+          ]
+        },
+        {
+          "required": [
+            "chart_name"
+          ]
+        }
+      ],
+      "properties": {
+        "chart_key": {
+          "type": "string",
+          "filterGraphKeyShapeDescription": "图表 key。别名 chartKey/graphKey。",
+          "x-backend": "GraphVO.graphKey"
+        },
+        "chart_name": {
+          "type": "string",
+          "filterGraphNameShapeDescription": "图表名称。别名 graphName。",
+          "x-backend": "GraphVO.graphName"
+        }
+      }
+    },
+    "FilterGroup": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "items"
+      ],
+      "filterGroupShapeDescription": "筛选规则组。",
+      "properties": {
+        "group_id": {
+          "type": "integer",
+          "filterGroupIdShapeDescription": "组 id(更新已有组时锚定;缺省新建)。",
+          "x-backend": "FilterConfig.filterGroupId"
+        },
+        "name": {
+          "type": "string",
+          "filterGroupNameShapeDescription": "组名称。",
+          "x-backend": "FilterConfig.filterGroupName"
+        },
+        "items": {
+          "type": "array",
+          "minItems": 1,
+          "filterGroupItemsShapeDescription": "组内筛选项。",
+          "items": {
+            "$ref": "#/$defs/FilterItem"
+          }
+        }
+      }
+    },
+    "FilterItem": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "name"
+      ],
+      "filterItemShapeDescription": "单个筛选项(绑定一个字段)。",
+      "properties": {
+        "item_id": {
+          "type": "integer",
+          "filterItemIdShapeDescription": "筛选项 id(更新锚定)。",
+          "x-backend": "FilterGroupConfig.filterItemId"
+        },
+        "name": {
+          "type": "string",
+          "filterItemNameShapeDescription": "筛选项名称。",
+          "x-backend": "FilterGroupConfig.filterItemName"
+        },
+        "conditions": {
+          "type": "array",
+          "filterItemConditionsShapeDescription": "筛选条件(受控透传;条件表达式键集以 dataset 实测形态定稿后开放规范键)。",
+          "x-backend": "FilterGroupConfig.filterCondition(List<FilterCondition>)"
+        },
+        "default_judge_type": {
+          "type": "integer",
+          "filterItemDftJudgeTypeShapeDescription": "默认比较符。",
+          "x-backend": "FilterGroupConfig.dftJudgeType"
+        },
+        "default_values": {
+          "type": "array",
+          "filterItemDftValuesShapeDescription": "默认比较值(受控透传)。",
+          "x-backend": "FilterGroupConfig.dftJudgeValue(List<AnswerValue>)"
+        },
+        "filter_type": {
+          "type": "string",
+          "filterItemTypeShapeDescription": "筛选项交互类型(受控枚举,dataset 校准)。",
+          "x-backend": "FilterGroupConfig.filterType"
+        }
+      }
+    },
+    "Section": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "title",
+        "source_type",
+        "config"
+      ],
+      "properties": {
+        "title": {
+          "type": "string",
+          "minLength": 1,
+          "sectionTitleShapeDescription": "组件标题(渲染在组件头部)。",
+          "x-backend": "组件标题(DashChartInfo.title / gridConfig.gridTitle 等)"
+        },
+        "source_type": {
+          "const": "filter",
+          "sourceTypeConstDescription": "组件类型固定为 filter(筛选);后端 type 整数见 x-backend。",
+          "x-backend": "DashComponentInfo.type(filter)"
+        },
+        "role": {
+          "type": "string",
+          "roleShapeDescription": "组件角色标注(编排辅助,如 metric=指标卡;影响布局预设的排布与行高)。别名 zone/section_role。"
+        },
+        "position": {
+          "$ref": "#/$defs/Position"
+        },
+        "style_config": {
+          "type": "object",
+          "styleConfigSectionDescription": "组件级样式(受控键集;键白名单以 ws40013 dataset 实测形态校准,未经校准的键会被拒绝)。别名 dash_style_config/dashStyleConfigBO。",
+          "x-backend": "DashComponentInfo.dashStyleConfigBO(DashStyleConfigBO)"
+        },
+        "config": {
+          "$ref": "#/$defs/FilterConfig",
+          "filterConfigPropDescription": "筛选配置(必填,groups 非空)。"
+        }
+      }
+    }
+  },
+  "$ref": "#/$defs/Section",
+  "x-qingflow-detail-query": {
+    "currentKind": "filter",
+    "tool": "portal_schema",
+    "cli": "qingflow builder portal schema --schema-kind filter",
+    "argument": "schema_kind",
+    "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。",
+    "readSources": {
+      "chartIds": "已有图表 id 用 chart 面读取;内联创建直接在 chart 键声明。",
+      "viewKeys": "视图唯一键用 qingflow builder views get --app-key APP 回读。"
+    }
+  },
+  "examples": [
+    {
+      "title": "数据筛选",
+      "source_type": "filter",
+      "position": {
+        "pc": {
+          "x": 0,
+          "y": 0,
+          "cols": 24,
+          "rows": 3
+        }
+      },
+      "config": {
+        "graphs": [
+          {
+            "chart_key": "CHART_KEY_1001"
+          },
+          {
+            "chart_name": "故障类型分布"
+          }
+        ],
+        "groups": [
+          {
+            "name": "默认组",
+            "items": [
+              {
+                "name": "报修日期",
+                "default_judge_type": 1,
+                "default_values": [],
+                "filter_type": "dateRange"
+              }
+            ]
+          }
+        ]
+      }
+    }
+  ]
+}