V2.18.1 账单模块优化复测报告

23条：12通过、3失败、1待复测、4部分验证、3阻塞。尚未整体验收通过。

PDF已从指定按钮生成并核对本次下载文件；列表XLSX已保存核对。本轮未复现3808。

本轮记录32条订阅账单相关响应，业务code均为200。实际部署提交号未核实。当前样本：1张10月待付账单、1台计费设备、分销商租户。

更新时间：2026-10-17 15:20:28 +08:00

完整Markdown报告 · 本次PDF · 本次列表导出

失败及补测范围

TC-21：已本地修复，待环境复测。表头“车牌”已改为“车辆”，3项PDF文档测试通过；代码已提交推送（2627de04af），尚未合并、部署，历史PDF不代表修复后效果。

失败：TC-13标题为文件名；TC-15页头及全部设备数标签；TC-23仍有固定脚注。PDF文案和脚注按附件判定，口径冲突需先统一。

未覆盖：第2页复位、多账期多状态、大批量设备分页、关闭管控、无设备组织和非分销商样本。详细步骤、请求sid、管控字段口径及补测条件见完整报告。Jev仅辅助分类，最终结论依据现场证据。

TC-01 通过 检查订阅账单列表工具栏新增账期与状态筛选

工具栏有账期起止、状态多选、账单号搜索及导出入口。

原用例步骤与预期
  1. 1. 登录系统并打开订阅账单列表页

    a. 成功打开订阅账单列表

  2. 2. 核对工具栏筛选条件与既有入口

    b. 工具栏展示账期与状态筛选，账单号搜索与导出按钮仍保留

scoped-default.png

scoped-default.png

TC-02 通过 检查账期为空时不按账期过滤

默认账期为空。GET /subscription-bill/page 不带账期参数，业务code=200，返回当前可见全部1张10月账单。多账期数据未覆盖。

原用例步骤与预期
  1. 1. 打开订阅账单列表确认账期筛选为空

    a. 账期筛选默认为空

  2. 2. 核对列表是否展示全部账期账单

    b. 不按账期过滤，列表展示全部账期账单

scoped-default.png list-api-evidence.json

scoped-default.png

TC-03 部分验证 检查选定账期起止年月后含边界月筛选

10月起止同月请求返回10月账单，9月同月请求code=200且total=0，含边界月及排除范围外月份已验证。当前仅1张账单，第2页复位和跨月双边界未覆盖。

原用例步骤与预期
  1. 1. 在账期筛选选定起止年月范围

    a. 列表按账期条件刷新，分页回到第一页

  2. 2. 核对列表账单月份是否均落在该范围内

    b. 仅展示账单月份落在起止范围内的账单，含起止月本身

08-status-or.png scoped-september.png list-api-evidence.json

08-status-or.pngscoped-september.png

TC-05 通过 检查状态筛选项为待付已付逾期

状态下拉仅待付、已付、逾期，支持多选，与当前列表待付文案一致。

原用例步骤与预期
  1. 1. 打开状态筛选下拉

    a. 状态为下拉多选

  2. 2. 核对选项文案

    b. 选项仅为待付、已付、逾期，选项文案与列表账单状态列一致

08-status-or.png

08-status-or.png

TC-06 部分验证 检查状态多选为或关系展示命中任一状态的账单

10月+已付时code=200,total=0；加入待付后请求同时携带PAID/PENDING并返回待付账单，OR关系已验证。缺少已付实单及第2页，双向数据和分页复位未覆盖。

原用例步骤与预期
  1. 1. 在状态筛选同时勾选待付与已付

    a. 列表刷新并回到第一页

  2. 2. 核对列表结果是否要求同时满足全部已选状态

    b. 满足待付或已付任一状态的账单均可出现，不要求同时满足全部已选状态

07-paid-empty.png 08-status-or.png list-api-evidence.json

07-paid-empty.png08-status-or.png

