@stalfh233/omc-cli 0.4.100 → 0.4.101

package/dist/rule-support.js

@@ -446,6 +446,100 @@ export function isModernAssignVersion(version) {
  * supported alternatives (BRANCH, or two rules).
  */
 const CHOICE_CONDITION_TYPES = new Set([12, 13, 14, 15]);
+/**
+ * 2026-10-27 用户反馈 + r24 沙盒四格矩阵（1.1.25 真机实测）：
+ * CREATE（新增数据）节点打到**已发布流程的模型**时的流程发起开关语义——
+ *
+ *   不传 startWorkflow          → 行落库、不发起流程（API 默认，实测）
+ *   true + originatorValue "{}" → 触发表单提交 50000（fastjson expect '[', but {）
+ *   true + 数组但 id 无效        → 50000「业务规则发起人不存在」
+ *   true + [{id,name}] 真实用户 + targetWorkflowCode → 行落库并自动发起流程
+ *
+ * 契约：目标有已发布流程而未声明开关 → warning 教学显式做法（合法的两种选择
+ * 都要写明）；开了开关但 originatorValue/targetWorkflowCode 不合法 → error
+ * 写前拒绝——那两种形状会把**触发表单的提交**整个打挂，正是 fail-closed 该拦的。
+ */
+async function createNodeFlowStartWarnings(session, nodes) {
+    const creates = nodes.filter((node) => String(node.nodeType ?? "") === "CREATE" && String(node.targetObjectCode ?? "") !== "");
+    if (creates.length === 0)
+        return [];
+    const flowByTarget = new Map();
+    for (const target of [...new Set(creates.map((node) => String(node.targetObjectCode)))]) {
+        try {
+            const isWorkflow = (await wireCall(session, { path: ENDPOINTS.workflowIsWorkflow, query: { schemaCode: target } })).data === true;
+            if (!isWorkflow)
+                continue;
+            const row = (await wireCall(session, { path: ENDPOINTS.workflowGetBySchema, query: { schemaCode: target } })).data;
+            const code = row && typeof row.workflowCode === "string" && row.workflowCode ? row.workflowCode : null;
+            if (!code)
+                continue;
+            // get_published 原样回模板（fake 保真：未发布也回 DRAFT 形状——Ticket 77，
+            // 发布证据是 templateType:PUBLISH 标记，不是有数据）；流程码用已解析的 code。
+            const published = (await wireCall(session, { path: ENDPOINTS.workflowGetPublished, query: { workflowCode: code } })).data;
+            const publishMarker = published !== null && published !== undefined ? String(published.templateType ?? "").toUpperCase() : "ABSENT";
+            if (published && (publishMarker === "" || publishMarker === "PUBLISH"))
+                flowByTarget.set(target, code);
+        }
+        catch {
+            // 读面失败不阻塞写面（与 radioConditionWarnings 同策略：读不到就不评）
+        }
+    }
+    const findings = [];
+    for (const node of creates) {
+        const target = String(node.targetObjectCode);
+        const flowCode = flowByTarget.get(target);
+        if (flowCode === undefined)
+            continue;
+        const nodeCode = String(node.nodeCode ?? "");
+        if (node.startWorkflow === undefined || node.startWorkflow === false) {
+            findings.push({
+                code: "rule-create-target-has-flow",
+                nodeCode,
+                key: "startWorkflow",
+                severity: "warning",
+                message: `CREATE 目标模型 ${target} 已发布流程 ${flowCode}：不传 startWorkflow 时规则建行**不发起流程**（实测 2026-10-27，行落库即止）。` +
+                    `要让规则新建的行直接进流程：显式 startWorkflow:true + targetWorkflowCode:"${flowCode}"，且 originatorValue 必须是用户对象数组 [{"id":"<userId>","name":"<名>"}]（id 用 org.user.search 取；传对象 {} 或无效 id 会让**触发表单的提交**直接 50000，实测）。` +
+                    `注意：设计器里手工编辑该节点可打开此开关——API 与设计器两侧配置可能漂移，改完用 rule.get 回读核对 startWorkflow/targetWorkflowCode。`,
+            });
+            continue;
+        }
+        const raw = typeof node.originatorValue === "string" ? node.originatorValue.trim() : node.originatorValue;
+        let parsed = raw;
+        if (typeof raw === "string" && raw.length > 0) {
+            try {
+                parsed = JSON.parse(raw);
+            }
+            catch {
+                parsed = null;
+            }
+        }
+        const originatorValid = Array.isArray(parsed)
+            && parsed.length > 0
+            && parsed.every((entry) => entry && typeof entry === "object" && typeof entry.id === "string" && entry.id.length > 0);
+        if (!originatorValid) {
+            findings.push({
+                code: "rule-create-startworkflow-originator-shape",
+                nodeCode,
+                key: "originatorValue",
+                message: `CREATE "${nodeCode}" 开了 startWorkflow 但 originatorValue 不是用户对象数组：期望 [{"id":"<userId>","name":"<名>"}]。` +
+                    `实测（2026-10-27，1.1.25）：传对象 {} → 触发表单提交 50000（fastjson "expect '[', but {"）；数组里 id 无效 → 50000「业务规则发起人不存在」。` +
+                    `id 用 org.user.search 取真实用户后再写。`,
+            });
+        }
+        // 「startWorkflow:true 必须带 targetWorkflowCode」由既有的离线同步检查
+        // rule-graph-create-workflow-code 负责（rule-graph.ts:2055），这里不重复——
+        // 但流程码要能对上：给了但不是该模型的已发布流程时补一条 error。
+        if (typeof node.targetWorkflowCode === "string" && node.targetWorkflowCode.length > 0 && node.targetWorkflowCode !== flowCode) {
+            findings.push({
+                code: "rule-create-startworkflow-target-mismatch",
+                nodeCode,
+                key: "targetWorkflowCode",
+                message: `CREATE "${nodeCode}" 的 targetWorkflowCode="${node.targetWorkflowCode}" 不是目标模型 ${target} 的已发布流程（应为 "${flowCode}"）——发到不匹配的流程会运行期失败。`,
+            });
+        }
+    }
+    return findings;
+}
 async function radioConditionWarnings(session, schemaCode, nodes) {
     const sources = new Set();
     const collect = (condition) => {
@@ -659,6 +753,8 @@ export async function executeRuleSaveWrite(session, args) {
     const blockers = [...prepared.warnings, ...validateRuleNodeGraph(preparedGraph, args.ruleCode, typeof args.schemaCode === "string" ? args.schemaCode : undefined, carriedNodeCodes ? { carriedNodeCodes } : {})];
     // 1.2: needs the published field types (pure lint cannot see them).
     blockers.push(...(await radioConditionWarnings(session, args.schemaCode, Array.isArray(preparedGraph.nodes) ? preparedGraph.nodes : [])));
+    // r24 反馈（2026-10-27 真机四格矩阵）：CREATE 目标带已发布流程时的发起开关教学/拦截。
+    blockers.push(...(await createNodeFlowStartWarnings(session, Array.isArray(preparedGraph.nodes) ? preparedGraph.nodes : [])));
     // Ticket 113: warning-severity findings (e.g. unknown mapping keys) do not
     // gate the write; they surface in the readback as lintWarnings.
     const warningFindings = blockers.filter((blocker) => blocker.severity === "warning");

package/docs/images/omc-nixi/README.md

@@ -0,0 +1,41 @@
+# 截图占位目录（尼西实战案例）
+
+`omc-introduction.md` 的「15. 实战一：尼西双表单与流程搭建」章节里引用了 9 张截图。
+把截图按下面文件名放进本目录即可，文档中的占位说明可逐条删除。
+
+## 客户源需求（3 张）
+
+| 文件名 | 内容 |
+|---|---|
+| `01-requirement-ft-sheet.png` | 客户 Excel 的 `FT` Sheet（字段清单 / 必填 / LotClass 显隐） |
+| `02-requirement-fp-sheet.png` | 客户 Excel 的 `FP` Sheet |
+| `03-requirement-flow.png` | 客户给的流程图（FT/FP，含 `SubConRootCause=1` 分支） |
+
+## 对话截图（6 张）
+
+| 文件名 | 内容 |
+|---|---|
+| `04-chat-app-create.png` | 确认新建应用 + `app.create ok` |
+| `05-chat-intent-apply.png` | `intent apply` 返回 `DELIVERED` + `equivalent: true`（89 个动作） |
+| `06-chat-workflow-role.png` | 流程节点与角色路由（PIC→蔡依涛 / MOS→赵益 / AOSIT / AOSENG） |
+| `07-chat-permission-matrix.png` | 节点字段权限矩阵（本节点 + 之前所有节点可见） |
+| `08-chat-biz-integration.png` | `service.register` 注册 productType 服务 + `method.test` 返回 `PRODUCT_TYPE=MOS` |
+| `09-chat-onlinejs-publish.png` | `onlinejs.compose` 返回 `published: true` |
+
+## 替换方式
+
+文档里每处占位是：
+
+```
+> **[截图 01｜客户源需求：FT 表单规格]**
+> 占位文件：`docs/images/omc-nixi/01-requirement-ft-sheet.png`
+> 建议内容：...
+```
+
+落地后改成标准图片引用即可：
+
+```markdown
+![客户源需求：FT 表单规格](images/omc-nixi/01-requirement-ft-sheet.png)
+```
+
+建议截图宽度 ≥ 1200px，避免中文文字模糊。