weaver-e10-builder 1.5.12 → 1.5.14

package/skill-docs/references/form/ref-list-filter-date-params.md

@@ -0,0 +1,83 @@
+# 条件里的日期系统参数占位符
+
+适用于视图数据条件（`form list-filter`，写入 `saveNListConfig` 的 `config.filter`）里的**日期字段**。
+日期字段的算子为**等于（`func: "eq"`）**时，右值可以直接写平台系统参数占位符；平台把占位符**原样存成字符串**，查询时按当时时间求值，不会像 `quick` 那样展开成死日期。
+
+```json
+{"fieldId":"<日期字段fieldId>","func":"eq","value":"{curryear}","text":"本年"}
+```
+
+- `value`：占位符原文（含花括号），原样保存，不要自己先算成日期。
+- `text`：界面显示名（如「本年」）。设计器回读时用它渲染条件，建议一并给出。
+- 已确认只用于 `eq`；其它算子请走普通值或 `quick`。命令对日期字段的非 `eq` 占位符会直接报错。
+- `n` 为整数，`:+n` / `:-n` 表示当前值之后 / 之前 n 个单位。
+
+> `quick`（今天 / 本周 / 今年…）与占位符是两条路：`quick` 是区间快捷档，保存时算成固定起止日期；占位符是动态右值，运行期才求值。要「每年自动跟进」用占位符，不要用 `quick`。
+
+## 占位符清单
+
+| 占位符 | 含义 |
+|---|---|
+| `{date}` | 当前日期（`yyyy-MM-dd`） |
+| `{date:+n}` | 当前日期后 n 天 |
+| `{date:-n}` | 当前日期前 n 天 |
+| `{time}` | 当前时间（`HH:mm:ss`） |
+| `{thisweek}` | 当前周所在的日期区间 |
+| `{thismonth}` | 当前月所在的日期区间 |
+| `{thisyear}` | 当前年所在的日期区间 |
+| `{lastweek}` | 上一周所在的日期区间 |
+| `{lastmonth}` | 上个月所在的日期区间 |
+| `{lastquarter}` | 上一季度所在的日期区间 |
+| `{lastyear}` | 上一年所在的日期区间 |
+| `{recentdays:-n}` | 距当前日期近 n 天的日期区间 |
+| `{recentmonths:-n}` | 距当前日期近 n 个月的日期区间 |
+| `{recentyears:-n}` | 距当前日期近 n 年的日期区间 |
+| `{year}` | 当前年 |
+| `{year:+n}` | 当前年的后 n 年 |
+| `{year:-n}` | 当前年的前 n 年 |
+| `{half}` | 当前半年度（`01-01` ~ `06-30`） |
+| `{yearhalf}` | 当前年的当前半年度 |
+| `{yearhalf:+n}` | 当前半年度的后 n 个半年 |
+| `{yearhalf:-n}` | 当前半年度的前 n 个半年 |
+| `{quarter}` | 当前季度 |
+| `{yearquarter}` | 当前年的当前季度 |
+| `{yearquarter:+n}` | 当前季度的后 n 个季度 |
+| `{yearquarter:-n}` | 当前季度的前 n 个季度 |
+| `{thisquarter}` | 当前季度是当前年的第几季度 |
+| `{firstdayinthismonth}` | 当前月的第一天 |
+| `{lastdayinthismonth}` | 当前月的最后一天 |
+| `{month}` | 当前月（`01`~`12`） |
+| `{yearmonth:+n}` | 当前年月的后 n 个月（`yyyy-MM`） |
+| `{yearmonth:-n}` | 当前年月的前 n 个月（`yyyy-MM`） |
+| `{day}` | 当前日 |
+| `{hour}` | 当前时 |
+| `{minute}` | 当前分 |
+| `{second}` | 当前秒 |
+| `{dateweek}` | 当前日期的星期（如「星期三」） |
+| `{weekinmonth}` | 当前日期在本月的第几周 |
+| `{weekinyear}` | 当前日期在本年的第几周 |
+| `{weekinyear:+n}` | 当前日期在本年的周数往后加 n 周 |
+| `{weekinyear:-n}` | 当前日期在本年的周数往前减 n 周 |
+| `{week}` | 当前周（`01-01` ~ `01-07` 这种月日区间） |
+| `{mon}` / `{tue}` / `{wed}` / `{thu}` / `{fri}` / `{sat}` / `{sun}` | 当前周的周一 / 周二 / … / 周日所在日期 |
+| `{mon:+n}` 等 | 对应星期几所在日期的后 n 天 |
+| `{mon:-n}` 等 | 对应星期几所在日期的前 n 天 |
+| `{curryear}` | 当前年（设计器「本年」条件实测使用；与 `{year}` 同类） |
+
+## 命令示例
+
+```bash
+# 台账只显示「等于本年」的数据
+e10-cli form list-filter <objId> <appId> <listId> \
+  --add '{"conditions":[{"fieldId":"<日期字段fieldId>","func":"eq","value":"{curryear}","text":"本年"}]}'
+
+# 近 7 天
+e10-cli form list-filter <objId> <appId> <listId> \
+  --add '{"conditions":[{"fieldId":"<日期字段fieldId>","func":"eq","value":"{recentdays:-7}","text":"近7天"}]}'
+
+# 当前日期后 3 天
+e10-cli form list-filter <objId> <appId> <listId> \
+  --add '{"conditions":[{"fieldId":"<日期字段fieldId>","func":"eq","value":"{date:+3}","text":"3天后"}]}'
+```
+
+保存后 `--json` 回读，`conditions.value` 应仍是 `{...}` 原文；被展开成具体日期说明走错了路径（多半是用了 `quick`）。

