Align Prengine engineering runtime strategy

.env.production.example

@@ -48,6 +48,20 @@ ARCHITOKEN_GENERATION__PROVIDER=http_text_to_bim
 ARCHITOKEN_GENERATION__TEXT_TO_BIM_URL=https://generation.example.com/v1/generate/text-to-bim
 
 # File adapter services. Empty values are not production-ready for that family.
+PAPERCLIP_DASHBOARD_URL=http://paperclip:3111
+NEXT_PUBLIC_PAPERCLIP_PUBLIC_URL=https://paperclip.architoken.example.com
+PAPERCLIP_INSTANCE_ID=architoken-production-manufacturing
+PAPERCLIP_CONFIG=/paperclip/instances/architoken-production-manufacturing/config.json
+PAPERCLIP_PUBLIC_URL=https://paperclip.architoken.example.com
+PAPERCLIP_AUTH_PUBLIC_BASE_URL=https://paperclip.architoken.example.com
+PAPERCLIP_ALLOWED_HOSTNAMES=paperclip.architoken.example.com,architoken.example.com
+BETTER_AUTH_BASE_URL=https://paperclip.architoken.example.com
+BETTER_AUTH_URL=https://paperclip.architoken.example.com
+BETTER_AUTH_TRUSTED_ORIGINS=https://paperclip.architoken.example.com,https://architoken.example.com
+PAPERCLIP_DEPLOYMENT_MODE=authenticated
+PAPERCLIP_DEPLOYMENT_EXPOSURE=private
+PAPERCLIP_BETTER_AUTH_SECRET=REPLACE_WITH_32_BYTES_RANDOM_SECRET
+PAPERCLIP_AGENT_JWT_SECRET=REPLACE_WITH_32_BYTES_RANDOM_SECRET
 LIBREOFFICE_ADAPTER_URL=https://office-adapter.example.com
 UNIVER_DOCUMENT_SERVICE_URL=https://univer.example.com
 MARKITDOWN_WORKER_URL=http://markitdown-worker:8080

01-product/PRD.md

@@ -93,6 +93,8 @@ ArchIToken 不是 Revit、Tekla、PKPM、广联达、中望、Siemens Building X
 | 13    | `ai_center`                  | AI中心     | 模型 / RAG / MCP / Agent 配置    | 模型路由 + 工具权限 + 成本审计策略         | 实时   |
 | 14    | `settings_center` *(side-car)* | 设置中心 | 租户 / RBAC / 模型路由 / 预算配置 | 全局配置推送 (被其它 13 模块拉取)          | 实时   |
 
+当前阶段,Paperclip v2026.517.0 完整接管 `production_manufacturing` 模块主工作区,用于 Agent 组织、工厂任务、heartbeat、预算和治理编排;不得替代 ArchIToken 的模块 ID、CDE 文件、CNC/QC/MES/ERP 真源或专业审批结论。
+
 **架构承诺**: 未来新增模块(例如"拿地分析 / 方案投标 / 碳排放核算")不需改任何已有代码 —— 只在
 `modules` 表 + Rust `REGISTRY` + Python `MODULE_REGISTRY` 各加一行,加配 3 个 prompt 文件即可。
 

02-architecture/ARCHITOKEN-SOURCE-OF-TRUTH.md

@@ -179,6 +179,8 @@ K3s 可作为极端资源受限场景的可选适配,但不是正式部署基线
 
 `production_manufacturing` 是生产制造模块,包括生产计划、工序路线、下料优化、CNC / 数控文件、焊接、喷涂 / 防腐 / 防火、质检、工厂排产、MES / ERP 对接、构件编码和包装发运。
 
+当前阶段 Paperclip v2026.517.0 完整接管 `production_manufacturing` 模块主工作区,作为 Agent 组织、工厂任务、heartbeat、预算和治理编排的外部进程 / 服务适配器;不得替代 ArchIToken 的模块 ID、CDE 文件、CNC/QC/MES/ERP 真源或专业审批结论。
+
 ### 4.4 施工管理
 
 施工管理包括方案、进度、质量、安全、日志、AR、360 全景、三维扫描、倾斜摄影、无人机巡检、建筑机器人、IoT、影像对比、整改闭环和竣工资料。

02-architecture/CONSTITUTION.md

