@mldong/jeeflow 1.6.2 → 1.6.4

package/dist/persist.d.ts

@@ -32,12 +32,25 @@ export declare class SqliteDynamicTableWriter implements DynamicTableWriter {
     updateTimeColumn?: string | null;
     updateUserColumn?: string | null;
     isDeletedColumn?: string | null;
+    /** 用户列默认值（issues/19）：优先取 data 中已注入的 apply_user_id=流程 operator，
+     *  否则用此配置值，缺省 "system"——多数框架业务表 create_user/update_user 为 BIGINT 存 userId */
+    defaultUserValue: unknown;
+    /** 列匹配（issues/20）：默认宽松——驼峰↔下划线归一匹配（表单字段 companyName ↔ 表列 company_name）；
+     *  需要精确控制列名的集成方显式开启严格模式（忽略大小写精确匹配） */
+    strictColumnMatch: boolean;
     constructor(db: DatabaseSync);
     private tableColumns;
     filterColumns(tableName: string, columns: string[]): string[];
     insert(tableName: string, data: Record<string, unknown>): unknown;
+    /** 列匹配（issues/20）：严格=忽略大小写精确；宽松（默认）=驼峰↔下划线归一匹配 */
+    private findColumn;
+    /** 在 data 中找匹配指定表列的 key（宽松模式驼峰 key 匹配下划线列） */
+    private findDataKey;
     exists(tableName: string, bizKey: string, bizKeyValue: unknown): boolean;
     fillSystemFields(data: Record<string, unknown>, isInsert: boolean): void;
+    /** 默认用户值（issues/19）：优先取 data 中已注入的 apply_user_id
+     * （拦截器场景 = 流程 operator，BIGINT 用户列表开箱即用），否则回落配置默认值 */
+    private resolveDefaultUser;
 }
 /** 流程定义加载器（用于解析 relTableName / 流程 name），通常透传仓库 findDefineById */
 export type DefineLoader = (defineId: number) => Promise<ProcessDefine | null>;

package/dist/persist.js

@@ -2,6 +2,10 @@ import { KeySubmitType, KeyDeptID } from './engine.js';
 import { TypeEnd, InstanceState, SubmitType } from './model.js';
 // ─── 默认实现：node:sqlite（内置零依赖） ──────────────────────────────────────
 const TABLE_NAME_RE = /^[A-Za-z0-9_]+$/;
