feat: improve channel resilience and operations

docs/first-version-development-requirements.md

@@ -1643,3 +1643,22 @@
 - 号码基础校验只判断空值、字符、长度、数量上限、重复及多号码完整性；号段识别用于运营商和地区快照及路由提示，未知号段不得据此拒绝，必须继续按全国或三网兼容通道处理。
 - 预发布历史数据库仍为`SQL_ASCII`时，数据迁移不得使用可能把多字节UTF-8字符拆成单字节处理的正则字符类。中文签名修复必须同时校验主键和原始字节序列，并从迁移前备份恢复完整UTF-8；长期生产数据库必须规划迁移到`UTF8`编码。
 - 首次开通HTTP接口时，后端默认开启单条发送、状态查询、回执回调、上行查询、上行回调和客户端自助密钥六项能力，回执/上行投递默认为HTTP Webhook。参数复制必须包含应用名称、AppID、六项能力、基础地址、文档、QPS、白名单和真实投递方式。
+
+## 2026-07-23 供应商连接主动心跳与自动重连要求
+
+1. 供应商出站CMPP通道只要状态为`active`，首次连接失败、运行中断链、心跳超时或Gateway重启后都必须持续自动恢复到`desiredConnections`；不得依赖下一条短信触发惰性重连。
+2. Gateway必须主动向供应商发送`CMPP_ACTIVE_TEST`并按`Sequence_Id`确认`CMPP_ACTIVE_TEST_RESP`。默认30秒一次，连续3次未响应判定断链；间隔和阈值允许按通道配置。短信提交、回执响应和心跳写包必须串行，断链后旧读写循环必须退出。
+3. 网络类失败按5秒、15秒、30秒、60秒、2分钟、5分钟逐级退避并增加抖动，达到上限后持续重试；鉴权或凭据类失败仍持续重试，但默认降为5分钟一次。重连成功后清零失败次数和下次重连时间。
+4. API每30秒协调数据库期望状态与Gateway真实状态，以Redis租约避免多实例重复下发；连接数不足、心跳陈旧、失败且到期或状态缺失的活动通道需要重新下发连接意图。
+5. 手动停用或逻辑删除通道必须向Gateway发送`DisconnectChannel`，关闭连接池、主动心跳和重连监督器；协调任务还必须清理数据库状态与通道状态不一致的存量连接。重新启用或修改地址、端口、账号、密码、版本、窗口、连接数、心跳配置时立即使用新配置连接。
+6. `CmppConnectionState`必须记录重连次数、最近重连尝试、下次重连时间、错误分类和最近心跳。运营端允许配置心跳参数并展示重连次数、下次时间和最近错误。
+7. 多API实例并发恢复同一供应商通道时，数据库必须以`channelId + connectionId`的部分唯一索引约束`applicationId IS NULL`状态行；唯一冲突复用并更新既有状态，不得生成重复连接状态。
+## 2026-07-23 通道、应用、详单与报表口径补充
+
+- 新建上游短信通道默认端口为 `7890`；当前仅支持 CMPP，管理端和 API 均不得接受 HTTP/SGIP 作为通道协议。
+- 通道业务代码写入真实通道运行配置 `config.serviceId`，默认 `SMS`，限制为 1～10 个 ASCII 字符，并用于 Gateway CMPP `Service_Id`。
+- 新建企业应用的“每任务最大号码数”默认 `10000`，超过上限仍由后端整任务拒绝。
+- 安全控制的企业黑名单、全局黑名单和敏感词接口不得返回逻辑删除记录。
+- 所有日报表按 `SmsMessageRecord.billingUnits` 统计长短信分片条数，输出提交、发送、未知、成功、失败五项；平台拦截（`status=rejected`）计入提交但不计入发送，并保证 `发送=未知+成功+失败`。
+- 通道维度只存在已经路由到通道的记录，因此该维度的提交数等于发送数；应用、签名、引流信息和对账维度的提交数包含平台拦截。
+- 二级添加、编辑页面必须继续高亮其所属侧边菜单。