fix: implement channel group routing failover

docs/first-version-development-requirements.md

@@ -134,9 +134,24 @@
 ### 4.6 通道配置与路由
 
 1. 运营端配置短信通道，包括通道名称、运营商、单价、网关地址、端口、企业代码、账号、密码、接入号、协议参数、启停状态。
-2. 运营端配置短信通道组，定义通道优先级、运营商适配、区域适配、权重和故障切换。
-3. 发送时根据企业、应用、签名、模板、号码归属、通道状态和通道组策略选择通道。
-4. 通道异常时应支持熔断、降级、切换备用通道和失败重试。
+2. 通道运营商支持移动、联通、电信和三网；三网通道可作为移动、联通、电信的通配通道。
+3. 通道必须配置发送地区，发送地区为全国或 34 个省级地区之一；单个通道只能选择一个发送地区。
+4. 运营端配置短信通道组，定义通道优先级、运营商适配、省网路由、全国路由、权重、失败补发开关和补发时间上限。
+5. 企业不配置默认通道组；企业应用必须单独配置至少一个运营商通道组，否则页面不可保存，发送时也必须直接失败。
+6. 一个企业应用可以分别绑定移动、联通、电信通道组；可以只绑定其中一类或两类，但不能一个都不绑定。
+7. 发送时先按运营商识别结果分流：移动短信走移动通道组，联通短信走联通通道组，电信短信走电信通道组；识别不出的号码走移动通道组。
+8. 运营商识别优先使用可配置的号码前缀正则表达式，通常匹配手机号前 3 到 4 位；如当前没有配置能力，手机号段库需增加“运营商区分规则”配置。
+9. 路由规则只能表达应用到通道组的绑定关系，不能直接绑定单个通道，也不在规则层配置省份；省份和全国路由在通道组内部处理。
+10. 发送服务必须使用手机号段库识别手机号省份和城市；无法识别省份时走对应运营商的全国通道组路由。
+11. 通道组内必须先匹配省网路由；省网未匹配时走同一运营商通道组内的全国通道。省网发送失败后，当前版本立即跳到该通道组第一个全国通道补发，不再尝试同省第二省网通道。
+12. 省网配置当前版本一省只能配置一个通道；全国通道可配置多个，并按优先级依次补发。
+13. 未命中企业应用通道组或无可用通道时不得 fallback 到全局第一个 active 通道，应将该短信标记为 failed，并记录可读失败原因、trace 和系统日志；客户端本期不展示通道细节。
+14. 可发送通道必须同时满足：通道业务状态 active、CMPP 连接状态 online、当前连接数大于 0、心跳未失败；auth_failed、heartbeat_timeout、reconnecting、disconnected 或当前连接数为 0 的通道均不可被选中。
+15. 多连接通道只要至少 1 条连接 online 且可用即可参与路由；心跳失败应及时更新连接状态，连续 3 次心跳失败后进入重连，重连成功前不可发送。
+16. 通道异常时应支持熔断、降级、切换备用通道和失败重试；失败补发必须在同一企业应用授权的通道组范围内执行，并保证计费、退款、幂等和 trace 可追踪。
+17. 失败补发除以下情况外均应触发：短信状态为 unknown；距离客户提交时间超过 72 小时；距离客户提交时间超过通道组配置的补发时间上限；通道组关闭失败补发。
+18. 通道组补发时间上限由运营端配置，最大不得超过 72 小时；本期不配置最大补发次数、补发间隔或失败类型白名单。
+19. 提交 accepted 后立即按企业应用配置的客户费率扣费；补发过程中最终成功只扣一次，submit failed 未真正发出时释放冻结且不扣费；本期客户计费不使用通道成本价。
 
 ### 4.7 通道签名报备
 
@@ -462,12 +477,17 @@
 2. 拆分号码和变量，生成 message_record。
 3. 写入数据库并投递 send.queue。
 4. Send Worker 消费消息，校验黑名单、敏感词、限额。
-5. 路由选择通道。
-6. 通过通道限速器控制 TPS。
-7. 调用 Gateway Adapter 提交短信。
-8. 写入 submit 状态。
-9. Receipt Worker 接收回执并更新最终状态。
-10. 统计任务进度。
+5. 使用可配置号码前缀正则识别运营商；识别不出时按移动处理。
+6. 使用手机号段库识别号码省份和城市；识别不出省份时按全国路由处理。
+7. 按企业应用绑定的对应运营商通道组执行路由：先匹配省网通道，再匹配全国通道；不得直接绑定或 fallback 到非授权单通道。
+8. 过滤业务 disabled、连接离线、认证失败、心跳超时或无可用连接数的通道。
+9. 通过通道限速器控制 TPS。
+10. 调用 Gateway Adapter 提交短信。
+11. 写入 submit 状态。
+12. Submit rejected、submit timeout、Gateway 连接断开或未提交成功、receipt failed 等场景按通道组策略补发到下一可用全国通道；unknown、超过 72 小时、超过通道组补发时间上限或关闭补发时不再补发。
+13. Receipt Worker 接收回执并更新最终状态。
+14. 补发过程必须保持幂等、计费一致和 trace 可查，最终成功只扣一次客户费率。
+15. 统计任务进度。
 
 ### 8.3 500 条/秒实现建议