Files
go-sms-V2/memory-bank/docs/Go-sms-需求分析.md
T

21 KiB
Raw Blame History

汇网综合业务支撑平台(go-sms)功能需求分析

【文档状态】✅ 重建需求基线(判定 2026-11-12) 重建范围裁决=核心先行:P0+P1 全做+结算域;P2(§4 增值业务线)不排期。页面覆盖对照与排期见《Go-sms-重建计划.md》。

来源:汇网科技综合业务平台使用文档 V6(doc.huiwwl.com,共 18 个功能模块 / 94 个功能页面,已全量抓取分析) 分析日期:2026-08-29 优先级定义:

  • P0:平台价值主线的必需功能,缺失则平台无法营业(收发主链路、开户、路由、合规、回执)
  • P1:重要支撑功能,影响运营效率与商业闭环(统计、结算、审计、运维告警)
  • P2:增强型 / 增值业务,可后置到后续迭代(大屏、增值业务线、便利工具)

1. 平台概览

1.1 平台定位

多业务线消息综合支撑平台,作为上游通道资源与下游客户之间的中间运营平台:

上游(运营商直连 / 第三方通道) ──► 本平台(路由·合规·计费·审核·统计) ──► 下游客户(HTTP API / CMPP / SMPP / 网页客户端)

1.2 业务线

业务线 说明 状态判断
国内短信 核心业务,CMPP/HTTP 通道,群发/个性/文件/定时 成熟,核心
国际短信 SMPP 通道,按国家配置单价与通道 成熟
视频短信 仅国内,模板+审核体系与短信平行 成熟
CSP 5G消息 移动/电信/联通 CSP、Chatbot、非直签、阅信单点登录 较新
空号过滤 实号/空号/风险号/沉默号检测 增值
短链 短链生成、报备、访问统计 增值

1.3 核心业务流程(快速入门明确给出)

创建通道(接上游) ──► 开通客户账号+账号配置 ──► 充值 ──► 发送(网页/API)
      ──► 回执/上行处理 ──► 记录查询 ──► 统计报表 ──► 上下家结算

1.4 功能模块地图(18 模块)

主页 · 预警公告 · 帐号管理 · 业务审核 · 短信业务 · 视频业务 · CSP业务 · 空号业务 · 短链业务 · 通道配置 · 规则策略 · 通讯录 · 用户统计 · 通道统计 · 结算管理 · 日志报表 · 系统配置 · 常见问题


2. 核心功能

2.1 账号与权限体系

功能 需求要点 优先级
用户管理-开户 一站式开通国内/国际短信、视频、空号、CSP 业务;支持 CMPP/SMPP/HTTP(API)/网页客户端四种接入形态开户 P0
用户配置-基础 IP 绑定、单价(时间线分时计价)、授信余额、短信类别、进账类型、状态开放、失败返还 P0
审核模式 免审 / 手动审核(不符模板入人工审)/ 自动审核(不符直接拒绝);集团审核独立前置 P0
角色权限 多级账号体系(admin/客户运维/客服/集团…),页面级角色权限 + 账号二级权限(充值、代发、导出、下载等按权限开放) P0
余额与充值 单个/批量充值、余额预警(预警时间可配)、充值需二级权限 P0
账号生命周期 启用/禁用、批量切换配置、切换上级(多级代理)、标星、删除(仅沉默账号或 60 天未发送可删)、导出用户(仅 admin) P0
实名认证 实名认证限制与审核、签名实名制信息记录 P1
服务团队 账号维度绑定服务团队展示 P2

2.2 通道接入与管理