package/skill-docs/references/menu/system-menus.md

@@ -73,3 +73,15 @@
 - 改名的命令会**重建写报文**再回读比对：名称变了、且「页面绑定 / 菜单 URL / 可见范围」等字段一个都没动，才算成功。改名只动名字，不会顺带改掉已有的筛选条件或页签配置。
 
 **平台系统菜单（回收站、设置及其子项）不能改名** —— 它们由平台维护、指向内置页面，改名没有语义，命令会直接拒绝。
+
+---
+
+## 菜单顺序
+
+平台按同级（同一个 `pid`）的 `showOrder` **升序**显示，同值再按菜单 id；系统菜单的 `showOrder` 是 `9999998/9999999`，所以总在最后。新建菜单默认 `showOrder=1`，因此会排到同级最后。
+
+- 创建时直接排第一：`menu add / add-dir / add-table / add-start`、`page publish-menu` 加 `--first`。
+- 创建时指定位置：`--show-order <n>`（整数，越小越靠前）。
+- 已建好的菜单调整：`e10-cli menu order <appId> <菜单ID或名称> --first`，或 `--show-order <n>`。
+
+命令在写完会回读：`showOrder` 必须落成请求值；`--first` 还会确认同级下标为 0。系统菜单不允许调整顺序。

package/skill-docs/references/workflow/condition-core-contract.md

