jeeflow docs

Appearance

Go 更新日志 ​

当前版本 v1.8.27 · Go proxy（github.com/mldong/jeeflow-go）· 仓库 mldong/jeeflow-go · Releases 版本日期以本仓 git tag 为准；跨语言对齐脉络见 更新记录总览。

1.0.0–1.8.4 为四语言同构对齐期（Java / Go / Python / Node 同号演进）；1.8.5 起按语言节奏发版，版本号不必同号（Go 全序列无跳号）。

v1.8.27 — 2026-09-09 ​

  • 修复 五语言 SQL 仓聚合水合：FindInstanceByID 此前只查 wf_process_instance 单表，inst.Tasks 为零值，门面 processInstance/detail 的 tasks/activeTaskList 恒空（gate26 L2-12 门禁真根因，非会签语义）。二次查 wf_process_task（复用 FindHistoryTasks：ORDER BY id ASC + 批查 ActorIDs，同连接/事务内 ctx 复用）水合任务副本，语义对齐 Java findTasksByInstanceId / PHP PdoProcessRepository / C# FindTasksInternalAsync（聚合水合口径）。updateTaskWithConn 按 task.id 幂等 UPDATE（无 INSERT / 不改 actor），水合后 withdraw 回写与 Java 同构。memory 仓本就水合（基线正确，未动）；引擎核心会签语义未动。
  • 测试 T0 新增 TestFindInstanceByIDHydratesTasks（engine 发起 → 水合非空 + ActorIDs + detail 非空）；全测试包绿（demo 包 go vet 存量报错已 stash 证伪，与本改动无关）。
  • 集成栈 mldong-goframe-jeeflow pin → v1.8.27 随 P3 收口（base+1，进行中）。

v1.8.26 — 2026-09-04 ​

  • 修复 pro 真验两回归：stuckApprover JOIN 条件 pta.task_id → process_task_id（卡单审批人恒空）；QueryInstancesForStats 的 CreateTime 扫描套 nullTimeScan（DSN 不加 parseTime 时 stats 报错）。

v1.8.25 — 2026-09-04 ​

  • 新增 stats 三 action（processInstance/stats/overview|trend|group）落地。
  • 修复 stats 契约对齐 A–E 验收；parseSurrogateTime 按本地时区解析（两线一致性）。
  • 修复 fireEvent 单监听器 panic 兜底（P2，一个监听器异常不打断其余）。

v1.8.24 — 2026-09-03 ​

  • 新增 CC_CREATE 抄送知会事件（六语言统一缺口 Go 栈）。

v1.8.23 — 2026-09-01 ​

  • 修复（引擎侧根因）：createTask 任务行落库之后 fire EventTaskCreate（带 instanceId/taskId/nodeId/operator）——此前「从不 fire」，新待办 TODO 事件整类缺失，messagePage 恒空；新待办 / 分支节点 / 退回重办 / 会签各子任务逐任务触发，对齐 Java CreateTaskHandler 时机。

v1.8.22 — 2026-08-31 ​

  • 修复：execute 不再覆盖实例 u_*——prepareExecuteTask + 结束节点写回两处把操作人 u_*（含 u_realName）整体写回实例变量，发起人漂移为上一操作人；改为以 start 注入的发起人 u_* 为底、仅并入非 u_* 键（helper mergeExecIntoInstance）。实例 u_realName 恒为发起人，对齐 Java 基准。

v1.8.21 — 2026-08-30 ​

  • 修复 批量入参契约：删除/启停类 action 统一走 idListArgs——{ids} 数组优先、单 {id} 兼容，空值 / 含非法值一律 99999999，不再静默成功。

v1.8.20 — 2026-08-23 ​

  • 修复 会签一票否决条件化 + merged 废弃残留任务（对齐内置引擎）：submitType=20 默认软拒绝；仅 countersignCompletionCondition=ONE_VOTE_VETO 时一票否决推进；merged 后废弃该节点剩余 DOING 任务。

v1.8.19 — 2026-08-23 ​

  • 修复–82 门面字段级契约批次（五语言）Go 部分：processSurrogate 补 update / detail、candidatePage 行键归一、listByType 补 processDefineState、id 精度守卫、委托修复。
  • 测试负向：抄送空 actors 报错——createCCInstance 空/缺失 actorIds → 99999999（对齐 Java/PHP 基准）。

v1.8.18 — 2026-08-16 ​

  • 修复：FormFieldAssigneeHandler.findFieldValue 增加 f_ 前缀优先匹配（对齐 Java 1.8.11）：f_ 前缀 → 裸名回落 → _NN 后缀去后缀。前端表单字段带 f_ 前缀提交时不再取人失败。

v1.8.17 — 2026-08-15 ​

  • 修复：JdbcTableReader 读 VARCHAR 时 []byte 不再被 JSON 成 Base64。

v1.8.16 — 2026-08-13 ​

  • 修复：processDesign/page 时间格式统一为 yyyy-MM-dd HH:mm:ss（§2.4 契约）。
  • 修复（五语言同批）：processTask/detail 的 taskModel 补全 ext / form 字段。

v1.8.15 — 2026-08-09 ​

  • 变更（CI）release workflow 移除 verify job（发布后 registry 可用性改为发版时人工确认）；为 CI 发布流水线做准备。

v1.8.14 — 2026-08-09 ​

  • 变更（CI）test job 移除、aliyun mirror；无引擎行为变更。

v1.8.13 — 2026-08-09 ​

  • 新增：persist.RegisterMeta 注册助手；声明拦截器缺注册表时发起/办理显式报错（引擎兜底）。
  • 新增 Dockerfile.demo。

