weaver-e10-builder 1.0.10-beta → 1.0.12-beta

package/skill-docs/actionflows/references/components/logic/LogicFlowSet.md

@@ -0,0 +1,17 @@
+# 规则集（`LogicFlowSet`）
+
+## 何时使用
+
+引用当前租户已有规则集完成复杂规则判断或计算。
+
+## 先查询
+
+获得当前租户规则 Browser 原对象。
+
+## 不可猜测
+
+不在动作流中创建或编辑规则定义；没有真实规则对象即停止。
+
+## 最小计划
+
+`logicFlow`；可选 `inputParams` 必须为平台回读结构。

package/skill-docs/actionflows/references/components/logic/MultipleExecution.md

@@ -0,0 +1,38 @@
+# 循环（MultipleExecution）
+
+循环体通过 `actions` 提供，至少包含一个非 `Output` 动作，当前不支持循环嵌套。
+
+## 循环方式
+
+| `cycleMode` | 场景 | 必填参数 |
+| --- | --- | --- |
+| `1` | 按指定次数 | `cycleTimes` |
+| `2` | 满足条件时继续 | `condition` |
+| `3` | 按列表逐条遍历 | `detailData` |
+| `4` | 按列表分批遍历 | `batchDetailData`、`batchSizeData` |
+| `5` | 存在下一页时继续 | `pageCycleData`（平台已有变量 FormulaBean） |
+
+## 参数规则
+
+- `cycleTimes`：固定整数 `1-1000`，或实时上下文的 `context/reference`。动态引用必须使用 `getComponentContext` 返回的完整 `paramKey`；预检会保留来源字段的真实类型、所属组件和参数路径。
+- `detailData` / `batchDetailData`：只能引用真实 List/数组字段（表单明细、多选浏览框或上游动态列表）。不可用普通文本字段伪装为列表。
+- `batchSizeData`：固定整数 `2-1000`。
+- `condition`：使用 ESB `ConditionRule`，与动作流分支复用同一类规则树和 `saveCondition` 持久化；它不是 e-builder 表单动作的 `filterInput/ConditionSet`。左值可使用完整 `paramKey`、字段显示名、`paramName` 或真实字段 ID；编译器会按当前流程实时上下文回填真实 DTO。
+- `pageCycleData`：设计器会创建布尔变量并在循环体首节点写入“是否存在下一页”。当前只接受已存在的原始 `type: "7"` 变量 FormulaBean；尚未自动创建变量及赋值节点时，不生成该模式。
+
+## 示例
+
+```json
+{
+  "type": "MultipleExecution",
+  "params": {
+    "cycleMode": "3",
+    "detailData": {
+      "kind": "context",
+      "source": "event",
+      "paramKey": "<workflowId>.<arrayField>[]"
+    }
+  },
+  "actions": [{ "type": "SendMessage", "params": { "receiver": { "type": "all" }, "msgTitle": "逐条处理", "msgContent": "..." } }]
+}
+```

package/skill-docs/actionflows/references/components/logic/Output.md

@@ -0,0 +1,17 @@
+# 终止（`Output`）
+
+## 何时使用
+
+结束主链或分支；通常由编译器自动补充。
+
+## 先查询
+
+无需查询。
+
+## 不可猜测
+
+普通 semantic plan 不应手写该节点。
+
+## 最小计划
+
+无需传入。

package/skill-docs/actionflows/references/components/message/SendMessage.md

@@ -0,0 +1,17 @@
+# 发送消息（`SendMessage`）
+
+## 何时使用
+
+向人员、角色、全员或上游人员字段发送 IM 消息。
+
+## 先查询
+
+固定接收人查询当前租户人员；动态内容查询本次上下文。
+
+## 不可猜测
+
+标题和内容按需求选固定文本或 `parts` 模板；纯字符串保持固定值，只有 `parts` 模板才进入设计器的动态赋值。模板上下文只传 `paramKey` 和 `label`，由 CLI 按消息编辑器的动态片段结构编译。对定时批量、按日期字段、表单数据等 e-builder 记录触发器，未显式提供链接时 CLI 自动生成 PC/移动端详情链接：`formId` 为触发表单 ID 固定值，`dataId` 为上游“数据ID”动态上下文。显式 `pcLink` / `mobileLink` 会覆盖该默认行为。
+
+## 最小计划
+
+`receiver`、`msgTitle`、`msgContent`。

