Skip to content

自动化规则中心 ​

代码在 modules/ecom/automation(Mapper 单独登记 AutomationMapperConfig,XML 在 mapper/ecom/automation),前端 views/ecom/automation、views/ecom/automation-log、views/ecom/automation-todo,接口 api/ecom/automation.js,语言包 ecomAuto.js,后端消息键 ecom.*.auto.*,测试 EcomAutomationTests。

结构 ​

包 / 类职责
model.AutoTrigger触发器枚举:分类、产生方式(REALTIME / FREQUENT / DAILY)、可能关联的对象(AutoRef)
model.AutoActionType动作枚举:需要的关联对象(如 ORDER_HOLD 需要 ORDER),supports(trigger) 决定能否用于某个触发器
model.AutoOperator条件运算符(参照工作流 ConditionOperator),supports(fieldType) 声明适用的字段类型,列表字段肯定类任一满足、否定类全部不满足
trigger.AutoTriggerSource一组触发器的事件来源:声明字段、监听业务事件 / 扫描、取最近的真实事件(试运行)
trigger.AutoEvent一个事件:触发器、对象标识(防抖按它判断)、对象名称、店铺 / 平台 / 站点 / SKU / 标签(范围过滤)、字段值、关联对象 ID、页面地址
action.AutoActionHandler一种动作的处理器:validate(保存时校验)、describe(试运行说明)、execute(执行)
service.AutoCatalog启动时收集全部来源和处理器,每个触发器必须有且只有一个来源、每种动作必须有处理器,否则启动失败
service.AutoRuleCache各租户启用的规则(按触发器分组),本机缓存 60 秒,修改规则时失效
service.AutoDispatcher实时事件分发:active(...) 读缓存判断有没有相关规则,有时 @Async 在后台取数并执行
service.AutoEngine一条事件逐条规则处理:范围 → 条件 → 防抖 → 每日上限 → 以创建人身份执行动作 → 写日志
service.AutoConditions条件组(且 / 或、一层子组)与范围的判断,生成判断说明
service.AutoText消息模板 ${字段} 渲染、存库文字(默认语言)
service.AutoRuleCodec范围、条件、动作 ↔ JSON 列;密钥用 CredentialCipher 加密,返回前端为掩码
service.AutoTemplates内置模板
service.AutoScanService / EcomAutomationJobs扫描类触发器的定时任务 ecom.autoScanFrequent(0 */15 * * * *)、ecom.autoScanDaily(0 30 8 * * *,同时清理日志)
service.AutoTodoProviders首页「我的待办」(TodoProvider)与电商看板(EcomDashboardTodoProvider)

表:ecom_auto_rule(范围 / 条件 / 动作存 JSON)、ecom_auto_log(事件与动作结果存 JSON,索引 rule_id, object_key, create_time 支撑防抖查询)、ecom_auto_todo。

执行流程与可靠性 ​

  • 不拖慢业务:监听器在业务事务提交后运行,没有相关的启用规则时只读一次本机缓存就返回;有规则时交给 @Async 线程(租户由 TenantTaskDecorator 传递)。
  • 事务:引擎本身不开事务。动作内部的写操作经过所属 Service(挂起订单 EcomOrderOpsService.hold、打标签 EcomOrderTagService.tag、采购计划 EcomPurchasePlanService、售后工单 EcomCsTicketService 等各自的事务);Webhook、群机器人、平台接口(改价、广告)都在事务外调用。
  • 身份:动作以规则创建人的 LoginUser 和默认语言执行(AutoRunAs),制单人、部门、店铺数据权限都按创建人;创建人不存在或停用时无登录用户执行,需要用户的动作会失败并记入日志。
  • 防抖:countExecuted(ruleId, objectKey, now - N 小时);扫描类触发器最少 24 小时。同一 JVM 内同一「规则 + 对象」加锁,避免并发重复执行。
  • 日志:扫描类触发器的「条件不满足」「防抖跳过」不记日志(每次扫描都会重复);达到上限每天只记一条。
  • 重试:AutoLogService.retry 用日志中保存的事件,只重新执行失败的动作,合并结果。

