fix: polish client templates docs dashboard and receipt display

2026-09-14 22:53:34 +08:00
parent 7f9abe3da0
commit 4665079ca3
22 changed files with 1305 additions and 762 deletions
@@ -0,0 +1,12 @@
+# 客户端页面与接口文档整改
+
+
+## 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、编辑顺序、文档示例归属及检索/复制；完整测试、类型、构建、样式、安全/标准发布门禁。
@@ -2302,3 +2302,8 @@ Webhook需在当前受支持Node运行时通过真实HTTPS投递；SSRF校验后
 - 引流报备按引流资料、通道、运营商独立配置，只有本运营商通过的通道可进入对应短信路由；显式未通过不能继承旧通道级通过状态。材料变化使旧审批失效。
 - 发送详情保留敏感词命中及明确异常，不显示正常的零命中检查；审计数据保留。
 - 兼容、迁移和验收以 [引流门禁方案第 11 节](drainage-send-gating-plan-20260910.md#11-2026-09-14-引流唯一性与通道运营商报备设计) 为准。
+
+
+## 2026-09-14 客户端页面与文档调整
+
+模板正文统一高度并纵向滚动，添加按钮按内容宽度，删除采用公共风险确认按钮；表单顺序为应用、模板名称、签名、内容，不再展示模板分类，历史分类不清空。接口文档使用独立客户端页面，所有示例紧随对应说明并按用途命名；工作台最近批次显示短信正文和统一中文状态；发送详情必须返回并显示真实回执状态与北京时间，未收到回执不伪造数据。设计与兼容边界见 [客户端整改设计](client-ui-remediation-20260914.md)。
@@ -5506,3 +5506,18 @@ HTTP-FULL-B02：去除URL IPv6方括号后区分IP字面量与DNS，DNS失败转
 | DRN-CARRIER-10 | 三尺寸首次打开、保存、刷新、切换详情；检查真实响应及数据库，不把隔离服务适配器视为完整认证/Gateway 验收。 |

 执行结果与未执行边界见 testing-progress.md 本日记录。
+
+
+## 2026-09-14 客户端整改验收
+
+| 编号 | 场景及预期 |
+|---|---|
+| CLIENT-0914-01 | 模板新增按钮宽度适配文字；长短正文均高 132px，长内容纵向滚动；删除 hover 沿用公共危险按钮，风险确认流程保留。 |
+| CLIENT-0914-02 | 新增/编辑依次显示应用、名称、签名、内容；无分类输入，提交不覆写历史 category；签名切换与变量插入保留。 |
+| CLIENT-0914-03 | /client/http-docs 独立导航、刷新可达；原接口对接页保留概览/凭据/回调/日志；无应用时仍能读文档。 |
+| CLIENT-0914-04 | 3.2 三步签名说明与五行原文/公式相邻；各接口参数后有具名示例，无编号示例切换或独立汇总章节；检索与复制正常且不执行请求。 |
+| CLIENT-0914-05 | 工作台列名短信内容，显示 content 而非 category；各批次状态使用共享中文映射。 |
+| CLIENT-0914-06 | 分页 API 返回 PG 主记录 receiptStatus/deliveredAt，租户条件保持，不加载全量回执关系；成功、失败、未回执三种展示正确；UTC 07:34:41 显示北京时间 15:34:41。 |
+| CLIENT-0914-07 | 最终聚合回执优先于旧尝试回执；无回执显示暂无回执且时间为空；三尺寸、刷新、路由切换和查询/分页语义回归。 |
+
+执行证据与在线验收边界见 testing-progress.md 本轮记录。
@@ -4997,3 +4997,15 @@ HTTP-FULL-B02：去除URL IPv6方括号后区分IP字面量与DNS，DNS失败转
 - 本轮仅本地修改、文档和本地提交；未推送、未部署测试、未部署预生产。迁移和代码未在两套线上环境生效。提交号见本条记录所在提交；最终汇报提供精确 SHA。
 - 隔离 HTTP 适配器直接调用真实业务服务与 PG，不包含完整 Nest 全局认证、生产反向代理和 worker；不得将其当作在线全功能验收。测试环境/预生产完整登录页面、权限与租户隔离在线回归、MinIO 报备文件导出/导入实物、Redis/Gateway 实际短信发送与计费闭环本轮未执行。原链路单元回归通过不替代物理发送专项验收。
 - 53 项已有保护文件在最终核对中保持摘要（仅本轮文档采用追加并精确暂存）；其余脏文件和草稿不纳入提交。历史重复资料不自动清理，历史通道级审批不批量重写。上线须先按标准发布流程执行新索引迁移，回退不可直接删除三网任务或重建旧索引。
+
+
+## 2026-09-14 客户端模板、接口文档、工作台与回执整改（发布前）
+
+- 起点 main 7f9abe3，实际远端 ac64490，测试机 97d133442350b9725422ed4e55386f47e37004fd。用户明确要求修改、提交、推送、测试部署；预生产、短信发送/重投、客户配置变更不在范围。测试发布包含上一轮引流三网报备提交和 20260914093000_drainage_carrier_reports 兼容迁移。既有 metrics、tools/release 和文档草稿全部保护。
+- 只读根因：测试库 http-cmu0xgl6o000k5mle3hrw4avd 为 delivered，receiptStatus=delivered、deliveredAt=2026-09-14T07:34:41.935Z，回执表原码 DELIVRD；另外两条送达样本一致。旧 listClientMessagesPage 投影三条均 receiptStatus=null、deliveredAt=null、receiptRecords=[]，因 listMessagesPage 未选择回执标量。仅补主记录两个标量，不加载全量尝试关系，不改消息状态/回执消费/账务。页面优先聚合最终回执并格式化北京时间。
+- 模板 toolbar 改为输入/查询操作/添加三列、窄屏堆叠；正文 132px 纵向滚动；页脚脱离 legacy button 规则，使用公共按钮和原风险确认流程；表单应用、名称、签名、内容，不提交 category，历史值保留。
+- /client/http-docs 独立路由与菜单；原接口配置页移除文档 Tab，保留其余功能。读者把示例移回所属正文，取消编号侧栏切换；第 11 节示例分配回鉴权与各接口章节，3.2 重写为三个步骤，37 段非 text 示例哈希逐一保持。新页面与 CSS 同目录登记所有权。
+- 工作台复用 batchTaskStatusMeta/normalizeBatchTaskStatus，短信内容列读取 content。设计见 client-ui-remediation-20260914.md，用例 CLIENT-0914-01 至 07。
+- 本地 API 74 suites / 812 tests 通过，API 构建通过；前端最终 31 files / 146 tests（maxWorkers=2）通过，类型/生产构建通过；代码 Lint 无错误（3 条旧依赖/any 提示），Stylelint、CSS治理15项、格式、包体及安全门禁通过。保留初始 worker 启动超时、回执标签断言、类型错误、CSS所有权/语法失败，后续修正和重测分开记录。精确发布候选仍需标准 validate。
+- 浏览器连接器仍 nodeRepl.fetch request failed；使用已安装 Playwright/Chrome。独立本地 PG 16414 + 真实服务 HTTP 适配器16419 + production preview16420，未启动 Gateway/发送Worker：模板长短正文高度均132px、按钮143px，三尺寸1600×1000/1366×768/390×844无横向溢出；编辑顺序、删除hover、真实回执成功/失败/空值及15:34:41时间、工作台正文/已完成、文档三步示例、检索与复制通过。复制未执行请求。此为真实服务组件验收，非完整在线登录/鉴权验收。
+- 本机证据 %TEMP%/cmpp-client-polish-20260914：api-full.log、frontend-final.log、css-final.log、style-final.log、format-final.log、browser-results.json 与 templates/receipts/home/docs 三尺寸截图。隔离库仅使用本轮专用样本；测试线上只读抽样。客户端登录账号尚待用户提供，不恢复旧账号、不造认证会话；在线页面与发布结果后续追加。