@mldong/jeeflow 1.8.6 → 1.8.8

package/dist/engine.d.ts

@@ -53,5 +53,11 @@ export declare class EngineImpl implements Engine {
     private resolveActors;
     private isAllowed;
     private addUserInfo;
+    /** 用户提供者访问（issue 41 补强：nodeProgress 姓名解析用） */
+    getUserProvider(): UserProvider | undefined;
     private nextId;
 }
+/** 会签判定（issue 42，对齐 Java ProcessTaskPerformTypeEnum.codeOf）：
+ *  '1' / 'ALL' / 'COUNTERSIGN'（大小写不敏感）→ 会签。
+ *  设计器属性面板保存 'ALL' 字符串符合 Java 契约，引擎必须兼容 */
+export declare function isCountersign(v: any): boolean;

package/dist/engine.js

@@ -356,11 +356,10 @@ export class EngineImpl {
         const actors = await this.resolveActors(node, inst, operator, vars);
         if (!actors.length)
             return;
-        const performType = parseInt(String(node.properties?.performType ?? '0'));
         const ct = node.properties?.countersignType;
         const now = new Date();
         const form = node.properties?.form ?? '';
-        if (performType === 1 && ct) {
+        if (isCountersign(node.properties?.performType) && ct) {
             switch (ct) {
                 case 'PARALLEL':
                     for (const actor of actors)
@@ -470,6 +469,10 @@ export class EngineImpl {
         if (u.postName)
             vars[KeyPostName] = u.postName;
     }
+    /** 用户提供者访问（issue 41 补强：nodeProgress 姓名解析用） */
+    getUserProvider() {
+        return this.userProv;
+    }
     nextId() {
         if (this.idGen)
             return this.idGen.nextId();
@@ -513,6 +516,13 @@ function isTruthy(v) {
         return v !== 0;
     return v != null;
 }
+/** 会签判定（issue 42，对齐 Java ProcessTaskPerformTypeEnum.codeOf）：
+ *  '1' / 'ALL' / 'COUNTERSIGN'（大小写不敏感）→ 会签。
+ *  设计器属性面板保存 'ALL' 字符串符合 Java 契约，引擎必须兼容 */
+export function isCountersign(v) {
+    const s = String(v ?? '').trim().toUpperCase();
+    return s === '1' || s === 'ALL' || s === 'COUNTERSIGN';
+}
 /** 办理提交的 f_ 字段按任务节点 field 权限过滤（issues/26）——
  *  任务节点 properties.field 声明 PERMISSION_f_{全名}（前端约定，优先）或
  *  PERMISSION_{去前缀名}（兼容）的字段，值非 EDIT(2)（只读 1/隐藏 3 等）→ 剔除不入变量。

package/dist/facade.d.ts

@@ -48,8 +48,11 @@ export declare class JeeflowFacade {
     private highLight;
     /** 节点成员进度（issue 41，对齐 boot3 highLight）：按任务状态 + 会签变量组装
      *  nodeProgress——会签节点带 type（PARALLEL/SEQUENTIAL），成员 done/active 标记；
-     *  动态参与人节点（无静态 actorIds）不返回；name 缺省（引擎不持有宿主用户体系，前端降级显示 id） */
+     *  动态参与人节点（无静态 actorIds）不返回；name 走引擎 UserProvider SPI 解析
+     *  realName（未注入/查不到时缺省空串，前端降级显示 id） */
     private buildNodeProgress;
+    /** 成员姓名解析（issue 43/E15）：UserProvider SPI 并行批量解析 realName，查不到缺省空串 */
+    private resolveMemberNames;
     private collectPath;
     /** 决策输出边表达式求值（args = 实例变量 + 决策节点前置任务变量） */
     private evalDecisionExpr;

package/dist/facade.js

@@ -4,7 +4,7 @@
 // action（boot2/boot3 端点短名）路由。返回统一结构 {code, msg, data}
 // （code=0 成功 / 99999999 失败）。操作人约定：args.operator 显式传入。
 import { TaskState, } from './model.js';
-import { KeyNextNodeOperator, KeyProcessStartNextNodeOperator } from './engine.js';
+import { KeyNextNodeOperator, KeyProcessStartNextNodeOperator, isCountersign } from './engine.js';
 // submitType 枚举（对齐 boot3）
 const SUBMIT_APPLY = 0;
 const SUBMIT_AGREE = 1;
@@ -607,7 +607,7 @@ export class JeeflowFacade {
         if (def) {
             try {
                 const flow = JSON.parse(toStr(def.content));
-                nodeProgress = this.buildNodeProgress(flow, his);
+                nodeProgress = await this.buildNodeProgress(flow, his);
                 await this.collectPath(flow, 'start', '', active, history, edges, new Set(), inst.variables ?? {}, his);
             }
             catch { /* ignore */ }
@@ -616,8 +616,9 @@ export class JeeflowFacade {
     }
     /** 节点成员进度（issue 41，对齐 boot3 highLight）：按任务状态 + 会签变量组装
      *  nodeProgress——会签节点带 type（PARALLEL/SEQUENTIAL），成员 done/active 标记；
-     *  动态参与人节点（无静态 actorIds）不返回；name 缺省（引擎不持有宿主用户体系，前端降级显示 id） */
-    buildNodeProgress(flow, his) {
+     *  动态参与人节点（无静态 actorIds）不返回；name 走引擎 UserProvider SPI 解析
+     *  realName（未注入/查不到时缺省空串，前端降级显示 id） */
+    async buildNodeProgress(flow, his) {
         const progress = {};
         const names = [...new Set(his.map(t => t.taskName))];
         for (const name of names) {
@@ -640,24 +641,43 @@ export class JeeflowFacade {
             const node = (flow.nodes ?? []).find((n) => n.id === name);
             // 会签判定：定义节点属性（引擎创建任务时 performType 未落任务表，取模型为准）
             const nodeProps = node?.properties ?? {};
-            const isCountersign = nodeProps.performType === 1 || nodeProps.countersignType != null;
-            const item = {
-                members: members.map((id) => {
-                    const m = { id, name: '' };
-                    if (doneSet.has(id))
-                        m.done = true;
-                    else if (id === activeActor)
-                        m.active = true;
-                    return m;
-                }),
-            };
-            if (isCountersign && nodeProps.countersignType) {
+            const isCs = isCountersign(nodeProps.performType) || nodeProps.countersignType != null;
+            // 姓名走 UserProvider SPI 解析（未注入/查不到缺省空串），done/active 按任务状态标记
+            const memberList = await this.resolveMemberNames(members);
+            for (const m of memberList) {
+                if (doneSet.has(m.id))
+                    m.done = true;
+                else if (m.id === activeActor)
+                    m.active = true;
+            }
+            const item = { members: memberList };
+            if (isCs && nodeProps.countersignType) {
                 item.type = nodeProps.countersignType;
             }
             progress[name] = item;
         }
         return progress;
     }
+    /** 成员姓名解析（issue 43/E15）：UserProvider SPI 并行批量解析 realName，查不到缺省空串 */
+    async resolveMemberNames(ids) {
+        const userProv = this.engine.getUserProvider();
+        const nameMap = {};
+        if (userProv) {
+            const results = await Promise.all(ids.map(async (id) => {
+                try {
+                    const u = await userProv.getUser(id);
+                    return [id, u?.realName ?? ''];
+                }
+                catch {
+                    return [id, '']; // 单用户失败不影响其余
+                }
+            }));
+            for (const [id, name] of results)
+                if (name)
+                    nameMap[id] = name;
+        }
+        return ids.map(id => ({ id, name: nameMap[id] ?? '' }));
+    }
     async collectPath(flow, nodeId, edgeName, active, history, edges, visited, vars, historyTasks) {
         if (visited.has(nodeId))
             return;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mldong/jeeflow",
-  "version": "1.8.6",
+  "version": "1.8.8",
   "description": "jeeflow workflow engine — Node.js / TypeScript implementation",
   "type": "module",
   "main": "./dist/index.js",