docs(changelog): 发送日志补content信息内容列+覆盖旁路发送通道(PR#3529)
这个提交包含在:
父节点
3a0da889ca
当前提交
a973ff3ec5
@ -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**
|
||||||
正在加载...
x
在新工单中引用
屏蔽一个用户