@qingflow-tech/qingflow-cli 1.1.61-beta.4 → 1.1.61-beta.6

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

@@ -0,0 +1,193 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://qingflow.com/schemas/builder/portals/v1alpha1/components/carousel.json",
+  "title": "Qingflow Builder Portals Section · carousel (v1alpha1)",
+  "portalCarouselSectionDescription": "门户轮播组件(carousel)的详细配置专项 Schema。获取命令:qingflow builder portal schema --schema-kind carousel(MCP: portal_schema(schema_kind=\"carousel\"))。本 Schema 校验 sections[] 中单个 carousel 区块(自包含,可直接交给 JSON Schema 校验器);后端 DashComponentInfo.type=3。整门户声明走 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_* 也接受(x/y 与 w/h/cols/rows 混写均认),归一为本结构。标准行高:指标卡 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"
+    },
+    "CarouselConfig": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [],
+      "carouselShapeDescription": "轮播组件配置:绑定一个应用的记录流,按标题/图片/链接字段轮播展示。",
+      "properties": {
+        "source_app_key": {
+          "type": "string",
+          "carouselSourceAppShapeDescription": "轮播数据源应用 key。 悬空轮播(源表已删,related_form_id NULL 存量形态)缺省合法:后端写链不写 relatedFormId,读面回空 sourceApp。",
+          "x-backend": "ComponentCarouselConfig.sourceApp(ComponentFormBaseInfo.appKey)"
+        },
+        "source_form_title": {
+          "type": "string",
+          "carouselSourceFormShapeDescription": "数据源应用名称(辅助校验,缺省按 app_key 解析)。",
+          "x-backend": "ComponentFormBaseInfo.formTitle"
+        },
+        "title_field": {
+          "type": "string",
+          "carouselTitleFieldShapeDescription": "标题字段(显示名)。",
+          "x-backend": "ComponentCarouselConfig.titleQue(ComponentQueBaseInfo)"
+        },
+        "image_field": {
+          "type": "string",
+          "carouselImageFieldShapeDescription": "图片字段(显示名,附件/图片类字段)。",
+          "x-backend": "ComponentCarouselConfig.imageQue"
+        },
+        "link_field": {
+          "type": "string",
+          "carouselLinkFieldShapeDescription": "链接字段(显示名,点击轮播项跳转)。",
+          "x-backend": "ComponentCarouselConfig.linkQue"
+        },
+        "jump_mode": {
+          "type": "integer",
+          "carouselJumpModeShapeDescription": "跳转方式。",
+          "x-backend": "ComponentCarouselConfig.jumpMode"
+        },
+        "scaling": {
+          "type": "boolean",
+          "carouselScalingShapeDescription": "图片是否缩放填充。别名 beingScaling。",
+          "x-backend": "ComponentCarouselConfig.beingScaling"
+        },
+        "show_latest_limit": {
+          "type": "integer",
+          "minimum": 1,
+          "carouselShowLatestShapeDescription": "只展示最新 N 条记录。",
+          "x-backend": "ComponentCarouselConfig.showLatestLimit"
+        },
+        "scroll_interval": {
+          "type": "integer",
+          "minimum": 1,
+          "carouselScrollIntervalShapeDescription": "轮播滚动间隔(秒)。",
+          "x-backend": "ComponentCarouselConfig.scrollInterval"
+        },
+        "filters": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "carouselFiltersShapeDescription": "数据源过滤条件(受控透传,MatchRule 组;规范键 dataset 校准后开放)。",
+            "x-backend": "ComponentCarouselConfig.filterConfig(List<List<MatchRule>>)"
+          }
+        }
+      }
+    },
+    "Section": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "title",
+        "source_type",
+        "carousel"
+      ],
+      "properties": {
+        "title": {
+          "type": "string",
+          "minLength": 1,
+          "sectionTitleShapeDescription": "组件标题(渲染在组件头部)。",
+          "x-backend": "组件标题(DashChartInfo.title / gridConfig.gridTitle 等)"
+        },
+        "source_type": {
+          "const": "carousel",
+          "sourceTypeConstDescription": "组件类型固定为 carousel(轮播);后端 type 整数见 x-backend。",
+          "x-backend": "DashComponentInfo.type(carousel)"
+        },
+        "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)"
+        },
+        "carousel": {
+          "$ref": "#/$defs/CarouselConfig",
+          "carouselPropDescription": "轮播配置(必填)。"
+        }
+      }
+    }
+  },
+  "$ref": "#/$defs/Section",
+  "x-qingflow-detail-query": {
+    "currentKind": "carousel",
+    "tool": "portal_schema",
+    "cli": "qingflow builder portal schema --schema-kind carousel",
+    "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": "carousel",
+      "position": {
+        "pc": {
+          "x": 12,
+          "y": 4,
+          "cols": 12,
+          "rows": 7
+        }
+      },
+      "carousel": {
+        "source_app_key": "APP_KEY_NOTICE",
+        "title_field": "公告标题",
+        "image_field": "封面图",
+        "link_field": "详情链接",
+        "show_latest_limit": 5,
+        "scroll_interval": 8,
+        "scaling": true
+      }
+    }
+  ]
+}