diff --git a/changelogs-v2/2026-06/05_合同签署短信进发送日志-CONTRACT_SIGN_SMS-管理后台.md b/changelogs-v2/2026-06/05_合同签署短信进发送日志-CONTRACT_SIGN_SMS-管理后台.md new file mode 100644 index 0000000..91e3acb --- /dev/null +++ b/changelogs-v2/2026-06/05_合同签署短信进发送日志-CONTRACT_SIGN_SMS-管理后台.md @@ -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**