业务事件接入路线

规则 CORE-EVENT-001。事件模型、配置 key、payload、资源解析和监听代码的唯一正文是集成事件指南。本页帮助决定如何接入。

选择事件

需要参与当前事务的模块内协作，先检查内部事件及监听器的异常/事务行为；需要在提交后执行的 JVM 内协作，检查蒸馏事件。需要可靠跨进程投递时另行设计可靠性方案，不能把蒸馏事件直接当作持久消息。

接入顺序

1. 明确业务动作、资源 key、消费方以及失败对主流程的影响。
2. 检查 Core 已有发送点，优先复用，避免在 Service 再补发一次。
3. 按正式指南配置全局与资源级开关，确认内部事件和蒸馏事件的依赖。
4. 监听器使用对应 payload，避免依赖某个 ORM 实体的未声明字段。
5. 验证事务提交、回滚、开关关闭、重复/无变化动作和响应式未订阅行为。

业务约束

事件消费者需要幂等时，应依据稳定业务标识设计。提交后监听失败不能保证撤销已经提交的数据库数据；外部副作用需明确重试和补偿。

新增事件字段时同步更新契约、生产方、消费方、测试和兼容说明。验证入口见测试规范。