功能 需求要点 优先级
短信通道-CMPP CMPP 通道对接与测试;企业代码、通道号(接入码)、扩展码 P0
短信通道-HTTP/SGIP HTTP API 通道、SGIP 通道对接与测试 P0
通道拦截机制 频次拦截、发送限制(不限/日限/限制)、夜间管控(直接失败/限速 4条/s·链)、通道黑关键字、通道签名限制、屏蔽地区 P0
通道号截断/优先发送 通道号截断 1~21 位可配;优先发送关键字命中走优先通道 P0
通道组路由 四步路由:条件过滤(频次/黑关键字/签名/地区/运营商)→ 优先通道(省网分流)→ 权重比例分发 → 默认通道兜底 P0
上家管理 上家(通道方)档案、通道分类、通道与上家单个/批量绑定 P1
短信码号报备 联通/移动福建/浙江广东电信 签名码号实名报备、子端口强关联 P1
签名管理 签名→扩展码映射导入(覆盖/追加/删除),配合"无匹配直接失败/自动生成扩展"两种模式 P1
屏蔽码号 按通道+码号直接拦截(返回"已屏蔽的子端口号") P1
配置ID短信通道 上游"模板ID+变量"模式(移动 MAS、CSP 中转),变量占位符 {%xxx%} P1
SMPP 通道接入 国际 SMPP 通道 P1
通道价格时间线 分时单价记录、估算余额(=校正余额-成功数-未知数,2 小时刷新) P1
视频通道 视频通道创建/启停/拦截配置(同短信模型) P1
黑名单/空号通道 第三方黑名单检测通道、空号检测通道接入 P2
携号转网通道统计/投诉查询 第三方携转通道统计、投诉记录查询 P2

2.3 消息发送

功能 需求要点 优先级
群发短信 网页批量提交,同内容群发,每成功 1 条扣减 1 条余额 P0
个性短信 号码+内容逐条不同的变量发送 P0
HTTP API 提交 HTTP 接口密码、回执绑定地址、上行绑定地址(回调推送)、随机/固定扩展码 P0
CMPP/SMPP 客户接入 企业代码、CMPP 扩展码、通道号校验(UT:0012)、速度=最大提交速度×连接数、CMPP 合包(聚合提交降低 HTTP 通道压力) P0
模板体系 精确模板报备/导入(仅创建者可用)、模板匹配自动放行、模板变量限制 P0
定时短信 定时发送、批量重置定时时间 P0
文件短信 TXT/EXCEL/CSV 号码文件直接发送(A 列号码 B 列内容,TXT 逗号/制表符分隔) P1
拆分短信 同模板按变量拆分多批(如 100 号码按联系人名拆分) P1
网页提交拆包 客户端群发批次拆包配置 P1
视频短信发送 视频+文字合帧发送,支持优先合帧 P1
上行码号分配 按上行码号(精确/前缀匹配)将上行回复分配给指定账号;优先 CMPP 推送,无对接则 HTTP 推送/自取 P1
CSP 发送 CSP 群发/个性发送(TXT 一行一个、XLSX 一格一个)、CSP 模板 P2
空号过滤发送 号码文件导入检测,导出 .csv,分类:实号/空号/风险号/沉默号 P2

2.4 路由、合规与风控

功能 需求要点 优先级
导流策略 按内容关键字/账号维度指定通道(如"张三"走 A 通道、"李四"走 B 通道) P0
黑名单机制 本地黑名单库(UT:0006)、汇网 API 黑名单、第三方黑名单通道(UT:0026)三级检测 P0
黑/白关键字 一级黑关键字(直接失败 UT:0023)、二级黑关键字(免审模式专用,失败/入审 UT:0010)、白关键字(免审直接通过) P0
频次策略 同号码/同内容时间窗发送次数限制(UT:0016),自然日/24 小时两种单位 P0
白名单库 忽略频次与黑名单限制 P0
签名限制 内容签名校验(缺签名 UT:0013、非指定签名拦截)、退订限制(末尾"拒收请回复R",UT:0014) P0
营销时间管控 全局/单账号营销发送时间、超时直接失败、全天发送豁免、夜间频繁拦截 P0
屏蔽地区 按地区拦截(UT:0009) P0
审核工作流 发送短信审核(48 小时未审自动失败)、待审核内容聚合展示、模板审核(批量通过/拒绝/删除)、集团短信审核(仅 HTTP 生效)、报备签名审核(通过后自动填充到账号签名限制)、短链地址审核 P0
失败重发策略 按失败状态码配置自动补发,仅补发一次 P1
国际短信规则 按国家配置单价与通道(客户扣费单价与通道成本分离) P1
上行自动拉黑 回复"拒收"等上行自动入黑名单(规则可配、页面隐藏不影响接口推送) P1

2.5 回执、上行与记录查询

