feat: 简化通道组顺序调整并过滤不可选通道

2026-09-06 15:54:27 +08:00
parent bd920f76b0
commit 69e3d7368d
12 changed files with 220 additions and 142 deletions
@@ -1,5 +1,15 @@
 # 通道组编辑交互优化方案

+## 2026-09-06 顺序交互调整
+
+本节替代下文优先级输入、拖拽及不可选项展示的旧交互。此次仅授权修改并本地提交，历史发布授权不延续到本轮。
+
+- 编辑页只展示顺序序号；全国通道仅通过上移/下移调整，撤销恢复最近一次排序。撤销与保存修改使用相同紧凑按钮宽度。
+- 添加/编辑弹窗不提供优先级或顺序输入；编辑保留当前位置，新增全国通道始终追加到末尾。普通历史优先级槽位保留；达到PostgreSQL整数上限而不能追加时，仅在当前草稿按原相对顺序压紧为连续整数后追加，保存前摘要提示顺序，失败保留草稿。
+- 待选列表只显示符合运营商、地区且未占用、未删除的通道；编辑当前成员时允许保留自身。搜索在可选集合内生效，省网先选省份，再呈现匹配项。沿用原规则：暂时断连和停用状态如允许配置仍真实标注，发送资格由后端校验，不把“可配置”说成“可发送”。
+- API继续提交真实priority字段，不变更表或补发算法。全国列表按priority升序；后端selectChannelCandidate在剔除已尝试、未报备及不可用通道后，选择最小priority。因此符合资格的全国通道按页面顺序首次尝试和补发，weight/isBackup不会覆盖不同priority的顺序。省网匹配优先、失败转全国等规则保持，不把不匹配省份当作顺序中的可用通道。
+- 验收覆盖首尾移动、撤销、追加/替换/保存失败、历史负数与最大整数、候选过滤及三尺寸按钮宽度；通过真实API/PostgreSQL只读配置和无副作用选路函数核对，不发送短信或保存现有业务通道组。单元隔离异常与真实环境结果分开记录。
+
 日期：2026-09-05。适用通道组新建与修改，用户已授权实施、提交推送及双环境发布。沿用TC-ADMIN-004路由语义，不改变真实通道价格、发送或计费规则。

 - 修正历史任意合法整数优先级回显；重复通道、归一化后重复省份及全国重复优先级明确报错，绝不删除或覆盖原行。弹窗确认只更新草稿。
@@ -2208,3 +2208,12 @@
 - 签名清退预警移至报备任务提醒，数量使用现有真实今日未读且未抑制汇总；不再计入预警中心。原侧栏入口保留，审核待办统计不变。
 - 报备任务提醒新增“报备进度提醒”禁用按钮和“待开发”标签，不提供跳转、虚构数量或假成功。后续真实进度能力需另行设计后端，本轮不实现。
 - 预警中心继续汇总安全检测与封禁、系统监控告警。三个一级按钮和弹层在1600×1000、1366×768、390×844均应完整可用。
+
+## 通道组顺序交互调整（2026-09-06）
+
+本节替代2026-09-05通道组交互中优先级输入、拖拽和不可选通道展示要求，设计见[channel-group-interaction-plan-20260905.md](channel-group-interaction-plan-20260905.md)同日调整节。
+
+- 编辑页仅显示顺序序号，不显示优先级；撤销排序与保存修改宽度一致（当前160px）。
+- 添加/编辑通道弹窗不允许设置顺序或优先级；新增全国通道固定追加末尾，编辑保留当前位置，调整只通过编辑页上移/下移，保留撤销功能。
+- 待选通道隐藏已占用、不支持运营商/地区、已删除的项；编辑当前成员可保留自身，搜索只在可选集合中进行。保留原可配置的停用/暂断连状态及真实提示，不等同发送资格。
+- 符合发送资格的全国通道按列表顺序首次尝试和补发，跳过已尝试、未报备和不可用通道；省网优先及失败转全国规则保持。优先级仅作为API兼容字段，整数上限时保持相对顺序压紧当前草稿后追加，不将新增项插到前面。
@@ -5130,3 +5130,18 @@ npm run verify:phase8
 | TC-REPORT-NOTICE-006 | 检查无通知配置的客户端壳层 | 不新增运营端报备提醒；不得为占位功能读取或制造客户端数据 |

 真实正数清退、失败/权限和客户端登录需有授权夹具/账号才可记为真实验收；本轮现有测试环境清退数为0，正数与失败分支使用单元测试隔离覆盖。