@@ -108,8 +108,10 @@ ArchIToken 的技术选型必须以实现能力、生产价值、生态成熟度
 
 - 开源项目、源码仓库和用户提供的 GitHub 链接是一等技术来源。需要能力时优先从源代码、上游文档、release tag 和可复现构建路线落地; apt、snap、系统包或二进制分发只是加速路径,不是能力边界。
 - ArchIToken 可以按业务需要整体开源、局部开源、私有部署或混合分发。是否开源不能成为限制技术路线的理由。
-- CAD/BIM/PDF/工程几何遵循矢量优先、语义优先、原生源文件优先。DWG、DXF、IFC、STEP/STP、IGES/IGS、STL、SKP、3DM、RVT、PDF 和 3D PDF 等格式必须优先读取源文件实体、图层、属性、B-Rep、mesh、材质、单位和构件关系; 只有在真实原生/矢量/轻量化路线不可用时,才允许降级到 glTF/GLB/3D Tiles/OBJ/IFC 派生或其它可审计 derivative。
-- GitHub / 上游源码接入基线必须覆盖 OpenCascade/OCCT、FreeCAD、CGAL、LibreDWG、IfcOpenShell、Bonsai、buildingSMART、Blender、rhino3dm、OpenNURBS、ForgeCAD、Trimble/Tekla、Speckle、ThatOpen/WebIFC、Microsoft IFC、DataDrivenConstruction、louistrue IFC/CAD、OpenCDE、PDF/Office/Image/Video workers。它们必须进入 AdapterSourceRegistry、格式能力路由、AI 生成/在线编辑动作和审计链,不得只停留在口头技术选型。
+- CAD/BIM/PDF/工程几何遵循矢量优先、语义优先、原生源文件优先。DWG、DXF、IFC、STEP/STP、IGES/IGS、STL、SKP、3DM、RVT、PDF 和 3D PDF 等格式必须优先读取源文件实体、图层、属性、B-Rep、mesh、材质、单位和构件关系。
+- Prengine 是 ArchIToken 自研工程智能、几何、属性、资产派生和协同调用引擎名称,不是第三方 viewer 名称,也不是单一前端组件名称。Prengine 能力必须覆盖 OpenEngineeringViewer、AI 生成、可编辑几何、可编辑属性、构件选择、尺寸量测、坐标/单位、BOM/清单导出、worker 派生、审计、SDK 和 API 调用。
+- 工程模型/数字孪生资产主链路必须优先选择 OpenUSD/USDZ/3D Tiles。OpenUSD/USDZ 负责工程资产组合、层级、变体、引用、材质、属性、BOM 绑定和跨工具交换; 3D Tiles 负责超大场景、城市/园区、点云、倾斜摄影和分块 LOD 流式交付。只有在 OpenUSD/USDZ/3D Tiles 运行时、目标平台、授权边界、worker 转换、交付对象或浏览器能力明确不可用且形成审计证据时,才允许降级到 glTF/GLB。OBJ 和 FBX 不得作为新的平台主路线、默认导出目标、默认查看派生或长期资产标准,只允许作为历史导入兼容边界,并必须尽快归一到 OpenUSD/USDZ/3D Tiles 或 glTF/GLB 兜底资产。
+- GitHub / 上游源码接入基线必须覆盖 OpenCascade/OCCT、FreeCAD、CGAL、LibreDWG、IfcOpenShell、Bonsai、buildingSMART、Blender、OpenUSD/Pixar USD、Khronos glTF、Cesium/OGC 3D Tiles、rhino3dm、OpenNURBS、ForgeCAD、Trimble/Tekla、Speckle、ThatOpen/WebIFC、Microsoft IFC、DataDrivenConstruction、louistrue IFC/CAD、OpenCDE、PDF/Office/Image/Video workers。它们必须进入 AdapterSourceRegistry、格式能力路由、AI 生成/在线编辑动作和审计链,不得只停留在口头技术选型。
 - WebGPU 是浏览器和交互式工程视口的第一渲染/计算路线。WebGL 只能作为兼容回退、缩略图或第三方遗留组件边界,不得作为 BIM、CAD、数字孪生、视频/图像 AI 编辑或工程模型在线编辑的默认核心路线。
 - GPU 和平台能力必须全面覆盖 NVIDIA/CUDA/OptiX、AMD ROCm/HIP、Intel oneAPI/Level Zero/Vulkan、Apple Metal、Windows DirectX 12、Linux/Vulkan/WebGPU、Android/Vulkan/WebGPU、iOS/Metal/WebGPU、Triton AI kernel 和 CPU SIMD fallback。ARM64、x86_64、NVIDIA、AMD、Intel、Apple Silicon 都是生产目标,不是兼容性例外。
 - 可进入核心分发边界的依赖优先使用 Apache-2.0 / MIT / BSD / ISC / MPL-2.0 / MPL-2.0 等宽松许可。
