lislgosms/docs/client-ui-remediation-20260914.md

客户端页面与接口文档整改

2026-09-14 客户端页面与接口文档整理设计

本轮按用户要求提交、推送并部署测试环境；不操作预生产，不发送或重新入队短信。基于 main 7f9abe3 实施，发布包含上一轮引流运营商迁移，须独立复核兼容。

• 模板页添加按钮按内容宽度，工具栏使用输入+查询操作+新增三列，窄屏堆叠；正文固定 132px、14px 字体和纵向滚动，覆盖本需求对常规三行截断的例外。页脚使用公共 Button/DeleteRiskAction，移除本页对旧通用 footer 按钮样式的依赖，保留删除风险确认。编辑顺序为应用、名称、签名、内容；不再展示或发送 category，旧数据库分类保留，不清空历史数据。
• 接口文档新增独立客户端路由 /client/http-docs 和导航，从接口配置页移除文档 Tab。共享服务端 /api/client-docs 仍为唯一内容源；示例紧随所属正文，使用说明名称，不按数字分组。第 11 节示例按鉴权、发送、查询、上行、回调、错误处理归并，不修改签名协议/GET 兼容摘要、认证或安全边界。
• 工作台复用批次统一中文状态映射；最近批次列改为短信内容并读取 content，避免使用 category；保留详情入口及批次范围。
• 回执 Bug：测试库已送达记录存在 receiptStatus/deliveredAt，而分页投影未查询两字段，客户白名单视图输出 null。分页补两个主记录标量，不全量加载回执关联、不改回执消费/计费/数据。展示以消息最终聚合状态为准，时间统一北京时间；真实未收到回执保留空时间并明确显示暂无回执。
• 验收覆盖真实 API/PG 的有回执、无回执、失败回执与分页/租户边界；UI 三尺寸、首次进入/刷新/跨路由、长正文滚动、按钮 hover、编辑顺序、文档示例归属及检索/复制；完整测试、类型、构建、样式、安全/标准发布门禁。

2026-09-14 23:25 CST 测试发布与验收

• 应用提交 4665079ca3d2f985c85c5c1d08f8fe173047e9bd，已提交/推送并通过远端精确回读；包含此前 7f9abe3 的引流运营商报备变更。测试从 97d1334423 升级至本提交；未部署预生产。
• 精确 Git 归档候选：前端 31 文件/146 测试、后端 74 集/811 测试、前后端类型、格式、lint、style、CSS 15 项通过。工作区曾执行 812 后端测试，其中包含受保护未提交 metrics 测试，不能冒称归档候选结果。第一次候选前端有两个 worker 启动超时（29 文件/128 测试执行通过但整轮失败）；保留原日志，停止本轮已完成的本地隔离服务后，同候选完整复测通过，未调高超时或跳过用例。
• 标准计划 .local-data/releases/20260914T151450-4665079ca3d2-874a39f8/plan.json，复用同提交实际执行日志摘要，经 preflight → prepare → deploy → verify → report。远端 production 前端构建及 API 构建通过；工具目录为受保护未提交内容，独立摘要 cc01ce7d24ef4cc0a6a84a5f05d9219ff8f97b47cb8596869ea79c0dbf26d8db，未把应用 SHA 冒称工具版本。
• 只读复核同三条测试消息 http-cmu0xgl6o000k5mle3hrw4avd / http-cmu0wpxdc0059t8lerzyvyd5c / http-cmu0wpv740050t8le9ekgvfzs：数据库原有 delivered 与时间保持不变；已部署 OperationsMessageQueries.listClientMessagesPage 现在分别返回 delivered 和 07:34:41.935Z / 07:13:57.824Z / 07:13:55.013Z，原返回 null。该项是在服务器加载真实查询服务并访问 PostgreSQL，不冒充带登录鉴权的 HTTP 页面验收。
• 本地独立 PostgreSQL + 真实查询/配置/工作台服务 HTTP 适配器 + 实际 production 页面组件验收通过；适配器未启动 Nest 全局鉴权及发送 Worker。模板正文 132px、新增按钮 143px；编辑顺序正确且不提交分类；回执成功/失败/暂无回执与北京时间；工作台中文状态与正文；1600×1000、1366×768、390×844 无页面横向溢出。隔离夹具仅写本地库，没有发送短信。验收结束已停止本轮临时服务及独立 PG。
• 测试在线 /api/client-docs 三尺寸 HTTP 200，无 JS 页面错误/横向溢出，43 个示例内嵌正文、无数字示例切换按钮；SIGNATURE_INVALID 检索命中 1 节。HTTP 测试入口自动剪贴板复制不可用时实际选中文本并提示手动复制；本地受信任入口自动复制已验证。受保护客户端页面正常转登录。浏览器连接器再次返回 nodeRepl.fetch request failed，因此用独立 Chrome Playwright 验证；这不证明用户已有浏览器会话未登录。未获得客户端账号回复，线上登录后模板/工作台/详情全流程仍未执行，不恢复或创建账号。
• 线上 .deployed-commit 精确一致，API/Gateway/send-worker active，入口 200，标准队列/迁移/受保护文件/增量日志检查无警告。恢复备份 /var/backups/cmpp-platform/20260914T151450-4665079ca3d2-874a39f8-attempt-1789399125391792291，497029120 字节；仅验证可读性及摘要，未做恢复演练。
• 时长：候选前端复测 78.58 秒，后端全量 352.864 秒；远端准备 61.7 秒、备份 34.5 秒、stop 开始至 start 完成墙钟约 13.4 秒、内置 verify 5.3 秒。不能把本地验证、worker 故障处理、登录等待计为服务器停机。
• 容量：/dev/sda2 同时承载应用和备份，无本轮独立数据盘；发布前已用 79648636928 / 可用 20052152320 字节，发布后已用 81221177344 / 可用 18479611904，净增 1572540416（约 1.46 GiB）。当前程序 1029238784；发布目录合计 11551481856；备份根 7047651328；/var/log 992362496；/root/.npm 696639488 字节。上述父/子路径不能重复相加。本次发布目录约 1035001856 字节，含上一有效 97d1334 的 previous-dist 39653376、previous-api-dist 4734976、previous-api-node_modules 587194368、previous-source 2756608，源包 4288512；candidate-1789398992364860311 剩余 396275712 字节保留候选证据/依赖。历史 previous 目录与备份完整保留；未完成当前+上一有效版本的容量治理，不擅自清理。
• 证据：本机临时目录 cmpp-client-polish-20260914 中 browser-results.json/ui-evidence.json/live-docs-results.json/live-capacity.json 与截图；发布失败/复测日志保存在 .local-data/releases/20260914T145516-4665079ca3d2-62e921fe，标准 state/report 在最终计划目录。未发送、补发、重投或重新入队短信，未修改测试/预生产余额、通道、客户配置。