Files
Qt_DesktopPet/docs/test-records

测试记录维护规则

本目录保存 QtDesktopPet 每次正式回归、候选发布和性能验收的长期记录。验收标准定义在 ../QtDesktopPet_测试清单与验收标准.md,本目录只记录某一次构建的实际执行结果。

文件规则

  • 每次验收创建独立文件:YYYY-MM-DD_<version>_<commit>.md
  • 已完成记录不覆盖;复测结果追加在原记录的“缺陷与复测”部分。
  • index.md 维护所有测试轮次和最终结论。
  • 工作树不干净时,commit 后增加 -dirty,并记录差异摘要。
  • 状态统一使用 PASS / FAIL / BLOCKED / NOT_RUN

数据边界

  • 允许提交:测试环境、用例结论、脱敏错误摘要、性能统计摘要和缺陷编号。
  • 禁止提交:API Key、Authorization、完整用户对话、完整服务端错误正文、真实用户路径和原始性能 CSV。
  • 原始性能 CSV 保存在 reports/perf/,该目录不进入 Git。
  • 自动化临时输出保存在 internal/qa/out/,该目录不进入 Git。

工作流

  1. TEMPLATE.md 创建本次记录并填写不可变构建信息。
  2. 执行内部自动化和静态检查,粘贴摘要而不是完整原始日志。
  3. 按功能测试清单分批手测,用户反馈后更新本次记录。
  4. 执行性能采样,将审核后的 Markdown 摘要纳入本次记录。
  5. index.md 登记结论;存在阻断问题时不得标记为可发布。