55 行
2.6 KiB
Markdown
55 行
2.6 KiB
Markdown
# 【后端已上线·前端补一枚 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**
|