ENGINEERING / PROJECT RECORD
单桩基础 Web3D 教学样例
通过中空桩身、泥面与水面示意，观察单桩基础的几何与入土关系。这是风电可视化系列的首个基础教学样例，使用假设参数。
本地开发中 · 尚无公开体验入口
适合：希望了解单桩几何表达与模型接入过程的学习者
#进行中
#上游项目扩展
扩展与实现记录
- 修复架构缺口：参数卡通用化（含来源标注）、Toolbar 特性联动、拆解规则语义化（level 0 恒不位移）、check-model 注册表驱动多模型校验
- Blender 参数化建模脚本：布尔差构建真实壁厚中空桩身，端面顶点严格落在理论高程并逐项校验
- 辅助面约定：泥面/水面以 Aux_ 命名 + extras.aux 标记导出，运行时不参与拾取与取景
- 修复产品缺陷：重复选择同一模型导致页面卡在载入中
- 专属回归测试：风机↔单桩互切、无叶轮控件、假设参数展示、拆解精确复位、三轴剖切、失败重试
来源与适用范围
- 本样例在派生仓库的 foundation-pilot 开发分支上进行（未合并、未发布）
- 全部尺寸为假设参数，仅供教学示意；无土层、荷载与计算依据，不生成承载力、寿命、安全系数或应力结果
- 上游三维架构与风机模型归属原作者（Apache-2.0）
LEARN / TRY IT YOURSELF
想继续了解？从这里开始。
项目问题
风机数字样机的注册表架构能否不改渲染代码就承载基础类模型？单桩基础与风机构型差异极大：无叶轮、无机舱、参数是桩径/壁厚/入土深度而非功率/转子直径，还有泥面、水面这类”辅助示意面”。
当前进展（进行中）
- 架构缺口修复：参数卡改为通用指标列表并强制展示数据来源（官方资料/公开资料/工程近似/假设参数）；Toolbar 叶轮控件按模型特性显隐；
stagedExplosion语义实际生效（level 0 恒不位移，保证整机精确复位）；模型检查脚本注册表驱动化。 - 建模链路：
build_monopile.py用布尔差构建真实壁厚的中空桩身，桩顶、入土底端、泥面、水面高程逐项断言；辅助面以Aux_命名并携带aux标记导出到节点 extras。 - 回归：新增 4 个单桩专属测试；全套 14 项（13 通过 + 1 按配置跳过）。
验证证据（单桩接入阶段记录）
- 模型检查：4 个 GLB（风机三档 + 单桩）全部通过；
- 全量交互测试通过（Edge 155 无头，生产构建预览）；
- 截图见本页顶图（参数卡可见”假设参数 · 仅供教学”标注）。
局限与边界
- 全部尺寸为假设参数，仅供教学示意——无土层、荷载与计算依据，不生成承载力、寿命、安全系数、优化方案或应力云图；
- 泥面/水面为示意面，不模拟土-结构相互作用；
- 分支未合并、未部署；合入 main 并发布需人工触发。
下一步
单桩接入已扩展为风电基础教学实验室，本页保留最初接入阶段的记录。下一阶段优先实现参数、模型几何、计算与导出的联动闭环。