@qingflow-tech/qingflow-cli 1.1.43 → 1.1.44

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

@@ -0,0 +1,484 @@
+{
+  "$defs": {
+    "DepartmentSelector": {
+      "additionalProperties": false,
+      "description": "部门身份;deptId 必填,deptName 仅用于展示。",
+      "properties": {
+        "deptId": {
+          "minimum": 1,
+          "type": "integer"
+        },
+        "deptName": {
+          "minLength": 1,
+          "type": "string"
+        }
+      },
+      "required": [
+        "deptId"
+      ],
+      "type": "object"
+    },
+    "DynamicMemberSelector": {
+      "additionalProperties": false,
+      "properties": {
+        "queId": {
+          "type": "integer"
+        },
+        "queTitle": {
+          "type": "string"
+        },
+        "type": {
+          "minimum": 1,
+          "type": "integer"
+        }
+      },
+      "required": [
+        "type"
+      ],
+      "type": "object"
+    },
+    "ExternalDepartmentSelector": {
+      "additionalProperties": false,
+      "properties": {
+        "deptId": {
+          "minimum": 1,
+          "type": "integer"
+        },
+        "deptName": {
+          "type": "string"
+        }
+      },
+      "required": [
+        "deptId"
+      ],
+      "type": "object"
+    },
+    "ExternalMemberSelector": {
+      "additionalProperties": false,
+      "properties": {
+        "email": {
+          "type": "string"
+        },
+        "nickName": {
+          "type": "string"
+        },
+        "uid": {
+          "minimum": 1,
+          "type": "integer"
+        }
+      },
+      "required": [
+        "uid"
+      ],
+      "type": "object"
+    },
+    "FieldCommon": {
+      "allOf": [
+        {
+          "if": {
+            "properties": {
+              "defaultType": {
+                "const": 2
+              }
+            },
+            "required": [
+              "defaultType"
+            ]
+          },
+          "then": {
+            "properties": {
+              "defaultValue": {
+                "type": "null"
+              }
+            }
+          }
+        },
+        {
+          "if": {
+            "properties": {
+              "defaultType": {
+                "const": 3
+              }
+            },
+            "required": [
+              "defaultType"
+            ]
+          },
+          "then": {
+            "properties": {
+              "defaultValue": {
+                "minLength": 1,
+                "type": [
+                  "string",
+                  "null"
+                ]
+              }
+            }
+          }
+        }
+      ],
+      "anyOf": [
+        {
+          "required": [
+            "queId"
+          ]
+        },
+        {
+          "required": [
+            "name"
+          ]
+        }
+      ],
+      "description": "顶层业务字段的公共属性;字段类型由 TopField 的判别分支定义。",
+      "properties": {
+        "beingRequired": {
+          "description": "该字段是否必填;缺失时保留已有字段当前值。",
+          "type": "boolean"
+        },
+        "defaultType": {
+          "default": 1,
+          "description": "默认值类型,与 defaultValue 联动;1 表示静态值,2 表示关联/绑定值且 defaultValue 只能省略或为 null,3 表示公式值且提供 defaultValue 时必须为非空公式文本。省略 defaultType 但提供 defaultValue 时按 1 处理。",
+          "enum": [
+            1,
+            2,
+            3
+          ],
+          "type": "integer"
+        },
+        "defaultValue": {
+          "$ref": "#/$defs/ScalarDefaultValue",
+          "description": "普通字段的默认值;后端 queDefaultValue 为字符串,因此数字等字面量也必须以字符串传入。defaultType 为 1 时表示静态文本,为 3 时表示公式文本,为 2 时不携带字面量默认值。表格、地址、附件、引用等结构化默认值必须放在具体字段 config.defaultValues。显式 null 表示清除默认值。"
+        },
+        "name": {
+          "description": "字段展示名称;新增字段必填,已有字段可在携带 queId 时省略;同一父级内唯一。",
+          "minLength": 1,
+          "type": "string"
+        },
+        "queId": {
+          "description": "已有字段的后端 ID;更新时用于精确定位并复用,新增字段通常省略。",
+          "minimum": 1,
+          "type": "integer"
+        },
+        "questionDescription": {
+          "description": "字段说明;null 或空字符串表示清空。",
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "questionType": {
+          "description": "字段类型;具体可用值由当前字段详情 Schema 的判别分支约束。",
+          "type": "string"
+        },
+        "width": {
+          "description": "字段在所在行的宽度百分比;只能选择 25、50、75 或 100。",
+          "enum": [
+            25,
+            50,
+            75,
+            100
+          ],
+          "type": "integer"
+        }
+      },
+      "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"
+    },
+    "MemberConfig": {
+      "additionalProperties": false,
+      "description": "成员字段的选择范围和默认成员。",
+      "properties": {
+        "canScan": {
+          "type": [
+            "boolean",
+            "null"
+          ]
+        },
+        "defaultMembers": {
+          "$ref": "#/$defs/MemberScope"
+        },
+        "memberScope": {
+          "$ref": "#/$defs/MemberScope"
+        },
+        "memberScopeRelation": {
+          "$ref": "#/$defs/SelectScopeRelation"
+        },
+        "noRepeat": {
+          "type": [
+            "boolean",
+            "null"
+          ]
+        },
+        "scanType": {
+          "minimum": 0,
+          "type": [
+            "integer",
+            "null"
+          ]
+        }
+      },
+      "type": "object"
+    },
+    "MemberScope": {
+      "description": "成员字段可选范围;all 为工作区全部成员,custom 为显式成员/部门/角色或动态成员,relation 为按字段关联。",
+      "oneOf": [
+        {
+          "additionalProperties": false,
+          "properties": {
+            "includeSubDeparts": {
+              "type": "boolean"
+            },
+            "mode": {
+              "const": "all"
+            }
+          },
+          "required": [
+            "mode"
+          ],
+          "type": "object"
+        },
+        {
+          "additionalProperties": false,
+          "properties": {
+            "departments": {
+              "items": {
+                "$ref": "#/$defs/DepartmentSelector"
+              },
+              "type": "array"
+            },
+            "dynamic": {
+              "items": {
+                "$ref": "#/$defs/DynamicMemberSelector"
+              },
+              "type": "array"
+            },
+            "externalDepartments": {
+              "items": {
+                "$ref": "#/$defs/ExternalDepartmentSelector"
+              },
+              "type": "array"
+            },
+            "externalMembers": {
+              "items": {
+                "$ref": "#/$defs/ExternalMemberSelector"
+              },
+              "type": "array"
+            },
+            "includeSubDeparts": {
+              "type": "boolean"
+            },
+            "members": {
+              "items": {
+                "$ref": "#/$defs/MemberSelector"
+              },
+              "type": "array"
+            },
+            "mode": {
+              "const": "custom"
+            },
+            "roles": {
+              "items": {
+                "$ref": "#/$defs/RoleSelector"
+              },
+              "type": "array"
+            }
+          },
+          "required": [
+            "mode"
+          ],
+          "type": "object"
+        },
+        {
+          "additionalProperties": false,
+          "properties": {
+            "departments": {
+              "items": {
+                "$ref": "#/$defs/DepartmentSelector"
+              },
+              "type": "array"
+            },
+            "dynamic": {
+              "items": {
+                "$ref": "#/$defs/DynamicMemberSelector"
+              },
+              "type": "array"
+            },
+            "externalDepartments": {
+              "items": {
+                "$ref": "#/$defs/ExternalDepartmentSelector"
+              },
+              "type": "array"
+            },
+            "externalMembers": {
+              "items": {
+                "$ref": "#/$defs/ExternalMemberSelector"
+              },
+              "type": "array"
+            },
+            "includeSubDeparts": {
+              "type": "boolean"
+            },
+            "members": {
+              "items": {
+                "$ref": "#/$defs/MemberSelector"
+              },
+              "type": "array"
+            },
+            "mode": {
+              "const": "relation"
+            },
+            "roles": {
+              "items": {
+                "$ref": "#/$defs/RoleSelector"
+              },
+              "type": "array"
+            }
+          },
+          "required": [
+            "mode"
+          ],
+          "type": "object"
+        }
+      ]
+    },
+    "MemberSelector": {
+      "additionalProperties": false,
+      "properties": {
+        "nickName": {
+          "minLength": 1,
+          "type": "string"
+        },
+        "uid": {
+          "minimum": 1,
+          "type": "integer"
+        }
+      },
+      "required": [
+        "uid"
+      ],
+      "type": "object"
+    },
+    "RoleSelector": {
+      "additionalProperties": false,
+      "properties": {
+        "roleId": {
+          "minimum": 1,
+          "type": "integer"
+        },
+        "roleName": {
+          "minLength": 1,
+          "type": "string"
+        }
+      },
+      "required": [
+        "roleId"
+      ],
+      "type": "object"
+    },
+    "ScalarDefaultValue": {
+      "description": "后端 queDefaultValue 支持的普通字段默认值;非空值必须是字符串,显式 null 表示清除默认值。数字和布尔值应先转换为字符串,对象和数组必须使用字段专用默认值配置。defaultType 为 3 时,通过 AppForm Schema 查询能力传入当前 schema_version 并设置 schema_kind=formula 获取公式语法、字段引用、运算符和全部函数说明;CLI 使用 builder app-form schema --schema-kind formula。需要配置结构化默认值时,传入当前 schema_version,并将字段的 questionType 作为 field_type 获取字段详细 Schema。",
+      "type": [
+        "null",
+        "string"
+      ]
+    },
+    "SelectScopeRelation": {
+      "additionalProperties": false,
+      "properties": {
+        "displayedField": {
+          "$ref": "#/$defs/FieldSelector"
+        },
+        "displayedFieldType": {
+          "type": [
+            "integer",
+            "null"
+          ]
+        },
+        "matchRuleFormula": {
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "matchRuleType": {
+          "type": [
+            "integer",
+            "null"
+          ]
+        },
+        "matchRules": {
+          "type": [
+            "array",
+            "null"
+          ]
+        },
+        "targetAppKey": {
+          "minLength": 1,
+          "type": "string"
+        },
+        "targetAppTitle": {
+          "type": [
+            "string",
+            "null"
+          ]
+        }
+      },
+      "required": [
+        "displayedField",
+        "targetAppKey"
+      ],
+      "type": "object"
+    }
+  },
+  "$id": "https://builder.qingflow.com/schemas/app-form-apply/v1alpha1/fields/member.json",
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "allOf": [
+    {
+      "$ref": "#/$defs/FieldCommon"
+    },
+    {
+      "properties": {
+        "config": {
+          "$ref": "#/$defs/MemberConfig"
+        },
+        "questionType": {
+          "const": "member"
+        }
+      },
+      "required": [
+        "questionType"
+      ]
+    }
+  ],
+  "title": "Qingflow AppForm v1alpha1 member field",
+  "type": "object",
+  "unevaluatedProperties": false
+}

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

@@ -0,0 +1,214 @@
+{
+  "$defs": {
+    "ChoiceConfig": {
+      "additionalProperties": false,
+      "description": "选择类字段配置。",
+      "properties": {
+        "beingShowColor": {
+          "description": "是否展示选项颜色。",
+          "type": [
+            "boolean",
+            "null"
+          ]
+        },
+        "defaultOptions": {
+          "description": "选项默认选中状态;值必须来自 options,省略表示保留现有状态。",
+          "items": {
+            "minLength": 1,
+            "type": "string"
+          },
+          "type": "array",
+          "uniqueItems": true
+        },
+        "maxOpts": {
+          "description": "最多选择项数;null 表示不限制。",
+          "minimum": 0,
+          "type": [
+            "integer",
+            "null"
+          ]
+        },
+        "minOpts": {
+          "description": "最少选择项数;null 表示不限制。",
+          "minimum": 0,
+          "type": [
+            "integer",
+            "null"
+          ]
+        },
+        "optDirection": {
+          "description": "选项排列方向 ID。",
+          "minimum": 0,
+          "type": [
+            "integer",
+            "null"
+          ]
+        },
+        "optSelectMode": {
+          "description": "多项选择模式 ID。",
+          "minimum": 0,
+          "type": [
+            "integer",
+            "null"
+          ]
+        },
+        "options": {
+          "description": "非空有序选项文案;缺失选项表示从该字段配置中删除。",
+          "items": {
+            "minLength": 1,
+            "type": "string"
+          },
+          "minItems": 1,
+          "type": "array",
+          "uniqueItems": true
+        }
+      },
+      "required": [
+        "options"
+      ],
+      "type": "object"
+    },
+    "FieldCommon": {
+      "allOf": [
+        {
+          "if": {
+            "properties": {
+              "defaultType": {
+                "const": 2
+              }
+            },
+            "required": [
+              "defaultType"
+            ]
+          },
+          "then": {
+            "properties": {
+              "defaultValue": {
+                "type": "null"
+              }
+            }
+          }
+        },
+        {
+          "if": {
+            "properties": {
+              "defaultType": {
+                "const": 3
+              }
+            },
+            "required": [
+              "defaultType"
+            ]
+          },
+          "then": {
+            "properties": {
+              "defaultValue": {
+                "minLength": 1,
+                "type": [
+                  "string",
+                  "null"
+                ]
+              }
+            }
+          }
+        }
+      ],
+      "anyOf": [
+        {
+          "required": [
+            "queId"
+          ]
+        },
+        {
+          "required": [
+            "name"
+          ]
+        }
+      ],
+      "description": "顶层业务字段的公共属性;字段类型由 TopField 的判别分支定义。",
+      "properties": {
+        "beingRequired": {
+          "description": "该字段是否必填;缺失时保留已有字段当前值。",
+          "type": "boolean"
+        },
+        "defaultType": {
+          "default": 1,
+          "description": "默认值类型,与 defaultValue 联动;1 表示静态值,2 表示关联/绑定值且 defaultValue 只能省略或为 null,3 表示公式值且提供 defaultValue 时必须为非空公式文本。省略 defaultType 但提供 defaultValue 时按 1 处理。",
+          "enum": [
+            1,
+            2,
+            3
+          ],
+          "type": "integer"
+        },
+        "defaultValue": {
+          "$ref": "#/$defs/ScalarDefaultValue",
+          "description": "普通字段的默认值;后端 queDefaultValue 为字符串,因此数字等字面量也必须以字符串传入。defaultType 为 1 时表示静态文本,为 3 时表示公式文本,为 2 时不携带字面量默认值。表格、地址、附件、引用等结构化默认值必须放在具体字段 config.defaultValues。显式 null 表示清除默认值。"
+        },
+        "name": {
+          "description": "字段展示名称;新增字段必填,已有字段可在携带 queId 时省略;同一父级内唯一。",
+          "minLength": 1,
+          "type": "string"
+        },
+        "queId": {
+          "description": "已有字段的后端 ID;更新时用于精确定位并复用,新增字段通常省略。",
+          "minimum": 1,
+          "type": "integer"
+        },
+        "questionDescription": {
+          "description": "字段说明;null 或空字符串表示清空。",
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "questionType": {
+          "description": "字段类型;具体可用值由当前字段详情 Schema 的判别分支约束。",
+          "type": "string"
+        },
+        "width": {
+          "description": "字段在所在行的宽度百分比;只能选择 25、50、75 或 100。",
+          "enum": [
+            25,
+            50,
+            75,
+            100
+          ],
+          "type": "integer"
+        }
+      },
+      "type": "object"
+    },
+    "ScalarDefaultValue": {
+      "description": "后端 queDefaultValue 支持的普通字段默认值;非空值必须是字符串,显式 null 表示清除默认值。数字和布尔值应先转换为字符串,对象和数组必须使用字段专用默认值配置。defaultType 为 3 时,通过 AppForm Schema 查询能力传入当前 schema_version 并设置 schema_kind=formula 获取公式语法、字段引用、运算符和全部函数说明;CLI 使用 builder app-form schema --schema-kind formula。需要配置结构化默认值时,传入当前 schema_version,并将字段的 questionType 作为 field_type 获取字段详细 Schema。",
+      "type": [
+        "null",
+        "string"
+      ]
+    }
+  },
+  "$id": "https://builder.qingflow.com/schemas/app-form-apply/v1alpha1/fields/multi_select.json",
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "allOf": [
+    {
+      "$ref": "#/$defs/FieldCommon"
+    },
+    {
+      "properties": {
+        "config": {
+          "$ref": "#/$defs/ChoiceConfig"
+        },
+        "questionType": {
+          "const": "multi_select"
+        }
+      },
+      "required": [
+        "questionType",
+        "config"
+      ]
+    }
+  ],
+  "title": "Qingflow AppForm v1alpha1 multi_select field",
+  "type": "object",
+  "unevaluatedProperties": false
+}