@mldong/jeeflow 1.6.3 → 1.6.4

package/dist/persist.d.ts

@@ -35,10 +35,17 @@ export declare class SqliteDynamicTableWriter implements DynamicTableWriter {
     /** 用户列默认值（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

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');
@@ -34,6 +38,9 @@ export class SqliteDynamicTableWriter {
     /** 用户列默认值（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;
     }
@@ -51,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}`);
@@ -80,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); // 表不存在提前报错

package/package.json

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