package/skill-docs/actionflows/references/components/personnel/AlterPersonStatus.md

@@ -0,0 +1,30 @@
+# 人员状态变更
+
+组件类型：`AlterPersonStatus`。先运行 `component-describe AlterPersonStatus`。
+
+## 何时使用
+
+用于把已有人员批量设为在职或离职。它只改变人员账号状态；不要用它修改人员资料、入职信息或人员类型。
+
+## 生成前查询
+
+使用 `recipient-search` 取得每一位目标人员和操作人的当前租户 Browser 原对象。
+
+## 业务边界
+
+- `personList` 是人员 Browser 原对象数组，`operators` 是单个人员 Browser 原对象；本组件设计器仅提供固定值，不能用上下文、系统变量或裸人员 ID。
+- `userStatus` 仅为 `1`（在职）或 `2`（离职）。
+- 变更离职状态会影响真实人员可用性；仅在用户明确要求时生成。
+
+## 语义计划形状
+
+```json
+{
+  "type": "AlterPersonStatus",
+  "params": {
+    "personList": [{"id": "<真实人员ID>", "name": "<真实姓名>"}],
+    "userStatus": "2",
+    "operators": {"id": "<真实人员ID>", "name": "<真实姓名>"}
+  }
+}
+```

package/skill-docs/actionflows/references/components/personnel/HrmEmployeeUpdate.md

@@ -0,0 +1,32 @@
+# 更新人员
+
+组件类型：`HrmEmployeeUpdate`。先运行 `component-describe HrmEmployeeUpdate`。
+
+## 何时使用
+
+用于更新一个已有人员的资料。它不创建人员；需要新增人员时使用 `PersonnelOnboarding`。只变更在职/离职状态时使用 `AlterPersonStatus`。
+
+## 生成前查询
+
+1. 使用 `recipient-search` 分别取得操作人和待更新人员的当前租户 Browser 原对象。
+2. 使用 `hrm-onboarding-fields '{}'` 取得当前租户人员字段定义。
+
+## 业务边界
+
+- `operators`、`person` 均为固定人员 Browser 原对象；本组件设计器不支持以动态上下文代替它们。
+- plan 只传 `fieldAssignments`，CLI 基于实时定义生成平台 `setting`；不允许手写 DTO。
+- Browser 字段必须匹配字段的真实选择器对象；字段名重名时必须传字段 ID。
+- 至少提供一个待更新字段；字段、对象或必填约束无法解析时，停止生成。
+
+## 语义计划形状
+
+```json
+{
+  "type": "HrmEmployeeUpdate",
+  "params": {
+    "operators": {"id": "<真实人员ID>", "name": "<真实姓名>"},
+    "person": {"id": "<真实人员ID>", "name": "<真实姓名>"},
+    "fieldAssignments": {"main": {"邮箱": "zhangsan@example.com"}}
+  }
+}
+```

package/skill-docs/actionflows/references/components/personnel/PersonnelOnboarding.md

