Skip to content

待办、消息与定时任务 ​

站内信(NotificationClient)是不可变事实通知,只区分已读/未读;统一待办(TodoClient)则代表随业务状态动态消失的待处理事项,由业务服务按 (项目, bizKey, 处理人) 幂等打开与关闭,避免“单据已审批,平台工作台待办却消不掉”的脱节,也无需每个业务系统自建待办中心。两者共用同一份项目服务凭据,失败只记日志不阻断业务事务。SDK 接入配置

跟踪一张审批单 ​

java
String key = "approval:" + order.getNo();
todoClient.open(approverId, key, "订单待审批");
// 或签:任一人通过后 close(key) 关闭全部处理人待办
// 会签:每人办理完只关闭自己的待办
todoClient.close(key, approverId);

把业务单号固定在 bizKey 中,重复投递只更新内容而不产生重复待办,原生支持或签(close(key))、会签(close(key, userId))、撤回取消(cancel(key))、带截止时间逾期置顶以及超期未办自动兜底清理。验收时用审批人登录工作台,重复投递同一事项,检查待办数量;办结后检查它从待办列表移出。用 NotificationClient 投递站内信,在接收人的通知中心核对标题、内容和已读状态。待办契约

让业务服务按时执行任务 ​

Platform 调度器不执行任意 Java 类名、Shell 或 URL,只触发业务项目主动上报的固定 Handler,并通过中央租约抢占 + 协作式 fencingToken() / assertLeaseActive() 栅栏让处理器在失去租约后停止后续写入:

  1. 在业务后端实现 ProjectScheduledTaskHandler。taskType() 返回稳定的任务类型,例如 report.daily;execute(context) 复用业务服务。
  2. 启用 kaiwu.starter.scheduler.enabled,配置项目身份和调度凭据。服务启动后上报 Handler。
  3. 在 kaiwu/jobs.yml 声明相同任务类型,运行 清单预览与同步。在平台调度页核对 Cron 和时区,再启用任务。
  4. 查看执行记录,在业务库核对一次预期结果。任务语义为 at-least-once,用 context.executionId() 或任务 ID 与计划时间做幂等;长任务在批次间检查 context.assertLeaseActive()。调度与租约

Apache License 2.0