功能 需求要点 优先级
状态回执 DELIVRD/FAILURE/未知状态归一,错误代码表可维护 P0
下行记录 批次级记录(近 5 天热数据),拦截失败/通道失败号码下载、批次状态统计(客服+)、定时标红 P0
下行明细 号码级明细(近 5 天),CMPP 用户/通道日志追溯(5 天内) P0
历史记录 全量历史记录/明细按时间查询 P0
上行记录 上行接收、匹配失败归 admin、指定用户、导出(非 admin 需权限)、只匹配 15 天内发送数据 P0
定时记录 定时任务管理、批量重置发送时间、取消发送 P1
回执重推 回执/上行手动重推任务(选用户+时间),30 天内可重推 P1
手动配对状态 直接失败/指定状态/上传状态文件/提取通道回执日志匹配 4 种方式处理 3 小时外无状态短信 P1
下载明细 全量明细异步下载(非 admin 需单独开权限),按发送时间筛选 P1
视频记录体系 视频下行记录/明细/上行/定时(模型同短信,5 天热数据) P1

2.6 计费与结算

功能 需求要点 优先级
预扣费/按条计费 提交预扣、成功计费、失败返还("状态开放"才返还条数) P0
授信余额 授信额度下发,允许负余额发送 P0
分时单价 用户/通道单价按时间线生效,与结算联动 P0
下家结算 按客户月度结算、账单/明细 P1
上家结算 上家账单/明细导出、结账记录、单价追加、上家切换 P1
消耗日志 按账号/业务/天记录消耗 P1
充值日志 充值记录、付款审核确认 P1
利润分析 用户利润(含下级)、通道利润按时间段分析 P1

3. 辅助功能

3.1 监控与告警

功能 需求要点 优先级
余额预警 用户级预警设置 + 初始化预警时间,微信推送/短信通道告警 P1
通道告警 通道维度异常告警配置 P1
用户/通道通讯日志 当天通讯实时曲线,每 2 秒刷新 P1
系统信息监控 MySQL/Redis 空间监控,容量 80% 需扩容/清理 P1
系统公告 主页公告/底部公告、详情跳转 P2
可视化大屏 用户监控大屏+通道监控大屏(今日在线/活跃、正常/活跃通道),仅客户运维及以上角色,F11 全屏 P2

3.2 效率工具

功能 需求要点 优先级
通讯录 分组树(子节点/重命名/删除)、节点全选、批量导入(.xls/.xlsx,日期 yyyy-mm-dd)、导出/删除、一键跳转发短信 P2
任务提醒 通讯录客户变量短信自动提醒 P2
常用短语 树形管理、发送页快捷调用 P2
常用号码 号码组管理、批量导入自动去重、导出 txt P2
在线接口文档 HTTP 短信/视频/空号接口规范查询 P1
错误代码表 错误码/失败原因/转义值查询与维护(UT:xxxx 体系) P1
签名实名制 签名信息记录(仅记录,与发送无关联) P2
投诉查询 投诉记录查询 P2

3.3 系统运维

功能 需求要点 优先级
系统参数配置 服务协议弹窗、默认查询天数、频繁发送日单位(自然日/24h)、全局营销时间、黑名单收集(第三方黑自动入本地库)、模板变量限制 P1
初始化配置 用户开户/短信/视频/空号/短链业务开户默认参数、登录手机验证码通道与内容 P1
备份与恢复 数据备份清理(仅 admin) P1
系统日志 登录审计(账号/IP/日期检索) P1
主页工作台 账号身份、公告、系统信息、已激活产品今日用量、发送类型/数据分析 P1
更换主题 按钮与菜单颜色自定义 P2

4. 未来规划(增值业务线,P2)

功能 需求要点 优先级
CSP 5G消息全栈 移动/电信/联通 CSP 对接、非直签客户配置(运营商平台批量导入)、Chatbot 配置、阅信单点登录、CSP 代理统计 P2
短链业务 短链域名配置、客户报备链接审核、短链任务记录、访问详情统计(点击分析) P2
空号过滤业务 空号通道、过滤记录(实号/空号/风险号/沉默号,标称准确率 100% 误差 5%)、空号用户配置与统计 P2
视频短信业务线 视频模板/审核/发送/记录全链路(国内) P2
国际短信业务线 SMPP 通道、按国家单价/通道规则 P2
黑名单通道增值 第三方黑名单检测通道 + 检测统计 P2
携号转网增强 第三方携转库接入、携转通道统计、号段库远程同步 P2
可视化大屏 见 3.1,依赖实时统计能力 P2