+/** 列名归一（issues/20）：转小写 + 去下划线（companyName / company_name / COMPANY_NAME 等价） */
+function normalizeColumn(name) {
+    return name.toLowerCase().replace(/_/g, '');
+}
 function nowText() {
     const d = new Date();
     const p = (n) => String(n).padStart(2, '0');
@@ -31,6 +35,12 @@ export class SqliteDynamicTableWriter {
     updateTimeColumn = 'update_time';
     updateUserColumn = 'update_user';
     isDeletedColumn = 'is_deleted';
+    /** 用户列默认值（issues/19）：优先取 data 中已注入的 apply_user_id=流程 operator，
+     *  否则用此配置值，缺省 "system"——多数框架业务表 create_user/update_user 为 BIGINT 存 userId */
+    defaultUserValue = 'system';
+    /** 列匹配（issues/20）：默认宽松——驼峰↔下划线归一匹配（表单字段 companyName ↔ 表列 company_name）；
+     *  需要精确控制列名的集成方显式开启严格模式（忽略大小写精确匹配） */
+    strictColumnMatch = false;
     constructor(db) {
         this.db = db;
     }
@@ -48,27 +58,21 @@ export class SqliteDynamicTableWriter {
     }
     filterColumns(tableName, columns) {
         checkTableName(tableName);
-        const set = new Set(this.tableColumns(tableName));
-        return columns.filter(c => set.has(c.toUpperCase()));
+        const cols = this.tableColumns(tableName);
+        return columns.filter(c => this.findColumn(cols, c) !== '');
     }
     insert(tableName, data) {
         checkTableName(tableName);
         const cols = this.tableColumns(tableName);
         const names = [];
         const values = [];
-        // 保持插入顺序稳定（对象键无序，按表列顺序取）
+        // 保持插入顺序稳定（对象键无序，按表列顺序取）；写入用表列原名（issues/20）
         for (const col of cols) {
-            if (Object.prototype.hasOwnProperty.call(data, col)) {
-                names.push(col);
-                values.push(data[col]);
-            }
-            else {
-                const key = Object.keys(data).find(k => k.toUpperCase() === col);
-                if (key !== undefined) {
-                    names.push(col);
-                    values.push(data[key]);
-                }
-            }
+            const key = this.findDataKey(data, col);
+            if (key === '')
+                continue;
+            names.push(col);
+            values.push(data[key]);
         }
         if (names.length === 0)
             throw new Error(`persist: no matching columns for ${tableName}`);
@@ -77,6 +81,27 @@ export class SqliteDynamicTableWriter {
         const res = stmt.run(...values);
         return res.lastInsertRowid;
     }
+    /** 列匹配（issues/20）：严格=忽略大小写精确；宽松（默认）=驼峰↔下划线归一匹配 */
+    findColumn(cols, key) {
+        for (const col of cols) {
+            if (this.strictColumnMatch) {
+                if (col.toUpperCase() === key.toUpperCase())
+                    return col;
+            }
+            else if (normalizeColumn(col) === normalizeColumn(key)) {
+                return col;
+            }
+        }
+        return '';
+    }
+    /** 在 data 中找匹配指定表列的 key（宽松模式驼峰 key 匹配下划线列） */
+    findDataKey(data, col) {
+        for (const k of Object.keys(data)) {
+            if (this.findColumn([col], k) !== '')
+                return k;
+        }
+        return '';
+    }
     exists(tableName, bizKey, bizKeyValue) {
         checkTableName(tableName);
         this.tableColumns(tableName); // 表不存在提前报错
@@ -89,11 +114,11 @@ export class SqliteDynamicTableWriter {
             if (this.createTimeColumn)
                 data[this.createTimeColumn] ??= now;
             if (this.createUserColumn)
-                data[this.createUserColumn] ??= 'system';
+                data[this.createUserColumn] ??= this.resolveDefaultUser(data);
             if (this.updateTimeColumn)
                 data[this.updateTimeColumn] ??= now;
             if (this.updateUserColumn)
-                data[this.updateUserColumn] ??= 'system';
+                data[this.updateUserColumn] ??= this.resolveDefaultUser(data);
             if (this.isDeletedColumn)
                 data[this.isDeletedColumn] ??= 0;
         }
@@ -101,9 +126,14 @@ export class SqliteDynamicTableWriter {
             if (this.updateTimeColumn)
                 data[this.updateTimeColumn] = now;
             if (this.updateUserColumn)
-                data[this.updateUserColumn] ??= 'system';
+                data[this.updateUserColumn] ??= this.resolveDefaultUser(data);
         }
     }
+    /** 默认用户值（issues/19）：优先取 data 中已注入的 apply_user_id
+     * （拦截器场景 = 流程 operator，BIGINT 用户列表开箱即用），否则回落配置默认值 */
+    resolveDefaultUser(data) {
+        return data['apply_user_id'] ?? this.defaultUserValue;
+    }
 }
 /**
  * 工作流业务数据入库适配拦截器——流程结束同意后，f_ 表单数据写入业务表。
@@ -141,6 +171,14 @@ export class PersistPostInterceptor {
         const submitType = Number(inst.variables[KeySubmitType]);
         if (submitType !== SubmitType.Agree)
             return;
+        // 同链重复触发防护（issues/19）：最后任务节点与结束节点都会触发后置拦截器，
+        // 同一执行链（共享 inst.variables）只插一次。标记写入时实例已完成持久化
+        // （引擎 executeNode 先 updateInstance 后触发拦截器，repo 存副本）不会落库；
+        // exists 保留作为跨请求/重启的幂等兜底（先查后插语义不变）。
+        const chainKey = `__persist_executed_${inst.id}`;
+        if (inst.variables[chainKey] === true)
+            return;
+        inst.variables[chainKey] = true;
         // 表名：流程定义顶层 relTableName，缺省回落流程 name
         const tableName = await this.resolveTableName(inst);
         if (!tableName)

package/package.json

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