+
+## 通道组顺序与候选过滤用例（2026-09-06）
+
+本节替代TC-CHANNEL-GROUP-EDITOR-001的拖拽、002的优先级输入以及003的禁用项展示预期；保留原保存失败、部分创建重试、草稿保护及权限边界。
+
+| 编号 | 场景与步骤 | 预期结果 |
+|---|---|---|
+| TC-CHANNEL-ORDER-001 | 打开历史10/20顺序的通道组，上移第二条、下移第一条、撤销 | 仅显示1/2等顺序，无优先级或拖拽入口；顺序、预览及保存参数一致，首尾按钮正确禁用；撤销恢复最近一次排序 |
+| TC-CHANNEL-ORDER-002 | 添加全国通道，编辑已有成员，再保存或模拟保存失败 | 弹窗无顺序/优先级控件；新增永远末尾、编辑保留位置，API提交升序唯一priority；旧成员weight/isBackup保留，失败保留草稿 |
+| TC-CHANNEL-ORDER-003 | 历史负数、乱序返回、最大整数2147483647下追加 | 按原升序追加；上限耗尽时仅草稿按相对顺序压紧为连续整数，全部可持久化，不修改原对象或使新增项插队 |
+| TC-CHANNEL-ORDER-004 | 添加时包含已占用、其他运营商、已删除、地区不匹配通道；切换省份及搜索 | 不可选项完全不在待选列表；编辑自身可保留；省网先选省份再显示匹配项；显示真实可选数、无结果和无可添加通道空态 |
+| TC-CHANNEL-ORDER-005 | 以列表对应priority构造组成员，顺次排除已尝试通道调用无副作用后端选择函数 | 选择顺序与全国列表一致；主备/权重不覆盖不同priority；离线、未报备项跳过；此测试不发送或补发短信 |
+| TC-CHANNEL-ORDER-006 | 三尺寸首次进入、刷新、上移/下移/撤销、添加、搜索空态和跨路由切换 | 撤销和保存按钮宽度相同且紧凑；表格/弹窗可操作，无新增裁切或控制台异常；真实API验收不保存业务配置 |
+
+真实短信补发、真实保存业务通道组及真实权限/故障注入未授权时仍标记未执行；不能把纯函数、模拟保存或构建通过当作发送链投递验收。
@@ -4593,3 +4593,15 @@ git diff --check
 - 数据与账户：用户授权新建并保留`codex_qa_admin`（ID `cmtphgp340000yrle7v11jemc`，platform_admin、active），安全入口见[部署文档持久验收管理员节](production-deployment.md#测试环境持久验收管理员2026-09-06)。2026-09-06 15:32左右PostgreSQL短信记录仍119509，三条短信Stream的consumer/pending/last-delivered/entries-read/lag与验收前一致（pending/lag均0）。账号与受限凭据按要求保留，浏览器测试正常logout；未发送、补发、重投、重新入队短信或更改余额、通道、客户配置。
 - 证据：本机`%TEMP%/cmpp-report-notice-20260906`的before.json/png、after.json、reporting-1600/1366/390.png、browser.mjs、build.log。浏览器脚本只在内存读取安全凭据，不保存会话凭证或密码到报告。
 - 边界：真实清退正数、真实故障/权限注入和客户端账号登录未执行，正数/失败/无配置由隔离单元测试覆盖，不冒充真实验收；未为造数据改变历史消息状态。纯前端入口调整未重跑后端/Gateway全量测试与构建。仅授权本地提交，不推送、不部署测试或预生产；既有文档改动保持未提交。
+
+## 2026-09-06 通道组顺序与候选过滤调整（本地实现）
+
+- 起始main/HEAD为`bd920f7`，远端main重新核验为`442dda711d5c9f778f3f76fd6d8fd69f14414ce6`，本地领先1个提交，暂存空；原8份修改文档、3份未跟踪文档继续保护，本轮仅精确提交功能用例和本节增量。测试环境SSH回读部署标记442dda7，未访问预生产。
+- 只读复现：真实测试API的电信本地压测组`cmsvlitxw002pgdleix0hs04d`，PostgreSQL成员顺序为备用通道priority10、主通道priority20，weight均100；原添加弹窗仍有优先级输入，最初6项全部不可选却完整展示。旧nextAvailablePriority在Int上限时选择更小空位，可能导致新增通道插队。顺序撤销按钮是grid子项而默认拉满；保存按钮既有min-width为160px。
+- 修改：编辑页仅显示顺序，移除拖拽和弹窗优先级输入；新增通过appendNationalRoute在末尾分配顺序，上限时仅草稿按原相对顺序压紧，编辑成员保留位置。撤销与保存共用局部160px宽度类。候选列表先过滤不可选项，再搜索并显示可选总数；省份选项不从删除/不兼容/其他已占用通道产生。既有允许配置的停用/暂断连通道仍真实标注。未改历史CSS模块、import顺序或Stylelint例外。
+- 补发一致性：只读核对SendRetryService以attemptedChannelIds排除已尝试通道，并调用selectChannelForMessage；其selectChannelCandidate按资格过滤后取最小priority。全国顺序与后端一致，主备/权重只在同priority内影响选择，前端/后端均校验全国priority唯一；省网匹配优先与失败转全国保持。本轮无API运行时代码、数据库结构或队列改动，新增后端4项顺序回归覆盖乱序输入、历史负数/大整数、备用在前及不可用通道跳过。
+- 自动验证：定向前端3套24项、后端2套13项通过；最终前端全量18套95项、API全量56套624项通过。前端TypeScript、前后端生产构建、format:check、变更ESLint、quality:verify、Stylelint、CSS治理及15项测试、bundle:verify通过；保留既有Chart包体提示，入口gzip108.26KiB低于250KiB预算。当前shell无npm，使用已有Node执行package.json等价脚本；未新增依赖。实现时Array.at不符合现有TS lib，已改兼容数组索引。
+- 真实浏览器：Browser插件入口不可用，沿用前端测试技能与已有Playwright/Edge。用持久codex_qa_admin正常验证码登录，本地生产预览4173代理测试环境真实API；1600×1000、1366×768、390×844均完成首次进入/刷新、上移、撤销、新建草稿连续添加末尾、已加入项隐藏、搜索空态及路由切换，撤销/保存计算宽度均160px，console warning/error、pageerror、失败HTTP响应均0。截图复查列表仅顺序，窄屏弹窗及页脚可用。所有通道组写请求设置拦截，本轮只在前端草稿添加，不点击最终业务保存。账户保留并正常logout。
+- 动态环境：浏览器验收期间其他操作新增了一个真实停用通道，旧候选快照因此不再匹配；改为用当前页面实际收到的API响应核对过滤集合，未删除或改写该通道。只读数据库短信记录119509；三条短信Stream在核验时pending/lag均0且last-delivered/entries-read与本轮开始一致。未发送、补发、重投或重新入队短信，未修改余额、通道或客户配置。
+- 证据目录：本机`%TEMP%/cmpp-channel-order-20260906`内before.png、after.json、editor-1600/1366/390.png、choices-1600/1366/390.png、前后浏览器脚本、build.log和api-tests.log。首轮浏览器脚本修正了API路径/定位器及草稿beforeunload确认处理；不把脚本超时当作功能通过。图片、响应报告不含密码，认证文件沿用部署文档受限入口。
+- 验收边界：未真实保存现有通道组、未执行短信补发；参数映射/保存失败用组件隔离测试，补发顺序用真实代码、当前PostgreSQL/API顺序及无副作用策略测试交叉核对。无真实省网可选夹具，地区过滤和历史缺失项由组件测试覆盖；不冒充端到端投递或真实权限异常验收。仅本地提交，不推送、不部署测试或预生产。