feat: add workbench kafka migration support

docs/IM-Kafka接入方案.md

@@ -899,9 +899,11 @@ IM Server 不再生产或消费 `im.file.lifecycle`。文件相关的小流量
 3. 文件对象字节流仍走 OSS/文件服务，Kafka 不承载上传/下载内容。
 4. 合规删除、临时文件 TTL 回收、OSS 删除动作仍保留为后续深化项。
 
-### 11.11 IM Server 工作台事件同步处理
+### 11.11 IM Server 工作台事件消费处理
 
-IM Server 不再生产或消费 `im.workbench.event`。工作台小流量事件由业务接口同步创建系统通知和 `im_business_events_outbox`。
+工作台拆分为独立 `im_workbench` 服务后，工作台业务变更由 `im_workbench` 生产 `im.workbench.event`，IM Server 新增独立 Kafka consumer 消费该 Topic，并转为系统通知和 C 端业务实时事件。
+
+说明：IM Server 当前保留旧工作台 HTTP 代码和同步处理函数，仅作为迁移过渡兼容。待 `im_workbench` 全部接口稳定后，再统一删除 IM Server 内的旧工作台业务代码。
 
 当前生产范围：
 
@@ -914,8 +916,11 @@ IM Server 不再生产或消费 `im.workbench.event`。工作台小流量事件
 
 当前消费行为：
 
-1. 按 `target_user_ids` 同步生成系统通知。
-2. 同步写入 `im_business_events_outbox`，由现有 WS 业务事件投递器下发在线客户端。
+1. `im_workbench` 直接发送 JSON 事件到 `im.workbench.event`，Topic 配置键为 `workbench_external`。
+2. IM Server 按 `event_id + consumer_group` 做消费幂等。
+3. 按 `target_user_ids` 为非发布人生成系统通知。
+4. 写入 `im_business_events_outbox`，由现有 WS 业务事件投递器下发在线客户端。
+5. 消费失败按统一 Kafka 重试逻辑处理，超过最大重试次数后进入 `im.dead.letter`。
 
 ### 11.12 IM Server 已接入的审计事件