hl-api-changelog/changelogs-v2/2026-06/05_发送日志补信息内容content列+覆盖更多发送通道-管理后台.md

3.6 KiB

【后端已上线·前端可加一列·管理后台】发送日志通知日志新增「信息内容」content 字段 + 覆盖更多发送通道

关联: 通知中心 / 发送日志(接前篇 05_通知发送日志富化-通道列+发送对象列-管理后台.md 服务: hl-user-service后端已改 + 部署测试服 + boot 验证)| 前端 hl-ui 提报时间: 2026-06-05 | 后端: @wx | 前端待接: mmg 位置: 管理后台 → 通知中心 → 发送日志(推送日志)列表 后端 PR: #3529已合并 dev-v3 + 部署测试服 + 双实例 boot 验证)


⚠️ 关键说明

  1. GET /admin/notification/logs 每条记录新增 content 字段(信息内容 = 实际发出的消息正文),前端可加一列直接展示。
  2. 发送日志此前「明显不全」:很多发送(短信验证码、任务企微通知等)走的是绕开通知中心的旁路,没进发送日志。本次已统一补记,前端无需改动即会看到更多类型的发送记录

1. 新增字段 content(信息内容)

字段 含义 示例
content 实际发出的消息正文 站内信=「标题\n正文」;短信/小程序/公众号/企微=渲染后文本

前端可在发送日志列表加一列「信息内容」展示 content(可空——历史旧数据该列为 null,新产生的记录才有

实测(测试服,自定义推送站内信):

GET /admin/notification/logs?channel=INAPP&pageNum=1&pageSize=1
→ records[0].content = "发送日志content验证\n这是一条用于验证content列落库的测试站内信"

2. 发送日志现已覆盖更多发送通道(前端无需改动,记录变多)

后端把过去绕开通知中心、不进发送日志的旁路发送统一补记进 notification_send_log,前端日志页会自动多出这些记录

现已记录的发送 通道(channel / channelLabel) event_code
C 端登录/注册短信验证码 SMS / 短信 SMS_VERIFY_CODE
管理端(定制师)登录验证码短信 SMS / 短信 SMS_ADMIN_LOGIN
客户投诉通知短信 SMS / 短信 SMS_COMPLAINT
任务指派/评论/订单待办 企微通知 WEWORK / 企业微信 WECHAT_MQ
通用企微 Feign 直发(审批/提醒等) WEWORK / 企业微信 WECHAT_DIRECT
外部联系人新增/流失 企微提醒 WEWORK / 企业微信 WECHAT_EXTERNAL

这些 event_code 是新值,前端若对 event_code 做了白名单/枚举映射,记得放开(否则可能显示成未知事件);若直接展示 channelLabel + content 则无需改。


3. 暂未覆盖(后端 Phase 2,告知避免误判「还是不全」

  • 合同签署/催签短信:由第三方电子合同平台(腾讯电子签 / 12301下发,发送在 order 服务、日志表在 user 服务,需跨服务日志通道,单独一期补。
  • 车务司机驳回短信:当前为 mock 未真发,接通真实短信网关时纳入。

这两类目前不会出现在发送日志里,属已知待补,非 bug。


4. 前端 TODO

  • 发送日志列表加一列「信息内容」→ 取 content(可空)。
  • 若 event_code 有枚举校验,补上 SMS_VERIFY_CODE / SMS_ADMIN_LOGIN / SMS_COMPLAINT / WECHAT_MQ / WECHAT_DIRECT / WECHAT_EXTERNAL

5. 关联

  • 前篇(通道中文名 + 发送对象):05_通知发送日志富化-通道列+发送对象列-管理后台.md
  • 后端:@wx | 前端:mmg