说明:文档中视频/国际短信已是成熟功能,但对新平台建设而言属于"第二条业务线",建议在短信主链路(P0)稳定后实施,故整体归入 P2 规划;其单页面内的通用能力(记录、审核、统计模型)已随 P0/P1 的通用平台能力一并实现。


5. 技术约束与依赖

5.1 协议与对接约束

约束项 内容
下游接入协议 HTTP API、CMPP(企业代码/扩展码/通道号校验/连接数×速度)、SMPP(system ID)、网页客户端
上游通道协议 CMPP、HTTP API、SGIP、SMPP;上游"模板 ID+变量"模式({%变量%} 占位符)
回执/上行推送 HTTP 客户:回执绑定 + 上行绑定地址(推荐填写不强制);CMPP 客户:优先 CMPP 推送;支持 HTTP 自取
合包约束 CMPP 提交 + HTTP 通道场景需按时间窗合包(如 5 秒)降低通道压力
限速模型 平台总速度 = 最大提交速度 × 连接数;夜间管控单链路 4 条/s(N 链路 = N×4)

5.2 存储与数据保留约束

约束项 内容
存储组件 MySQL(业务数据+记录,需手动配置监控)、Redis(空间监控);容量 80% 触发扩容/清理动作
热数据窗口 下行记录/明细仅保留 5 天,更早数据进"历史记录/历史明细"全量库
上行匹配窗口 上行只匹配 15 天内的发送数据
回执重推窗口 30 天内允许回执/上行重推
状态回补 提交失败次日返回;通道失败状态 72 小时后凌晨返回;3 小时外无状态走手动配对
日志窗口 CMPP 用户/通道日志仅可查 5 天内当天日志
删除约束 账号/通道仅在"从未发送(沉默)"或"60 天以上未发送"时可删除
明细下载 只要数据库未清理即可下载(下载中心模式,非 admin 需授权)

5.3 统计与调度约束

约束项 内容
统计刷新 用户/通道使用统计逢偶数整点更新;昨日统计 7/13/17 点补算;前 2-3 天凌晨 2 点补算
多维统计 时间、用户、地区、运营商、签名、状态码、回执速率 7 个维度
通道估算余额 = 校正余额 - 成功数 - 未知数,每 2 小时刷新,偶数点刷新,空值不参与统计
实时监控 用户/通道通讯日志 2 秒刷新
审核时效 待审核短信/视频 48 小时未审核自动失败

5.4 计费模型约束

  • 按条计费:提交预扣、回执成功确认、失败按"状态开放+失败返还"规则返还条数。
  • 单价双线:客户扣费单价(用户侧)与通道成本单价(上家侧)分离,均支持时间线动态调价。
  • 授信机制:授信余额支持透支发送;充值需二级权限,非 admin 充值需显式授权。
  • 错误码体系(UT:xxxx):0006 黑名单、0009 屏蔽地区、0010 二级黑关键字/通道黑关键字、0012 通道号错误、0013 签名、0014 退订、0015 审核、0016 频繁、0021 参数不符、0023 一级黑关键字、0026 第三方黑、0027 空号;通道侧:通道拒收 -1(屏蔽码号)/-3(发送限制)、提交失败 -3。

5.5 合规与运营商约束

  • 营销短信时间窗管控(全局+单账号)、夜间管控、超时直接失败。
  • 签名体系:【签名】前后置识别、签名报备审核自动化(审核通过自动写入账号签名限制)、签名实名制记录。
  • 码号报备:联通、移动福建、浙江/广东电信的签名码号实名报备与子端口强关联。
  • 退订合规:内容末尾必须含"拒收请回复R"类退订标识(可配)。
  • 上行拒收自动拉黑规则。

5.6 外部依赖

依赖 用途
微信推送 余额/通道告警推送
汇网 API 黑名单库 二级黑名单数据源
第三方黑名单通道 发送前实时检测
第三方携号转网通道 携转识别
汇网号码库/号段库 号码归属地、号段分类远程同步
运营商 CSP 平台 移动/电信/联通 CSP、阅信单点登录
上游通道方 短信/视频/空号/黑名单通道资源

