@mldong/jeeflow 1.4.0 → 1.5.0

package/dist/engine.d.ts

@@ -31,6 +31,8 @@ export declare class EngineImpl implements Engine {
     setExtensions(ext: EngineExtensions): void;
     setRegistry(reg: HandlerRegistry): void;
     private firePre;
+    /** 表达式求值（v1.5.0，门面 highLight 决策分支过滤用） */
+    evalExpr(expr: string, vars: Record<string, any>): Promise<any>;
     private firePost;
     private fireEvent;
     startProcessInstanceById(defineId: number, operator: string, args?: Record<string, any>): Promise<ProcessInstance>;

package/dist/engine.js

@@ -36,6 +36,12 @@ export class EngineImpl {
                 return false;
         return true;
     }
+    /** 表达式求值（v1.5.0，门面 highLight 决策分支过滤用） */
+    async evalExpr(expr, vars) {
+        if (!this.exprEval)
+            throw new Error('ExpressionEvaluator 未配置');
+        return this.exprEval.eval(expr, vars);
+    }
     async firePost(node, inst) {
         if (!this.ext?.interceptors)
             return;

package/dist/facade.d.ts

@@ -24,6 +24,8 @@ export declare class JeeflowFacade {
     private getLastByName;
     private highLight;
     private collectPath;
+    /** 决策输出边表达式求值（args = 实例变量 + 决策节点前置任务变量） */
+    private evalDecisionExpr;
     private approvalRecord;
     private getAssigneeTextData;
     private createCCInstance;
@@ -36,4 +38,14 @@ export declare class JeeflowFacade {
     private taskAddActor;
     private taskLatest;
     private ext;
+    private definePage;
+    private defineDetail;
+    private instancePage;
+    private instanceDetail;
+    /** 流程 JSON 中第一个任务节点 id（issues/05-4 isFirstTaskNode 用） */
+    private firstTaskNodeId;
+    private todoList;
+    private doneList;
+    /** 定义 content 解析为 LogicFlow JSON（issues/05 jsonObject） */
+    private parseGraph;
 }

package/dist/facade.js

@@ -3,6 +3,7 @@
 // 集成方只实现一个转发端点：把 body JSON 转成对象传入 flow()，所有流程能力按
 // action（boot2/boot3 端点短名）路由。返回统一结构 {code, msg, data}
 // （code=0 成功 / 99999999 失败）。操作人约定：args.operator 显式传入。
+import { TaskState, } from './model.js';
 // submitType 枚举（对齐 boot3）
 const SUBMIT_APPLY = 0;
 const SUBMIT_AGREE = 1;
@@ -37,6 +38,10 @@ export class JeeflowFacade {
     }
     async dispatch(action, args) {
         switch (action) {
+            case 'processDefine/page':
+                return this.definePage(args);
+            case 'processDefine/detail':
+                return this.defineDetail(args);
             case 'processDefine/startAndExecute':
             case 'processInstance/startAndExecute':
                 return this.startAndExecute(args);
@@ -49,8 +54,16 @@ export class JeeflowFacade {
                 return this.repo.removeDefine(toId(args.id));
             case 'processDefine/upAndDown':
                 return this.repo.updateDefineState(toId(args.id), toInt(args.state));
+            case 'processInstance/page':
+                return this.instancePage(args);
+            case 'processInstance/detail':
+                return this.instanceDetail(args);
             case 'processInstance/withdraw':
                 return this.withdraw(args);
+            case 'processTask/todoList':
+                return this.todoList(args);
+            case 'processTask/doneList':
+                return this.doneList(args);
             case 'processTask/execute':
                 return this.execute(args);
             case 'processDesign/page':
@@ -231,7 +244,7 @@ export class JeeflowFacade {
     }
     // ── 流程设计（需扩展仓储） ───────────────────────────────────────────────
     async designPage(args) {
-        const [rows, total] = await this.ext().pageDesigns(toInt(args.pageNum ?? 1), toInt(args.pageSize ?? 10));
+        const [rows, total] = await this.ext().pageDesigns(toInt(args.pageNum ?? 1), toInt(args.pageSize ?? 10), undefined, parseMQuery(args));
         return { rows, recordCount: total };
     }
     async designDetail(args) {
@@ -244,12 +257,25 @@ export class JeeflowFacade {
             type: design.type, icon: design.icon, isDeployed: design.isDeployed, remark: design.remark,
         };
         const hisList = await ext.listDesignHis(design.id);
+        let jsonObject;
         if (hisList.length > 0) {
             try {
-                data.jsonObject = JSON.parse(toStr(hisList[0].content));
+                jsonObject = JSON.parse(toStr(hisList[0].content));
             }
             catch { /* ignore */ }
         }
+        // issues/07：jsonObject 缺失基本信息时从设计表补齐（对齐 boot3 ProcessDesignServiceImpl.findById）
+        if (!jsonObject || typeof jsonObject !== 'object')
+            jsonObject = {};
+        if (!(jsonObject.name))
+            jsonObject.name = design.name;
+        if (!(jsonObject.displayName))
+            jsonObject.displayName = design.displayName;
+        if (!(jsonObject.type))
+            jsonObject.type = design.type;
+        if (!(jsonObject.processDesignId))
+            jsonObject.processDesignId = design.id;
+        data.jsonObject = jsonObject;
         data.his = hisList;
         return data;
     }
@@ -296,7 +322,7 @@ export class JeeflowFacade {
     // ── 委托代理（需扩展仓储） ───────────────────────────────────────────────
     async surrogatePage(args) {
         const filters = args.operator != null ? { operator: String(args.operator) } : undefined;
-        const [rows, total] = await this.ext().pageSurrogates(toInt(args.pageNum ?? 1), toInt(args.pageSize ?? 10), filters);
+        const [rows, total] = await this.ext().pageSurrogates(toInt(args.pageNum ?? 1), toInt(args.pageSize ?? 10), filters, parseMQuery(args));
         return { rows, recordCount: total };
     }
     async surrogateSave(args) {
@@ -353,26 +379,33 @@ export class JeeflowFacade {
         for (const t of his)
             if (!active.includes(t.taskName) && !history.includes(t.taskName))
                 history.push(t.taskName);
-        // 路径补全：start 沿边递归（遇活跃节点停止）
+        // 路径补全：start 沿边递归（遇活跃节点停止）；决策分支按表达式求值过滤（issues/06）
         const def = await this.repo.findDefineById(inst.defineId);
         if (def) {
             try {
                 const flow = JSON.parse(toStr(def.content));
-                this.collectPath(flow, 'start', '', active, history, edges, new Set());
+                await this.collectPath(flow, 'start', '', active, history, edges, new Set(), inst.variables ?? {}, his);
             }
             catch { /* ignore */ }
         }
         return { activeNodeNames: active, historyNodeNames: history, historyEdgeNames: edges };
     }
-    collectPath(flow, nodeId, edgeName, active, history, edges, visited) {
+    async collectPath(flow, nodeId, edgeName, active, history, edges, visited, vars, historyTasks) {
         if (visited.has(nodeId))
             return;
         visited.add(nodeId);
         if (edgeName && !edges.includes(edgeName))
             edges.push(edgeName);
+        const src = (flow.nodes ?? []).find((n) => n.id === nodeId);
         for (const e of flow.edges ?? []) {
             if (e.sourceNodeId !== nodeId)
                 continue;
+            // 决策节点：输出边表达式求值过滤（对齐 boot3 recursionModel，issues/06）
+            if (src?.type === 'snaker:decision') {
+                const expr = e.properties?.expr;
+                if (expr && !await this.evalDecisionExpr(flow, src, expr, vars, historyTasks))
+                    continue;
+            }
             const target = (flow.nodes ?? []).find((n) => n.id === e.targetNodeId);
             if (!target)
                 continue;
@@ -381,7 +414,25 @@ export class JeeflowFacade {
                 history.push(tid);
             if (active.includes(tid))
                 continue;
-            this.collectPath(flow, tid, e.id, active, history, edges, visited);
+            await this.collectPath(flow, tid, e.id, active, history, edges, visited, vars, historyTasks);
+        }
+    }
+    /** 决策输出边表达式求值（args = 实例变量 + 决策节点前置任务变量） */
+    async evalDecisionExpr(flow, decision, expr, vars, historyTasks) {
+        const args = { ...(vars ?? {}) };
+        for (const e of flow.edges ?? []) {
+            if (e.targetNodeId === decision.id) {
+                const t = (historyTasks ?? []).find((x) => x.taskName === e.sourceNodeId);
+                if (t?.variables)
+                    Object.assign(args, t.variables);
+                break;
+            }
+        }
+        try {
+            return Boolean(await this.engine.evalExpr(expr, args));
+        }
+        catch {
+            return false;
         }
     }
     async approvalRecord(args) {
@@ -424,8 +475,8 @@ export class JeeflowFacade {
         const pageNum = toInt(args.pageNum ?? 1);
         const pageSize = toInt(args.pageSize ?? 10);
         const actorId = String(args.operator ?? 'user1');
-        const { rows, total } = await this.repo.pageCcInstances(pageNum, pageSize, actorId);
-        return { rows, recordCount: total };
+        const { rows, total } = await this.repo.pageCcInstances(pageNum, pageSize, actorId, parseMQuery(args));
+        return { rows: rows.map(r => ccRowToMap(r)), recordCount: total };
     }
     async taskDetail(args) {
         const taskId = toId(args.id);
@@ -446,6 +497,7 @@ export class JeeflowFacade {
         if (inst) {
             const def = await this.repo.findDefineById(inst.defineId);
             if (def) {
+                vo.jsonObject = this.parseGraph(def.content); // issues/05
                 try {
                     const flow = JSON.parse(toStr(def.content));
                     for (const n of flow.nodes ?? []) {
@@ -558,8 +610,206 @@ export class JeeflowFacade {
             throw new Error('未配置 ProcessExtRepository（扩展仓储）');
         return this.extRepo;
     }
+    // ═══ 基础分页/详情（v1.5.0 补齐，对齐 Java 门面）═══
+    async definePage(args) {
+        const pageNum = toInt(args.pageNum ?? 1);
+        const pageSize = toInt(args.pageSize ?? 10);
+        const { rows, total } = await this.repo.pageDefines(pageNum, pageSize, parseMQuery(args));
+        return { rows: rows.map(r => defineRowToMap(r)), recordCount: total };
+    }
+    async defineDetail(args) {
+        const id = toId(args.id);
+        const def = await this.repo.findDefineById(id);
+        if (!def)
+            throw new Error('流程定义不存在');
+        return {
+            id: def.id, name: def.name, displayName: def.displayName,
+            type: def.type, state: def.state, version: def.version,
+            jsonObject: this.parseGraph(def.content), // issues/05
+        };
+    }
+    async instancePage(args) {
+        const pageNum = toInt(args.pageNum ?? 1);
+        const pageSize = toInt(args.pageSize ?? 10);
+        const operator = String(args.operator ?? 'user1');
+        const { rows, total } = await this.repo.pageInstances(pageNum, pageSize, operator, parseMQuery(args));
+        return { rows: rows.map(r => instanceRowToMap(r)), recordCount: total };
+    }
+    async instanceDetail(args) {
+        const id = toId(args.id);
+        const inst = await this.repo.findInstanceById(id);
+        if (!inst)
+            throw new Error('流程实例不存在');
+        const def0 = await this.repo.findDefineById(inst.defineId);
+        const graph = def0 ? this.parseGraph(def0.content) : undefined;
+        // 任务列表（issues/05-4）：全量 tasks + activeTaskList（仅 DOING）+ 任务行 ext/isFirstTaskNode
+        const firstTaskNodeId = this.firstTaskNodeId(graph);
+        const tasks = [];
+        const activeTaskList = [];
+        for (const t of inst.tasks ?? []) {
+            const vo = {
+                id: t.id, processInstanceId: t.processInstanceId, taskName: t.taskName,
+                displayName: t.displayName, taskType: t.taskType ?? null,
+                performType: t.performType ?? null, taskState: t.taskState,
+                operator: t.actorId ?? '', finishTime: t.finishTime,
+                expireTime: t.expireTime, formKey: t.formKey ?? '', taskParentId: t.parentTaskId ?? null,
+                variable: JSON.stringify(t.variables ?? {}),
+                createTime: t.createTime, createUser: t.createUser,
+                updateTime: t.updateTime, updateUser: t.updateUser,
+                taskActorIdList: t.actorIds ?? [],
+            };
+            const ext = { ...(t.variables ?? {}) };
+            const doing = t.taskState === TaskState.Doing;
+            ext.isFirstTaskNode = doing && t.taskName === firstTaskNodeId;
+            vo.ext = ext;
+            tasks.push(vo);
+            if (doing)
+                activeTaskList.push(vo);
+        }
+        return {
+            id: inst.id, parentId: inst.parentId, processDefineId: inst.defineId,
+            state: inst.state, parentNodeName: inst.parentNodeName,
+            businessNo: inst.businessNo, operator: inst.operator,
+            variables: inst.variables, createTime: inst.createTime, createUser: inst.createUser,
+            jsonObject: graph, // issues/05
+            tasks,
+            activeTaskList,
+        };
+    }
+    /** 流程 JSON 中第一个任务节点 id（issues/05-4 isFirstTaskNode 用） */
+    firstTaskNodeId(graph) {
+        for (const n of graph?.nodes ?? []) {
+            if (n?.type === 'snaker:task')
+                return n.id;
+        }
+        return '';
+    }
+    async todoList(args) {
+        const pageNum = toInt(args.pageNum ?? 1);
+        const pageSize = toInt(args.pageSize ?? 10);
+        const actorId = String(args.operator ?? 'user1');
+        const { rows, total } = await this.repo.pageTodoTasks(pageNum, pageSize, actorId, parseMQuery(args));
+        return { rows: rows.map(r => taskRowToMap(r)), recordCount: total };
+    }
+    async doneList(args) {
+        const pageNum = toInt(args.pageNum ?? 1);
+        const pageSize = toInt(args.pageSize ?? 10);
+        const operator = String(args.operator ?? 'user1');
+        const { rows, total } = await this.repo.pageDoneTasks(pageNum, pageSize, operator, parseMQuery(args));
+        return { rows: rows.map(r => taskRowToMap(r)), recordCount: total };
+    }
+    /** 定义 content 解析为 LogicFlow JSON（issues/05 jsonObject） */
+    parseGraph(content) {
+        try {
+            const str = typeof content === 'string' ? content : new TextDecoder().decode(content);
+            const obj = JSON.parse(str);
+            return obj && typeof obj === 'object' ? obj : undefined;
+        }
+        catch {
+            return undefined;
+        }
+    }
+}
+// ── 行转 Map（issues/05-2 列表字段契约 + 05-3 时间格式）─────────────────────
+/** Date → 'yyyy-MM-dd HH:mm:ss'（null/undefined → null） */
+function fmtTime(v) {
+    if (v == null)
+        return null;
+    const p = (n) => String(n).padStart(2, '0');
+    return `${v.getFullYear()}-${p(v.getMonth() + 1)}-${p(v.getDate())} ${p(v.getHours())}:${p(v.getMinutes())}:${p(v.getSeconds())}`;
+}
+/** JSON 字符串 → 对象（坏 JSON / 空返回空对象） */
+function parseVarMap(json) {
+    if (!json)
+        return {};
+    try {
+        const o = JSON.parse(json);
+        return o && typeof o === 'object' ? o : {};
+    }
+    catch {
+        return {};
+    }
+}
+/** 定义行：时间格式化 */
+function defineRowToMap(r) {
+    return {
+        id: r.id, name: r.name, displayName: r.displayName, type: r.type,
+        state: r.state, version: r.version,
+        createTime: fmtTime(r.createTime), createUser: r.createUser,
+        updateTime: fmtTime(r.updateTime), updateUser: r.updateUser,
+    };
+}
+/** 实例行：ext（实例变量对象）+ displayName/version（定义） */
+function instanceRowToMap(r) {
+    return {
+        id: r.id, parentId: r.parentId ?? null, processDefineId: r.defineId,
+        state: r.state, parentNodeName: r.parentNodeName, businessNo: r.businessNo,
+        operator: r.operator, expireTime: fmtTime(r.expireTime),
+        variable: r.variables, createTime: fmtTime(r.createTime), createUser: r.createUser,
+        updateTime: fmtTime(r.updateTime), updateUser: r.updateUser,
+        processDefineName: r.defineName, processDefineDisplayName: r.defineDisplayName,
+        processDefineVersion: r.defineVersion,
+        ext: r.variables, displayName: r.defineDisplayName, version: r.defineVersion,
+    };
+}
+/** 抄送行：ext（实例变量对象）+ displayName/version（定义） */
+function ccRowToMap(r) {
+    return {
+        id: r.id, parentId: r.parentId ?? null, processDefineId: r.defineId,
+        state: r.state, parentNodeName: r.parentNodeName, businessNo: r.businessNo,
+        operator: r.operator, expireTime: fmtTime(r.expireTime),
+        variable: r.variables, createTime: fmtTime(r.createTime), createUser: r.createUser,
+        updateTime: fmtTime(r.updateTime), updateUser: r.updateUser,
+        processDefineName: r.defineName, processDefineDisplayName: r.defineDisplayName,
+        processDefineVersion: r.defineVersion,
+        ext: r.variables, displayName: r.defineDisplayName, version: r.defineVersion,
+    };
+}
+/** 任务行：ext（任务变量，空回退实例变量）+ instanceExt + version */
+function taskRowToMap(r) {
+    const instanceExt = parseVarMap(r.instanceVariable);
+    const ext = Object.keys(r.variables ?? {}).length > 0 ? r.variables : instanceExt;
+    return {
+        id: r.id, processInstanceId: r.processInstanceId, taskName: r.taskName,
+        displayName: r.displayName, taskType: r.taskType, performType: r.performType,
+        taskState: r.taskState, operator: r.operator, finishTime: fmtTime(r.finishTime),
+        expireTime: fmtTime(r.expireTime), formKey: r.formKey, taskParentId: r.taskParentId ?? null,
+        variable: r.variables, createTime: fmtTime(r.createTime), createUser: r.createUser,
+        updateTime: fmtTime(r.updateTime), updateUser: r.updateUser,
+        processDefineName: r.processDefineName, processDefineDisplayName: r.processDefineDisplayName,
+        instanceVariable: r.instanceVariable, instanceCreateTime: fmtTime(r.instanceCreateTime),
+        ext, instanceExt, version: r.defineVersion,
+    };
 }
 // ── 工具 ──────────────────────────────────────────────────────────────────────
+/** m_ 前缀查询参数解析（issues/05-5，对齐 Java JeeflowQueryParser）：
+ *  m_EQ_taskName → t.task_name EQ；m_pd_LIKE_displayName → pd.display_name LIKE */
+function parseMQuery(args) {
+    const out = [];
+    for (const [key, value] of Object.entries(args)) {
+        if (!key.startsWith('m_') || value == null || value === '')
+            continue;
+        const parts = key.slice(2).split('_');
+        if (parts.length < 2)
+            continue;
+        let column;
+        let operator;
+        if (parts.length === 2) {
+            // 无别名 → 默认主表别名 t（对齐 Java，白名单列均带表别名）
+            operator = parts[0];
+            column = 't.' + toUnderscore(parts[1]);
+        }
+        else {
+            operator = parts[1];
+            column = parts[0] + '.' + toUnderscore(parts[2]);
+        }
+        out.push({ column, operator: operator.toUpperCase(), value });
+    }
+    return out;
+}
+function toUnderscore(camel) {
+    return camel.replace(/[A-Z]/g, c => '_' + c.toLowerCase());
+}
 function toStr(v) {
     if (v == null)
         return '';

package/dist/jdbc/ext.d.ts

@@ -1,5 +1,5 @@
 import { ProcessDesign, ProcessDesignHis, ProcessSurrogate } from '../model.js';
-import type { IDGenerator, ProcessExtRepository } from '../spi.js';
+import type { IDGenerator, ProcessExtRepository, QueryCondition } from '../spi.js';
 import { type SqlAdapter } from './shared.js';
 export declare class JdbcProcessExtRepository implements ProcessExtRepository {
     private readonly adapter;
@@ -13,7 +13,10 @@ export declare class JdbcProcessExtRepository implements ProcessExtRepository {
     saveDesign(d: ProcessDesign): Promise<void>;
     updateDesign(d: ProcessDesign): Promise<void>;
     removeDesign(id: number): Promise<void>;
-    pageDesigns(pageNum?: number, pageSize?: number, filters?: Record<string, any>): Promise<[ProcessDesign[], number]>;
+    pageDesigns(pageNum?: number, pageSize?: number, filters?: Record<string, any>, conditions?: QueryCondition[]): Promise<[ProcessDesign[], number]>;
+    private buildExtWhere;
+    private static readonly DESIGN_WHITELIST;
+    private static readonly SURROGATE_WHITELIST;
     saveDesignHis(his: ProcessDesignHis): Promise<void>;
     listDesignHis(designId: number): Promise<ProcessDesignHis[]>;
     private static SURROGATE_COLS;
@@ -21,7 +24,7 @@ export declare class JdbcProcessExtRepository implements ProcessExtRepository {
     saveSurrogate(s: ProcessSurrogate): Promise<void>;
     updateSurrogate(s: ProcessSurrogate): Promise<void>;
     removeSurrogate(id: number): Promise<void>;
-    pageSurrogates(pageNum?: number, pageSize?: number, filters?: Record<string, any>): Promise<[ProcessSurrogate[], number]>;
+    pageSurrogates(pageNum?: number, pageSize?: number, filters?: Record<string, any>, conditions?: QueryCondition[]): Promise<[ProcessSurrogate[], number]>;
     getSurrogate(operator: string, processName: string, at?: Date): Promise<ProcessSurrogate | null>;
     private querySurrogate;
     private mapDesign;

package/dist/jdbc/ext.js

@@ -76,7 +76,7 @@ export class JdbcProcessExtRepository {
             await this.done(conn);
         }
     }
-    async pageDesigns(pageNum = 1, pageSize = 10, filters) {
+    async pageDesigns(pageNum = 1, pageSize = 10, filters, conditions) {
         let sql = `SELECT ${JdbcProcessExtRepository.DESIGN_COLS} FROM wf_process_design t WHERE 1=1`;
         let countSql = 'SELECT COUNT(*) FROM wf_process_design t WHERE 1=1';
         const args = [];
@@ -89,6 +89,12 @@ export class JdbcProcessExtRepository {
                 args2.push(val);
             }
         }
+        // m_ 条件（issues/05-5）：LIKE/EQ 等走白名单
+        const cond = this.buildExtWhere(conditions ?? [], JdbcProcessExtRepository.DESIGN_WHITELIST);
+        sql += cond.sql;
+        countSql += cond.sql;
+        args.push(...cond.params);
+        args2.push(...cond.params);
         const conn = await this.c();
         try {
             const countRow = await conn.fetchOne(this.sql(countSql), args2);
@@ -102,6 +108,53 @@ export class JdbcProcessExtRepository {
             await this.done(conn);
         }
     }
+    // m_ 条件 WHERE 构建（issues/05-5，白名单 + 参数化）
+    buildExtWhere(conditions, whitelist) {
+        let sql = '';
+        const params = [];
+        for (const c of conditions) {
+            if (!whitelist.has(c.column))
+                continue;
+            const val = c.value;
+            if (val == null || val === '')
+                continue;
+            switch (c.operator.toUpperCase()) {
+                case 'EQ':
+                    sql += ` AND ${c.column} = ?`;
+                    params.push(val);
+                    break;
+                case 'LIKE':
+                    sql += ` AND ${c.column} LIKE ?`;
+                    params.push(`%${val}%`);
+                    break;
+                case 'LLIKE':
+                    sql += ` AND ${c.column} LIKE ?`;
+                    params.push(`%${val}`);
+                    break;
+                case 'RLIKE':
+                    sql += ` AND ${c.column} LIKE ?`;
+                    params.push(`${val}%`);
+                    break;
+                case 'IN': {
+                    if (Array.isArray(val) && val.length > 0) {
+                        const marks = val.map(() => '?').join(',');
+                        sql += ` AND ${c.column} IN (${marks})`;
+                        params.push(...val);
+                    }
+                    break;
+                }
+            }
+        }
+        return { sql, params };
+    }
+    static DESIGN_WHITELIST = new Set([
+        't.id', 't.name', 't.display_name', 't.type', 't.is_deployed', 't.remark',
+        't.create_time', 't.update_time',
+    ]);
+    static SURROGATE_WHITELIST = new Set([
+        't.id', 't.process_name', 't.operator', 't.surrogate', 't.enabled',
+        't.start_time', 't.end_time', 't.create_time', 't.update_time',
+    ]);
     // ── 设计历史 ─────────────────────────────────────────────────────────────
     async saveDesignHis(his) {
         if (!his.id)
@@ -182,7 +235,7 @@ export class JdbcProcessExtRepository {
             await this.done(conn);
         }
     }
-    async pageSurrogates(pageNum = 1, pageSize = 10, filters) {
+    async pageSurrogates(pageNum = 1, pageSize = 10, filters, conditions) {
         let sql = `SELECT ${JdbcProcessExtRepository.SURROGATE_COLS} FROM wf_process_surrogate t WHERE 1=1`;
         let countSql = 'SELECT COUNT(*) FROM wf_process_surrogate t WHERE 1=1';
         const args = [];
@@ -195,6 +248,12 @@ export class JdbcProcessExtRepository {
                 args2.push(val);
             }
         }
+        // m_ 条件（issues/05-5）
+        const cond = this.buildExtWhere(conditions ?? [], JdbcProcessExtRepository.SURROGATE_WHITELIST);
+        sql += cond.sql;
+        countSql += cond.sql;
+        args.push(...cond.params);
+        args2.push(...cond.params);
         const conn = await this.c();
         try {
             const countRow = await conn.fetchOne(this.sql(countSql), args2);

package/dist/jdbc/shared.d.ts

@@ -1,5 +1,5 @@
-import { ProcessInstance, ProcessTask, type ProcessDefine, type CcInstanceRow } from '../model.js';
-import type { IDGenerator, ProcessRepository } from '../spi.js';
+import { ProcessInstance, ProcessTask, type ProcessDefine, type CcInstanceRow, type DefineRow, type InstanceRow, type TaskRow } from '../model.js';
+import type { IDGenerator, ProcessRepository, QueryCondition } from '../spi.js';
 /** 默认 ID 生成器：时间戳毫秒 + 同毫秒递增序号（对齐 Java nextId 默认实现） */
 export declare class TsIDGenerator implements IDGenerator {
     private last;
@@ -63,7 +63,30 @@ export declare class JdbcRepository implements ProcessRepository {
     removeTaskActor(taskId: number, actors: string[]): Promise<void>;
     createCcInstance(instanceId: number, creator: string, ...actorIds: string[]): Promise<void>;
     updateCcStatus(instanceId: number, actorId: string): Promise<void>;
-    pageCcInstances(pageNum: number, pageSize: number, actorId: string): Promise<{
+    pageDefines(pageNum: number, pageSize: number, conditions?: QueryCondition[]): Promise<{
+        rows: DefineRow[];
+        total: number;
+    }>;
+    pageInstances(pageNum: number, pageSize: number, operator: string, conditions?: QueryCondition[]): Promise<{
+        rows: InstanceRow[];
+        total: number;
+    }>;
+    pageTodoTasks(pageNum: number, pageSize: number, actorId: string, conditions?: QueryCondition[]): Promise<{
+        rows: TaskRow[];
+        total: number;
+    }>;
+    pageDoneTasks(pageNum: number, pageSize: number, operator: string, conditions?: QueryCondition[]): Promise<{
+        rows: TaskRow[];
+        total: number;
+    }>;
+    private pageTasks;
+    private mapInstanceRow;
+    protected buildWhere(conditions: QueryCondition[], whitelist: Set<string>): {
+        sql: string;
+        params: any[];
+    };
+    private mapTaskRow;
+    pageCcInstances(pageNum: number, pageSize: number, actorId: string, conditions?: QueryCondition[]): Promise<{
         rows: CcInstanceRow[];
         total: number;
     }>;

package/dist/jdbc/shared.js

@@ -11,6 +11,30 @@
 import { AsyncLocalStorage } from 'node:async_hooks';
 import { ProcessInstance, ProcessTask } from '../model.js';
 import { TaskState } from '../model.js';
+// ═══ 列白名单（issues/05-5，与 mldong-boot2 别名一致） ═══
+const TASK_WHITELIST = new Set([
+    't.id', 't.task_name', 't.display_name', 't.task_type', 't.perform_type', 't.task_state',
+    't.operator', 't.form_key', 't.create_time', 't.finish_time', 't.expire_time',
+    't.process_instance_id', 't.task_parent_id', 't.variable',
+    'pi.id', 'pi.business_no', 'pi.operator', 'pi.create_time', 'pi.state',
+    'pd.name', 'pd.display_name', 'pd.type',
+    'pta.actor_id', 'pta.process_task_id',
+]);
+const INSTANCE_WHITELIST = new Set([
+    't.id', 't.parent_id', 't.process_define_id', 't.state', 't.business_no',
+    't.operator', 't.create_time', 't.expire_time', 't.variable',
+    'pd.name', 'pd.display_name', 'pd.type', 'pd.version',
+]);
+const CC_WHITELIST = new Set([
+    't.id', 't.process_define_id', 't.state', 't.business_no', 't.operator',
+    't.create_time', 't.variable',
+    'pd.name', 'pd.display_name', 'pd.type', 'pd.version',
+    'cc.actor_id', 'cc.state',
+]);
+const DEFINE_WHITELIST = new Set([
+    't.id', 't.name', 't.display_name', 't.type', 't.state', 't.version',
+    't.create_time', 't.update_time',
+]);
 // 当前异步上下文绑定的事务连接
 const txStore = new AsyncLocalStorage();
 /** 默认 ID 生成器：时间戳毫秒 + 同毫秒递增序号（对齐 Java nextId 默认实现） */
@@ -399,20 +423,193 @@ export class JdbcRepository {
             await this.done(conn);
         }
     }
+    // ── 核心表分页（v1.5.0，对齐 Java pageDefines/pageInstances/pageTodoTasks/pageDoneTasks）──
+    async pageDefines(pageNum, pageSize, conditions) {
+        const cond = this.buildWhere(conditions ?? [], DEFINE_WHITELIST);
+        const where = ' FROM wf_process_define t WHERE 1=1' + cond.sql;
+        const conn = await this.c();
+        try {
+            const countRow = await conn.fetchOne(this.sql('SELECT COUNT(*) ' + where), cond.params);
+            const total = Number(Object.values(countRow)[0] ?? 0);
+            const rows = await conn.fetchAll(this.sql('SELECT id, name, display_name, type, state, version, create_time, create_user, update_time, update_user' +
+                where + ' ORDER BY t.id DESC LIMIT ? OFFSET ?'), [...cond.params, pageSize, (pageNum - 1) * pageSize]);
+            return {
+                rows: rows.map(r => ({
+                    id: Number(r.id), name: r.name, displayName: r.display_name, type: r.type,
+                    state: Number(r.state), version: Number(r.version),
+                    createTime: r.create_time, createUser: r.create_user ?? '',
+                    updateTime: r.update_time, updateUser: r.update_user ?? '',
+                })),
+                total,
+            };
+        }
+        finally {
+            await this.done(conn);
+        }
+    }
+    async pageInstances(pageNum, pageSize, operator, conditions) {
+        const cond = this.buildWhere(conditions ?? [], INSTANCE_WHITELIST);
+        const where = ' FROM wf_process_instance t' +
+            ' LEFT JOIN wf_process_define pd ON t.process_define_id = pd.id' +
+            ' WHERE t.operator = ?' + cond.sql;
+        const conn = await this.c();
+        try {
+            const countRow = await conn.fetchOne(this.sql('SELECT COUNT(*) ' + where), [operator, ...cond.params]);
+            const total = Number(Object.values(countRow)[0] ?? 0);
+            const cols = 't.id, t.parent_id, t.process_define_id, t.state, t.parent_node_name, t.business_no,' +
+                ' t.operator, t.expire_time, t.variable, t.create_time, t.create_user, t.update_time, t.update_user,' +
+                ' pd.name, pd.display_name, pd.version';
+            const rows = await conn.fetchAll(this.sql(`SELECT ${cols}${where} ORDER BY t.id DESC LIMIT ? OFFSET ?`), [operator, ...cond.params, pageSize, (pageNum - 1) * pageSize]);
+            return { rows: rows.map(r => this.mapInstanceRow(r)), total };
+        }
+        finally {
+            await this.done(conn);
+        }
+    }
+    async pageTodoTasks(pageNum, pageSize, actorId, conditions) {
+        return this.pageTasks(pageNum, pageSize, false, actorId, conditions);
+    }
+    async pageDoneTasks(pageNum, pageSize, operator, conditions) {
+        return this.pageTasks(pageNum, pageSize, true, operator, conditions);
+    }
+    async pageTasks(pageNum, pageSize, done, filter, conditions) {
+        const cond = this.buildWhere(conditions ?? [], TASK_WHITELIST);
+        const where = ' FROM wf_process_task t' +
+            ' LEFT JOIN wf_process_instance pi ON t.process_instance_id = pi.id' +
+            ' LEFT JOIN wf_process_define pd ON pi.process_define_id = pd.id' +
+            ' LEFT JOIN wf_process_task_actor pta ON t.id = pta.process_task_id' +
+            (done ? ' WHERE t.task_state <> 10 AND t.operator = ?' : ' WHERE t.task_state = 10 AND pta.actor_id = ?') + cond.sql;
+        const conn = await this.c();
+        try {
+            const countRow = await conn.fetchOne(this.sql('SELECT COUNT(DISTINCT t.id) ' + where), [filter, ...cond.params]);
+            const total = Number(Object.values(countRow)[0] ?? 0);
+            const cols = 'DISTINCT t.id, t.process_instance_id, t.task_name, t.display_name, t.task_type, t.perform_type,' +
+                ' t.task_state, t.operator, t.finish_time, t.expire_time, t.form_key, t.task_parent_id, t.variable,' +
+                ' t.create_time, t.create_user, t.update_time, t.update_user,' +
+                ' pd.name, pd.display_name, pd.version AS process_define_version,' +
+                ' pi.variable AS instance_variable, pi.create_time AS instance_create_time';
+            const rows = await conn.fetchAll(this.sql(`SELECT ${cols}${where} ORDER BY t.id DESC LIMIT ? OFFSET ?`), [filter, ...cond.params, pageSize, (pageNum - 1) * pageSize]);
+            return { rows: rows.map(r => this.mapTaskRow(r)), total };
+        }
+        finally {
+            await this.done(conn);
+        }
+    }
+    mapInstanceRow(r) {
+        let variables = {};
+        if (r.variable) {
+            try {
+                variables = JSON.parse(r.variable);
+            }
+            catch { /* 忽略坏 JSON */ }
+        }
+        return {
+            id: Number(r.id), parentId: r.parent_id != null ? Number(r.parent_id) : undefined,
+            defineId: Number(r.process_define_id), state: r.state,
+            parentNodeName: r.parent_node_name ?? '', businessNo: r.business_no ?? '', operator: r.operator ?? '',
+            expireTime: r.expire_time ?? undefined, variables,
+            createTime: r.create_time, createUser: r.create_user ?? '',
+            updateTime: r.update_time, updateUser: r.update_user ?? '',
+            defineName: r.name ?? '', defineDisplayName: r.display_name ?? '',
+            defineVersion: Number(r.version ?? 0),
+        };
+    }
+    // ═══ m_ 条件 WHERE 构建（issues/05-5，白名单 + 参数化，对齐 Java buildWhere） ═══
+    buildWhere(conditions, whitelist) {
+        let sql = '';
+        const params = [];
+        for (const c of conditions) {
+            if (!whitelist.has(c.column))
+                continue; // 不在白名单，丢弃
+            const val = c.value;
+            if (val == null || val === '')
+                continue;
+            switch (c.operator.toUpperCase()) {
+                case 'EQ':
+                    sql += ` AND ${c.column} = ?`;
+                    params.push(val);
+                    break;
+                case 'NE':
+                    sql += ` AND ${c.column} <> ?`;
+                    params.push(val);
+                    break;
+                case 'LIKE':
+                    sql += ` AND ${c.column} LIKE ?`;
+                    params.push(`%${val}%`);
+                    break;
+                case 'LLIKE':
+                    sql += ` AND ${c.column} LIKE ?`;
+                    params.push(`%${val}`);
+                    break;
+                case 'RLIKE':
+                    sql += ` AND ${c.column} LIKE ?`;
+                    params.push(`${val}%`);
+                    break;
+                case 'GT':
+                    sql += ` AND ${c.column} > ?`;
+                    params.push(val);
+                    break;
+                case 'GE':
+                    sql += ` AND ${c.column} >= ?`;
+                    params.push(val);
+                    break;
+                case 'LT':
+                    sql += ` AND ${c.column} < ?`;
+                    params.push(val);
+                    break;
+                case 'LE':
+                    sql += ` AND ${c.column} <= ?`;
+                    params.push(val);
+                    break;
+                case 'IN':
+                case 'NIN': {
+                    if (Array.isArray(val) && val.length > 0) {
+                        const marks = val.map(() => '?').join(',');
+                        sql += ` AND ${c.column} ${c.operator.toUpperCase() === 'IN' ? 'IN' : 'NOT IN'} (${marks})`;
+                        params.push(...val);
+                    }
+                    break;
+                }
+            }
+        }
+        return { sql, params };
+    }
+    mapTaskRow(r) {
+        let variables = {};
+        if (r.variable) {
+            try {
+                variables = JSON.parse(r.variable);
+            }
+            catch { /* 忽略坏 JSON */ }
+        }
+        return {
+            id: Number(r.id), processInstanceId: Number(r.process_instance_id), taskName: r.task_name,
+            displayName: r.display_name, taskType: Number(r.task_type), performType: Number(r.perform_type),
+            taskState: r.task_state, operator: r.operator ?? '', finishTime: r.finish_time ?? undefined,
+            expireTime: r.expire_time ?? undefined, formKey: r.form_key ?? '',
+            taskParentId: r.task_parent_id != null ? Number(r.task_parent_id) : undefined,
+            variables, createTime: r.create_time, createUser: r.create_user ?? '',
+            updateTime: r.update_time, updateUser: r.update_user ?? '',
+            processDefineName: r.name ?? '', processDefineDisplayName: r.display_name ?? '',
+            defineVersion: Number(r.process_define_version ?? 0),
+            instanceVariable: r.instance_variable ?? '', instanceCreateTime: r.instance_create_time,
+        };
+    }
     // pageCcInstances 我的抄送分页（v1.3.0）：cc 表 join 实例 + 定义，按抄送人过滤（对齐 Java pageCcInstances）
-    async pageCcInstances(pageNum, pageSize, actorId) {
+    async pageCcInstances(pageNum, pageSize, actorId, conditions) {
+        const cond = this.buildWhere(conditions ?? [], CC_WHITELIST);
         const where = ' FROM wf_process_instance t' +
             ' LEFT JOIN wf_process_define pd ON t.process_define_id = pd.id' +
             ' LEFT JOIN wf_process_cc_instance cc ON t.id = cc.process_instance_id' +
-            ' WHERE cc.actor_id = ?';
+            ' WHERE cc.actor_id = ?' + cond.sql;
         const cols = 't.id, t.parent_id, t.process_define_id, t.state, t.parent_node_name, t.business_no,' +
             ' t.operator, t.expire_time, t.variable, t.create_time, t.create_user, t.update_time, t.update_user,' +
             ' pd.name, pd.display_name, pd.version';
         const conn = await this.c();
         try {
-            const countRow = await conn.fetchOne(this.sql('SELECT COUNT(*) ' + where), [actorId]);
+            const countRow = await conn.fetchOne(this.sql('SELECT COUNT(*) ' + where), [actorId, ...cond.params]);
             const total = Number(Object.values(countRow)[0] ?? 0);
-            const rows = await conn.fetchAll(this.sql(`SELECT ${cols}${where} ORDER BY t.id ASC LIMIT ? OFFSET ?`), [actorId, pageSize, (pageNum - 1) * pageSize]);
+            const rows = await conn.fetchAll(this.sql(`SELECT ${cols}${where} ORDER BY t.id ASC LIMIT ? OFFSET ?`), [actorId, ...cond.params, pageSize, (pageNum - 1) * pageSize]);
             return {
                 rows: rows.map(r => this.mapCcRow(r)),
                 total,

package/dist/memory-ext.d.ts

@@ -1,5 +1,5 @@
 import { ProcessDesign, ProcessDesignHis, ProcessSurrogate } from './model.js';
-import type { ProcessExtRepository } from './spi.js';
+import type { ProcessExtRepository, QueryCondition } from './spi.js';
 export declare class MemoryExtRepository implements ProcessExtRepository {
     private designs;
     private designHis;
@@ -9,13 +9,13 @@ export declare class MemoryExtRepository implements ProcessExtRepository {
     saveDesign(d: ProcessDesign): Promise<void>;
     updateDesign(d: ProcessDesign): Promise<void>;
     removeDesign(id: number): Promise<void>;
-    pageDesigns(_pageNum?: number, _pageSize?: number, _filters?: Record<string, any>): Promise<[ProcessDesign[], number]>;
+    pageDesigns(_pageNum?: number, _pageSize?: number, _filters?: Record<string, any>, conditions?: QueryCondition[]): Promise<[ProcessDesign[], number]>;
     saveDesignHis(his: ProcessDesignHis): Promise<void>;
     listDesignHis(designId: number): Promise<ProcessDesignHis[]>;
     findSurrogateById(id: number): Promise<ProcessSurrogate | null>;
     saveSurrogate(s: ProcessSurrogate): Promise<void>;
     updateSurrogate(s: ProcessSurrogate): Promise<void>;
     removeSurrogate(id: number): Promise<void>;
-    pageSurrogates(_pageNum?: number, _pageSize?: number, _filters?: Record<string, any>): Promise<[ProcessSurrogate[], number]>;
+    pageSurrogates(_pageNum?: number, _pageSize?: number, filters?: Record<string, any>, conditions?: QueryCondition[]): Promise<[ProcessSurrogate[], number]>;
     getSurrogate(operator: string, processName: string, at?: Date): Promise<ProcessSurrogate | null>;
 }

package/dist/memory-ext.js

@@ -1,4 +1,24 @@
 // 扩展仓储内存实现（v1.1.0，测试/演示用）
+import { matchConditions } from './memory.js';
+// ═══ 条件匹配基建（issues/05-5） ═══
+const DESIGN_FIELDS = {
+    't.id': 'id', 't.name': 'name', 't.display_name': 'displayName', 't.type': 'type',
+    't.is_deployed': 'isDeployed', 't.remark': 'remark',
+    't.create_time': 'createTime', 't.update_time': 'updateTime',
+};
+const SURROGATE_FIELDS = {
+    't.id': 'id', 't.process_name': 'processName', 't.operator': 'operator',
+    't.surrogate': 'surrogate', 't.enabled': 'enabled',
+    't.start_time': 'startTime', 't.end_time': 'endTime',
+    't.create_time': 'createTime', 't.update_time': 'updateTime',
+};
+function pickFields(row, map) {
+    const fields = {};
+    for (const [col, key] of Object.entries(map)) {
+        fields[col] = row[key];
+    }
+    return fields;
+}
 export class MemoryExtRepository {
     designs = new Map();
     designHis = new Map();
@@ -24,8 +44,9 @@ export class MemoryExtRepository {
         this.designs.delete(id);
         this.designHis.delete(id);
     }
-    async pageDesigns(_pageNum = 1, _pageSize = 10, _filters) {
-        return [[...this.designs.values()], this.designs.size];
+    async pageDesigns(_pageNum = 1, _pageSize = 10, _filters, conditions) {
+        const rows = [...this.designs.values()].filter(d => matchConditions(conditions, pickFields(d, DESIGN_FIELDS)));
+        return [rows, rows.length];
     }
     // ── 设计历史 ──
     async saveDesignHis(his) {
@@ -61,8 +82,18 @@ export class MemoryExtRepository {
     async removeSurrogate(id) {
         this.surrogates.delete(id);
     }
-    async pageSurrogates(_pageNum = 1, _pageSize = 10, _filters) {
-        return [[...this.surrogates.values()], this.surrogates.size];
+    async pageSurrogates(_pageNum = 1, _pageSize = 10, filters, conditions) {
+        const rows = [...this.surrogates.values()].filter(s => {
+            for (const [col, val] of Object.entries(filters ?? {})) {
+                if (val == null || val === '')
+                    continue;
+                const k = col === 'process_name' ? 'processName' : col;
+                if (String(s[k]) !== String(val))
+                    return false;
+            }
+            return matchConditions(conditions, pickFields(s, SURROGATE_FIELDS));
+        });
+        return [rows, rows.length];
     }
     async getSurrogate(operator, processName, at = new Date()) {
         let fallback = null;

package/dist/memory.d.ts

@@ -1,6 +1,10 @@
-import type { CcInstanceRow, ProcessDefine } from './model.js';
+import type { CcInstanceRow, DefineRow, InstanceRow, TaskRow, ProcessDefine } from './model.js';
 import { type ProcessInstance, type ProcessTask } from './model.js';
-import type { ProcessRepository } from './spi.js';
+import type { ProcessRepository, QueryCondition } from './spi.js';
+/** 条件全匹配（操作符对齐 JDBC buildWhere；列不在字段中则跳过） */
+export declare function matchConditions(conditions: QueryCondition[] | undefined, fields: Record<string, any>): boolean;
+/** EQ：值或集合包含判断（pta.actor_id/cc.actor_id 为数组） */
+export declare function eqValue(v: any, expect: any): boolean;
 export declare class MemoryRepository implements ProcessRepository {
     private defines;
     private instances;
@@ -29,7 +33,24 @@ export declare class MemoryRepository implements ProcessRepository {
     removeTaskActor(taskId: number, actors: string[]): Promise<void>;
     createCcInstance(instanceId: number, _creator: string, ...actorIds: string[]): Promise<void>;
     updateCcStatus(_instanceId: number, _actorId: string): Promise<void>;
-    pageCcInstances(pageNum: number | undefined, pageSize: number | undefined, actorId: string): Promise<{
+    pageDefines(pageNum?: number, pageSize?: number, conditions?: QueryCondition[]): Promise<{
+        rows: DefineRow[];
+        total: number;
+    }>;
+    pageInstances(pageNum: number | undefined, pageSize: number | undefined, operator: string, conditions?: QueryCondition[]): Promise<{
+        rows: InstanceRow[];
+        total: number;
+    }>;
+    pageTodoTasks(pageNum: number | undefined, pageSize: number | undefined, actorId: string, conditions?: QueryCondition[]): Promise<{
+        rows: TaskRow[];
+        total: number;
+    }>;
+    pageDoneTasks(pageNum: number | undefined, pageSize: number | undefined, operator: string, conditions?: QueryCondition[]): Promise<{
+        rows: TaskRow[];
+        total: number;
+    }>;
+    private taskRow;
+    pageCcInstances(pageNum: number | undefined, pageSize: number | undefined, actorId: string, conditions?: QueryCondition[]): Promise<{
         rows: CcInstanceRow[];
         total: number;
     }>;

package/dist/memory.js

@@ -1,4 +1,97 @@
+import { TaskState } from './model.js';
 import { cloneInstance, cloneTask } from './model.js';
+// ═══ 条件匹配基建（issues/05-5，对齐 JDBC 白名单语义） ═══
+// 行字段映射（列名 → 行属性，白名单列均可匹配）
+const TASK_FIELDS = {
+    't.id': 'id', 't.task_name': 'taskName', 't.display_name': 'displayName',
+    't.task_type': 'taskType', 't.perform_type': 'performType', 't.task_state': 'taskState',
+    't.operator': 'operator', 't.form_key': 'formKey', 't.create_time': 'createTime',
+    't.finish_time': 'finishTime', 't.expire_time': 'expireTime',
+    't.process_instance_id': 'processInstanceId', 't.task_parent_id': 'taskParentId',
+    'pd.name': 'processDefineName', 'pd.display_name': 'processDefineDisplayName',
+    'pd.version': 'defineVersion',
+};
+const INSTANCE_FIELDS = {
+    't.id': 'id', 't.parent_id': 'parentId', 't.process_define_id': 'defineId',
+    't.state': 'state', 't.parent_node_name': 'parentNodeName', 't.business_no': 'businessNo',
+    't.operator': 'operator', 't.expire_time': 'expireTime', 't.create_time': 'createTime',
+    'pd.name': 'defineName', 'pd.display_name': 'defineDisplayName', 'pd.version': 'defineVersion',
+};
+const DEFINE_FIELDS = {
+    't.id': 'id', 't.name': 'name', 't.display_name': 'displayName', 't.type': 'type',
+    't.state': 'state', 't.version': 'version', 't.create_time': 'createTime',
+    't.update_time': 'updateTime',
+};
+/** 行字段提取（列名 → 值） */
+function pickFields(row, map) {
+    const fields = {};
+    for (const [col, key] of Object.entries(map)) {
+        fields[col] = row[key];
+    }
+    return fields;
+}
+/** 条件全匹配（操作符对齐 JDBC buildWhere；列不在字段中则跳过） */
+export function matchConditions(conditions, fields) {
+    for (const c of conditions ?? []) {
+        const v = fields[c.column];
+        const expect = c.value;
+        if (v == null || expect == null)
+            continue;
+        switch (c.operator.toUpperCase()) {
+            case 'EQ':
+                if (!eqValue(v, expect))
+                    return false;
+                break;
+            case 'NE':
+                if (eqValue(v, expect))
+                    return false;
+                break;
+            case 'LIKE':
+                if (!String(v).includes(String(expect)))
+                    return false;
+                break;
+            case 'LLIKE':
+                if (!String(v).endsWith(String(expect)))
+                    return false;
+                break;
+            case 'RLIKE':
+                if (!String(v).startsWith(String(expect)))
+                    return false;
+                break;
+            case 'GT':
+                if (Number(v) <= Number(expect))
+                    return false;
+                break;
+            case 'GE':
+                if (Number(v) < Number(expect))
+                    return false;
+                break;
+            case 'LT':
+                if (Number(v) >= Number(expect))
+                    return false;
+                break;
+            case 'LE':
+                if (Number(v) > Number(expect))
+                    return false;
+                break;
+            case 'IN':
+                if (!Array.isArray(expect) || !expect.includes(v))
+                    return false;
+                break;
+            case 'NIN':
+                if (Array.isArray(expect) && expect.includes(v))
+                    return false;
+                break;
+        }
+    }
+    return true;
+}
+/** EQ：值或集合包含判断（pta.actor_id/cc.actor_id 为数组） */
+export function eqValue(v, expect) {
+    if (Array.isArray(v))
+        return v.includes(expect);
+    return String(v) === String(expect);
+}
 export class MemoryRepository {
     defines = new Map();
     instances = new Map();
@@ -162,8 +255,90 @@ export class MemoryRepository {
         this.ccInstances.set(instanceId, existing);
     }
     async updateCcStatus(_instanceId, _actorId) { }
+    // ── 核心表分页（v1.5.0）──
+    async pageDefines(pageNum = 1, pageSize = 10, conditions) {
+        const rows = [...this.defines.values()].map(d => ({
+            id: d.id, name: d.name, displayName: d.displayName, type: d.type,
+            state: d.state, version: d.version,
+            createTime: d.createTime, createUser: d.createUser,
+            updateTime: d.updateTime, updateUser: d.updateUser,
+        })).filter(r => matchConditions(conditions, pickFields(r, DEFINE_FIELDS)));
+        const total = rows.length;
+        const start = (pageNum - 1) * pageSize;
+        return { rows: rows.slice(start, start + pageSize), total };
+    }
+    async pageInstances(pageNum = 1, pageSize = 10, operator, conditions) {
+        const rows = [];
+        for (const inst of this.instances.values()) {
+            if (operator && inst.operator !== operator)
+                continue;
+            const def = this.defines.get(inst.defineId);
+            const r = {
+                id: inst.id, parentId: inst.parentId, defineId: inst.defineId, state: inst.state,
+                parentNodeName: inst.parentNodeName, businessNo: inst.businessNo, operator: inst.operator,
+                expireTime: inst.expireTime, variables: { ...inst.variables },
+                createTime: inst.createTime, createUser: inst.createUser,
+                updateTime: inst.updateTime, updateUser: inst.updateUser,
+                defineName: def?.name ?? '', defineDisplayName: def?.displayName ?? '',
+                defineVersion: def?.version ?? 0,
+            };
+            if (matchConditions(conditions, pickFields(r, INSTANCE_FIELDS)))
+                rows.push(r);
+        }
+        const total = rows.length;
+        const start = (pageNum - 1) * pageSize;
+        return { rows: rows.slice(start, start + pageSize), total };
+    }
+    async pageTodoTasks(pageNum = 1, pageSize = 10, actorId, conditions) {
+        const rows = [];
+        for (const t of this.tasks.values()) {
+            if (t.taskState !== TaskState.Doing)
+                continue;
+            if (actorId && !(this.actors.get(t.id) ?? []).includes(actorId))
+                continue;
+            const r = this.taskRow(t);
+            const fields = pickFields(r, TASK_FIELDS);
+            fields['pta.actor_id'] = this.actors.get(t.id) ?? [];
+            if (matchConditions(conditions, fields))
+                rows.push(r);
+        }
+        const total = rows.length;
+        const start = (pageNum - 1) * pageSize;
+        return { rows: rows.slice(start, start + pageSize), total };
+    }
+    async pageDoneTasks(pageNum = 1, pageSize = 10, operator, conditions) {
+        const rows = [];
+        for (const t of this.tasks.values()) {
+            if (t.taskState === TaskState.Doing)
+                continue;
+            if (operator && t.actorId !== operator)
+                continue;
+            const r = this.taskRow(t);
+            if (matchConditions(conditions, pickFields(r, TASK_FIELDS)))
+                rows.push(r);
+        }
+        const total = rows.length;
+        const start = (pageNum - 1) * pageSize;
+        return { rows: rows.slice(start, start + pageSize), total };
+    }
+    taskRow(t) {
+        const inst = this.instances.get(t.processInstanceId);
+        const def = inst ? this.defines.get(inst.defineId) : undefined;
+        return {
+            id: t.id, processInstanceId: t.processInstanceId, taskName: t.taskName,
+            displayName: t.displayName, taskType: t.taskType, performType: t.performType,
+            taskState: t.taskState, operator: t.actorId ?? '', finishTime: t.finishTime,
+            expireTime: t.expireTime, formKey: t.formKey ?? '', taskParentId: t.parentTaskId,
+            variables: { ...t.variables }, createTime: t.createTime, createUser: t.createUser,
+            updateTime: t.updateTime, updateUser: t.updateUser,
+            processDefineName: def?.name ?? '', processDefineDisplayName: def?.displayName ?? '',
+            defineVersion: def?.version ?? 0,
+            instanceVariable: inst ? JSON.stringify(inst.variables ?? {}) : '',
+            instanceCreateTime: inst?.createTime ?? t.createTime,
+        };
+    }
     // pageCcInstances 我的抄送分页（v1.3.0）：按抄送人 actorId 过滤，join 实例 + 定义
-    async pageCcInstances(pageNum = 1, pageSize = 10, actorId) {
+    async pageCcInstances(pageNum = 1, pageSize = 10, actorId, conditions) {
         const rows = [];
         for (const [instId, actors] of this.ccInstances) {
             if (actorId && !actors.includes(actorId))
@@ -172,7 +347,7 @@ export class MemoryRepository {
             if (!inst)
                 continue;
             const def = this.defines.get(inst.defineId);
-            rows.push({
+            const r = {
                 id: inst.id, parentId: inst.parentId, defineId: inst.defineId, state: inst.state,
                 parentNodeName: inst.parentNodeName, businessNo: inst.businessNo, operator: inst.operator,
                 expireTime: inst.expireTime, variables: { ...inst.variables },
@@ -180,7 +355,11 @@ export class MemoryRepository {
                 updateTime: inst.updateTime, updateUser: inst.updateUser,
                 defineName: def?.name ?? '', defineDisplayName: def?.displayName ?? '',
                 defineVersion: def?.version ?? 0,
-            });
+            };
+            const fields = pickFields(r, INSTANCE_FIELDS);
+            fields['cc.actor_id'] = actors;
+            if (matchConditions(conditions, fields))
+                rows.push(r);
         }
         const total = rows.length;
         const start = (pageNum - 1) * pageSize;

package/dist/model.d.ts

@@ -225,3 +225,57 @@ export interface CcInstanceRow {
     defineDisplayName: string;
     defineVersion: number;
 }
+export interface DefineRow {
+    id: number;
+    name: string;
+    displayName: string;
+    type: string;
+    state: number;
+    version: number;
+    createTime: Date;
+    createUser: string;
+    updateTime: Date;
+    updateUser: string;
+}
+export interface InstanceRow {
+    id: number;
+    parentId?: number;
+    defineId: number;
+    state: InstanceState;
+    parentNodeName: string;
+    businessNo: string;
+    operator: string;
+    expireTime?: Date;
+    variables: Record<string, any>;
+    createTime: Date;
+    createUser: string;
+    updateTime: Date;
+    updateUser: string;
+    defineName: string;
+    defineDisplayName: string;
+    defineVersion: number;
+}
+export interface TaskRow {
+    id: number;
+    processInstanceId: number;
+    taskName: string;
+    displayName: string;
+    taskType: number;
+    performType: number;
+    taskState: TaskState;
+    operator: string;
+    finishTime?: Date;
+    expireTime?: Date;
+    formKey: string;
+    taskParentId?: number;
+    variables: Record<string, any>;
+    createTime: Date;
+    createUser: string;
+    updateTime: Date;
+    updateUser: string;
+    processDefineName: string;
+    processDefineDisplayName: string;
+    defineVersion: number;
+    instanceVariable: string;
+    instanceCreateTime: Date;
+}

package/dist/spi.d.ts

@@ -1,4 +1,9 @@
-import type { CcInstanceRow, ProcessDefine, ProcessDesign, ProcessDesignHis, ProcessInstance, ProcessSurrogate, ProcessTask, UserInfo } from './model.js';
+import type { CcInstanceRow, DefineRow, InstanceRow, TaskRow, ProcessDefine, ProcessDesign, ProcessDesignHis, ProcessInstance, ProcessSurrogate, ProcessTask, UserInfo } from './model.js';
+export interface QueryCondition {
+    column: string;
+    operator: string;
+    value: any;
+}
 export interface ProcessRepository {
     findDefineById(id: number): Promise<ProcessDefine | null>;
     findDefineByName(name: string): Promise<ProcessDefine | null>;
@@ -20,10 +25,26 @@ export interface ProcessRepository {
     removeTaskActor(taskId: number, actors: string[]): Promise<void>;
     createCcInstance(instanceId: number, creator: string, ...actorIds: string[]): Promise<void>;
     updateCcStatus(instanceId: number, actorId: string): Promise<void>;
-    pageCcInstances(pageNum: number, pageSize: number, actorId: string): Promise<{
+    pageCcInstances(pageNum: number, pageSize: number, actorId: string, conditions?: QueryCondition[]): Promise<{
         rows: CcInstanceRow[];
         total: number;
     }>;
+    pageDefines(pageNum: number, pageSize: number, conditions?: QueryCondition[]): Promise<{
+        rows: DefineRow[];
+        total: number;
+    }>;
+    pageInstances(pageNum: number, pageSize: number, operator: string, conditions?: QueryCondition[]): Promise<{
+        rows: InstanceRow[];
+        total: number;
+    }>;
+    pageTodoTasks(pageNum: number, pageSize: number, actorId: string, conditions?: QueryCondition[]): Promise<{
+        rows: TaskRow[];
+        total: number;
+    }>;
+    pageDoneTasks(pageNum: number, pageSize: number, operator: string, conditions?: QueryCondition[]): Promise<{
+        rows: TaskRow[];
+        total: number;
+    }>;
 }
 export interface UserProvider {
     getUser(userId: string): Promise<UserInfo | null>;
@@ -39,13 +60,13 @@ export interface ProcessExtRepository {
     saveDesign(d: ProcessDesign): Promise<void>;
     updateDesign(d: ProcessDesign): Promise<void>;
     removeDesign(id: number): Promise<void>;
-    pageDesigns(pageNum?: number, pageSize?: number, filters?: Record<string, any>): Promise<[ProcessDesign[], number]>;
+    pageDesigns(pageNum?: number, pageSize?: number, filters?: Record<string, any>, conditions?: QueryCondition[]): Promise<[ProcessDesign[], number]>;
     saveDesignHis(his: ProcessDesignHis): Promise<void>;
     listDesignHis(designId: number): Promise<ProcessDesignHis[]>;
     findSurrogateById(id: number): Promise<ProcessSurrogate | null>;
     saveSurrogate(s: ProcessSurrogate): Promise<void>;
     updateSurrogate(s: ProcessSurrogate): Promise<void>;
     removeSurrogate(id: number): Promise<void>;
-    pageSurrogates(pageNum?: number, pageSize?: number, filters?: Record<string, any>): Promise<[ProcessSurrogate[], number]>;
+    pageSurrogates(pageNum?: number, pageSize?: number, filters?: Record<string, any>, conditions?: QueryCondition[]): Promise<[ProcessSurrogate[], number]>;
     getSurrogate(operator: string, processName: string, at?: Date): Promise<ProcessSurrogate | null>;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mldong/jeeflow",
-  "version": "1.4.0",
+  "version": "1.5.0",
   "description": "jeeflow workflow engine — Node.js / TypeScript implementation",
   "type": "module",
   "main": "./dist/index.js",
@@ -29,7 +29,9 @@
   ],
   "license": "Apache-2.0",
   "devDependencies": {
+    "@types/express": "^4.17.25",
     "@types/pg": "^8.20.3",
+    "express": "^4.22.2",
     "tsx": "^4.19.0",
     "typescript": "^5.5.0"
   },