@qingflow-tech/qingflow-cli 1.1.42 → 1.1.43-beta.1

package/src/qingflow_mcp/builder_facade/schemas/app_form/v1alpha1/fields/subtable.json

@@ -0,0 +1,810 @@
+{
+  "$defs": {
+    "AliasSelector": {
+      "additionalProperties": false,
+      "description": "Q-Linker 或代码块输出别名;已有输出优先携带 aliasId。",
+      "properties": {
+        "aliasId": {
+          "description": "后端生成的别名 ID;新增输出时可省略。",
+          "minimum": 1,
+          "type": "integer"
+        },
+        "name": {
+          "description": "输出别名名称。",
+          "minLength": 1,
+          "type": "string"
+        }
+      },
+      "required": [
+        "name"
+      ],
+      "type": "object"
+    },
+    "ChoiceConfig": {
+      "additionalProperties": false,
+      "description": "选择类字段配置。",
+      "properties": {
+        "options": {
+          "description": "非空有序选项文案;缺失选项表示从该字段配置中删除。",
+          "items": {
+            "minLength": 1,
+            "type": "string"
+          },
+          "minItems": 1,
+          "type": "array",
+          "uniqueItems": true
+        }
+      },
+      "required": [
+        "options"
+      ],
+      "type": "object"
+    },
+    "DataRelationCondition": {
+      "additionalProperties": false,
+      "description": "一条数据关联过滤条件。",
+      "properties": {
+        "operand": {
+          "$ref": "#/$defs/DataRelationOperand",
+          "description": "比较值来源;可为字面量、当前表单字段或输出别名。"
+        },
+        "operator": {
+          "description": "比较运算符;Reconciler 会结合字段类型校验可用性。",
+          "enum": [
+            "equal",
+            "not_equal",
+            "contains",
+            "not_contains",
+            "greater_than",
+            "greater_or_equal",
+            "less_than",
+            "less_or_equal",
+            "dynamic_range",
+            "equal_any",
+            "not_equal_any",
+            "is_empty",
+            "is_not_empty",
+            "belongs_to",
+            "not_belongs_to",
+            "subordinate_to",
+            "not_subordinate_to",
+            "subordinate_included",
+            "subordinate_not_included",
+            "fuzzy_match",
+            "contains_any",
+            "contains_all",
+            "decimal_range"
+          ]
+        },
+        "sourceField": {
+          "$ref": "#/$defs/FieldSelector",
+          "description": "被过滤的数据源字段。"
+        }
+      },
+      "required": [
+        "sourceField",
+        "operator",
+        "operand"
+      ],
+      "type": "object"
+    },
+    "DataRelationConfig": {
+      "additionalProperties": false,
+      "description": "数据关联字段配置;从应用、Q-Linker 或代码块输出中读取数据。",
+      "properties": {
+        "aggregation": {
+          "description": "可选聚合方式;null 表示不聚合。",
+          "enum": [
+            "sum",
+            "average",
+            "max",
+            "min",
+            "first",
+            "last",
+            "filled_count",
+            "empty_count",
+            "count",
+            null
+          ],
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "customButton": {
+          "$ref": "#/$defs/DataRelationCustomButton",
+          "description": "可选自定义按钮配置。"
+        },
+        "filters": {
+          "$ref": "#/$defs/DataRelationFilters",
+          "description": "可选过滤条件;支持简单条件组或高级公式。"
+        },
+        "sort": {
+          "$ref": "#/$defs/DataRelationSort",
+          "description": "可选排序配置。"
+        },
+        "source": {
+          "$ref": "#/$defs/DataRelationSource",
+          "description": "数据来源;按 kind 选择一种来源结构。"
+        }
+      },
+      "required": [
+        "source"
+      ],
+      "type": "object"
+    },
+    "DataRelationCustomButton": {
+      "description": "数据关联自定义按钮;启用时必须引用已有 buttonId。",
+      "oneOf": [
+        {
+          "additionalProperties": false,
+          "properties": {
+            "enabled": {
+              "const": false
+            }
+          },
+          "required": [
+            "enabled"
+          ],
+          "type": "object"
+        },
+        {
+          "additionalProperties": false,
+          "properties": {
+            "buttonId": {
+              "minimum": 1,
+              "type": "integer"
+            },
+            "enabled": {
+              "const": true
+            }
+          },
+          "required": [
+            "enabled",
+            "buttonId"
+          ],
+          "type": "object"
+        }
+      ]
+    },
+    "DataRelationFilters": {
+      "description": "simple 模式的外层组为 OR、组内条件为 AND;advanced 模式使用完整公式。",
+      "oneOf": [
+        {
+          "additionalProperties": false,
+          "properties": {
+            "groups": {
+              "description": "OR 条件组数组;每个内层数组是一组 AND 条件。",
+              "items": {
+                "items": {
+                  "$ref": "#/$defs/DataRelationCondition"
+                },
+                "minItems": 1,
+                "type": "array"
+              },
+              "type": "array"
+            },
+            "mode": {
+              "const": "simple"
+            }
+          },
+          "required": [
+            "mode",
+            "groups"
+          ],
+          "type": "object"
+        },
+        {
+          "additionalProperties": false,
+          "properties": {
+            "formula": {
+              "description": "解码后的高级筛选公式。",
+              "minLength": 1,
+              "type": "string"
+            },
+            "mode": {
+              "const": "advanced"
+            }
+          },
+          "required": [
+            "mode",
+            "formula"
+          ],
+          "type": "object"
+        }
+      ]
+    },
+    "DataRelationOperand": {
+      "description": "数据关联条件右值的判别联合。",
+      "oneOf": [
+        {
+          "additionalProperties": false,
+          "properties": {
+            "kind": {
+              "const": "literal"
+            },
+            "values": {
+              "description": "字面量值列表。",
+              "items": {
+                "$ref": "#/$defs/JsonValue"
+              },
+              "type": "array"
+            }
+          },
+          "required": [
+            "kind",
+            "values"
+          ],
+          "type": "object"
+        },
+        {
+          "additionalProperties": false,
+          "properties": {
+            "field": {
+              "$ref": "#/$defs/FieldSelector"
+            },
+            "kind": {
+              "const": "current_field"
+            }
+          },
+          "required": [
+            "kind",
+            "field"
+          ],
+          "type": "object"
+        },
+        {
+          "additionalProperties": false,
+          "properties": {
+            "alias": {
+              "$ref": "#/$defs/AliasSelector"
+            },
+            "kind": {
+              "const": "alias"
+            },
+            "producer": {
+              "$ref": "#/$defs/FieldSelector"
+            }
+          },
+          "required": [
+            "kind",
+            "producer",
+            "alias"
+          ],
+          "type": "object"
+        }
+      ]
+    },
+    "DataRelationSort": {
+      "description": "数据关联排序开关;启用时必须指定排序来源和方向。",
+      "oneOf": [
+        {
+          "additionalProperties": false,
+          "properties": {
+            "enabled": {
+              "const": false
+            }
+          },
+          "required": [
+            "enabled"
+          ],
+          "type": "object"
+        },
+        {
+          "additionalProperties": false,
+          "properties": {
+            "by": {
+              "$ref": "#/$defs/DataRelationSortBy"
+            },
+            "direction": {
+              "enum": [
+                "asc",
+                "desc"
+              ]
+            },
+            "enabled": {
+              "const": true
+            }
+          },
+          "required": [
+            "enabled",
+            "by",
+            "direction"
+          ],
+          "type": "object"
+        }
+      ]
+    },
+    "DataRelationSortBy": {
+      "description": "排序值来源;可为来源字段或输出别名。",
+      "oneOf": [
+        {
+          "additionalProperties": false,
+          "properties": {
+            "field": {
+              "$ref": "#/$defs/FieldSelector"
+            },
+            "kind": {
+              "const": "field"
+            }
+          },
+          "required": [
+            "kind",
+            "field"
+          ],
+          "type": "object"
+        },
+        {
+          "additionalProperties": false,
+          "properties": {
+            "alias": {
+              "$ref": "#/$defs/AliasSelector"
+            },
+            "kind": {
+              "const": "alias"
+            },
+            "producer": {
+              "$ref": "#/$defs/FieldSelector"
+            }
+          },
+          "required": [
+            "kind",
+            "producer",
+            "alias"
+          ],
+          "type": "object"
+        }
+      ]
+    },
+    "DataRelationSource": {
+      "description": "数据关联来源判别联合;kind 决定其余必填字段。",
+      "oneOf": [
+        {
+          "additionalProperties": false,
+          "properties": {
+            "appKey": {
+              "description": "来源应用的 appKey。",
+              "minLength": 1,
+              "type": "string"
+            },
+            "field": {
+              "$ref": "#/$defs/FieldSelector",
+              "description": "来源应用中的结果字段。"
+            },
+            "kind": {
+              "const": "app"
+            }
+          },
+          "required": [
+            "kind",
+            "appKey",
+            "field"
+          ],
+          "type": "object"
+        },
+        {
+          "additionalProperties": false,
+          "properties": {
+            "alias": {
+              "$ref": "#/$defs/AliasSelector",
+              "description": "Q-Linker 输出别名。"
+            },
+            "kind": {
+              "const": "q_linker"
+            },
+            "producer": {
+              "$ref": "#/$defs/FieldSelector",
+              "description": "当前应用中的 Q-Linker 字段。"
+            }
+          },
+          "required": [
+            "kind",
+            "producer",
+            "alias"
+          ],
+          "type": "object"
+        },
+        {
+          "additionalProperties": false,
+          "properties": {
+            "alias": {
+              "$ref": "#/$defs/AliasSelector",
+              "description": "代码块输出别名。"
+            },
+            "kind": {
+              "const": "code_block"
+            },
+            "producer": {
+              "$ref": "#/$defs/FieldSelector",
+              "description": "当前应用中的代码块字段。"
+            }
+          },
+          "required": [
+            "kind",
+            "producer",
+            "alias"
+          ],
+          "type": "object"
+        }
+      ]
+    },
+    "DepartmentConfig": {
+      "additionalProperties": false,
+      "description": "部门字段的可选范围配置。",
+      "properties": {
+        "departmentScope": {
+          "$ref": "#/$defs/DepartmentScope"
+        }
+      },
+      "required": [
+        "departmentScope"
+      ],
+      "type": "object"
+    },
+    "DepartmentScope": {
+      "description": "all 表示全部部门;custom 表示仅允许指定部门。",
+      "oneOf": [
+        {
+          "additionalProperties": false,
+          "properties": {
+            "includeSubDeparts": {
+              "description": "是否包含所选部门的下级部门。",
+              "type": "boolean"
+            },
+            "mode": {
+              "const": "all"
+            }
+          },
+          "required": [
+            "mode"
+          ],
+          "type": "object"
+        },
+        {
+          "additionalProperties": false,
+          "properties": {
+            "departments": {
+              "description": "custom 模式允许选择的部门列表。",
+              "items": {
+                "$ref": "#/$defs/DepartmentSelector"
+              },
+              "minItems": 1,
+              "type": "array"
+            },
+            "includeSubDeparts": {
+              "description": "是否包含指定部门的下级部门。",
+              "type": "boolean"
+            },
+            "mode": {
+              "const": "custom"
+            }
+          },
+          "required": [
+            "mode",
+            "departments"
+          ],
+          "type": "object"
+        }
+      ]
+    },
+    "DepartmentSelector": {
+      "additionalProperties": false,
+      "description": "部门身份;deptId 必填,deptName 仅用于展示。",
+      "properties": {
+        "deptId": {
+          "minimum": 1,
+          "type": "integer"
+        },
+        "deptName": {
+          "minLength": 1,
+          "type": "string"
+        }
+      },
+      "required": [
+        "deptId"
+      ],
+      "type": "object"
+    },
+    "EmptyConfig": {
+      "additionalProperties": false,
+      "description": "该字段类型没有特殊配置。",
+      "type": "object"
+    },
+    "FieldCommon": {
+      "description": "顶层业务字段的公共属性;字段类型由 TopField 的判别分支定义。",
+      "properties": {
+        "dataCover": {
+          "description": "是否作为数据封面;仅顶层附件字段可设为 true。",
+          "type": "boolean"
+        },
+        "dataTitle": {
+          "description": "是否作为数据标题;整个 body 最多且必须按规则存在一个。",
+          "type": "boolean"
+        },
+        "description": {
+          "description": "字段说明;null 或空字符串表示清空。",
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "name": {
+          "description": "字段展示名称;同一父级内唯一,不单独作为字段身份。",
+          "minLength": 1,
+          "type": "string"
+        },
+        "queId": {
+          "description": "已有字段的后端 ID;get 返回,新增字段省略。",
+          "minimum": 1,
+          "type": "integer"
+        },
+        "required": {
+          "description": "是否必填;缺失时保留已有字段当前值。",
+          "type": "boolean"
+        },
+        "width": {
+          "description": "字段在所在行的宽度百分比;同一行要么全部提供且合计 100,要么全部省略。",
+          "maximum": 100,
+          "minimum": 1,
+          "type": "integer"
+        }
+      },
+      "required": [
+        "name"
+      ],
+      "type": "object"
+    },
+    "FieldSelector": {
+      "additionalProperties": false,
+      "anyOf": [
+        {
+          "required": [
+            "queId"
+          ]
+        },
+        {
+          "required": [
+            "name"
+          ]
+        }
+      ],
+      "description": "跨字段引用选择器;至少提供 queId 或 name,两者同时提供时必须指向同一字段。",
+      "properties": {
+        "name": {
+          "description": "字段名称;仅在当前作用域内唯一时可用于解析。",
+          "minLength": 1,
+          "type": "string"
+        },
+        "queId": {
+          "description": "已有字段的后端 ID;优先用于精确解析。",
+          "minimum": 1,
+          "type": "integer"
+        }
+      },
+      "type": "object"
+    },
+    "JsonValue": {
+      "description": "数据关联字面量支持的任意 JSON 值。",
+      "oneOf": [
+        {
+          "type": "null"
+        },
+        {
+          "type": "boolean"
+        },
+        {
+          "type": "number"
+        },
+        {
+          "type": "string"
+        },
+        {
+          "items": {
+            "$ref": "#/$defs/JsonValue"
+          },
+          "type": "array"
+        },
+        {
+          "additionalProperties": {
+            "$ref": "#/$defs/JsonValue"
+          },
+          "type": "object"
+        }
+      ]
+    },
+    "RelationConfig": {
+      "additionalProperties": false,
+      "description": "引用字段配置;引用其他应用中的数据。",
+      "properties": {
+        "displayField": {
+          "$ref": "#/$defs/FieldSelector",
+          "description": "引用值的主展示字段。"
+        },
+        "relationMode": {
+          "default": "single",
+          "description": "单条引用或多条引用;缺失时按 single 处理。",
+          "enum": [
+            "single",
+            "multiple"
+          ]
+        },
+        "targetAppKey": {
+          "description": "被引用应用的 appKey。",
+          "minLength": 1,
+          "type": "string"
+        },
+        "visibleFields": {
+          "description": "引用选择界面额外展示的字段。",
+          "items": {
+            "$ref": "#/$defs/FieldSelector"
+          },
+          "type": "array",
+          "uniqueItems": true
+        }
+      },
+      "required": [
+        "targetAppKey",
+        "displayField"
+      ],
+      "type": "object"
+    },
+    "SubField": {
+      "allOf": [
+        {
+          "$ref": "#/$defs/SubFieldCommon"
+        },
+        {
+          "oneOf": [
+            {
+              "properties": {
+                "config": {
+                  "$ref": "#/$defs/EmptyConfig"
+                },
+                "type": {
+                  "enum": [
+                    "text",
+                    "long_text",
+                    "number",
+                    "link",
+                    "date",
+                    "phone",
+                    "email",
+                    "attachment",
+                    "member"
+                  ]
+                }
+              },
+              "required": [
+                "type"
+              ]
+            },
+            {
+              "properties": {
+                "config": {
+                  "$ref": "#/$defs/ChoiceConfig"
+                },
+                "type": {
+                  "enum": [
+                    "single_choice",
+                    "single_select",
+                    "multi_select"
+                  ]
+                }
+              },
+              "required": [
+                "type",
+                "config"
+              ]
+            },
+            {
+              "properties": {
+                "config": {
+                  "$ref": "#/$defs/DepartmentConfig"
+                },
+                "type": {
+                  "const": "department"
+                }
+              },
+              "required": [
+                "type",
+                "config"
+              ]
+            },
+            {
+              "properties": {
+                "config": {
+                  "$ref": "#/$defs/RelationConfig"
+                },
+                "type": {
+                  "const": "relation"
+                }
+              },
+              "required": [
+                "type",
+                "config"
+              ]
+            },
+            {
+              "properties": {
+                "config": {
+                  "$ref": "#/$defs/DataRelationConfig"
+                },
+                "type": {
+                  "const": "data_relation"
+                }
+              },
+              "required": [
+                "type",
+                "config"
+              ]
+            }
+          ]
+        }
+      ],
+      "description": "表格子字段;仅允许一期白名单类型,不包含布局宽度。",
+      "type": "object",
+      "unevaluatedProperties": false
+    },
+    "SubFieldCommon": {
+      "description": "表格子字段的公共属性;不允许 dataTitle、dataCover 或 width。",
+      "properties": {
+        "description": {
+          "description": "子字段说明;null 或空字符串表示清空。",
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "name": {
+          "description": "子字段展示名称;在所属表格内唯一。",
+          "minLength": 1,
+          "type": "string"
+        },
+        "queId": {
+          "description": "已有子字段的后端 ID;新增时省略。",
+          "minimum": 1,
+          "type": "integer"
+        },
+        "required": {
+          "description": "是否必填;缺失时保留当前值。",
+          "type": "boolean"
+        }
+      },
+      "required": [
+        "name"
+      ],
+      "type": "object"
+    }
+  },
+  "$id": "https://builder.qingflow.com/schemas/app-form-apply/v1alpha1/fields/subtable.json",
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "allOf": [
+    {
+      "$ref": "#/$defs/FieldCommon"
+    },
+    {
+      "properties": {
+        "config": {
+          "$ref": "#/$defs/EmptyConfig"
+        },
+        "subfields": {
+          "items": {
+            "$ref": "#/$defs/SubField"
+          },
+          "minItems": 1,
+          "type": "array"
+        },
+        "type": {
+          "const": "subtable"
+        }
+      },
+      "required": [
+        "type",
+        "subfields"
+      ]
+    }
+  ],
+  "title": "Qingflow AppForm v1alpha1 subtable field",
+  "type": "object",
+  "unevaluatedProperties": false
+}