TC-07 通过 检查状态为空时不按状态过滤

默认状态为空；分页请求不带statusList，code=200返回当前全部1张待付账单。其他状态样本未覆盖。

原用例步骤与预期
  1. 1. 确认状态筛选未选任何状态

    a. 状态筛选默认为空

  2. 2. 核对列表是否展示全部状态账单

    b. 不按状态过滤，列表展示全部状态账单

scoped-default.png list-api-evidence.json

scoped-default.png

TC-08 通过 检查账期状态与账单号搜索组合取交集

10月+待付/已付+NO_MATCH_SELFTEST返回code=200,total=0；换为真实账单号后返回code=200,total=1。请求参数和行内容吻合。

原用例步骤与预期
  1. 1. 同时设置账期范围、状态多选与账单号搜索

    a. 列表按当前条件刷新

  2. 2. 核对列表结果是否为三条件交集

    b. 结果仅为同时满足账期、状态与账单号条件的账单

09-combined-empty.png 10-combined-sort.png list-api-evidence.json

09-combined-empty.png10-combined-sort.png

TC-09 部分验证 检查筛选变更后排序保持不变

净额升序后，将待付/已付变更为仅待付，aria-sort仍为ascending，请求仍含sortField=netAmountMinor&sortOrder=ASC。没有第2页和多行排序样本。

原用例步骤与预期
  1. 1. 记录当前排序字段与方向

    a. 分页回到第一页

  2. 2. 变更账期或状态筛选后核对分页与排序

    b. 当前排序字段与方向保持不变

10-combined-sort.png list-api-evidence.json

10-combined-sort.png

TC-10 通过 检查总览区指标卡片不受账期状态筛选影响

9月、已付、不匹配账单号筛选使列表为空时，四卡片仍为待付2.87 USD、当月2.87 USD、下次2026-11-16、当年支付0.00 USD，与基线一致。

原用例步骤与预期
  1. 1. 记录筛选前总览区四张指标卡片数值

    a. 列表明细随筛选刷新

  2. 2. 变更账期或状态筛选后再次核对总览区

    b. 总览区四张指标卡片数值不随本次筛选变化

scoped-default.png scoped-september.png 07-paid-empty.png 09-combined-empty.png

scoped-default.pngscoped-september.png07-paid-empty.png09-combined-empty.png

TC-11 通过 检查列表导出内容为当前筛选结果范围

导出任务订阅账单_20261017074455成功，XLSX已下载。数据工作表仅1行BILL2026100018232；导出条件工作表记录账期2026-10~2026-10、状态待付、目标关键字、数据行数1，与筛选集合一致。仅单账单样本，尚不能证明多账单剔除场景。

原用例步骤与预期
  1. 1. 记录当前筛选后列表账单集合

    a. 导出操作成功

  2. 2. 点击工具栏导出并核对导出文件账单范围

    b. 导出文件账单范围与当前筛选结果一致

11-list-export-success.png 订阅账单_20261017074455.xlsx xlsx-inspection.json

11-list-export-success.png

TC-12 通过 检查按组织Tab点击组织行打开费用明细弹窗

实际Tab名为按子组织，表无操作列或费用明细链接；点击streamaxlipiao主体行，打开设备订阅费用弹窗，org-cost接口code=200。Tab命名差异留作口径说明。

原用例步骤与预期
  1. 1. 点击某一组织行

    a. 打开组织费用明细弹窗

  2. 2. 核对是否出现操作栏费用明细链接

    b. 列表无操作栏费用明细入口

12-org-table.png 13-org-modal-reopened.png list-api-evidence.json

12-org-table.png13-org-modal-reopened.png

TC-13 失败 检查导出以blob新标签直开组织费用明细PDF

已从用户圈出的组织费用弹窗导出，生成新的blob标签；overview及org-cost接口code=200，本次下载文件为有效1页PDF，未进入编辑器。但新标签及PDF元数据标题均为BILL2026100018232_20261017064100_orgexpense.pdf，不符合用例要求的组织费用明细 · PDF。