新增一个触发器 ​

  1. 在 AutoTrigger 加枚举值:分类、产生方式、关联对象。
  2. 在一个 AutoTriggerSource(已有的或新建的 @Component)中:
    • fields() 返回该触发器的字段(AutoField.number / text / enumOf(字典) / bool,名称消息键 ecom.label.auto.field.<字段>,样例值用于没有真实数据时的试运行);
    • 实时触发器:监听业务事件,先 dispatcher.active(触发器),再 dispatcher.dispatch(() -> 构造事件);业务 Service 中没有合适的事件时,在写入后补发一个(如 EcomReviewService.ReviewCreatedEvent、EcomSyncService.SyncFailedEvent、EcomInboundService.InboundSignedEvent、EcomMonitorService.AlertsCreatedEvent);
    • 扫描类:实现 scan(trigger),返回当前满足基本条件的对象(阈值交给规则条件),尽量复用已有的计算(断货风险复用补货建议 EcomReplenishService.rows),取数 SQL 写在 EcomAutoScanMapper.xml;
    • recent(trigger, limit):试运行用的最近真实事件。
  3. 构造事件时用 AutoEvent.builder(trigger, "类型:ID"):store(...) 同时写入店铺 / 平台 / 站点字段,skus、tags 用于范围过滤,ref(AutoRef.X, id) 给动作使用,link 为前端页面路由。
  4. 字典 ecom_auto_trigger(init.sql + 升级脚本)、后端消息 ecom.enum.auto.trigger.<值> 与 .desc、前端英文字典同步增加。AutoCatalog 会在启动时检查每个触发器都有来源。

新增一个动作 ​

  1. 在 AutoActionType 加枚举值,声明需要的关联对象(AutoRef),特殊规则写在 supports。
  2. 实现 AutoActionHandler(@Component,或像 OrderActionHandlers 一样在 @Configuration 中声明多个 Bean):
    • 配置字段放在 AutoRuleParts.Action 中(一个扁平的记录,按类型使用其中的部分字段;需要新字段时加在末尾并同步 withSecret、of);
    • validate 抛 BizException;describe 不能有副作用;execute 通过所属模块的 Service 完成写操作,返回 AutoOutcome.success / skipped / suggested,失败抛异常;
    • 需要关联对象时用 AutoActionSupport.require(event, AutoRef.X),接收人用 AutoActionSupport.recipients。
  3. 前端 ActionEditor.vue 增加该类型的配置字段,applyActionDefaults 补默认值;字典 ecom_auto_action、后端消息 ecom.enum.auto.action.<值> 与 .desc 同步增加。

新增运算符 / 字段类型 ​

运算符加在 AutoOperator(supports 中声明适用的字段类型),前端 locales/*/ecomAuto.js 的 op 增加名称;字段类型加在 AutoFieldType,并在 ConditionGroup.vue 中增加对应的值输入方式。

Webhook 报文与签名 ​

json
{
  "tenantId": 1,
  "ruleId": 12,
  "ruleName": "预估亏损订单自动挂起",
  "trigger": "ORDER_LOSS",
  "triggerName": "订单预估亏损",
  "objectKey": "ORDER:10086",
  "objectLabel": "114-1234567-1234567",
  "event": {
    "storeId": 3, "platform": "AMAZON", "site": "US", "skus": ["DM-EARBUD-BK"], "tags": [],
    "fields": { "orderNo": "114-1234567-1234567", "estProfit": -12.5, "...": "..." },
    "refs": { "ORDER": 10086, "STORE": 3 },
    "link": "/ecom/order?localStatus=PENDING",
    "time": "2026-11-12T09:30:00"
  }
}

配置了密钥时带请求头 X-Lemon-Timestamp(毫秒)和 X-Lemon-Signature: sha256=<hex(HMAC-SHA256(密钥, 时间戳 + "." + 请求体))>,接收方按同样方式计算并比较,同时校验时间戳在允许的偏差内。连接超时 5 秒、请求超时 10 秒,网络错误、5xx、429 重试最多 3 次(间隔 1、2 秒),不跟随重定向。

群机器人与通知 ​

  • 通知动作经 framework/message/ChannelMessageSender(系统模块实现):写入站内消息,并只推送到选择的钉钉 / 企业微信 / 飞书应用消息(已绑定的成员)。
  • 群机器人动作经 framework/message/ImRobotSender(系统模块 SysImRobotSender):指定 Webhook 时校验是该平台的群机器人地址,否则使用「第三方集成」中配置的群机器人。电商模块不直接依赖系统模块。

测试 ​

EcomAutomationTests(集成测试,H2):目录与模板、规则校验与密钥加密;条件且 / 或、子组、列表字段与范围;订单写入后实时执行(挂起、打标签、通知、Webhook 签名、失败地址重试 3 次、单个动作失败不影响其他、重试只执行失败的动作、店铺范围);防抖、每日上限、待办;调价 / 仅建议、采购计划、调预算 / 竞价 / 暂停活动;新差评建售后工单、监控预警触发;试运行不产生副作用;扫描类立即执行与 24 小时防抖。测试共用一个内存库,规则都限定在测试新建的店铺上,结束时停用;实时规则在后台线程执行,测试轮询执行日志等待结果。

面向跨境电商卖家的开源 ERP · 基于 GPL-3.0 协议
联系我们:电话 17701123202 · 微信 BG7LIF · 邮箱 zmissu@163.com