5.7 安全约束

  • IP 绑定(接口客户)、登录手机验证码(可配通道与内容)、服务协议弹窗。
  • 分级授权:admin 专属(导出用户、备份恢复、全局配置);二级权限控制充值/代发/导出上行/下载明细;页面级 RBAC 角色(客户运维及以上才可访问大屏)。
  • 数据安全:仅 admin 可导出全量用户数据。

5.8 文件处理约束

  • 号码文件:TXT(逗号/制表符分隔)、EXCEL、CSV(A 列号码 B 列内容)。
  • 通讯录:.xls/.xlsx,出生日期格式 yyyy-mm-dd 或 yyyy/mm/dd。
  • 检测结果导出:.csv;号码组导出:.txt;报表导出:.xls。
  • 大文件异步处理:文件短信、批量导入、明细下载均为任务化流程。

6. 优先级总览

6.1 P0(主链路必需,共 ~30 项)

开户(多协议多业务)· 用户配置(单价/授信/IP/审核模式)· 角色权限与二级权限 · 充值与余额预警 · 通道创建(CMPP/HTTP/SGIP)· 通道拦截机制 · 通道组四步路由 · 导流策略 · 黑白名单/黑白关键字/频次/签名/退订/地区拦截 · 营销时间管控 · 审核工作流(发送/集团/模板/签名)· 群发/个性/定时发送 · HTTP/CMPP/SMPP 提交 · 模板体系 · 状态回执 · 上行接收推送 · 下行记录/明细(含历史库)· 上行记录 · 预扣费/失败返还 · 分时单价 · 号码归属地/号段/携转库

6.2 P1(运营支撑,共 ~25 项)

文件短信/拆分短信 · 上行码号分配 · 视频通道与视频记录体系 · 上家管理/码号报备/签名管理/屏蔽码号/配置ID通道/SMPP 通道/价格时间线 · 失败重发 · 国际短信规则 · 上行自动拉黑 · 定时记录 · 回执重推 · 手动配对状态 · 下载明细 · 下家/上家结算 · 充值/消耗日志 · 利润分析 · 多维使用统计 · 余额/通道告警 · 通讯日志 · 系统监控 · 接口文档/错误代码 · 系统参数/初始化配置 · 备份恢复 · 登录审计 · 主页工作台

6.3 P2(增值与规划,共 ~20 项)

CSP 5G消息全栈 · 短链业务 · 空号过滤业务 · 视频短信业务线 · 国际短信业务线(SMPP 客户接入)· 黑名单通道 · 携转增强 · 可视化大屏 · 系统公告 · 通讯录/常用短语/常用号码/任务提醒 · 签名实名制 · 投诉查询 · 更换主题 · 服务团队


附录 A:错误代码体系(发送链路依赖)

错误码 含义 触发场景
UT:0006 黑名单 本地/API 黑名单命中
UT:0009 屏蔽地区 地区拦截
UT:0010 黑关键字 二级黑关键字/通道黑关键字
UT:0012 通道号错误 CMPP 提交通道号前置不匹配
UT:0013 签名错误 缺签名/非指定签名
UT:0014 退订错误 缺退订标识
UT:0015 审核拒绝 手动/自动审核不通过
UT:0016 频繁发送 频次策略命中
UT:0021 参数不符 变量限制触发
UT:0023 一级黑关键字 强制失败关键字
UT:0026 第三方黑名单 黑名单检测通道命中
UT:0027 空号 空号通道检测命中
通道拒收 -1 已屏蔽子端口号 屏蔽码号命中
通道拒收/提交失败 -3 发送限制 通道日限/限制模式
DELIVRD / FAILURE 回执状态 成功/失败

附录 B:数据来源

  • 文档首页:https://doc.huiwwl.com/document_new/(iframe 框架结构,菜单 /document_new/page/sy,正文 /document_new/page/right?cont_id={id})
  • 全量抓取 94 个功能页面(cont_id 见正文各表),关键字快速入门(1713)、用户管理(19)、短信用户配置(33)、短信通道(84)、通道组(100)、系统参数配置(111)等为需求密度最高的页面。