@@ -0,0 +1,63 @@
+# 公共条件能力与业务适配契约
+
+## 边界与顺序
+
+出口条件是第一迁移点。先用正式 `workflow condition add` 验证编译、保存、绑定及 `get --tree` 回读，再迁移其他场景。矩阵规则与节点字段校验不接入此核心。
+
+`compileWorkflowCondition` 负责语法、类型、字段/浏览对象解析，返回 `{relation, childrens}`；不写入。`persistWorkflowCondition` 在 sourceId=-1 上新建条件集合并保存，返回 conditionKey；业务适配层绑定引用。替换时不先删除旧条件；绑定失败保留原引用，并报告新条件 key。未绑定的旧条件不自动删除，避免误删其他引用。
+
+## 各场景
+
+| 场景 | source | 字段/条件上下文 | 业务绑定 |
+| --- | --- | --- | --- |
+| 出口 | 2 | workflowId，解析时 sourceId=linkId；保存新集合 sourceId=-1 | nodeLink/saveLinkConditionKey |
+| 操作者批次 | 3 | workflowId，解析时 sourceId=operatorSetId | saveOperatorGroup 的指定行 conditionId；保留全部原操作者属性及其他行 |
+| 默认共享 | 24 | workflowId，sourceId=-1 | ShareConfig/saveConfigCondition 的共享行 shareCondition |
+| 子流程触发 | 7 | workflowId；明细触发带 detailTable=true、detailTableId=triSource | subWf/saveSet 的 ruleId/ruleName，重读原配置再更新 |
+| 权责表分支 | 2 | belongScene=3、belongSceneId/segmentId=authRespId；独立表 workflowId=-99999999、variable 元数据 | 保留原 saveConditionSet/saveCondition + saveLinkConditionKey + 权责表行保存流程 |
+
+权责表使用编译结果而保留业务入库方式，不能丢失变量类型、场景和片段同步上下文。原始 childrens 是有效高级输入，保留；不把它当成第二套自然语言解析器。
+
+## 代码核对依据
+
+- 前端 `weapp-workflow/src/components/public/rule/api/ruleDesign.ts`：条件编译结果保存与 getExpressionBean 回显。
+- 前端 `.../nodeset/operatorset/store.ts` 的 editGroupItemDatasConditionByIndex：只更新 conditionId、condition、groupCondition、conditionSourceId，与操作者类型独立。
+- 后端 `.../pathnode/cmd/operator/DoSaveOrUpdateNodeOperatorCmd.java`：conditionId 作为条件 key，既有 operatorSetId 保持更新语义。
+- 子流程前端 `.../pathset/subwf/baseSetEdit.tsx`：条件保存回调绑定 ruleId/ruleName。
+- 子流程后端 `.../pathnode/cmd/subwf/GetBaseSetCmd.java#getRuleParams`：明细触发必须携带 detailTable/detailTableId。
+- 后端 `.../condition/cmd/WfpGetFormfieldListCmd.java`：按 belongScene/belongSceneId 解析权责表变量。
+- 后端 `.../pathnode/cmd/link/SaveLinkConditionKeyCmd.java`：虚拟流程出口仍由 linkId + workflowId 查找；segmentId 控制片段条件同步。
+
+## 兼容与纠错
+
+- 字段 ID/名称/dataKey/columnName；有歧义要求 ID。明细合计与明细原字段可能共享 ID，必须分别保留；直接 ID 指普通字段，合计用合计名称。
+- 范围为开区间；闭区间使用大于等于、小于等于两条。拒绝旧语法中会被忽略的多余参数。
+- 浏览名称必须唯一精确匹配，支持准确 ID 或结构化 `{id,content}`；保留选项 valueKey=0。
+- Switch 是/否编码为 SwitchCompareOptionLeft=5、SwitchTextValueLeft1=1/0；Bool 使用 23/24。107 实际接口已证明二者不相同。
+- 系统人员/组织使用 Browser 前缀；紧急程度/密级使用 SysBrowser。
+- 明细任一/所有分别为 detailOption=1/2；合计不带 detailOption。
+- 结构化输入支持任意嵌套 AND/OR，避免字符串里的冒号/竖线歧义。
+
+## 验证对象
+
+107 独立测试流程 `1328015591882129414`，表单 `1328015587520053248`。
+出口第一阶段：CLI 入口测试 13 个测试组通过；实环境保存并回读数值/日期八种比较、文本六种比较、范围、字段比较、明细任一/所有及合计、人员、分部、选项、开关、系统条件、AND/OR 子组及替换绑定。
+原始 JSON 回读存放于 `output/condition-core-regression/`；这些结果验证配置持久化，不代表已执行真实流程实例。
+
+
+第二阶段实环境结果：
+- 指定人批次 `1328020561216045057`，公共条件 key `1328020694334865409`；CLI 自动比对原操作者字段未变。
+- 共享规则 `1328021059283222553`，source=24 条件 key `1328021059298033665`，停用。
+- 子流程配置 `1328021080909053952`，source=7 条件 key `1328021179523563520`，停用。
+- 独立权责表 `1328021896900542464`（baseId `1328021896900542465`），变量条件 key `1328022412372115475`，普通变量与嵌套 OR 回读通过。
+- 较早的回归权责表 `1328021205488271361` 保留用于对照变量量词修复；不用于业务。
+
+清理复核：src/test 中不再有 buildConditionChildrens/saveWorkflowCondition 的调用，已删除旧实现。SYSTEM_FIELDS 等常量保留给公共编译器及节点校验。--batch-condition 只写描述、不生成条件引用，已删除并用 operator-batch set-condition 替代。workflow save-condition 与权责表 raw childrens 仍是有效高级入口，保留，不误删。
+
+限制：配置验证不等同于流程实例执行。独立测试表单的 Switch 由现有 add-field 创建时没有选项文案，107 条件中文显示为空；完整树已回读确认 1/0 正确。旧 Bool 编码在真实 Switch 上会丢值，已修复。
+
+最终验证：构建通过；针对性测试 120 项通过、0 失败。另在107验证上级操作者、表单人员本人批次及明细子流程条件。见 output/condition-core-regression/verification.json 和 test-result.txt。
+
+准确ID验证：人员 1259330131187138561 与分部 1259330045288693760 通过正式 CLI --preview 解析成功。纯数字ID走 common/browser/destData/{type}，名称走 complete/{type} 精确匹配；不能用联想接口搜索ID。
+
+准确ID路径修复后的末次 CLI 回归：15 项通过、0 失败（在前述 120 项测试基础上复测 CLI 套件）。

