docs(changelog): 合同签署短信进发送日志 CONTRACT_SIGN_SMS(PR#3534)

这个提交包含在:
API Changelog Bot 2026-06-05 18:10:23 +08:00
父节点 aa399de161
当前提交 2b79b32b70

查看文件

@ -0,0 +1,54 @@
# 【后端已上线·前端补一枚 event_code·管理后台】合同签署短信现已进「发送日志」
> **关联**: 接 `05_发送日志补信息内容content列+覆盖更多发送通道-管理后台.md`#3529 的 Phase 2 收尾)
> **服务**: hl-user-service + hl-order-service-v2 + hl-order-service-v3均已部署测试服 + 双实例 boot 验证)
> **提报时间**: 2026-06-05 | **后端**: @wx | **前端待接**: mmg
> **位置**: 管理后台 → 通知中心 → 发送日志
> **后端 PR**: #3534(已合并 dev-v3 + 部署 user/order-v2/order-v3 + 6 实例 boot 验证)
---
## ⚠️ 关键说明
上一篇里标为「Phase 2 暂未覆盖」的**合同签署短信**,现在**已经会进发送日志**了。
合同签署短信由第三方电子合同平台(腾讯电子签 / 12301下发,发送在 order 服务、日志表在 user 服务,过去看不到;本次加了跨服务补记,现已统一进 `notification_send_log`
---
## 1. 前端唯一要做的事:补一枚 event_code
若发送日志页对 `event_code` 做了**白名单/枚举映射**,补上 **`CONTRACT_SIGN_SMS`**(否则该类记录的事件名可能显示成未知)。直接展示 `channelLabel` + `content` 则无需改。
合同签署短信在发送日志里的样子:
| 字段 | 值 |
|------|-----|
| 通道 channelLabel | 短信 |
| 信息内容 content | 合同签署短信(创建首发) / 合同签署短信(重发) / 合同签署短信(C端重发) |
| 发送对象 | 签署人手机号 |
| 关联业务 bizId / bizType | 合同编号 / CONTRACT |
| event_code | `CONTRACT_SIGN_SMS` |
覆盖 4 个发送场景:合同**创建首发**、管理端**发送签署链接**、管理端**重发**、C 端**重发**。
---
## 2. 发送日志 event_code 全集(截至本次)
前端 event_code 白名单建议放开这些(都是后端已落库的旁路发送类型):
`SMS_VERIFY_CODE`C端验证码`SMS_ADMIN_LOGIN`(管理端登录码)、`SMS_COMPLAINT`(投诉短信)、`WECHAT_MQ`(任务/订单企微)、`WECHAT_DIRECT`企微Feign直发`WECHAT_EXTERNAL`(外部联系人企微)、**`CONTRACT_SIGN_SMS`(合同签署短信,本次新增)**。
---
## 3. 仍未覆盖(唯一)
- **车务司机驳回短信**:当前为 mock 未真发,接通真实短信网关时再纳入。
至此发送日志完整性除车务外全部收口(通知中心 6 通道 + 6 处旁路缺口 + 合同跨服务补记)。
## 4. 关联
- 上一篇:`05_发送日志补信息内容content列+覆盖更多发送通道-管理后台.md`
- 后端:@wx | 前端:**mmg**