@mldong/jeeflow 1.8.7 → 1.8.8

package/dist/engine.d.ts

@@ -53,6 +53,8 @@ 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）：

package/dist/engine.js

@@ -469,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();

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

@@ -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) {
@@ -641,16 +642,15 @@ export class JeeflowFacade {
             // 会签判定：定义节点属性（引擎创建任务时 performType 未落任务表，取模型为准）
             const nodeProps = node?.properties ?? {};
             const isCs = isCountersign(nodeProps.performType) || 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;
-                }),
-            };
+            // 姓名走 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;
             }
@@ -658,6 +658,26 @@ export class JeeflowFacade {
         }
         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.7",
+  "version": "1.8.8",
   "description": "jeeflow workflow engine — Node.js / TypeScript implementation",
   "type": "module",
   "main": "./dist/index.js",