消息网关后台管理页面原型说明
原型入口
- 原型文件：
D:\Africa\管理后台原型\index.html - 本次新增模块：左侧菜单新增“消息网关”分组，包含消息网关概览、短信模板配置、Push 模板配置、短信通道路由配置、语音模板配置、发送记录、手动发送通知。
- 交互方式：列表页支持点击行打开详情页；概览页流程节点支持点击跳转；手动发送支持切换短信、Push、语音，预览内容并生成 mock 发送记录。
页面范围
| 页面 | 一期原型能力 | 说明 |
|---|---|---|
| 消息网关概览 | 展示模板、通道路由、发送记录、供应商接入状态 | 用于说明消息网关对上游屏蔽供应商差异 |
| 短信模板配置 | mock 登录 OTP、还款提醒、还款成功、贷款审批模板 | 支持按供应商、状态、场景、关键词过滤 |
| Push 模板配置 | mock App Push 模板 | Push 纳入消息网关框架，具体客户端 SDK 接入仍以 Firebase 文档为准 |
| 短信通道路由配置 | mock 原 CRS 短信通道迁移后的同类型路由 | 一期只启用短信通道内路由，不启用语音失败后短信 / WhatsApp 自动降级 |
| 语音模板配置 | mock 首家 AI 语音外呼供应商，策略 ID 50 | Secret 不在原型中展示，仅以密钥托管引用表达 |
| 发送记录 | mock 短信、Push、语音发送记录与回执状态 | 用于客服追踪和运营排查 |
| 手动发送通知 | 支持短信、Push、语音手动发送 mock | 生产需补角色权限、接收人归属、频控、审计和审批策略 |
模板新增与编辑
- 短信模板、Push 模板、语音模板均支持在原型中新增和编辑。
- 列表页提供“New Template”入口，详情页提供“Edit Template”入口。
- 保存后回写 mock 数据，并打开模板详情页用于确认。
- 短信模板采用“一个内部模板 + 多个外部通道映射”的结构；一期原型先编辑主映射字段，详情页展示映射列表。
- 一期原型只模拟保存，不包含审批流、发布流、灰度、版本回滚和模板审核回调。
短信供应商差异处理
短信场景下，消息网关需要区分“上游使用的网关模板”和“供应商侧发送模板”。上游系统只传网关模板编码和变量，不直接感知供应商模板 ID、发送账号、签名、审核状态等差异。
| 字段 | 归属 | 用途 |
|---|---|---|
| Gateway Template Code | 消息网关统一字段 | BNS、FCS、CRS 等上游调用方使用的稳定模板编码 |
| Business Scene | 消息网关统一字段 | 用于路由、权限、频控和统计 |
| Variables | 消息网关统一字段 | 上游传入变量，网关负责映射到不同供应商格式 |
| Content | 消息网关统一字段 | 网关侧可读模板内容，用于预览、审计和校验 |
| SMS Provider | 供应商映射字段 | 当前模板绑定的短信供应商 |
| Sender Account | 供应商映射字段 | 供应商侧发送账号，例如 OTP 账号、通知账号、测试账号 |
| Sender Sign | 供应商映射字段 | 供应商侧短信签名或 Sender ID |
| Provider Template ID | 供应商映射字段 | 供应商审核通过后的模板 ID |
| Provider Audit Status | 供应商映射字段 | 待提交、审核中、已通过、驳回等供应商侧状态 |
一期功能表和原型已覆盖模板配置、供应商模板映射、发送账号配置、短信同类型路由、发送记录和手动发送验证。一个内部短信模板可以维护多条外部通道映射，后续如接入第二家短信供应商，只新增该供应商的映射记录，而不是让上游系统选择供应商模板。
SMS Routing 编辑
- SMS Routing 列表支持点击行进入详情，详情页支持编辑。
- 可编辑字段包括业务场景、主短信供应商、备用短信供应商、权重、启用状态、跨通道降级预留说明。
- 一期只允许在短信通道内部选择主备供应商；语音未接通后自动短信 / WhatsApp 的跨类型路由仍为二期能力。
一期边界
- 一期后台以“能配置、能查询、能追踪、能手动验证”为目标，不建设完整营销自动化平台。
- 短信通道路由只覆盖同类型通道。当前 mock 中仅一家具备生产迁移意义的短信供应商，即原 CRS 短信通道迁移后的
crs_legacy_sms。 - 语音外呼接入一家供应商，测试 App Key 仅展示公钥部分，Secret 只显示“存储在密钥管理”。
- Push 在原型中提供模板与发送记录框架，是否纳入一期上线按服务端发送与客户端 FCM SDK 完成度评估。
- 跨类型自动降级，例如语音未接通后自动短信 / WhatsApp，原型中仅展示“Phase 2 reserved”，不作为一期验收能力。
- 手动发送通知为原型验证能力，不作为一期默认生产验收范围；生产如需开放，必须另行补充角色权限、接收人归属校验、频控、审批和审计要求。
后续开发提示
- 后台页面权限需要拆分为：模板管理、路由管理、发送记录查询、手动发送。
- 所有手动发送必须写入审计：操作人、业务原因、接收人、模板、变量、请求 ID、发送结果。
- 供应商接入后台不直接保存明文 Secret，应只保存密钥托管引用。
- 路由配置保存后应触发配置版本号变更，发送记录保留当次命中的配置版本，便于回溯。