fix: harden channel retry attribution and operations UI

2026-07-26 21:33:58 +08:00
parent 059b38e8fe
commit 0857de09d8
27 changed files with 888 additions and 117 deletions
@@ -1721,3 +1721,32 @@
 7. 模板变量异常指本次发送缺少模板必填变量或传入模板未定义变量。该校验保留为不可配置的确定性拒绝，返回明确的缺失/多传变量原因，不进入人工审核；模板创建时的人工审核不能替代每次发送的变量完整性校验。
 8. 短信审核页面只展示待人工审核和人工审核记录；自动放行和自动拒绝不得混入“人工通过/人工驳回”。号码数量可点击查看真实号码明细，字段仅为手机号码、号码归属地、运营商和短信记录状态，并提供服务端搜索与分页。
 9. 创建待审核批次时，每条待审`SmsMessageRecord.reviewTaskId`必须同步保存。人工通过或驳回应同时兼容短信直连审核任务和`SmsBatchTask.riskTaskId`关联路径，保证审核任务、批次、短信状态及入队/拒绝动作一致；本次不修复或补发升级前历史异常数据。
+## 2026-07-26 编号名称统一补充要求
+
+- `SmsBatchTask.taskNo`在运营端短信任务进度、客户端批量任务、客户端首页及发送成功提示中统一显示为“发送批次号”，不得再显示为笼统的“任务编号”或“批次编号”。
+- `SmsSendTask.taskNo`在短信审核列表、筛选、详情及号码明细标题中统一显示为“审核任务号”。
+- 报备任务及其状态记录中的任务标识统一显示为“报备任务号”。
+- 数据库内部主键、发送批次号、审核任务号、报备任务号和协议`Msg_Id`保持原有数据结构与编号格式，本次只统一用户可见名称，不做字段迁移。
+## 2026-07-26 企业删除拦截提示补充要求
+
+- 删除企业或变更企业状态被后端业务规则拦截时，错误必须显示在当前确认弹窗内，弹窗保持打开；不得只写入被遮挡的页面级错误区域。
+- 请求处理中禁用确认、取消及弹窗关闭操作，避免重复提交；仅在操作成功后关闭弹窗并刷新企业列表。
+- 企业仍有启用或停用中的应用时，必须展示后端返回的应用数量和“先完成应用停用”提示。
+
+## 2026-07-26 运营页面细节与通道重连补充要求
+
+1. 企业签名和引流信息报备状态中，通道运营商必须显示为移动、联通、电信或全网等中文名称；目标通道使用真实通道名称展示，不得用内部通道编号替代。
+2. 短信上行列表为上行内容保留足够列宽，列表可展示最多三行并在表格容器内横向滚动；完整内容继续以详情为准。
+3. 编辑启用中的通道时，仅当网关地址、端口、账号、密码、CMPP版本、连接数、窗口或心跳参数的实际值发生变化才请求重连。名称、运营商、地区、单价、服务号、扩展位、企业代码及TPS限速等业务参数不得触发重连；启用和停用状态变更仍按原规则连接或断开。
+4. 运营端短信记录首次进入及点击重置后，默认查询北京时间昨天和今天两天，仍允许用户选择其他日期。
+5. 下游投递详情按时间线卡片展示每次投递，分别呈现中文状态、发送/ACK/截止时间、连接ID、Sequence_Id、Msg_Id、ACK Result和错误，不使用需要横向滚动的宽表。
+6. Gateway提交异常列表标题区域必须与容器边框、表格留出清晰间距，并展示当前结果总数；分页区域具有独立分隔。
+7. 原提议的报表“T-4未知转失败”本轮明确取消，不改变既有日报未知状态、重算逻辑或历史数据。
+
+## 2026-07-26 通道补发归因与发送详情补充要求
+
+1. 模板短信和直接签名短信必须使用短信记录保存的真实`signatureId`进行通道路由及失败补发，不得要求直接签名短信必须存在模板；无法选出备用通道时必须写结构化原因、已尝试通道和通道组信息，禁止静默吞掉异常。
+2. Gateway返回的每条聚合和逐分片提交结果必须携带连接命令原始`submitId`。API必须按`submitId`精确更新一次`SmsSubmitRecord`；滚动升级期间收到不含`submitId`的旧结果时，只能在短信记录、通道和提交尝试构成唯一候选时兼容，零个或多个候选必须拒绝并记录日志，禁止批量覆盖历史尝试。
+3. 迟到的旧尝试结果只允许更新其对应提交尝试和分片审计，不得覆盖短信主记录当前尝试的通道、上游消息号或终态。
+4. 发送详情中的“通道发送与回执”必须优先按`SmsMessageSegmentAudit.submitId`重建逐次尝试，显示每次真实通道、发送时间、提交结果及各分片回执；不得用短信主记录最终通道回填所有历史尝试。
+5. 通道组成员顺序、优先级、权重或主备关系变更必须写操作审计，保存修改前后有序成员及真实通道名称，便于解释某条短信发送当时使用的路由配置。
@@ -3853,3 +3853,45 @@ npm run verify:phase8
 - `SMS-REVIEW-010`：点击号码数量后，通过真实后端分页查看手机号码、归属地、运营商和短信状态；号码搜索与10/20/50条分页正确，接口同时兼容`reviewTaskId`和批次`riskTaskId`关联。
 - `SMS-REVIEW-011`：客户端和CMPP待审核任务创建时短信记录保存`reviewTaskId`；人工通过后短信由`pending_review`转为`queued`并入队，人工驳回后转拒绝且执行既有资金释放，不能只更新审核任务。
 - `SMS-REVIEW-012`：升级前历史`pending_review`异常记录保持原样，不执行数据修复或短信补发；升级后新任务不再产生审核任务与短信状态不一致。
