weaver-e10-builder 1.0.11-beta → 1.1.0

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/CustomTrigger.md

@@ -0,0 +1,45 @@
+# 自定义事件触发（`CustomTrigger`）
+
+## 何时使用
+
+需求明确要求由平台自定义事件主动触发动作流时使用。它不是 e-builder 表单数据变化触发，也不是按钮触发。
+
+## 参数
+
+唯一必填参数是 `customData`。设计器实际使用的是 `SetParam` 的参数对象：顶层保留 `customId`、`formType`、`businessModule`、`tableList`，每个 `tableList` 项包含 `id`、`showName`、`isMain`、`orderNum` 和 `fields`；每个字段至少要有 `id`、`paramName`、`showName`、`paramType`。它必须来自平台自定义触发配置/回读或上下文接口返回的原生对象，不要改写成旧的 `tables` 结构，也不要猜测一套字段。
+
+```json
+{
+  "event": {
+    "type": "CustomTrigger",
+    "params": {
+      "customData": {
+        "customId": "<平台返回>",
+        "formType": "input",
+        "businessModule": "esb",
+        "tableList": [{
+          "id": "<平台返回>",
+          "showName": "主表",
+          "isMain": true,
+          "orderNum": 0,
+          "fields": [{
+            "id": "<平台返回>",
+            "paramName": "payload",
+            "showName": "消息体",
+            "paramType": "string",
+            "isRequired": true
+          }]
+        }]
+      }
+    }
+  }
+}
+```
+
+自定义参数的字段定义是业务特定的。没有真实 `customData` 时先读取已有动作流/组件上下文，不要生成空壳触发器。`tableList` 或其中的 `fields` 为空时，设计器“输入参数设置”就是空白；这不是回读截断，而是发送的对象本身没有参数。
+
+根触发器图标不是 `Icon-custom-trigger`，编译器统一保存为 `Icon-N-Triggerrul`。
+
+## 上下文
+
+触发后可引用平台提供的 `FormData`、`FormField`、`SettingInfo`、`accessId` 和 `monitorId`；具体字段以当前租户上下文返回为准。

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

@@ -0,0 +1,40 @@
+# 内置 MQ 监听（`InnerMQListener`）
+
+## 何时使用
+
+需求明确要求监听平台内置 MQ 广播 Topic 时使用。它不同于外部 RabbitMQ/Kafka 等 `MqConsumer`。
+
+## 参数
+
+```json
+{
+  "event": {
+    "type": "InnerMQListener",
+    "params": {
+      "queueName": "真实Topic名称",
+      "sendModel": "1",
+      "receiveParams": {
+        "tableId": "<平台参数表 ID>",
+        "tableData": [{
+          "id": "<平台字段 ID>",
+          "paramKey": "payload",
+          "paramName": "payload",
+          "showName": "消息体",
+          "paramType": "string",
+          "dataType": "attribute",
+          "required": true,
+          "arrs": false
+        }]
+      }
+    }
+  }
+}
+```
+
+- `queueName` 必填，使用平台真实 Topic/队列名称。
+- `sendModel` 当前只支持 `1`（广播模式），省略时 CLI 默认填入 `1`。
+- `receiveParams` 可选；有业务接收字段时传平台原生 `ParamSettingBean`，在当前设计器回读结构中表现为 `tableId + tableData`，没有时省略。不能传 `{type:'SETTING', tables:[]}` 期待它自动生成输入字段。
+
+根触发器图标不是猜测的 `Icon-message-queue`，平台内置 MQ 监听实际使用 `Icon-built-in-mq-listening-mcolor`；不要把发送动作的图标当成监听触发器图标。
+
+`InnerMQListener` 与动作 `InnerMQSend` 不能同时出现在一个动作流中，包括条件和循环内部；CLI 会在创建或更新前拒绝该计划。

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,84 @@
+# 流程触发（`ApproveTrigger`）
+
+## 同一流程的多条触发规则
+
+平台的“动作执行节点/出口”窗口可为同一个流程添加多行规则；不要把它误拆成多个动作流。计划用 `triggerRules` 表达：
+
+```json
+{
+  "workflowPath": {"id":"<流程id>","name":"<流程名>"},
+  "triggerRules": [
+    {"triggerTiming":"leave","approveNode":{"id":"<发起节点id>","name":"发起节点"}},
+    {"triggerTiming":"arrive","nodeTime":"2","approveNode":{"id":"<发起节点id>","name":"发起节点"}},
+    {"triggerTiming":"workflow_completed","approveNode":{"id":"<结束节点id>","name":"结束节点"}}
+  ]
+}
+```
+
+CLI 会逐条校验真实节点/出口及其允许的执行时间，并写入同一流程的 `singleApproveConfigs[workflowId]` 数组。未传 `triggerRules` 时，才使用原来的单条 `triggerTiming` 写法。
+
+## 多时机触发不同动作时，先按触发上下文分支
+
+多条规则触发的仍是**同一张动作流画布**，因此不能把“新增 / 删除 / 更新”三个动作直接串在主链上。应在事件后的第一个节点放 `Condition`，用流程触发器实时输出的字段路由：
+
+- `triggerType`：`pre`（节点前）、`after`（节点后）、`link`（出口）等；
+- `executeTime`：例如 `2` 表示返回到达；
+- `triggerNodeOrLinkId`：实际触发的节点或出口 ID。
+
+例如“发起节点离开新增、返回到达删除、结束节点正向到达更新”写成三条互斥分支：
+
+```text
+triggerNodeOrLinkId = 发起节点 AND triggerType = after AND executeTime = 1  -> 新建
+triggerNodeOrLinkId = 发起节点 AND triggerType = pre   AND executeTime = 2  -> 删除
+triggerNodeOrLinkId = 结束节点 AND triggerType = pre   AND executeTime = 1  -> 更新
+```
+
+以上三个字段必须从当前流程触发器的 `getComponentContext` 返回结果取真实 `paramKey`，不要手写成业务表单字段。
+
+## 何时使用
+
+由流程提交、审批、结束等时机触发动作流。
+
+## 先查询
+
+查询真实流程、节点和当前时机的 `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`。