@@ -0,0 +1,34 @@
+# 人员入职
+
+组件类型：`PersonnelOnboarding`。先运行 `component-describe PersonnelOnboarding`。
+
+## 何时使用
+
+用于新增人员到系统。它没有“目标人员”参数：人员由入职字段创建。若人员已经存在并只需改资料，改用 `HrmEmployeeUpdate`。
+
+## 生成前查询
+
+1. 使用 `recipient-search` 取得操作人的当前租户 Browser 原对象。
+2. 使用 `hrm-onboarding-fields '{}'` 取得当前租户人员主表、明细、字段类型和必填项。
+
+## 业务边界
+
+- plan 传 `fieldAssignments`，CLI 根据实时字段定义生成平台 `setting`；不允许手写 `setting` / `EsbFormDataDto`。
+- 字段可用显示名或字段 ID。当前租户出现同名字段时必须使用字段 ID。
+- Browser 字段（部门、岗位、上级等）只接受其对应选择器返回的真实对象，不能把名称或 ID 当文本填入。
+- 未提供当前租户必填字段、或字段/取值无法解析时，停止生成并报告缺项。
+
+## 语义计划形状
+
+```json
+{
+  "type": "PersonnelOnboarding",
+  "params": {
+    "operators": {"id": "<真实人员ID>", "name": "<真实姓名>"},
+    "fieldAssignments": {
+      "main": {"姓名": "张三", "部门": {"id": "<真实部门ID>", "name": "研发部"}},
+      "detail": [{"table": "教育经历", "fields": {"学校名称": "某大学"}}]
+    }
+  }
+}
+```

package/skill-docs/actionflows/references/components/trigger/SimpleScheduler.md

@@ -0,0 +1,17 @@
+# 简单定时器（`SimpleScheduler`）
+
+## 何时使用
+
+按 Quartz Cron 表达式定时触发。
+
+## 先查询
+
+无需外部对象；确认业务时间规则。
+
+## 不可猜测
+
+只传 `cornString`，例如每天 10:00：`0 0 10 * * ?`。不传 `rate/day/cycle/hour` 等历史调度参数。
+
+## 最小计划
+
+`cornString`。

package/skill-docs/actionflows/references/components/workflow/ApproveAddSign.md

@@ -0,0 +1,17 @@
+# 加审流程（`ApproveAddSign`）
+
+## 何时使用
+
+为流程增加审批人员。
+
+## 先查询
+
+查询实例、操作人和加审人员。
+
+## 不可猜测
+
+`src` 只用契约支持的加审方式。
+
+## 最小计划
+
+`requestId`、`employeeId`、`src`、`joinOperators`。

package/skill-docs/actionflows/references/components/workflow/ApproveAgreeRejectApply.md

@@ -0,0 +1,17 @@
+# 同意退回申请（`ApproveAgreeRejectApply`）
+
+## 何时使用
+
+同意一项已发起的流程退回申请。
+
+## 先查询
+
+确认真实流程实例和操作人。
+
+## 不可猜测
+
+只处理退回申请，不等同于直接退回流程。
+
+## 最小计划
+
+`requestId`、`employeeId`。

package/skill-docs/actionflows/references/components/workflow/ApproveCommit.md

@@ -0,0 +1,17 @@
+# 提交流程（`ApproveCommit`）
+
+## 何时使用
+
+对已有流程进行审批提交，并可更新流程表单。
+
+## 先查询
+
+查询流程、实例上下文、操作人和目标流程表单字段。
+
+## 不可猜测
+
+只能对真实实例提交；字段映射不能跨流程猜测。
+
+## 最小计划
+
+`workflowPath`、`requestId`、`operator`。

package/skill-docs/actionflows/references/components/workflow/ApproveCompletelyDelete.md

@@ -0,0 +1,17 @@
+# 彻底删除流程（`ApproveCompletelyDelete`）
+
+## 何时使用
+
+永久删除回收站中的流程实例。
+
+## 先查询
+
+确认实例已处于可彻底删除状态及操作人。
+
+## 不可猜测
+
+这是不可逆动作，不能用定义 ID 或名称代替实例 ID。
+
+## 最小计划
+
+`requestIds`、`operator`。

package/skill-docs/actionflows/references/components/workflow/ApproveConsulTurnTodo.md

@@ -0,0 +1,17 @@
+# 征询转办流程（`ApproveConsulTurnTodo`）
+
+## 何时使用
+
+将意见征询的流程转交他人。
+
+## 先查询
+
+查询实例和接收人。
+
+## 不可猜测
+
+不能以普通转办替代征询转办。
+
+## 最小计划
+
+`requestId`、`receiveIds`、`initiator`。