+## 2026-07-26 发送批次号与任务号命名用例
+
+| 用例编号 | 场景 | 预期结果 |
+|---|---|---|
+| TC-ID-NAME-001 | 查看运营端短信任务进度 | 列表、查询条件和详情均使用“发送批次号”，显示真实`SmsBatchTask.taskNo` |
+| TC-ID-NAME-002 | 查看客户端批量任务、首页和发送成功提示 | 统一使用“发送批次号”，不再出现“任务编号”或“批次编号” |
+| TC-ID-NAME-003 | 查看短信审核列表、详情和号码明细 | 显示真实`SmsSendTask.taskNo`并统一命名为“审核任务号”，可按该编号筛选 |
+| TC-ID-NAME-004 | 查看报备任务及报备记录 | 列表、筛选和详情统一使用“报备任务号” |
+| TC-ID-NAME-005 | 验证接口和数据库兼容性 | 仅修改展示文案，不改变现有ID、`taskNo`、关联关系或协议`Msg_Id` |
+## 2026-07-26 企业删除拦截提示用例
+
+| 用例编号 | 场景 | 预期结果 |
+|---|---|---|
+| TC-TENANT-DELETE-001 | 删除仍有启用或停用中应用的企业 | 后端拒绝删除，确认弹窗保持打开，并在弹窗内显示应用数量及先停用应用的原因 |
+| TC-TENANT-DELETE-002 | 删除请求处理中重复点击或关闭弹窗 | 确认、取消和关闭均被禁用，不产生重复请求 |
+| TC-TENANT-DELETE-003 | 删除无阻塞依赖的企业 | 删除成功后才关闭弹窗，并刷新企业列表 |
+
+## 2026-07-26 运营页面细节与通道重连用例
+
+| 用例编号 | 场景 | 预期结果 |
+|---|---|---|
+| TC-OPS-UI-001 | 查看企业签名及引流信息报备状态 | 运营商以中文显示，目标通道显示真实名称，不出现内部通道编号替代名称 |
+| TC-OPS-UI-002 | 查看较长的短信上行内容 | 内容列宽不被其他列挤窄，可展示最多三行，完整内容可在详情查看 |
+| TC-CHANNEL-RECONNECT-003 | 仅修改启用中通道的名称、单价、运营商或TPS | 保存成功且不创建连接中状态、不发送Gateway连接控制请求 |
+| TC-CHANNEL-RECONNECT-004 | 前端提交包含未变化连接参数的完整通道表单 | 按修改前后实际值判断，不发送无效重连请求 |
+| TC-CHANNEL-RECONNECT-005 | 修改网关地址、账号、连接数、窗口或心跳参数 | 保存后发送连接控制请求；停用/启用仍正确断开/连接 |
+| TC-SMS-RECORD-006 | 首次进入短信记录或点击重置 | 日期默认覆盖北京时间昨天和今天，并以该范围请求真实后端 |
+| TC-DOWNSTREAM-UI-007 | 查看包含多次投递的下游投递详情 | 每次投递按纵向时间线展示中文状态、时间、连接和ACK证据，窄屏无需横向滚动 |
+| TC-GATEWAY-UI-008 | 查看Gateway提交异常列表 | 标题、说明、总数、表格和分页层次清晰，不紧贴容器边框 |
+| TC-REPORT-SCOPE-009 | 检查本轮报表变更范围 | T-4未知转失败未实现，日报未知口径和历史数据保持不变 |
+
+## 2026-07-26 通道补发归因与发送详情用例
+
+| 用例编号 | 场景 | 预期结果 |
+|---|---|---|
+| TC-RETRY-ROUTE-001 | 直接签名短信在首通道失败，签名在同组备用通道已报备通过 | 使用短信记录`signatureId`选中备用通道；无需模板；日志记录开始、选择结果和尝试通道 |
+| TC-RETRY-ROUTE-002 | 模板短信在首通道失败，备用通道不可用或未报备 | 不创建伪补发；结构化日志记录失败原因、通道组和已尝试通道，不静默吞错 |
+| TC-SUBMIT-ATTR-003 | 同一短信先后经两个通道提交，旧尝试的聚合结果迟到 | Gateway携带原始`submitId`；API只更新对应`SmsSubmitRecord`，不覆盖当前尝试主记录 |
+| TC-SUBMIT-ATTR-004 | 滚动升级期间收到不含`submitId`的聚合或分片结果 | 唯一候选时兼容并告警；零个或多个候选时返回失败、写歧义日志且不批量更新 |
+| TC-SUBMIT-ATTR-005 | 两分片长短信在通道A失败后由通道B补发 | 每个分片结果归属正确`submitId`和通道；任一迟到结果不污染另一尝试 |
+| TC-SMS-DETAIL-006 | 查看先经富泷失败、再经铁布衫失败的历史短信详情 | “通道发送与回执”显示两次真实通道及各自分片回执，不把两行都显示为最终通道 |
+| TC-CHANNEL-GROUP-007 | 调整通道组成员顺序、优先级、权重或主备 | 操作日志保存修改前后有序成员、通道编号和名称，可还原短信发送时配置 |
@@ -2490,3 +2490,37 @@ git diff --check
 - 新待审核短信同步保存`reviewTaskId`，审核决定同时按短信直连和批次`riskTaskId`查找，修复审核任务已通过而短信仍`pending_review`。遵照要求不改写现存历史异常数据、不补发历史短信。
 - 用户登录标识改为“仅未删除记录唯一”后，部署管理员初始化与真实环境冒烟脚本同步从`username`唯一`upsert`改为先查询未删除用户、再按主键更新或创建，避免迁移后Prisma拒绝旧的唯一查询。
 - 发布前门禁阶段结果：Prisma format/generate/validate通过；风险审核+发送链定向2 suites / 108 tests通过，随后补充应用覆盖、号码分页与逐号码拦截用例；API全量26 suites / 338 tests、API TypeScript build、前端TypeScript/Vite生产构建、Gateway `go test ./...`/`go vet ./...`、依赖安全门禁通过。API保留既有Redis不可用容错告警与`--forceExit`提示，前端保留约1.95MB单chunk/584.70KB gzip提示。
