diff --git a/changelogs-v2/2026-06/05_发送日志补信息内容content列+覆盖更多发送通道-管理后台.md b/changelogs-v2/2026-06/05_发送日志补信息内容content列+覆盖更多发送通道-管理后台.md new file mode 100644 index 0000000..345a624 --- /dev/null +++ b/changelogs-v2/2026-06/05_发送日志补信息内容content列+覆盖更多发送通道-管理后台.md @@ -0,0 +1,69 @@ +# 【后端已上线·前端可加一列·管理后台】发送日志(通知日志):新增「信息内容」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**