package/skill-docs/actionflows/references/components/workflow/ApproveCreate.md

@@ -0,0 +1,17 @@
+# 新建流程（`ApproveCreate`）
+
+## 何时使用
+
+发起一个新的独立流程，不用于保存或提交已有流程。
+
+## 先查询
+
+查询目标流程、目标流程表单字段及发起人。
+
+## 不可猜测
+
+目标流程必须带真实表单字段；标题可固定、上下文或系统变量，映射目标字段不能猜。
+
+## 最小计划
+
+`workflowPath`、`operator`、`requestName`；按需求补充表单赋值。

package/skill-docs/actionflows/references/components/workflow/ApproveDelete.md

@@ -0,0 +1,17 @@
+# 删除流程（`ApproveDelete`）
+
+## 何时使用
+
+将指定流程实例移入回收站；永久删除使用 `ApproveCompletelyDelete`。
+
+## 先查询
+
+确认真实实例和操作人。
+
+## 不可猜测
+
+删除实例具有副作用，实例来源必须可追溯。
+
+## 最小计划
+
+`requestId`、`operator`。

package/skill-docs/actionflows/references/components/workflow/ApproveDoCirculate.md

@@ -0,0 +1,17 @@
+# 抄送流程（`ApproveDoCirculate`）
+
+## 何时使用
+
+将流程实例抄送给指定接收人。
+
+## 先查询
+
+查询实例与接收人 Browser 对象。
+
+## 不可猜测
+
+接收人不能仅用姓名或 ID 表示。
+
+## 最小计划
+
+`requestId`、`receiveIds`、`initiator`。

package/skill-docs/actionflows/references/components/workflow/ApproveDoForward.md

@@ -0,0 +1,17 @@
+# 转发流程（`ApproveDoForward`）
+
+## 何时使用
+
+将流程转发给指定人员。
+
+## 先查询
+
+查询实例和接收人。
+
+## 不可猜测
+
+标题与意见可固定或引用上下文；人员必须为真实 Browser 对象。
+
+## 最小计划
+
+`requestId`、`receiveIds`、`initiator`。

package/skill-docs/actionflows/references/components/workflow/ApproveDoTurnTodo.md

@@ -0,0 +1,17 @@
+# 转办流程（`ApproveDoTurnTodo`）
+
+## 何时使用
+
+将流程待办转交指定人员处理。
+
+## 先查询
+
+查询实例和接收人。
+
+## 不可猜测
+
+只对真实待办实例操作。
+
+## 最小计划
+
+`requestId`、`receiveIds`、`initiator`。

package/skill-docs/actionflows/references/components/workflow/ApproveEntrust.md

@@ -0,0 +1,17 @@
+# 委托流程（`ApproveEntrust`）
+
+## 何时使用
+
+将某人的流程委托给另一人代办。
+
+## 先查询
+
+查询操作人、委托人、受托人，并由预检读取该委托人的真实可用身份。
+
+## 不可猜测
+
+`identityId` 必须由当前租户返回；不能根据名称推断身份或范围。
+
+## 最小计划
+
+`operator`、`entrustUser`、`consignee`、`identityId`、`entrustType`。

package/skill-docs/actionflows/references/components/workflow/ApproveIntervention.md

@@ -0,0 +1,17 @@
+# 干预流程（`ApproveIntervention`）
+
+## 何时使用
+
+将流程干预流转到指定节点并指定处理人。
+
+## 先查询
+
+查询真实流程、节点、实例、操作人和节点处理人。
+
+## 不可猜测
+
+`workflowId`、`submitToNodeId`、处理人均必须是当前租户 Browser 对象。
+
+## 最小计划
+
+`workflowId`、`submitToNodeId`、`requestId`、`employeeId`、`interventionReceiverIds`。

package/skill-docs/actionflows/references/components/workflow/ApproveMandatoryArchiving.md