+## 2026-07-26 发送批次号与任务号命名统一（本地未提交、未部署）
+
+- 运营端短信任务进度、客户端批量任务、客户端首页及发送成功提示统一把`SmsBatchTask.taskNo`展示为“发送批次号”；同步修改查询标签、占位提示、详情标题和终止失败提示。
+- 短信审核列表新增“审核任务号”列，筛选、详情和号码明细标题统一展示`SmsSendTask.taskNo`；不新增接口请求或浏览器派生数据。
+- 报备任务和报备记录的列表、筛选及详情统一使用“报备任务号”。本次不修改数据库字段、编号格式、关联关系或协议消息ID。
+- Node.js v24.14.0下前端TypeScript检查、Vite生产构建和`git diff --check`通过；构建保留既有约1.95MB单chunk/584.75KB gzip提示。应用内浏览器访问本地短信任务进度路由时，未登录会话由真实鉴权守卫引导到运营登录页，标题、表单交互和控制台0条error/warn通过；图形验证码阻止登录后页面验收，未绕过认证或把登录页冒充目标页面。
+- 本轮按要求保持本地未提交、未推送、未部署；`api/tsconfig.build.tsbuildinfo`、`tsconfig.tsbuildinfo`、`outputs/`及未跟踪空文件`=`继续作为既有构建/临时产物隔离。
+## 2026-07-26 企业删除拦截提示修复（本地未提交、未部署）
+
+- 后端原本已在企业仍有`active/disabling`应用时返回具体数量和“先完成应用停用”提示；运营端此前仅把失败写入弹窗背后的页面级错误，用户几乎不可见。
+- 企业删除/状态变更确认弹窗新增独立错误和请求中状态：失败保持弹窗并就地显示原因；请求期间禁用确认、取消及关闭；成功后才关闭并刷新列表。实现复用用户管理最后管理员拦截的交互口径。
+- Node.js v24.14.0下前端TypeScript检查、Vite生产构建和`git diff --check`通过，保留既有约1.95MB单chunk/584.92KB gzip提示。应用内浏览器访问本地企业管理路由时由真实鉴权守卫引导到图形验证码登录页，页面完整、输入交互正常且控制台0条error/warn；未绕过认证，登录后的拦截弹窗仍需有效运营会话补充可见验收。
+- 本节仅记录本地修改；未提交、未推送、未部署。
+
+## 2026-07-26 运营页面细节与通道重连收敛（本地未提交、未部署）
+
+- 企业签名及引流信息报备状态将运营商映射为中文，并使用目标通道真实名称替代内部通道编号；展示忠实反映实际通道关联，不根据签名名称猜测运营商。
+- 短信上行内容列扩大到360px并最多展示三行，表格最小宽度同步增加；短信记录首次加载及重置默认查询北京时间昨天和今天。
+- 下游投递详情把逐次投递宽表改为纵向时间线卡片，中文展示等待确认、已确认、拒绝和失败状态，并分组展示发送/ACK/截止时间、连接、Sequence_Id、Msg_Id、ACK Result和错误。
+- Gateway提交异常列表新增带间距和分隔的标题区、结果总数及分页分隔，解决标题和边框紧贴的问题。
+- 通道更新改为比较修改前后实际连接参数；仅网关地址、端口、账号/密码、CMPP版本、连接数、窗口和心跳参数变化时请求重连。名称、价格、运营商、地区、服务号、扩展位及TPS等非连接参数不触发连接控制，状态启停逻辑不变。
+- 按最新要求取消日报T-4未知转失败，本轮未修改报表重算、未知口径或历史数据。
+- Node.js v24.14.0下通道服务定向1 suite / 40 tests、API TypeScript build、前端TypeScript检查、Vite生产构建及`git diff --check`通过。Jest仅保留既有Redis不可用容错告警和`--forceExit`异步句柄提示，前端保留既有约1.95MB单chunk/585.35KB gzip提示。
+- 应用内浏览器分别以默认桌面和390×844视口访问本地短信记录路由，真实认证守卫均引导至运营登录页；页面非空、无框架错误覆盖、控制台0条error/warn，输入框交互正常，移动端`scrollWidth=clientWidth=390`。未绕过图形验证码，因此六个登录后目标页面的最终视觉和真实数据验收仍需有效运营会话复核。
+- 本轮按要求保持未提交、未推送、未部署；工作区原有用户管理、编号命名、依赖安全整改、构建产物及临时文件保持原样。
+
+## 2026-07-26 通道补发归因与发送详情修复（发布前）
+
+- 预生产只读核对`13901860234 / 17:53:46`：首轮富泷物业-移动两个分片均提交成功后返回`FLBLACK`，随后会员营销-铁布衫补发并返回`WL:FSNM`。详情把两次尝试都显示为铁布衫，是因为接口未返回提交/回执关联通道且前端使用短信主记录最终通道兜底；后续仅显示一个通道，是直接签名短信没有模板时补发签名解析失败并被空`catch`吞掉，与18:01通道顺序调整只是时间相关而非真实原因。
+- 直接签名和模板短信统一从短信记录解析真实`signatureId`；补发开始、跳过、选中和失败均输出结构化日志，包含消息、通道组、尝试通道、限制时间和异常原因。
+- Gateway聚合及逐分片提交结果携带原始`submitId`，API按提交记录主键精确更新。旧Gateway缺少`submitId`时只允许严格唯一候选兼容；歧义结果拒绝并记录，不再按短信批量覆盖多个尝试。迟到旧尝试结果只更新对应提交审计，不倒写当前短信尝试。
+- 运营短信接口返回提交及回执关联通道；详情优先按分片审计的`submitId`重建逐次通道、发送时间、提交状态和分片回执，因此既有17:53记录可还原为富泷到铁布衫两次真实尝试。
+- 通道组更新新增修改前后有序成员操作日志，包含通道编号、名称、运营商、地区、优先级、权重和主备，可审计顺序变化。
+- 定向验证已通过发送链1 suite / 98 tests（含直接签名备用通道、聚合及分片歧义拒绝）、通道和运营接口专项以及Gateway消息透传专项。最终发布门禁通过：API全量26 suites / 343 tests、API TypeScript build、Prisma format/validate、前端TypeScript/Vite生产构建、Gateway `go test ./...`/`go vet ./...`、依赖安全门禁及`git diff --check`；前端仅保留既有约1.95MB单chunk提示。提交、推送和预生产部署结果将在发布完成后补记。