自动化规则中心
代码在 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用日志中保存的事件,只重新执行失败的动作,合并结果。
新增一个触发器
- 在
AutoTrigger加枚举值:分类、产生方式、关联对象。 - 在一个
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):试运行用的最近真实事件。
- 构造事件时用
AutoEvent.builder(trigger, "类型:ID"):store(...)同时写入店铺 / 平台 / 站点字段,skus、tags用于范围过滤,ref(AutoRef.X, id)给动作使用,link为前端页面路由。 - 字典
ecom_auto_trigger(init.sql + 升级脚本)、后端消息ecom.enum.auto.trigger.<值>与.desc、前端英文字典同步增加。AutoCatalog会在启动时检查每个触发器都有来源。
新增一个动作
- 在
AutoActionType加枚举值,声明需要的关联对象(AutoRef),特殊规则写在supports。 - 实现
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。
- 配置字段放在
- 前端
ActionEditor.vue增加该类型的配置字段,applyActionDefaults补默认值;字典ecom_auto_action、后端消息ecom.enum.auto.action.<值>与.desc同步增加。
新增运算符 / 字段类型
运算符加在 AutoOperator(supports 中声明适用的字段类型),前端 locales/*/ecomAuto.js 的 op 增加名称;字段类型加在 AutoFieldType,并在 ConditionGroup.vue 中增加对应的值输入方式。
Webhook 报文与签名
{
"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 小时防抖。测试共用一个内存库,规则都限定在测试新建的店铺上,结束时停用;实时规则在后台线程执行,测试轮询执行日志等待结果。