@@ -199,6 +201,8 @@ OpenAPI + AsyncAPI + JSON Schema + IFC Schema + Module Schema
 | IFC Schema | BIM / AEC 模型语义、构件、属性、关系校验 |
 | Module Schema | 模块注册、模块输入输出、能力、SLA、权限、UI 元数据 |
 
+Prengine 对外能力必须通过 OpenAPI、AsyncAPI、JSON Schema 和生成 SDK 暴露,不得只通过前端组件或临时代码调用。Prengine SDK/API 的最小能力边界包括: 源模型导入、AI 模型/构件生成、可编辑几何操作、可编辑属性写回、构件选择与高亮、尺寸/坐标/单位读取、BOM/清单导出、格式派生、异步 worker 任务、审计事件和审批状态。所有模型资产 API 必须声明源文件真源、目标格式优先级、OpenUSD/USDZ/3D Tiles 优先策略、glTF/GLB 降级理由、属性 Schema、元素 ID 映射、单位/坐标系和审计 ID。
+
 **CI 执行**: Schema 变更必须有 diff 检查、生成物检查、兼容性检查。
 
 ---
@@ -297,6 +301,11 @@ ArchIToken 可以使用 Next.js 16.2.6 + React 19.2.5 + TypeScript 6.0.3 + WASM
 Next.js + React + TypeScript = 应用工程基座
 GPU-first = 默认执行策略
 WebGPU + WASM = 浏览器高性能计算与渲染核心
+Prengine = ArchIToken 自研工程智能、几何、属性、资产派生与 SDK/API 调用引擎
+OpenUSD/USDZ = AI 生成、可编辑几何、可编辑属性、BOM、工程场景与数字孪生资产主派生/交换路线
+3D Tiles = 超大场景、城市/园区、点云、倾斜摄影与分块 LOD 主流式路线
+glTF / GLB = OpenUSD/USDZ/3D Tiles 不可用时的 Web 运行时与交付兜底
+OBJ / FBX = 废弃兼容输入,不得作为新主链路
 CUDA / ROCm / DirectX 12 / Metal / Vulkan / Triton = 平台原生 GPU 加速路线
 Three.js = WebGPU 承载层 / 兼容层 / 生态层 / 快速验证层
 WebGL = 最后兼容回退,非默认核心
@@ -305,6 +314,10 @@ CPU = 有证据的兼容回退,非默认热路径
 
 WebGPU 是 CAD/BIM/IFC/STEP/STL/IGES/3DM/SKP/PDF 图形层、数字孪生、图片/视频 AI 编辑和在线工程编辑的默认交互式渲染与浏览器计算路线。Three.js 可以作为 WebGPU renderer、场景组织、loader 生态和 fallback 承载层,但禁止把 Three.js/WebGL 当作唯一渲染路线,也禁止为了“纯 WebGPU”放弃成熟工程框架。
 
+Prengine 是 ArchIToken 自研工程智能、几何、属性、资产派生和 SDK/API 调用引擎。Prengine 不是单一 viewer,其能力边界必须覆盖 AI 生成、在线几何编辑、属性编辑、构件选择/高亮、尺寸量测、坐标/单位处理、BOM/清单导出、worker 派生、审计、审批和外部 SDK/API 调用。
+
+工程模型和数字孪生派生格式的优先级为 OpenUSD/USDZ/3D Tiles -> glTF/GLB。OpenUSD/USDZ 承担 AI 生成结果、长期资产组合、层级、变体、引用、材质、属性、BOM 绑定和跨工具交换; 3D Tiles 承担超大场景、园区、城市、点云、倾斜摄影和分块 LOD 主流式交付; glTF/GLB 只有在 OpenUSD/USDZ/3D Tiles 不可用并写入审计理由时,才承担浏览器交互运行时和交付兜底。OBJ/FBX 不得作为新功能默认 viewer、默认 export、默认 worker artifact 或长期资产标准。
+
 GPU-first 是默认执行策略。只要目标设备、浏览器、驱动、运行时或集群节点具备可用 GPU,以下能力必须优先选择 GPU 路线: CAD/BIM/数字孪生视口、点云/mesh/IFC/STEP/STL/IGES/3DM/SKP 几何处理、PDF/Office 图形层编辑、图片/视频 AI 生成与在线编辑、模型推理、向量/矩阵/栅格/几何 kernel、渲染、转码和批量派生。CPU-only、WebGL-only 或纯前端 Canvas 路线只能作为明确记录的兼容 fallback、无 GPU 环境的离线模式、缩略图生成或失败恢复路径,不得成为生产默认热路径。
 
 平台 GPU 路线必须覆盖:

02-architecture/DIGITAL_TWIN.md

@@ -90,8 +90,9 @@
 
 | 层 | 当前实现 | 后续目标 |
 |----|----------|----------|
-| HMI 驾驶舱 | Next.js + React + Tailwind CSS | 驾驶舱配置 JSON 化,支持租户主题 |
-| 3D / CIM 主视图 | CSS/SVG HMI prototype | WebGPU renderer + OpenUSD / IFC / 3D Tiles |
+| HMI 驾驶舱 | Next.js + React + Ant Design tokenized CSS | 驾驶舱配置 JSON 化,支持租户主题 |
+| 3D / CIM 主视图 | WebGPU 原生 WGSL 视口 + Three.js fallback | OpenUSD / IFC / 3D Tiles 真实运行时接入 |
+| 场景与资产组合 | openBIM IFC4.3 / IDS / BCF + glTF/GLB + 3D Tiles + OpenUSD 契约 | 后端原生 worker 输出可审计 scene package |
 | 3DGS 实景层 | fixture 标注为 video/photo/360 来源 | SPZ / PLY runtime loader,支持视频重建实景 |
 | 点云校核层 | E57 / LiDAR residual 标注 | E57 / LAS / LAZ 控制点与残差热图 |
 | BIM 语义层 | IFC4.3 / MBD fixture | buildingSMART IFC4.3 / IDS / BCF 校验 |
@@ -135,6 +136,7 @@
 | 文档需求 | 实现文件 |
 |----------|----------|
 | UI 信息架构 | [`../03-frontend/components/ModuleWorkbenchShell.tsx`](../03-frontend/components/ModuleWorkbenchShell.tsx), [`../03-frontend/components/ModuleFileExplorer.tsx`](../03-frontend/components/ModuleFileExplorer.tsx) |
+| WebGPU 主视口 | [`../03-frontend/components/DigitalTwinWebGPUViewport.tsx`](../03-frontend/components/DigitalTwinWebGPUViewport.tsx), [`../03-frontend/components/DigitalTwinOperationsPanel.tsx`](../03-frontend/components/DigitalTwinOperationsPanel.tsx) |
 | 数据契约 | [`../03-frontend/lib/digital-twin.ts`](../03-frontend/lib/digital-twin.ts) |
 | 验收测试 | [`../03-frontend/lib/digital-twin.test.ts`](../03-frontend/lib/digital-twin.test.ts) |
 | 模块工作台入口 | [`../03-frontend/app/app/modules/[moduleId]/page.tsx`](../03-frontend/app/app/modules/%5BmoduleId%5D/page.tsx) |

02-architecture/HEAVY_STEEL_AI_TOKEN_COMMERCIAL_WORKFLOW.md

@@ -38,7 +38,7 @@
 
 ## 3. 文件与模型运行时
 
-IFC、DWG、DXF、RVT、DGN、STEP、STP、IGES、IGS、STL、OBJ、FBX、glTF、GLB、3DM、SKP、USD、PDF、3D PDF、Office、代码和压缩包都必须通过 FileTypeRegistry、Adapter Isolation Registry、StorageRouter 和 Worker 管线进入。
+IFC、DWG、DXF、RVT、DGN、STEP、STP、IGES、IGS、STL、PLY、DAE、OpenUSD/USDZ、3D Tiles、glTF/GLB 兜底、3DM、SKP、PDF、3D PDF、Office、代码和压缩包都必须通过 FileTypeRegistry、Adapter Isolation Registry、StorageRouter 和 Worker 管线进入。OBJ/FBX 只作为废弃历史输入兼容边界,不得作为新默认 viewer/export/worker artifact。
 
 优先顺序:
 

02-architecture/MODULES.md

@@ -104,11 +104,12 @@ ArchIToken = AEC AI-Native + Harness Engineering + OpenBIM CDE Workflow OS
 - **description**:
   项目立项、WBS、里程碑、资源计划、审批计划与跨模块交付总控模块。
   承接市场客服形成的商机和需求,将其转化为可执行的项目计划、责任矩阵和交付节奏。
