wangdequan
72152ef356
Real IFC2X3/IFC4 import tested. Full BIM authoring/export remains out of scope; 349-second building import performance remains to optimize.
64 lines
4.1 KiB
Markdown
64 lines
4.1 KiB
Markdown
# Web FreeCAD 用户测试工作区
|
||
|
||
2026-09-16 最新：[IFC 原生导入修复与复测](IFC-IMPORT-REPAIR-20260916.md)。FILE-02 的真实 IFC 导入现已通过，累计手册 21 项通过；完整 BIM 作者/IFC 导出 API 不在本次关闭范围。
|
||
|
||
最新授权修复结果见 [修复与复测记录](REPAIR-REPORT.md)。原始失败保留在旧时间戳目录，当前缺陷状态以 `defects.json` 和最新报告为准。
|
||
|
||
原剩余九项的后续结果见 [九项执行结果与 IFC 依赖缺口](REMAINING-NINE-REPORT.md)：8 项通过、IFC 所在的多格式项失败，未以“已执行”冒充“已通过”。
|
||
|
||
## 范围和事实基线
|
||
|
||
本目录执行用户手册中的真实浏览器操作，保存通过、失败和阻塞证据。1452/1452 是实现登记数，不是用户验收通过数。此前“完整烟测已通过”的表述不成立：旧流程没有完成浏览器业务链路，TypeScript 门禁也存在错误。
|
||
|
||
本目录根部的 `summary.tsv`、模块日志及 PNG 为最初的旧烟测框架探索批次。部分场景名不被旧框架支持，部分截图可能来自旧框架已有文件，不能据此签署验收。后续以 `manual-时间戳/` 里的新鲜证据为准。
|
||
|
||
## 分步计划
|
||
|
||
1. 读取 Markdown 手册，保存本轮输入快照和发布文件指纹。
|
||
2. 启动带 COOP/COEP 的本地预览服务，创建独立 Chrome 配置，隔离 OPFS 和下载。
|
||
3. 执行 UI-01/02、GEO-01 至 GEO-04，记录新建、尺寸、事务、布尔和删除。
|
||
4. 执行 FILE-01/03/04、DOC-01，记录导入、FCStd、OPFS、属性和重开。
|
||
5. 执行 UI-04、ERR-02/03，记录相机交互、非法输入和重复请求。
|
||
6. 访问结构、链接、多格式及导出流程；入口失败时保留失败截图，后续业务步骤记未执行，不能由其他格式代替。
|
||
7. 按注册表逐一访问 32 个真实工作台入口，不能用独立模块演示页代替工作台。
|
||
8. 运行 20 轮有限稳定性循环，单列未覆盖的大文件、完整导入循环和内存评估。
|
||
9. 输出手册覆盖矩阵、缺陷清单和上线结论。任何 P0/P1 或关键未测项都禁止据此宣布可上线。
|
||
|
||
## 运行与恢复
|
||
|
||
在 FreeCAD 仓库目录执行：
|
||
|
||
```bash
|
||
node tools/run_user_manual_tests.mjs
|
||
```
|
||
|
||
仅复测指定项目，不重复已通过的无关项：
|
||
|
||
```bash
|
||
FREECAD_MANUAL_IDS=FILE-03,DOC-01 node tools/run_user_manual_tests.mjs
|
||
```
|
||
|
||
每轮生成新目录。脚本有步骤超时、异常快速退出、逐项落盘和进程清理。`results.json` 是机器可读进度，`checkpoint.json` 是恢复入口，`report.md` 是逐步过程。返回非零表示存在失败/阻塞，不表示整批未运行。
|
||
|
||
## 文件管理
|
||
|
||
| 文件 | 用途 |
|
||
|---|---|
|
||
| manual-snapshot.md | 当次测试所依据的手册，不随后续编辑变化 |
|
||
| environment.json | 浏览器、样本 SHA-256、发布物指纹、视口和渲染环境 |
|
||
| results.json | 编号、步骤、实际值、状态、耗时、证据路径 |
|
||
| checkpoint.json | 当前项目、已完成项目、下一步处理方式 |
|
||
| 编号-步骤.png / .json | 当步截图和页面状态；错误也保留 |
|
||
| events.json / chrome.log | 浏览器异常、网络响应、Chrome 输出 |
|
||
| downloads/ | 本轮用户操作下载的文件 |
|
||
| report.md | 按步骤编排的最终执行报告 |
|
||
|
||
状态：`passed` 仅适用于实际断言；`failed` 表示执行后不符合预期；`blocked` 表示条件不足或覆盖不完整。流程中的第一个失败会停止该案例后续依赖步骤，不影响其他独立案例。
|
||
|
||
## 安全和限制
|
||
|
||
- 测试脚本只使用本机发布产物和示例，不修改业务代码或功能验收登记。后续用户授权的修复与增量构建单列于 REPAIR-REPORT.md，不与原始测试记录混淆。
|
||
- 清理存储只针对脚本创建的临时测试源和配置；保留测试配置路径供排查，不删除真实用户文件。
|
||
- 当前为 Chrome headless 软件 WebGL，不能作为用户 GPU、Firefox/Edge、真实移动设备或性能容量通过证据。
|
||
- 原 PDF 在生成时有中文字体缺失告警，不能认定为可靠验收输入；本轮使用保存的 UTF-8 Markdown 快照，PDF 可读性需另行修正。
|