原用例步骤与预期
  1. 1. 点击弹窗导出按钮

    a. 以blob URL新开浏览器标签页直开PDF预览，不在当前页跳转，不注册独立路由页

  2. 2. 核对打开方式与页面标题

    b. 页标题为组织费用明细 · PDF，不再进入原PDF编辑器

pdf-inspection.json pdf-api-responses.json 本次组织费用明细.pdf

TC-14 通过 检查点击导出后原抽屉与费用明细弹窗保持打开

点击导出后新建blob标签并产出有效PDF，原账单详情抽屉和费用明细弹窗均保持打开。

原用例步骤与预期
  1. 1. 点击导出打开新标签页

    a. 新标签页成功打开PDF页

  2. 2. 回到原标签页观察抽屉与弹窗状态

    b. 原页面账单详情抽屉与组织费用明细弹窗均仍保持打开

02-org-modal-after.png 本次组织费用明细.pdf

02-org-modal-after.png

TC-15 失败 检查PDF页头展示全部设备数且无页内打印按钮

PDF页头为组织费用明细，缺少 · PDF；没有全部 1 台设备标签。汇总区的设备数1不能替代页头标签。PDF页面无自定义打印/存为PDF按钮。

原用例步骤与预期
  1. 1. 核对页头标题与设备数标签

    a. 页头标题为组织费用明细 · PDF，设备数标签为全部 N 台设备

  2. 2. 核对页内是否提供打印或存为PDF按钮

    b. 页内不提供打印或存为PDF按钮，打印存档依托浏览器原生PDF查看器

pdf-page-1.png 本次组织费用明细.pdf

pdf-page-1.png

TC-16 通过 检查PDF基础信息展示账期账单号出账日开票主体

PDF标题区突出streamaxlipiao；账期Oct 2026、账单号BILL2026100018232、出账日2026-10-16、开票主体深圳市锐明技术股份有限公司均与本次overview及组织数据吻合。

原用例步骤与预期
  1. 1. 核对基础信息区区块标题与组织名称

    a. 区块标题为组织费用明细，下方突出展示所点击组织名称

  2. 2. 核对账期、账单号、出账日、开票主体取值

    b. 展示账期、账单号、出账日、开票主体，取值与当前账单及该组织一致

pdf-page-1.png pdf-api-responses.json

pdf-page-1.png

TC-17 通过 检查PDF汇总区块行序项目与本组织当月合计加粗

汇总标题和设备数、设备小计、下行流量费、存储、小计、税、本组织当月合计行序符合用例。设备2.87+流量0+存储0=小计2.87，税0，总计2.87 USD；总计加粗。

原用例步骤与预期
  1. 1. 打开汇总区块核对行序与项目名称

    a. 汇总标题为汇总，行序为设备数、设备小计(订阅费 + 硬件能力激活)、下行流量费、存储、小计、税(税率%)、本组织当月合计

  2. 2. 核对本组织当月合计行样式

    b. 本组织当月合计行加粗强调，金额带当前账单币种单位

pdf-page-1.png pdf-api-responses.json

pdf-page-1.png

TC-18 阻塞 检查未开启流量或存储管控时汇总裁剪对应行

缺少已确认关闭管控的可访问租户样本。当前storageCtrlEnabled=true；流量专用enable接口为true，而租户detail.flowCtrlEnabled=false，不能仅凭该detail字段认定流量已关闭。未改租户配置，本项不作通过或失败判定。

原用例步骤与预期
  1. 1. 在未开启流量管控租户导出PDF核对汇总行

    a. 未开启流量管控时不展示下行流量费行

  2. 2. 在未开启存储管控租户导出PDF核对汇总行

    b. 未开启存储管控时不展示存储行，小计与本组织当月合计按已展示行计算

control-api-evidence.json

TC-19 通过 检查已开启管控金额为0时汇总仍保留对应行