+  支持进度计划在线编制、任务拆解、进度反馈、图表分析、进度预警、进度调整和任务状态闭环。
   为方案设计、计量造价、生产制造、施工管理和财务人力提供统一计划基线。
 - **inputs**: `[marketing_service]`
 - **outputs**: `[concept_design, quantity_costing, production_manufacturing, construction_management, finance_hr]`
 - **prompt_dir**: `prompts/planning_management/`
-- **tables**: `project_plans`, `wbs_items`, `milestones`, `resource_plans`, `approval_plans`
+- **tables**: `project_plans`, `wbs_items`, `milestones`, `resource_plans`, `approval_plans`, `project_plan_progress_feedback`, `project_plan_schedule_alerts`, `project_plan_schedule_adjustments`
 
 ### 2.3 `concept_design` · 方案设计
 
@@ -118,7 +119,8 @@ ArchIToken = AEC AI-Native + Harness Engineering + OpenBIM CDE Workflow OS
 - **order**: 3
 - **description**:
   面向已确认需求的客户输出多方案比选:户型、立面、风格、体量、造价估。
-  产出 3 个候选方案(SVG + 3D + 造价估)供客户选型。
+  产出多套候选方案(SVG + 3D + 造价估 + 评估证据)供客户选型。
+  户型候选使用 `floorplan-layout` 共享内核生成,与深化设计的 Generate / Fit / Furnish 工作流保持同一 typed contract。
   覆盖传统 AEC 里的"方案 / 概念设计"阶段,但不做施工图深化。
 - **inputs**: `[marketing_service, planning_management]`
 - **outputs**: `[detailed_design, quantity_costing]`
@@ -150,6 +152,7 @@ ArchIToken = AEC AI-Native + Harness Engineering + OpenBIM CDE Workflow OS
 - **description**:
   把选定的概念方案深化为可施工的 BIM + 施工图。
   包含结构计算、节点详图、机电综合、碰撞检查、规范合规复核。
+  平面生成、模板适配和家具布置使用共享 `floorplan-layout` 内核输出候选、评分、评估报告和 CDE manifest,进入专业复核后才能作为深化输入。
   产出 IFC4 + 施工图 PDF + 结构计算书。
 - **inputs**: `[planning_management, concept_design, standard_library]`
 - **outputs**: `[quantity_costing, production_manufacturing, construction_management]`
@@ -195,10 +198,11 @@ ArchIToken = AEC AI-Native + Harness Engineering + OpenBIM CDE Workflow OS
   面向重钢结构、装配式构件和工厂预制全流程。
   把 BIM 构件翻译成 CNC / 焊接文件 + 加工 BOM + 质检单。
   对接工厂 MES / ERP,回传加工进度、发运批次与质检结果。
+  当前阶段由 Paperclip v2026.517.0 完整接管本模块主工作区,用于 Agent 组织、工厂任务、心跳、预算和治理编排;它不替代 ArchIToken 的生产制造模块 ID、CDE 文件、CNC/QC/MES/ERP 真源或专业签审门禁。
 - **inputs**: `[planning_management, detailed_design, quantity_costing, standard_library]`
 - **outputs**: `[material_logistics, construction_management, finance_hr]`
 - **prompt_dir**: `prompts/production_manufacturing/`
-- **tables**: `work_orders`, `cnc_files`, `qc_records`, `production_batches`
+- **tables**: `work_orders`, `cnc_files`, `qc_records`, `production_batches`, `paperclip_agent_runs`
 
 ### 2.9 `construction_management` · 施工管理 · **status: active · depth: production-ready**
 
@@ -281,12 +285,13 @@ ArchIToken = AEC AI-Native + Harness Engineering + OpenBIM CDE Workflow OS
 - **order**: 13
 - **description**:
   企业 AI、API、RAG、MCP、Agent、模型路由、工具权限、安全审计和成本策略模块。
+  AI 中心同时承载接口管理、数据库管理和可视化面板治理,用于登记接口合同、数据对象、RLS 边界、运行视图和发布门禁。
   为所有业务模块提供统一 AI 能力编排、上下文治理、审计和成本控制。
   与设置中心共同构成平台级能力底座。
 - **inputs**: `[]` (平台能力底座)
 - **outputs**: `[]` (被其它模块引用)
 - **prompt_dir**: `prompts/ai_center/`
-- **tables**: `model_routes`, `rag_sources`, `mcp_tools`, `agent_runs`, `ai_cost_events`
+- **tables**: `model_routes`, `interface_contracts`, `database_bindings`, `visualization_panels`, `rag_sources`, `mcp_tools`, `agent_runs`, `ai_cost_events`
 
 ### 2.14 `settings_center` · 设置中心