35 lines
8.5 KiB
Markdown
35 lines
8.5 KiB
Markdown
# 2026-09-21 六项运营功能整改
|
||
|
||
状态：实现及本机真实接口、页面验收完成，提交推送收尾。授权：本地修改、测试、提交、推送；不部署、不发送短信、不修改线上业务配置。基线main 28951b4，2026-09-21 19:25前回读实际远端main 001d5f2；推送将包含前一轮未报备统计修复及本次提交，其他会话未提交修改保留。
|
||
|
||
## 规则与实现范围
|
||
|
||
1. 模板：运营端和客户端复用Select的searchable；变量名仅ASCII英文字母和数字，保留1～32字符上限，不接受下划线、空格、汉字或其他符号，数字可以开头。自定义输入、正文占位符、API变量配置均校验；变量示例值仍可使用中文。已有模板不自动改写，编辑涉及变量/正文时按新规则校验。按用户随后更正，以“企业应用×模板名称”唯一，签名不同也不能同名；名称去首尾空格，非deleted状态均占用名称，已删除模板不占用，新建/编辑/恢复和并发保存由数据库部分唯一索引兜底，API返回明确中文冲突提示。不同应用同名允许。2026-09-21预生产只读检查有效模板按applicationId+btrim(name)重名组0；迁移不自动重命名或删除任何模板，目标环境若有新冲突则阻断迁移。
|
||
2. 首页：恢复今日24小时发送曲线，位于企业消费排行上方。沿用原曲线口径，按北京时间queuedAt小时汇总号码级业务短信数及其中最终delivered数，不把供应商补发计为新业务短信；来自真实PG当日范围查询，空小时补0，接口失败显示不可用/旧数据提示。通过现有首页summary加载，不重新调用旧的全量dashboard接口；返回hourlySendTrend，指标卡及其他快照逻辑保留。
|
||
3. 短信记录：“未知”筛选包含提交成功尚无最终送达结果的submitted以及历史unknown；不包含成功/失败/排队/拒绝，既有其他条件取交集。submitted显示“提交成功”，不变更真实业务状态或回执。
|
||
4. 签名质量：仅删除“签名通道发送质量”列表的通道提交列，调整该表统计说明；保留详情的提交尝试数及后端指标，避免改变其他统计口径。
|
||
5. 通道报备明细：拆分企业、应用、通道、报备对象四个独立文本搜索框，AND组合且各自仅匹配对应字段。报备对象按当前类型匹配签名或引流站点/URL。保留旧keyword接口兼容、时间/状态/运营商/类型条件、虚拟未报备行、详情/导出及分页，查询/重置回第一页，翻页使用已应用条件。
|
||
6. 通道运营商缩减：保存前列出移除的运营商并要求确认影响，提示将从这些运营商的全部通道组移除（含省网/全国），可能导致该组无可用通道；重新勾选/取消不写库。后端同一事务更新通道、按通道组carrier移除成员、记录移除关系审计，其他运营商组/组本体/企业应用路由/报备历史保持。能力变更不触发无关重连。成员写入的数据库约束锁定通道并检查组运营商兼容性，阻止并发通道组保存重新挂回已移除能力。事务失败整体回滚。替代此前“缩减能力仅跳过、不移除引用”的规则。
|
||
|
||
## 数据、权限与兼容
|
||
|
||
新增迁移仅增加模板名称部分唯一索引和通道组成员写入兼容性约束，无历史重写、余额/收费调整。迁移失败不自动resolve或清数据。应用回退不移除索引/约束，旧代码写入不兼容关系会被数据库拒绝。沿用既有运营端/客户端登录、权限及租户限定；前端提示不代替服务端校验。模板名称冲突返回400而非500。
|
||
|
||
## 验收
|
||
|
||
真实本机隔离PG全迁移、API与必要Redis；模板并发创建/更新、自编辑、跨应用、软删除重用、非法变量与中文示例；小时边界/零点/重复Submit；未知筛选的命中与排除；四搜索项组合及分页虚拟行；运营商移除、取消、回滚、并发成员写入、审计和保留项。页面1600×1000、1366×768、390×844首次进入/刷新/跨路由和相关交互，检查控制台及截图。Browser插件/对应browser技能不在清单，按前端测试技能使用已有Playwright，不安装依赖。定向+前后端全量、覆盖率、TypeScript/生产构建、格式/lint/样式/包体及diff门禁；精确提交候选与工作区结果区分。实际结果收尾追加，不将方案当已完成。
|
||
|
||
## 2026-09-21 本轮结果
|
||
|
||
- 根因：签名Select未启用通用搜索；变量校验允许下划线且前端缺少输入拦截；模板无应用名称唯一约束；新首页未接回旧小时序列；未知条件直接查unknown遗漏submitted；签名质量列表保留了不需要的列；报备查询只提供合并keyword；通道更新此前明确保留失配的通道组引用。
|
||
- 真实验收脚本：`tools/testing/verify-operations-six-fixes.mjs`，仅允许localhost专用数据库名。PG16.14隔离新库115项迁移通过（113项基线和本轮2项，不含其他会话未提交迁移）；Redis专用16452，真实Nest全局认证、PG、HTTP、前端production构建。无需文件上传/发送，未启动MinIO和Gateway，无任何网络短信发送。Redis5为既有本机版本，BullMQ版本建议提示保留；本轮只验证会话和配置查询，不作为队列/Gateway验收。
|
||
- 模板：运营与客户端均拒绝同应用跨签名重名；两个并发创建只有一个成功；首尾空格、自编辑、编辑重名、跨应用、删除后重用及恢复冲突通过；非法变量、数字开头和中文示例通过；未登录和客户端访问运营接口被拒绝。数据库唯一索引覆盖写竞争，迁移不自动处理历史重名。
|
||
- 小时与短信：真实24小时数据，北京零点包含、前日末排除、空桶为0；同业务多条供应商提交记录不增加小时业务量；真实首页summary一致。未知筛选只含submitted/unknown，浏览器真实请求参数为unknown且展示提交成功。
|
||
- 报备：企业/应用/通道/对象同时匹配；逐项不匹配均空；虚拟未报备记录保留，分页总数和第二页不同记录验证通过。签名质量真实页面三种尺寸均无通道提交表头。
|
||
- 通道：删除联通时全国与湖北成员均移除，移动/电信及4条应用路由保留，审计记录2条删除关系；强制审计失败触发整体回滚；真实第二数据库连接在通道更新期间写成员等待，提交后被兼容约束拒绝。页面不确认禁止保存、确认后可保存、关闭取消不写库。提示样式由同目录ChannelFormModal.css直接归属并登记所有权，不改历史CSS基线。
|
||
- 页面：1600×1000、1366×768、390×844覆盖首页刷新/图表位置、四个搜索框、模板签名搜索及粘贴非法变量、通道警示与取消、质量列表、未知筛选、跨路由；无pageerror。18张截图在`C:/Users/hectorzhao/AppData/Local/Temp/cmpp-operations-six-20260921-final/`，人工查看桌面首页与移动通道警示。截图为本机真实测试数据，不是预生产页面。
|
||
- 从暂存区导出精确候选`C:/cmpp-platform-local/operations-six-candidate-20260921`：前端38组179项、覆盖率语句88.48/分支85.09/函数84/行88.19；后端87组935项、覆盖率68.02/53.71/68.98/70.76，均达到现有门禁；前后端TypeScript与生产构建通过。lint无错误，保留10项既有any/Hook依赖警告；格式、样式、CSS所有权与15项治理测试、包体和staged diff检查通过，入口107.46KiB gzip低于250KiB预算。Gateway未改，不执行Go或线上链路测试。
|
||
- 原始日志：工作区`.local-data/operations-six-20260921/`与`C:/cmpp-platform-local/operations-six-*.log`；最终真实验收`operations-six-real-verified.log`。最初后端事务mock、浏览器控件定位/手机隐藏表头等待错误已修正；工作区并发覆盖率曾15项超时，精确候选maxWorkers=2、testTimeout=15000全通过。Windows导出CRLF造成格式检查失败，改用本次checkout-index进程级core.autocrlf=false导出提交内LF后通过，未改全局配置。旧拒收脚本中通道缩减断言同步新规则，未执行其发送命令生成流程。
|
||
- 边界：本次交付代码和两项迁移，未部署测试或预生产；目标环境真实页面、真实历史数据量下首页查询耗时以及迁移时新增重名检查仍需在获授权的发布流程核验。应用回退不会移除已执行的数据库约束。
|
||
- 增量覆盖率门禁另行执行87组935项通过，语句87.98/分支77.03/函数95.91/行91.22；专用PG和Redis已停止，隔离数据、产物和失败/成功日志保留。
|