当前租户storageCtrlEnabled=true，存储金额为0。PDF保留存储行并显示0.00 USD，符合用例。流量管控字段口径差异已在TC-18说明。

原用例步骤与预期
  1. 1. 打开汇总区块定位下行流量费或存储行

    a. 对应行仍保留展示

  2. 2. 核对金额展示

    b. 值展示为0.00加当前账单币种

control-api-evidence.json pdf-page-1.png

pdf-page-1.png

TC-20 部分验证 检查设备明细覆盖该组织本账期全部设备非当前页

本次org-cost导出请求pageSize=100000000，返回总设备数1，PDF设备行恰为JP600000001，当前样本数据齐全。但设备弹窗每页10条、样本仅1条，不能验证跨页全量及分页；页头N标签缺失已计TC-15失败。

原用例步骤与预期
  1. 1. 在弹窗仅停留第一页时点击导出打开PDF页

    a. 设备明细输出该组织本账期全部设备行，不限于弹窗当前页

  2. 2. 核对设备明细数据范围与页头全部设备数

    b. 页头全部设备数N与设备明细数据范围一致

pdf-api-responses.json 13-org-modal-reopened.png pdf-page-1.png

13-org-modal-reopened.pngpdf-page-1.png

TC-21 待复测 检查设备明细列含设备类型车辆激活时间费用与合计行

已本地修复，待环境复测：PDF第三列表头由“车牌”改为“车辆”，仍读取vehicleNo显示车牌号；“类型”仍读取model。现有PDF文档测试3项通过，覆盖七列表头顺序、设备行取值和金额。业务代码已提交并推送至功能分支（2627de04af），尚未合并或部署，未重新生成测试环境PDF；下方PDF截图为修复前历史证据，不作为通过凭据。

原用例步骤与预期
  1. 1. 核对设备明细表列名从左到右顺序

    a. 列依次为设备、类型、车辆、激活时间、订阅费、硬件能力激活、小计

  2. 2. 核对末尾合计行展示

    b. 末尾合计行设备列文案为设备小计(订阅费 + 硬件能力激活)，订阅费、硬件能力激活、小计列为纵向合计并加粗

本地修复验证记录 pdf-page-1.png

pdf-page-1.png

TC-22 阻塞 检查无设备组织导出时空态金额按零展示

当前可见组织仅主体组织且有1台计费设备，没有无设备组织样本，未新增/删除业务数据。

原用例步骤与预期
  1. 1. 导出该组织PDF页核对汇总区

    a. 设备数行不展示，设备小计、小计、本组织当月合计等金额行按0.00币种展示

  2. 2. 核对设备明细表

    b. 设备明细表无数据行，仅输出末尾合计行，金额列为0

12-org-table.png 13-org-modal-reopened.png

12-org-table.png13-org-modal-reopened.png

TC-23 失败 检查PDF页不再展示底部固定脚注文案

PDF底部仍展示流量与存储按整体计量后分摊、含一级组织本身/平台仅向一级组织开账单两条固定脚注，与附件要求不展示固定脚注不一致。

原用例步骤与预期
  1. 1. 滚动至页面底部

    a. 页面含页头、基础信息、汇总、设备明细区块

  2. 2. 核对是否仍展示原流量与存储或含一级组织本身类固定脚注

    b. 底部不展示原固定脚注文案

pdf-page-1.png

pdf-page-1.png

TC-24 阻塞 检查非分销商租户不展示按组织Tab导出路径

tenant/detail明确customerType=DISTRIBUTOR。当前为分销商，未取得可切换的非分销商租户样本，无法验收非分销商隐藏组织Tab。

原用例步骤与预期
  1. 1. 打开账单详情抽屉

    a. 成功打开账单详情抽屉

  2. 2. 核对是否出现按组织Tab

    b. 不展示按组织Tab，无法进入本需求组织费用明细导出路径

control-api-evidence.json