package/skill-docs/references/workflow/guide-base-auth-share-remind.md

@@ -0,0 +1,126 @@
+# 工作流基础设置：权限、共享、提醒
+
+命令名取自前端目录 `pathset-base-authset`、`pathset-base-shareset`、`pathset-base-remind`。配置的是工作流定义，参数使用 `workflowId`，不是流程实例 requestId。当前验证环境为 107，原生工作流；不据此宣称 EB、公文及个人工作流已验证。
+
+## 共同规则
+
+- `get --schema` 读取实时表单、枚举、浏览范围及默认值。所有命令输出 JSON，支持 `--out 文件`。
+- `create/update --data '{...}'` 或 `--data @文件.json`。单份配置的 create 是读取默认/现有配置后保存，不重复建第二份。
+- 修改先读后合并，只改明确的键；`false` 和 `[]` 是有效修改。拒绝未知字段、无效选项和跨流程节点，保存一次后回读；失败不自动重复写入。
+- ID 用字符串。节点浏览值用名称或 ID 数组，重名时改用 ID。组织对象用 `[{"_entityType":"user","id":"人员ID"}]`；支持 user/dept/subcompany/group/role/all，以该位置允许类型为准。错误提醒人只支持 user/role/employeeManager。非 all 对象会从服务端按 ID 核实。
+- 初始化可能创建配置记录；回读比较的是业务设置，记录 ID、创建/更新时间可变化。没有服务端并发版本控制，编辑期间应避免多人同时保存同一配置。
+
+## 权限设置
+
+```bash
+e10-cli workflow authset get <workflowId> --schema
+e10-cli workflow authset update <workflowId> --data '{"statistics":[{"_entityType":"user","id":"人员ID"}]}'
+```
+
+| 字段 | 设置 |
+|---|---|
+| maintenance | 维护权限；不包含删除工作流权限 |
+| statistics | 统计权限 |
+| statisticsExport | 统计数据导出权限，也影响统计导入 |
+| containSubDept | 包含下级部门，boolean |
+
+每组组织对象支持 `[]` 清空；没有指定的组保持原值。
+
+## 共享设置
+
+```bash
+e10-cli workflow shareset get <workflowId> --schema
+e10-cli workflow shareset update <workflowId> --data '{"defSharerCanViewComment":false}'
+e10-cli workflow shareset default get <workflowId> --schema
+e10-cli workflow shareset default update <workflowId> --data '{"commonTiming":"1","commonMultiNode":["审批节点ID"]}'
+```
+
+基础字段：`defSharerCanViewComment`（默认共享人查看意见/评论）、`allowAddNoDefShare`（允许添加非默认共享）、`sendRemindTiming`（数组，1 添加默认共享时、2 添加非默认共享时）。
+
+默认共享字段：`defaultShareType` 为 0 通用 / 1 按条件共享；`commonTiming` 为 0 创建 / 1 到达节点 / 2 离开节点；`commonMultiNode` 为节点；`shareUsers` 为组织对象。到达/离开模式必须指定节点。切换共享模式是显式操作，不随规则新增隐式切换。不会执行“更新/删除历史流程默认共享”。
+
+### 按条件共享
+
+```bash
+e10-cli workflow shareset default update <workflowId> --data '{"defaultShareType":"1"}'
+e10-cli workflow shareset rule create <workflowId> --data '{"isEnable":false,"shareMultiNode":["节点ID"],"shareConditionUsers":[{"_entityType":"user","id":"人员ID"}],"condition":{"rules":["system:流程标题:包含:申请"],"relation":"AND"}}'
+e10-cli workflow shareset rule get <workflowId> --schema
+e10-cli workflow shareset rule update <workflowId> --rule-id <规则行ID> --data '{"shareTiming":"2"}'
+e10-cli workflow shareset condition get <workflowId> --rule-id <规则行ID>
+```
+
+字段：`shareConditionUsers`、`shareMultiNode`、`shareTiming`（1 到达 / 2 离开）、`isEnable`、`condition` 或 `shareCondition`。
+
+新增时 `shareTiming` 取实时列默认值，`isEnable` 优先取列默认值，服务端未声明时继承前端程序 `newAddTableList` 的 true。示例特意设 false，便于先核对规则再启用。
+
+`condition.rules` 使用已有条件编译器的 `system:字段:关系:值` / `form:字段名或ID:关系:值` 语法；`relation` 为 AND/OR，默认采用条件编辑器服务端 relation。表单字段、数字范围、明细量词等语法见[条件指南](guide-workflow-condition.md)。本命令始终使用共享条件 source=24，不能拿出口 source=2 替代。输入新 condition 时生成新条件引用，只替换该行；不会原地修改可能被其他行引用的条件。规则保存失败可能留下尚未绑定的条件，勿盲目重试。
+
+`shareCondition:{}` 表示无条件；非空 `shareCondition` 只允许复用此流程已有共享行的 conditionKey。公共规则引用向导、任意嵌套表达式和条件多语言编辑未在此命令实现。
+
+### 共享字段权限
+
+```bash
+e10-cli workflow shareset field-permission get <workflowId>
+e10-cli workflow shareset field-permission update <workflowId> --data '{"fields":[{"name":"单行文本","display":false}]}'
+e10-cli workflow shareset system-field-permission get <workflowId>
+e10-cli workflow shareset system-field-permission update <workflowId> --data '{"fields":[{"fieldType":"REQUEST_NAMEL","isview":false}]}'
+```
+
+普通字段支持 id 或唯一 name，只改 display。系统字段使用 get 返回的 fieldType，只改 isview；编辑/必填等属性及其他字段保持原值，不同步到节点。
+
+共享字段权限固定使用 legacy，不提供 `--renderer` 参数，也不保留新版权限写入分支。工作流程和 EB 均先读取 `frame/getPathFrameInfo`，根据 `relateType=wea_form/wea_ebuilder` 判断类型；缺失、未知类型、业务失败或 formId 不一致时停止，禁止通过接口成功/失败推断类型。旧版接口读取完整明细，只修改明确指定字段的显示权限并回读，保留其他属性。
+
+共享字段权限 legacy 接口契约：
+
+| 类型 | 读取 | 保存 |
+|---|---|---|
+| `wea_form` | `/api/workflow/core/bridgeform/getFieldPermissionViewDataById` | `/api/workflow/core/form/formFieldPermission/saveNodeExtSet` |
+| `wea_ebuilder` | `/api/ebuilder/flow/core/bridgeform/getFieldPermissionViewDataById` | `/api/workflow/core/form/formFieldPermission/saveNodeExtSet` |
+
+读取参数为 `workflowId/formId/permissionId/nodeFormRelateId=-1`；保存携带 `share:true`、`nodeFormRelate.workflowId`、完整 `fieldPermission.permissionDetails`。EB 的旧接口可能没有 `initPermissionDetails`，按旧前端组件从 `fieldList/readFieldIds/writeFieldIds` 还原明细：复合控件 ComboSelect、DateInterval、MatrixComponent 的子字段继承父字段权限，Paragraph/SubTableControl 不可写；缺少必要列表则停止。已有明细保留原属性，不自行补默认权限。保存由 workflow/core 后端根据关联类型分发，不能将它替换为节点新版 `saveFieldPermission`。
+
+## 提醒设置
+
+```bash
+e10-cli workflow remind get <workflowId> --schema
+e10-cli workflow remind update <workflowId> --data '{"forceEndReceiver":[]}'
+e10-cli workflow remind detail get <workflowId> --src emailAndSmsRemind --schema
+e10-cli workflow remind detail update <workflowId> --src sysRemind --data '{"sysCcNoRemind":true}'
+```
+
+主设置：`remindType` 为数组（0 短信、1 邮件、2 系统）；`isCustomContent` 自定义内容；`forceEndReceiver` 为数组（0 结束节点操作者、1 未操作已查看、2 未操作未查看、3 发起人）；`errRemindCustom`、`errReminder` 为错误提醒自定义开关及组织对象。省略字段不清空。
+
+详情渠道必须显式指定 `--src`：
+
+| 渠道 | 字段 |
+|---|---|
+| sysRemind | sysRemindScope（0 全部 / 1 指定）、sysArchiveNoRemind、sysCcNoRemind、messageSenderCustom、messageSenderType（0 发起人 / 1 当前操作者） |
+| emailAndSmsRemind | remindScope（0 全部 / 1 指定）、defaultRemindType（0/1 数组）、archiveNoRemind、ccNoRemind、chooseReminder、alterNodesType（0 全部 / 1 选择）、alterNodesBrowser |
+
+默认渠道不能超出主设置已启用的渠道。指定节点模式需要先新增节点规则，不会隐式添加节点。详情两组完整读取并保留另一组。
+
+### 指定节点提醒
+
+```bash
+e10-cli workflow remind nodes get <workflowId> --src emailAndSmsRemind --schema
+e10-cli workflow remind nodes create <workflowId> --src emailAndSmsRemind --data '{"alterNodesBrowser":["节点ID"],"remindType":["0","1"]}'
+e10-cli workflow remind nodes update <workflowId> --src emailAndSmsRemind --rule-id <规则ID> --data '{"ccNoRemind":true}'
+e10-cli workflow remind detail update <workflowId> --src emailAndSmsRemind --data '{"remindScope":"1"}'
+```
+
+新增字段为 alterNodesBrowser/remindType/ccNoRemind，未指定项从服务端新增表单继承。修改字段为 reminders（渠道数组）、ccNoRemind、remindContentType（0 默认 / 1 自定义）。规则ID与节点ID不同；CLI 核实流程与渠道归属。
+
+### 邮件、短信、系统消息模板
+
+```bash
+e10-cli workflow remind templates get <workflowId> --content-type 1
+# 流程级保存会被后端联动开启自定义；必须先明确设置该开关
+e10-cli workflow remind update <workflowId> --data '{"isCustomContent":true}'
+e10-cli workflow remind templates update <workflowId> --content-type 1 --event 10 --data '{"title":"待审批：[-313]"}'
+# 节点模板需要先有该渠道节点提醒规则；省略 --node-id 是流程级
+e10-cli workflow remind templates get <workflowId> --content-type 0 --node-id <节点ID>
+```
+
+content-type：0 短信 / 1 邮件 / 2 系统。`--event` 取 get 返回的 remindType，不猜事件编号。模板字段为 content，邮件另有 title/isFormData/isSignData/isAttachmentData，后面三项以环境能力为准。字段占位符用 `[code]`，从 fields 获取，校验事件 hideSysFields。修改会保留其他事件、未指定属性及现有多语言元数据；本命令不提供多语言翻译编辑。
+
+107 租户启用需审核的短信服务，产品本身不支持工作流或节点自定义短信内容，仅支持应用全局默认设置（前端 smsTemplateCheckFlag 对 WORKFLOW/NODE 返回 2）。CLI 查询返回 editable:false 和入口说明，写入明确拒绝；不会显示未生效的普通短信正文冒充有效模板。未开启审核的环境支持普通短信正文，但该分支尚无远端写入验证。邮件、系统消息已在关闭渠道且未启用的临时节点上原值保存并回读；流程级开关未改变，临时节点规则已移除。全局模板修改测试曾被自动审批拒绝，已改用这一安全验证；没有执行被拒绝脚本。