主题
BIM引擎底座 · 需求分析
文档版本：0.16 ｜ 最近核对日期：2026-11-09
1. 目标与依据
BIM引擎底座以工程台账导航树为入口，模型归属工点下的单位工程，工点负责汇总查看。提供模型上传、黑洞引擎转换、全量构件及原始属性入库、三维预览和检查后发布能力。后续业务模块使用已发布的模型版本及构件资料，业务规则仍由相应模块管理。
本版依据用户在 2026-11-07 的明确确认建立首期需求基线，2026-11-08 确认单位工程归属、导航树主入口以及安全加固后置。页面交互方向已确认，修订效果图尚未验收；功能实现与验收情况见测试与验收，不以文档齐备代表系统已上线。
| 来源 | 已确认内容 |
|---|---|
| S-BIM-01 | 在 BIM 模块按工点集中查看各专业模型；下游模块以后也能进入对应模型 |
| S-BIM-02 | 首期只建设模型上传、转换、预览、解析基础能力；进度及 CAD 属下游范围 |
| S-BIM-03 | 单份模型归属一个单位工程，由单位工程确定工点；一个单位工程可有多个模型，模型可能只是主体结构、风亭等局部范围 |
| S-BIM-04 | 沿用单位工程的现有标准专业；局部范围写在模型名称中，不另填一套专业 |
| S-BIM-05 | 检查后直接发布，不走审批流程 |
| S-BIM-06 | 解析包含全量构件及属性入库，供后续业务检索和统计；2026-11-09用户调整为首期以RVT收口，PAK支持延期 |
| S-BIM-07 | 换版稳定标识匹配成功自动继承，异常人工处理；构件与进度项绑定数量规则暂不冻结 |
| S-BIM-08 | 复用单位工程台账的工程台账导航交互，补充单位工程叶节点；通过树定位，不设置独立查询卡 |
| S-BIM-09 | 首期优先完成基础业务闭环，资源源站封闭、短期访问票据等专项安全加固后置；保留平台登录、后端功能与工程范围校验、服务端凭据保护 |
工程对象及数据范围遵循工程基础需求、公共开发约定和业务地图。黑洞官方接口说明仅作为技术能力证据，不能代替本部署环境的验证。
2. 首期范围
| 纳入 | 交付行为 |
|---|---|
| 工程模型台账 | 导航树切换线路、工点、标段和单位工程；在当前范围内按专业、模型名称轻量筛选；一个单位工程允许多个独立模型 |
| 文件与版本 | 上传RVT原文件；同一模型新增版本，保留原文件和历史版本。PAK支持列后续，不作为本期完成条件 |
| 转换任务 | 查看上传至引擎、排队、转换、解析等实际阶段、进度和失败原因；失败后可重新处理 |
| 解析入库 | 保存全量构件、文件归属、引擎标识、可获取的稳定标识和原始属性分组、名称、值、单位；可分页检索与回读 |
| 预览 | 单模型检查、同工点已发布模型集中查看；旋转、缩放、平移、复位、模型显隐、构件树、选择定位和属性查看 |
| 发布 | 有权限的人员检查画面和解析结果后发布；记录发布人、时间和检查确认；无审批工作流 |
不纳入首期：进度 WBS、构件业务绑定及其界面、状态着色、工程量统计口径、GIS/CAD 预览与配准、跨工点模型拆分、模型编辑、碰撞检查、版本差异可视化、批注、漫游方案、移动端及云渲染。全量属性入库不等于首期新增专业统计报表。
3. 业务对象与角色
模型资产是某一单位工程下持续换版的一份逻辑模型。模型版本是该资产的一次文件交付；首期交付按每版本一份RVT验收，PAK支持延期。转换后产生的多个内部文件仍属于该版本，不拆成多个业务模型。
| 对象 | 业务含义 |
|---|---|
| 工点 | 复用物理工点主数据，作为空间汇总入口；不直接承载模型归属 |
| 单位工程 | 模型唯一工程归属；由既有主数据提供线路、标段、工点及专业，不以同名推断相同对象 |
| 专业 | 从单位工程解析现有标准专业编码；不另建 BIM 专业字典、不重复录入。综合专业下更细的交付范围用模型名称表达 |
| 模型名称 | 表达该份模型的实际范围，例如“主体结构”“1号风亭”；不是专业唯一键 |
| 当前发布版本 | 下游及集中预览默认使用的版本；允许尚未有发布版本 |
| 构件 | 某一模型版本、某一内部文件内的构件实例；不是跨版本天然相同的业务实体 |
| 属性 | 由源模型经引擎提取的原始数据；不得将同名属性直接覆盖合并 |
查看、上传处理、发布是权限能力，可分配给同一人或不同人。首期不要求上传人与发布人分离，不新增专门审批角色。
4. 业务规则
4.1 模型归属
- R-BIM-001：每个模型必须归属一个有效单位工程。线路、标段、工点与专业由后端从该单位工程解析并校验，不接受前端拼装或覆盖。未建立单位工程时先维护工程基础，不建立临时工点级模型。
- R-BIM-002：一个单位工程允许多份独立模型；不设置单位工程唯一占位，也不以“工点＋专业”合并不同标段的资产。模型名称用于识别局部范围，不另加主体/附属等分类字段。
- R-BIM-003：资产建立后不提供归属转移；误归属文件在正确单位工程下重新建立和上传。已有模型引用的单位工程不得删除或通过标段范围/专业调整间接清除，也不随改名重建模型。首期不增加模型清理或迁移工具。
- R-BIM-004：模型管理采用左侧工程台账导航、右侧模型列表；保留在建/规划/运营、空间/合同视图、树搜索、展开折叠及刷新。空间视图为“线路→工点→标段→单位工程”，合同视图为“线路→标段→工点→单位工程”。点击上层节点汇总其范围内的授权模型，点击单位工程进入其模型；尚无模型的有效单位工程也须可见，以便首次上传。
- R-BIM-005：不设置独立查询卡，不要求通过线路/工点/单位工程下拉组合才能使用。模型名称及专业筛选放列表工具栏；单位工程选定后专业只读带出。新建模型须先在树上选中单位工程，填写模型名称并上传文件；上层汇总视图提示先选择单位工程。导航切换清除旧行选择、重置分页，返回列表恢复原导航位置。
4.2 上传、转换与解析
- R-BIM-010：首期交付与验收格式为RVT。按2026-11-09用户决定，PAK支持及其样本验证放到后续，不再列本期阻断；既有PAK枚举或接收分支可作为技术预留保留，但不能宣称已经验证可用，不为本次延期删除存量数据或重建结构。RVT对应软件版本是否可转换，以部署组件、许可和真实样本验证为准，不能仅凭扩展名宣布兼容全部Revit年份。文件大小限制由实际部署能力配置并在上传前展示，不虚构已验证容量。
- R-BIM-011：上传保存原文件后生成版本并开始处理。原文件上传、引擎文件上传（采用厂商私有化部署后台上传路线：占位申请、宿主机物理路径安全流式传输与完成通知纳管）、引擎转换和平台解析是不同阶段；不得将上传 100% 显示为转换完成。多实例调度增加分布式任务互斥与引擎可达性探测，避免未放行实例误推任务。
- R-BIM-012：转换完成后执行全量解析入库；读取所有文件及构件，包含没有属性的构件、空值属性和组合构件。原始分组、名称、顺序、值及单位须保留，不因名称重复、空字符串或零值丢弃数据。
- R-BIM-013：全量指该源文件经已配置转换流程可提取的全部构件及原始属性。若转换过滤、接口漏项或源软件与转换结果不一致，必须报告差异，不能把“引擎未返回”当作已验证完整。首期不引入黑洞平台后加的扩展属性编辑能力。
- R-BIM-014：解析结束核对文件覆盖、构件集合、属性请求完成情况和入库行数；有未完成文件或构件、接口异常、截断，或同一文件内运行时构件身份冲突时，不得标为解析完成。候选稳定标识缺失或重复不等于运行时身份冲突：构件与属性仍完整保留，只是不具备自动继承条件。没有属性的构件是合法结果，但属性请求失败不是空属性。
- R-BIM-015：失败记录所属阶段和可理解的原因。重新处理只针对未发布版本；已发布版本的原文件和解析快照不可原地覆盖。查询异常只表示状态暂不可获知，不虚构引擎失败或成功。
4.3 预览与数据查询
- R-BIM-020：用户可检查待发布模型，查看构件树、定位构件和读取已完整入库的属性。未完成解析时可在几何资源可用的前提下检查画面，但明确提示数据尚未就绪，不返回部分结果冒充全量。
- R-BIM-021：工点集中查看汇总其有权访问的单位工程下各资产当前发布版本，可选择多个专业或局部模型同时显示；单位工程入口只加载该工程，带标段上下文的工点入口保留该标段范围。首期不提供跨工点同场景叠加；线路、全局或跨工点标段只汇总台账。未发布版本不自动进入集中查看，局部模型加载失败时指出失败对象，保留已加载模型。
- R-BIM-022：同工点模型按原坐标与引擎返回变换加载；坐标不一致须在源模型或转换配置中修正。首期不新增人工配准或坐标编辑界面，也不能擅自将每份模型移到原点冒充对齐。
- R-BIM-023：构件与属性支持按模型版本分页查询、构件名称及属性分组/名称/原始值筛选；单模型和属性筛选均受同一数据权限约束。首期保留原始数值和单位，不自动合计不同单位、不推导工程量口径。
4.4 发布与换版
- R-BIM-030：发布前须同时满足转换成功、全量解析完成、资源描述有效，以及发布人确认实际几何和数据检查通过。SDK 初始化、加载回调或 HTTP 200 单独均不能代替模型检查。
- R-BIM-031：直接发布，不走审批。发布事务记录检查确认、发布人、发布时间，并切换资产当前发布版本。权限与检查不能只在前端控制。
- R-BIM-032：新版本未发布、处理失败或尚在检查时，旧发布版本继续可用。已发布历史版本保留原文件、几何资源引用和解析快照；查询指定版本不得暗中回退为最新版。
- R-BIM-033：换版时不以引擎运行时构件整数 ID 认定同一构件。将来需要继承业务关联时，只有同资产、已确认来源文件身份、稳定标识唯一匹配成功才自动继承；缺失、重复、删除及一对多等异常由人工处理，不凭名称或空间接近自动关联。
- R-BIM-034：R-BIM-033 是后续接入原则。首期保存匹配所需标识和能力信息，不建设业务绑定、继承任务或人工冲突处理页面；构件能绑定几个进度项留待下游设计确认。
4.5 权限与安全
数据过滤策略：工程数据授权，资源类型为标段工点专属资源。 模型跟随单位工程：须命中同线整线授权或单位工程实际所属的有效标段工点组合，专业不是独立权限维度。工点汇总只合并已授权单位工程，不因有同工点另一标段授权而放开全部模型；导航计数与列表使用同一范围。此规则取代前期工点共享方案，复用公共开发约定既有专属授权机制。所有操作还须满足对应功能权限。
- R-BIM-040：导航、列表、详情、原文件、解析结果、预览上下文及平台资源入口均按实际单位工程核对专属组合权限，不以隐藏菜单或过滤列表代替后端鉴权。外部几何源站专项访问隔离按 R-BIM-042 分阶段处理。
- R-BIM-041：普通已发布浏览与未发布检查分开；读取未发布版本的模型内容、构件属性或原文件，除对应功能权限外还须具有上传或发布权限。仅有查询权限可看处理状态摘要，不能据此读取未发布内容。后台处理账号不因此取得用户跨工点业务查询权限。
- R-BIM-042：黑洞服务端凭据不进入浏览器、文档或日志。首期使用经核实的现有资源加载方式，平台业务 API 保留鉴权，不为适配 SDK 关闭已有保护。源站匿名旁路封闭、短期访问票据、撤权后的缓存/资源失效作为后续加固项，不阻塞本期基础闭环验收；首期不得宣称已实现端到端资源隔离，也不新增匿名开放入口。
- R-BIM-043：模型、文件、构件和属性来自外部内容，展示按文本处理；错误信息不能泄漏内部地址及凭据。下载源文件需独立下载权限。
5. 非功能要求
| 编号 | 要求与验证方式 |
|---|---|
| N-BIM-01 | 原文件及已发布解析快照可追溯；任务重启、失败恢复不能破坏已有发布版本 |
| N-BIM-02 | 上传流式传输，解析分批入库，不将全模型及全部属性一次装入应用内存；页面使用分页和按需展开 |
| N-BIM-03 | 黑洞 SDK、Worker、WASM 及资源固定为经过联调的一套版本；升级后重验加载、选择、属性与换版 |
| N-BIM-04 | 以实际RVT样本记录文件大小、文件数、构件数、属性数、转换/解析耗时、首次可交互时间及终端配置；PAK测量延期。没有实测前不承诺秒数或“无独显可用” |
| N-BIM-05 | 平台 ID 遵循 Long 序列化约定，前端不将雪花 ID 转数值；外部引擎标识保持原值及作用域 |
| N-BIM-06 | 复用现有异步任务和统一异常机制；不因理论并发新增消息中间件、锁或并发专项门槛 |
6. 验收标准
| 编号 | 场景 | 必须观察到的结果 |
|---|---|---|
| AC-BIM-01 | 同单位工程上传“主体结构”和“1号风亭” | 两个独立资产可查询、各自换版，工点/标段/专业自动一致；不存在专业唯一占位限制 |
| AC-BIM-02 | 上传有效RVT | 原文件、转换结果、全量构件和属性可追溯；不在实际接收白名单的格式前后端均拒绝。PAK预留不作为可用性承诺或本期验收项 |
| AC-BIM-03 | 含无属性构件、空值、零值及同名属性的样本 | 全量入库并保留差异；页面查询与源模型抽核及引擎全量结果对应 |
| AC-BIM-04 | 某文件或构件属性读取失败 | 任务明确失败位置，禁止发布；修复后重新处理完成，不出现重复可见数据 |
| AC-BIM-05 | 检查与发布 | 无审批；未满足处理条件或无发布权限不能发布；成功后记录检查人并成为当前版本 |
| AC-BIM-06 | 上传失败或解析失败的新版本 | 旧发布版本几何、树、属性和原文件继续对应旧版 |
| AC-BIM-07 | 同工点多模型集中查看 | 正确加载选择的发布版本，显隐及选择属性不串模型；失败项独立提示 |
| AC-BIM-08 | 同工点有A标授权但无B标授权 | 导航、计数、汇总及直接业务接口均不能读取B标单位工程模型；整线授权按既有规则覆盖 |
| AC-BIM-09 | 指定历史发布版本 | 画面、构件集合和属性一致属于所选版本；引擎不可达时不显示其他版本代替 |
| AC-BIM-10 | 平台业务鉴权与客户端材料 | 未登录不能调用平台模型业务接口；前端与日志不含服务端凭据；现有资源加载兼容性实测。源站旁路及失效隔离后置 |
| AC-BIM-11 | 用导航树完成查找与首次上传 | 双视图均能选中同一单位工程；空模型工程可进入；无独立查询卡，树切换即时更新列表；返回恢复位置 |
| AC-BIM-12 | 模型引用的单位工程删除/标段调整 | 明确拒绝会删除被引用单位工程的操作，模型和历史版本不失联；无BIM引用的既有合法操作保持 |
7. 已定边界与待验证项
首期范围、专业、模型粒度、解析入库、格式及发布方式已确认，不再列为待裁决。下列是技术验证依赖，不改变已确认业务目标：
- 已有RVT转换、几何显示与入库证据，继续补齐真实工点多模型及全量覆盖等缺口，见测试与验收。PAK支持与验证按用户决定延期，不因缺少PAK样本阻塞本轮。
- 全量导出及分页接口的实际字段、分页语义、空值保留、稳定标识能力与大样本开销。
- 每版本独立资源的历史保留和 SDK 资源请求兼容性；源站访问隔离与失效治理列后续加固，不混入本期业务完成门槛。
- 同工点各专业模型坐标一致性及实际终端性能。
下游构件绑定数量及具体继承业务对象不在本次冻结范围，不阻塞基础模型资料设计。