v1.8.12 — 2026-08-08 ​

  • 修复：designRedeploy 替换分支携带原 Version——对齐 Java 修复（JDBC 兜底曾误写 1 / memory 打回 0）。
  • 改进 updateDefine / save / deploy 的 content 字段支持 string 与 JSON 对象双形态（四语言同批）。

v1.8.11 — 2026-08-06 ​

  • 修复：parent_node_name NULL 扫描；ext 结构体补 json tag。
  • 修复：会签任务 performType 落库（三端对齐 Java）；撤回状态改为 Withdraw(30) 而非 Reject(45)；发起时抄送 f_ccActors 创建抄送。
  • 修复：普通任务 performType 误落 1（回归）；stringifyIDs 支持结构体（id 未字符串化）+ withdraw 级联补正。

v1.8.10 / v1.8.9 — 2026-08-05 ​

  • 无独立行为变更（收口随 1.8.8，重打 tag 对齐联邦号）。

v1.8.8 — 2026-08-05 ​

  • 新增：nodeProgress 成员 name 经 UserProvider SPI 解析 realName——goroutine + WaitGroup 并行批量 getUser（单用户失败不影响其余），未注册或查不到时回退空串。

v1.8.7 — 2026-08-05 ​

  • 修复：performType 增加字符串兼容（'ALL' / 'COUNTERSIGN'），设计器面板保存的字符串格式在会签流程中不再退化为普通节点。

v1.8.6 — 2026-08-05 ​

  • 新增：highLight 新增 nodeProgress——会签节点成员进度（done / active 逐人标记）、普通节点历史与进行中状态。

v1.8.5 — 2026-08-05 ​

  • 修复 E9：facade 出口 id 统一 string 化（stringifyIDs），对齐 Node 全程 string / Java 全局 ToStringSerializer。
  • 修复 E11：jdbc 可空列 sql.NullTime 与剩余 string 字段的 NULL 扫描。

v1.8.4 — 2026-08-05 ​

  • 新增：流程定义级 postInterceptors 声明与拦截器注册表，未声明的流程不触发，与 Java 语义一致。
  • 新增 三门下沉：processDesign/listByType、processInstance/bizData、updateDefine 顶层 JSON 兼容、remove / upAndDown 批量。
  • 修复：jdbc 可空列 NULL 扫描 / DATETIME 依赖 parseTime。

v1.8.3 — 2026-08-04 ​

  • 文档 persist 语言指南权限语义补强（办理入口过滤，上游只读不可绕过）；版本对齐。

v1.8.2 — 2026-08-04 ​

  • 文档：persist 语言指南权限语义补强（引擎行为本已正确，随 Java 修复批同步语义文档）。

v1.8.1 — 2026-08-04 ​

  • 修复：SYNC 字段权限键兼容前端 PERMISSION_f_ 约定（双格式匹配，前端优先）。

v1.8.0 — 2026-08-04 ​

  • 新增：SYNC 同步演进入库（发起入库 → 节点推进 → 结束定稿，对齐 Java）。

v1.7.0 — 2026-08-04 ​

  • 新增：元数据驱动的动态写入 / 读取规范（对齐 Java 阶段①②③）。

v1.6.6 — 2026-08-04 ​

  • 修复：information_schema 探测限定当前 schema（DATABASE() / CURRENT_SCHEMA()，对齐 Java）。

v1.6.5 — 2026-08-04 ​

  • 文档 persist 主键生成语义同步。

v1.6.4 — 2026-08-04 ​

  • 文档 persist 列匹配语义同步。

v1.6.3 — 2026-08-04 ​

  • 文档 persist 语义同步（用户列 operator + 同链防护）。

v1.6.2 — 2026-08-04 ​

  • 修复：表不存在显性报错——拦截器 exists 失败 panic（与 Java/Python 抛异常语义一致，配置错误快速失败）；persist/ 通用入库。

v1.6.1 — 2026-08-04 ​

  • 新增：HandlerRegistry 构造即内置 7 个通用 handler 元数据（字典零注册）。

v1.6.0 — 2026-08-04 ​

  • 新增：参与者解析 SPI 与 7 个内置 handler、candidatePage 双源（四语言同构）。
  • 新增 startAndExecute 支持 f_nextNodeOperator 预指派人（对齐 boot3）。

v1.5.1 — 2026-08-03 ​

  • 新增：processDesign/redeploy、updateDefine、update action + is_deployed 状态同步。

v1.5.0 — 2026-08-02 ​

  • 修复（issues 05/06/07 修复集）：详情 jsonObject、highLight 决策节点表达式过滤、design/detail jsonObject 补齐。

v1.4.0 — 2026-08-02 ​

  • 新增：引擎元数据能力——枚举字典 + SPI 实现清单。

v1.3.0 — 2026-08-02 ​

  • 新增 pageCcInstances 分页 SPI + ccList 补齐；addTaskActor 去重追加语义。

v1.2.0 — 2026-08-02 ​

  • 新增：Facade 补齐视图端点（12 个，二期反馈）。

v1.1.0 — 2026-08-02 ​

  • 新增 管理扩展与门面说明（三扩展表 + 扩展仓储 SPI 同构实现）。

v1.0.0 — 2026-08-01 ​

  • 引擎核心四语言同构实现（Go）：5 张核心表、启动/执行/驳回/跳转/退回发起人/会签/抄送/委托、4 SPI、MySQL / PostgreSQL，发布到 Go proxy。

jeeflow · 轻量级多语言工作流引擎

Apache-2.0 License © mldong