P2 · 需求到 CAD 完整走查
这条路径是 LatentFlow 的核心主链：把一段自然语言的球阀需求，变成结构化规格、工程计算结果， 最终得到 CAD 3D Draft 预览、参数映射与 Draft BOM。
1. 创建项目、描述需求
- 打开
/app/projects/new。 - 用中文或英文描述一个球阀需求，尽量包含：
- 口径 / DN（如 DN200、10 inch）
- 压力等级 / Class（如 Class 300、PN63）
- 介质（如天然气、水、含硫工况）
- 设计温度
- 可选：连接方式（法兰/焊接）、执行方式（手动/齿轮/电动/气动）、是否 fire-safe 等
- 提交后系统会把文本解析为结构化的 Requirement（字段化的工况、结构、材料等）。
提示：仓库
docs/alpha-test/samples/下提供了三份可直接复制粘贴的需求文本 （信息齐全 / 信息不全会触发澄清 / 故意超范围），可以直接用来测试，不用自己现想。
超范围（非球阀）会怎样
Alpha 只支持球阀。如果你的描述里出现闸阀（gate valve）、截止阀（globe valve）、蝶阀 （butterfly valve）等其他阀型的关键词，系统会明确拦截并提示"Alpha 仅支持球阀"，不会假装 继续解析或算出一个错误结果。这是预期行为——测试脚本里专门有一个超范围用例（描述一个闸阀） 用来验证这个拦截是否清晰、不误导。
2. 回答澄清问题
- 项目的 conversation 标签页会展示系统提出的澄清问题——通常是缺失或有歧义的字段 （材料牌号、密封类型、腐蚀裕量等）。
- 逐条回答（可以参考材料牌号示例，如 A105N 阀体、A182 F316 球体/阀杆、RPTFE 阀座密封、 A193 B7M 螺栓——这些是系统内置的常见选项，不熟悉工程材料也可以直接照抄测试）。
- 每次补充后，requirement 标签页的结构化字段会更新，未确认的假设会带有明显标记， 需要你确认或修正后才继续。
3. 冻结需求（Freeze intake）
- 在 requirement 标签页找到「冻结录入 / Freeze intake」按钮。
- 冻结是运行工程计算前的必需步骤：冻结会把当前规格生成一份快照，作为下游计算、CAD、 参数合同的"工况真源"。冻结前，计算与 CAD 导出接口都会被阻断。
- 如果必填字段还没补全，点击冻结会得到一个明确的阻塞提示，列出还缺哪些字段/项—— 不会是无提示的静默失败。按提示补全后再次点击冻结即可。
- 冻结后再修改需求，需要先「解冻」并说明原因（如"客户改了设计压力"），解冻会重新打开为草稿。
冻结（frozen）之后，requirement 字段就是后续所有计算和 CAD 参数映射唯一认可的输入来源， 这也是为什么这一步被设计成需要显式确认的关卡，而不是自动完成。
4. 运行工程计算
- 冻结后，在 calculations 标签页运行/查看工程计算。
- 计算覆盖球阀的密封与内件设计、扭矩与驱动链、阀体强度、法兰与螺栓、内件强度等模块。
- 每个检查项会显示通过/失败、具体输入输出数值，可以追溯到对应的规格字段和标准依据。
- 如果某项检查失败，会有对应的字段提示，指向需要修正的具体字段（回到 requirement 页调整， 必要时解冻重来）。
5. 查看 CAD / BOM
- cad 标签页展示：
- 3D Draft 预览 —— 依据当前参数合同生成的球阀（当前 Alpha 主交付为阀座镶圈 seat insert） 三维模型草稿。
- 参数映射 —— 计算结果如何映射到 CAD 几何参数。
- Draft BOM —— 物料清单草稿，含每个组件的就绪度状态（
ready/needs_review/blocked） 和阻塞原因。
- BOM 与 3D 预览均标注为 Draft — 不可用于生产。
6. 尝试导出
- 支持的导出格式：STEP、DXF、SVG（以及内部的参数包 JSON）。
- 导出前置条件：需求已冻结 + 参数合同没有阻断导出的 blocker。如果有 blocker，导出按钮会提示 「导出受阻 —— 请查看零件就绪情况以获取受阻参数」，去 BOM/组件就绪度里找具体原因。
- STEP/FCStd 导出依赖服务端是否装有 FreeCAD。如果当前部署环境没有安装 FreeCAD：
- 系统会明确提示"当前环境未安装 FreeCAD —— 无法生成 STEP 文件"，
- 但零件映射、图纸草稿（DXF/SVG）与 BOM 仍然会正常生成，不会因此崩溃或整体失败。
- 这是已知的部署限制（见 已知问题清单），不需要重复反馈，除非提示本身 显示不清楚或页面报错崩溃。
- DXF/SVG 通常不依赖 FreeCAD，应该能正常下载；如果点击导出后长时间无响应或下载文件为空， 请按 FAQ 反馈。
验收要点小结
跑完这条路径后，应该能确认：
- 需求解析出的结构化字段基本正确、缺失字段有清晰提示
- 能顺利冻结（不会遇到无提示的失败）
- 冻结后能运行计算，且计算结果有具体数值和可追溯依据
- CAD 页能看到 3D 预览、参数映射、BOM 且有内容（不是空白）
- 导出要么产出文件，要么在 FreeCAD 不可用时给出明确、不吓人的降级提示
- 描述闸阀等超范围需求时，系统清晰拦截而不是错误地继续计算
对应的可执行测试脚本见仓库 docs/alpha-test/SCENARIO-P2-requirement-to-cad.md。