@@ -0,0 +1,17 @@
+# 强制结束流程（`ApproveMandatoryArchiving`）
+
+## 何时使用
+
+将审批中的真实流程实例强制归档。
+
+## 先查询
+
+确认流程实例 ID 和操作人。
+
+## 不可猜测
+
+该动作有业务副作用，不能按流程名称或定义 ID 操作。
+
+## 最小计划
+
+`requestId`、`operator`。

package/skill-docs/actionflows/references/components/workflow/ApproveManualCC.md

@@ -0,0 +1,17 @@
+# 抄送批注流程（`ApproveManualCC`）
+
+## 何时使用
+
+向指定人员抄送流程并允许批注意见。
+
+## 先查询
+
+查询实例和人员。
+
+## 不可猜测
+
+当前仅支持人员接收方，不把部门或角色伪装为人员。
+
+## 最小计划
+
+`requestId`、`receiveTypes: "user"`、`receiveIds`、`initiator`。

package/skill-docs/actionflows/references/components/workflow/ApproveRefuseRejectApply.md

@@ -0,0 +1,17 @@
+# 拒绝退回申请（`ApproveRefuseRejectApply`）
+
+## 何时使用
+
+拒绝一项已发起的流程退回申请。
+
+## 先查询
+
+确认真实实例和操作人。
+
+## 不可猜测
+
+不要以普通审批或直接退回代替该动作。
+
+## 最小计划
+
+`requestId`、`employeeId`。

package/skill-docs/actionflows/references/components/workflow/ApproveRejectApply.md

@@ -0,0 +1,17 @@
+# 退回申请流程（`ApproveRejectApply`）
+
+## 何时使用
+
+为流程发起退回申请。
+
+## 先查询
+
+确认实例和操作人。
+
+## 不可猜测
+
+该动作需要真实意见，不自动虚构退回原因。
+
+## 最小计划
+
+`requestId`、`employeeId`、`remark`。

package/skill-docs/actionflows/references/components/workflow/ApproveSave.md

@@ -0,0 +1,17 @@
+# 保存流程（`ApproveSave`）
+
+## 何时使用
+
+保存已有流程及其表单数据，不执行审批提交。
+
+## 先查询
+
+查询流程定义、实例上下文和操作人。
+
+## 不可猜测
+
+实例 ID 与流程定义不可互换；表单赋值的目标字段必须来自真实流程表单。
+
+## 最小计划
+
+`workflowPath`、`requestId`、`operator`；按需求补充赋值。

package/skill-docs/actionflows/references/components/workflow/ApproveSendBack.md

@@ -0,0 +1,17 @@
+# 退回流程（`ApproveSendBack`）
+
+## 何时使用
+
+将流程退回至一个指定节点。
+
+## 先查询
+
+查询流程定义、实例、真实退回节点和操作人。
+
+## 不可猜测
+
+退回节点必须属于该流程；不能以节点名称或猜测 ID 代替。
+
+## 最小计划
+
+`workflowPath`、`requestId`、`rejectToNodeId`、`operator`。

package/skill-docs/actionflows/references/components/workflow/ApproveShareEntry.md

@@ -0,0 +1,17 @@
+# 共享流程（`ApproveShareEntry`）
+
+## 何时使用
+
+将流程实例共享给指定人员。
+
+## 先查询
+
+查询实例、共享对象和操作人。
+
+## 不可猜测
+
+当前仅支持人员共享；共享对象必须是 Browser 原对象。
+
+## 最小计划
+
+`requestIds`、`shareType: "user"`、`shareEntities`、`perator`。

package/skill-docs/actionflows/references/components/workflow/ApproveTrigger.md

@@ -0,0 +1,49 @@
+# 流程触发（`ApproveTrigger`）
+
+## 何时使用
+
+由流程提交、审批、结束等时机触发动作流。
+
+## 先查询
+
+查询真实流程、节点和当前时机的 `workflow-context-fields`。
+
+## 不可猜测
+
+后续动态引用只使用本次返回的 `paramKey`；多流程触发按组件契约提供真实列表。
+
+## 最小计划
+
+`workflowPath`、`triggerTiming`；节点型时机提供真实 `approveNode`，出口型时机提供真实 `approveLink`。
+
+## 触发时机
+
+plan 统一使用：`arrive`（节点前/到达）、`submitted`（流程提交）、`approve_passed`（审批通过）、`workflow_completed`（流程结束）、`leave`、`link`、`delete`、`save`、`revert`、`pause`、`cancel`。中文界面名称可输入，CLI 会归一为上述值后再查询并校验对应的真实流程节点；不能按“第一个节点”猜测时机。
+
+## 类型联动：可选节点/出口与执行时间
+
+| `triggerTiming` | 可选对象 | `nodeTime` |
+|---|---|---|
+| `submitted` | 仅发起节点（nodeType=0） | 仅正向到达（1） |
+| `approve_passed` | 审批/中间节点（1/2/5） | 不使用 |
+| `workflow_completed` | 仅结束节点（3） | 仅正向到达（1） |
+| `arrive` | 当前流程真实节点（0/1/2/3/5） | 结束节点可选 1/2/3/4/5/6；其他节点 1/2/3/4/6 |
+| `leave` | 当前流程真实节点（0/1/2/3/5） | 1/2/3/6 |
+| `link` | 仅当前流程真实出口 `approveLink` | 不使用 |
+| `pause` | 发起/审批/中间节点（0/1/2/5） | 1/2 |
+| `cancel` | 当前流程真实节点（0/1/2/3/5） | 1/2 |
+| `delete` / `save` / `revert` | 当前流程真实节点（0/1/2/3/5） | 不使用 |
+
+出口不能使用 `approveNode`，也不自动选择“第一条出口”；需求未指定出口时必须先查并追问。
+
+## 执行时间（节点前 / 节点后）
+
+节点型触发可传 `nodeTime`，其值和设计器下拉框一致：`1` 正向流转到达、`2` 返回到达、`3` 强制收回到达、`4` 撤回到达、`5` 强制结束到达、`6` 干预到达。
+
+例如，要在某节点**返回到达**时触发，使用真实节点和 `nodeTime:"2"`：
+
+```json
+{"workflowPath":{"id":"<流程ID>","name":"<流程名>"},"triggerTiming":"arrive","approveNode":{"id":"<真实节点ID>","nodeType":1},"nodeTime":"2"}
+```
+
+`revert` 是“流程还原时”，与节点执行时间中的“返回到达”不是同一事件。

package/skill-docs/actionflows/references/components/workflow/ApproveWithdraw.md

@@ -0,0 +1,17 @@
+# 撤回流程（`ApproveWithdraw`）
+
+## 何时使用
+
+撤回已处理的流程。
+
+## 先查询
+
+确认实例和撤回操作人。
+
+## 不可猜测
+
+仅在平台允许的实例状态下生成。
+
+## 最小计划
+
+`requestId`、`operator`。

package/skill-docs/actionflows/references/components/workflow/WorkFlowDocEmpowerment.md

@@ -0,0 +1,17 @@
+# 流程关联文档赋权（`WorkFlowDocEmpowerment`）
+
+## 何时使用
+
+为流程关联文档设置人员范围权限。
+
+## 先查询
+
+查询真实流程实例、文档和需要的人员范围对象。
+
+## 不可猜测
+
+文档与权限范围不能由裸 ID 拼装；固定对象须使用真实 Browser 值。
+
+## 最小计划
+
+`requestId`、`documents`；按需求补充权限范围。

package/skill-docs/actionflows/references/components/workflow/WorkflowToDoc.md

@@ -0,0 +1,17 @@
+# 流程存为文档（`WorkflowToDoc`）
+
+## 何时使用
+
+将流程内容作为附件形式存入文档。
+
+## 先查询
+
+查询流程、实例、操作人和平台返回的存文档设置。
+
+## 不可猜测
+
+固定目录必须是 `saveDirectoryBrowserValue` 的真实目录对象；设置为空时拒绝生成。
+
+## 最小计划
+
+`workflowPath`、`requestId`、`operator`、`toDocSettings`。