@dazitech/cli 3.0.9 → 3.1.1

package/dist/examples/onto//350/256/276/345/244/207/350/277/220/350/220/245/plans//345/214/226/345/267/245/350/256/276/345/244/207/350/277/220/350/220/245/345/210/206/346/236/220/346/234/254/344/275/223/346/226/271/346/241/210.md

@@ -0,0 +1,735 @@
+# 化工设备运营分析本体方案
+
+**文档 ID**: `dazi_test/equipment-ops-analysis`
+
+> 表/Cube/对象命名遵循 [本体命名规范](../../../../../资源/docs/onto/本体命名规范_物理表Cube与对象.md)。  
+> 对照参考（只读）：[销售示例 plans](../../销售示例/plans/规划示例_产品销售本体规划方案.md)、[利润示例 plans](../../利润示例/plans/规划示例_利润分析本体方案.md)（均在 `资源/examples/onto/`）
+
+---
+
+## 一、空间概述
+
+| 项目     | 说明 |
+| -------- | ---- |
+| 空间 ID  | `space_cate_test01` |
+| 空间名称 | 分类测试01 |
+| 规划日期 | 2026-06-06 |
+| 实现单元 | `项目/DAZI_TEST/本体/ontos/设备运营/` |
+
+### 1.1 业务背景
+
+化工生产以**连续或间歇装置**为核心资产，设备可用性、负荷与能耗直接决定产能与安全。本方案构建**化工设备运营分析本体**，以业务语言描述「装置区」「工艺单元」「设备」「停机事件」「维保记录」及其关系，支撑：
+
+- **运营总览**：在运设备数、综合开动率、计划内/外停机时长
+- **OEE 分析**：可用率 × 性能率 × 质量率（按设备/单元/装置汇总）
+- **停机归因**：按故障类型、停机原因、责任部门展开
+- **维保管理**：计划维保达成率、维保工时与成本
+- **能耗强度**：单位产量能耗、装置能效对标（化工特色）
+- **趋势与对标**：同比/环比、装置间/单元间横向对比
+- **异常聚焦**：故障频次 Top N、长停机设备预警
+
+### 1.2 核心业务问题
+
+| 问题 | 说明 |
+| ---- | ---- |
+| 装置开不开得起来 | 可用率、计划停机 vs 非计划停机 |
+| 跑满没有 | 性能率、负荷率、设计产能利用率 |
+| 质量是否拖累 OEE | 质量率、不合格批次关联（本方案以汇总质量率字段承载） |
+| 停在哪、为何停 | 停机事件明细、故障代码结构 |
+| 维保是否到位 | 计划维保 vs 实际完成、逾期维保 |
+| 能耗是否异常 | 单吨/单批次能耗、与同类型设备对标 |
+| 哪台设备是短板 | Top 故障设备、MTBF/MTTR 概览 |
+
+### 1.3 与参照示例的差异说明
+
+| 维度 | 销售示例 | 利润示例 | 本方案（化工设备运营） |
+| ---- | -------- | -------- | ---------------------- |
+| 核心锚点 | 订单/客户/产品 | 科目/分录/预算 | **设备/装置/停机/维保** |
+| 主事实粒度 | 订单行 | 凭证行 | **设备日运行汇总 + 停机事件行** |
+| 核心 KPI | 销售额、渠道占比 | 收入、成本、利润率 | **OEE、可用率、MTBF、能耗强度** |
+| 组织维度 | 区域/渠道 | 成本中心 | **厂区 → 工艺单元 → 设备** |
+| 对比分析 | 同比销售 | 预实对比 | **计划运行 vs 实际运行、装置对标** |
+| 行业特征 | 通用零售 | 制造财务 GL | **化工装置、连续生产、能源消耗** |
+| 函数设计 | 销售结构/Top 产品 | 科目/利润项结构 | **OEE/停机/维保/能耗专项** |
+
+> **共存说明**：本空间可能与销售/利润域共用 `dim_date`；init **仅**创建/注册本域表，若 `dim_date` 已存在则 **ensure** 不重复建表。
+
+---
+
+## 二、物理层设计
+
+### 2.0 时间维：dim_date（强制）
+
+**用途**：全空间共享日历；事实表通过 **`date_key`** 关联。
+
+| 字段名 | 类型 | 显示名 | 说明 |
+| ------ | ---- | ------ | ---- |
+| **date_key** | Int32 | 日期键 | YYYYMMDD，主键 |
+| calendar_date | Date | 自然日 | |
+| year | Int16 | 公历年 | |
+| quarter | Int8 | 季度 | 1–4 |
+| month | Int8 | 月 | 1–12 |
+| week_of_year | Int8 | 周 | |
+| day_of_week | Int8 | 星期 | |
+| is_weekend | UInt8 | 是否周末 | 0/1 |
+| year_month | String | 年月 | 如 2025-06 |
+
+**排序键**：`ORDER BY (date_key)` · **引擎**：`MergeTree()`
+
+### 2.1 维度表：dim_plant（厂区/装置区）
+
+**用途**：化工生产厂区或大型装置区主数据。
+
+| 字段名 | 类型 | 显示名 | 说明 |
+| ------ | ---- | ------ | ---- |
+| plant_id | String | 厂区 ID | 主键 |
+| plant_code | String | 厂区编码 | |
+| plant_name | String | 厂区名称 | 如 乙烯装置区 |
+| company_code | String | 公司代码 | |
+| plant_type | String | 装置类型 | 炼油/烯烃/芳烃/精细化工 |
+| location | String | 地理位置 | |
+| design_capacity | Float64 | 设计产能 | 吨/年或标方/年 |
+| capacity_unit | String | 产能单位 | 吨/标方 |
+| status | String | 状态 | 运行/检修/停产 |
+| created_at | DateTime | 创建时间 | |
+
+**排序键**：`ORDER BY (plant_code)`
+
+### 2.2 维度表：dim_process_unit（工艺单元）
+
+**用途**：装置内工艺单元（蒸馏、反应、压缩等工段）。
+
+| 字段名 | 类型 | 显示名 | 说明 |
+| ------ | ---- | ------ | ---- |
+| unit_id | String | 单元 ID | 主键 |
+| unit_code | String | 单元编码 | |
+| unit_name | String | 单元名称 | 如 裂解炉区 |
+| plant_id | String | 所属厂区 | 关联 dim_plant |
+| plant_name | String | 厂区名称 | 冗余 |
+| unit_type | String | 单元类型 | 反应/分离/换热/公用工程 |
+| criticality | String | 关键等级 | A/B/C |
+| status | String | 状态 | |
+| created_at | DateTime | 创建时间 | |
+
+**排序键**：`ORDER BY (plant_id, unit_code)`
+
+### 2.3 维度表：dim_equipment_type（设备类型）
+
+**用途**：设备分类主数据（泵、压缩机、反应釜、塔器等）。
+
+| 字段名 | 类型 | 显示名 | 说明 |
+| ------ | ---- | ------ | ---- |
+| equip_type_id | String | 类型 ID | 主键 |
+| equip_type_code | String | 类型编码 | |
+| equip_type_name | String | 类型名称 | |
+| category | String | 大类 | 动设备/静设备/仪表/电气 |
+| parent_type_id | String | 上级类型 | 自关联 |
+| type_level | Int32 | 层级 | |
+| is_leaf | Boolean | 末级 | |
+| status | String | 状态 | |
+| created_at | DateTime | 创建时间 | |
+
+**排序键**：`ORDER BY (equip_type_code)`
+
+### 2.4 维度表：dim_equipment（设备主数据）
+
+**用途**：单台设备台账；OEE 与停机分析的核心维度。
+
+| 字段名 | 类型 | 显示名 | 说明 |
+| ------ | ---- | ------ | ---- |
+| equipment_id | String | 设备 ID | 主键 |
+| equipment_code | String | 设备位号 | 如 P-101A |
+| equipment_name | String | 设备名称 | |
+| equip_type_id | String | 设备类型 | 关联 dim_equipment_type |
+| equip_type_name | String | 类型名称 | 冗余 |
+| category | String | 设备大类 | 冗余 |
+| plant_id | String | 所属厂区 | 关联 dim_plant |
+| plant_name | String | 厂区名称 | 冗余 |
+| unit_id | String | 所属单元 | 关联 dim_process_unit |
+| unit_name | String | 单元名称 | 冗余 |
+| manufacturer | String | 制造商 | |
+| model | String | 型号 | |
+| install_date | Date | 投运日期 | |
+| design_capacity | Float64 | 设计能力 | |
+| capacity_unit | String | 能力单位 | t/h、m³/h 等 |
+| criticality | String | 关键等级 | A/B/C |
+| production_mode | String | 生产模式 | 连续/间歇 |
+| status | String | 状态 | 运行/备用/检修/报废 |
+| created_at | DateTime | 创建时间 | |
+
+**排序键**：`ORDER BY (plant_id, unit_id, equipment_code)`
+
+### 2.5 维度表：dim_downtime_reason（停机原因）
+
+**用途**：停机/故障原因码表。
+
+| 字段名 | 类型 | 显示名 | 说明 |
+| ------ | ---- | ------ | ---- |
+| reason_id | String | 原因 ID | 主键 |
+| reason_code | String | 原因编码 | |
+| reason_name | String | 原因名称 | |
+| reason_category | String | 原因大类 | 机械/电气/仪表/工艺/计划检修/外部 |
+| is_planned | UInt8 | 是否计划停机 | 0/1 |
+| parent_reason_id | String | 上级原因 | 自关联 |
+| status | String | 状态 | |
+| created_at | DateTime | 创建时间 | |
+
+**排序键**：`ORDER BY (reason_code)`
+
+### 2.6 事实表：fact_equipment_daily_ops（设备日运行汇总）
+
+**用途**：每台设备每日运行 KPI 汇总；OEE 计算主源。
+
+| 字段名 | 类型 | 显示名 | 说明 |
+| ------ | ---- | ------ | ---- |
+| ops_id | String | 汇总 ID | 主键 |
+| **date_key** | Int32 | 日期键 | 关联 dim_date |
+| calendar_date | Date | 统计日期 | |
+| equipment_id | String | 设备 ID | 关联 dim_equipment |
+| equipment_code | String | 设备位号 | 冗余 |
+| equipment_name | String | 设备名称 | 冗余 |
+| plant_id | String | 厂区 ID | 冗余 |
+| plant_name | String | 厂区名称 | 冗余 |
+| unit_id | String | 单元 ID | 冗余 |
+| unit_name | String | 单元名称 | 冗余 |
+| equip_type_id | String | 设备类型 | 冗余 |
+| category | String | 设备大类 | 冗余 |
+| calendar_minutes | Float64 | 日历时间 | 分钟，通常 1440 |
+| planned_downtime_min | Float64 | 计划停机 | 分钟 |
+| unplanned_downtime_min | Float64 | 非计划停机 | 分钟 |
+| runtime_min | Float64 | 运行时间 | 分钟 |
+| idle_min | Float64 | 待机时间 | 分钟 |
+| planned_output_qty | Float64 | 计划产量 | |
+| actual_output_qty | Float64 | 实际产量 | |
+| qualified_output_qty | Float64 | 合格产量 | |
+| output_unit | String | 产量单位 | 吨/批次 |
+| ideal_cycle_rate | Float64 | 理想节拍 | 单位/分钟 |
+| energy_consumption | Float64 | 能耗 | kWh 或 GJ |
+| energy_unit | String | 能耗单位 | |
+| shift_code | String | 班次 | 早/中/晚/全天 |
+| data_source | String | 数据来源 | DCS/MES/手工 |
+| created_at | DateTime | 创建时间 | |
+
+**排序键**：`ORDER BY (date_key, equipment_id, shift_code)`
+
+**OEE 口径（seed 与函数统一）**：
+
+| 指标 | 公式 | 说明 |
+| ---- | ---- | ---- |
+| 可用率 availability | runtime_min / (calendar_minutes - planned_downtime_min) | 分母为计划运行时间 |
+| 性能率 performance | (actual_output_qty / runtime_min) / ideal_cycle_rate | runtime_min>0 时计算 |
+| 质量率 quality | qualified_output_qty / actual_output_qty | actual_output_qty>0 时计算 |
+| OEE | availability × performance × quality | 0–1 |
+
+### 2.7 事实表：fact_downtime_event（停机事件明细）
+
+**用途**：单次停机/故障事件流水。
+
+| 字段名 | 类型 | 显示名 | 说明 |
+| ------ | ---- | ------ | ---- |
+| event_id | String | 事件 ID | 主键 |
+| **date_key** | Int32 | 日期键 | 关联 dim_date（事件开始日） |
+| equipment_id | String | 设备 ID | 关联 dim_equipment |
+| equipment_code | String | 设备位号 | 冗余 |
+| equipment_name | String | 设备名称 | 冗余 |
+| plant_id | String | 厂区 ID | 冗余 |
+| unit_id | String | 单元 ID | 冗余 |
+| reason_id | String | 停机原因 | 关联 dim_downtime_reason |
+| reason_code | String | 原因编码 | 冗余 |
+| reason_name | String | 原因名称 | 冗余 |
+| reason_category | String | 原因大类 | 冗余 |
+| is_planned | UInt8 | 是否计划停机 | 0/1 |
+| start_time | DateTime | 开始时间 | |
+| end_time | DateTime | 结束时间 | |
+| duration_min | Float64 | 停机时长 | 分钟 |
+| impact_level | String | 影响等级 | 高/中/低 |
+| responsible_dept | String | 责任部门 | 机动/电气/仪表/生产 |
+| description | String | 事件描述 | |
+| created_at | DateTime | 创建时间 | |
+
+**排序键**：`ORDER BY (date_key, equipment_id, start_time)`
+
+### 2.8 事实表：fact_maintenance_record（维保记录）
+
+**用途**：计划与实际维保作业记录。
+
+| 字段名 | 类型 | 显示名 | 说明 |
+| ------ | ---- | ------ | ---- |
+| maint_id | String | 维保 ID | 主键 |
+| **date_key** | Int32 | 日期键 | 关联 dim_date（计划或完成日） |
+| equipment_id | String | 设备 ID | 关联 dim_equipment |
+| equipment_code | String | 设备位号 | 冗余 |
+| plant_id | String | 厂区 ID | 冗余 |
+| unit_id | String | 单元 ID | 冗余 |
+| maint_type | String | 维保类型 | 预防/预测/故障维修/大修 |
+| plan_date | Date | 计划日期 | |
+| actual_date | Date | 实际完成日期 | 可空 |
+| plan_hours | Float64 | 计划工时 | |
+| actual_hours | Float64 | 实际工时 | |
+| plan_cost | Float64 | 计划费用 | |
+| actual_cost | Float64 | 实际费用 | |
+| status | String | 状态 | 计划/进行中/完成/逾期 |
+| is_on_schedule | UInt8 | 是否按期 | 1=按期完成 |
+| vendor | String | 维保单位 | |
+| description | String | 作业内容 | |
+| created_at | DateTime | 创建时间 | |
+
+**排序键**：`ORDER BY (date_key, equipment_id, maint_id)`
+
+### 2.9 事实表：fact_equipment_plan（设备运行计划）
+
+**用途**：计划运行时间/产量，用于计划 vs 实际对比。
+
+| 字段名 | 类型 | 显示名 | 说明 |
+| ------ | ---- | ------ | ---- |
+| plan_id | String | 计划 ID | 主键 |
+| **date_key** | Int32 | 日期键 | 关联 dim_date |
+| equipment_id | String | 设备 ID | 关联 dim_equipment |
+| equipment_code | String | 设备位号 | 冗余 |
+| plant_id | String | 厂区 ID | 冗余 |
+| unit_id | String | 单元 ID | 冗余 |
+| plan_version | String | 计划版本 | 如 2026月度计划 |
+| fiscal_year | Int32 | 计划年度 | |
+| fiscal_month | Int32 | 计划月份 | 1–12 |
+| planned_runtime_min | Float64 | 计划运行时间 | 分钟 |
+| planned_output_qty | Float64 | 计划产量 | |
+| planned_energy | Float64 | 计划能耗 | |
+| output_unit | String | 产量单位 | |
+| status | String | 状态 | 草稿/已发布 |
+| created_at | DateTime | 创建时间 | |
+
+**排序键**：`ORDER BY (fiscal_year, fiscal_month, equipment_id, plan_id)`
+
+---
+
+## 三、表间关系设计
+
+**关系模型**：
+
+```text
+                              dim_date
+                             (date_key PK)
+                                   ▲
+           ┌───────────────────────┼───────────────────────┐
+           │ date_key              │                       │ date_key
+           │                       │                       │
+    dim_plant ◄── dim_process_unit ◄── dim_equipment ◄── dim_equipment_type
+  (plant_id)    (unit_id)         (equipment_id)      (equip_type_id)
+       ▲               ▲                  ▲
+       │               │                  │
+       │               │    fact_equipment_daily_ops
+       │               │         (日运行汇总)
+       │               │                  │
+       │               │    fact_downtime_event ──► dim_downtime_reason
+       │               │         (停机事件)            (reason_id)
+       │               │
+       │               │    fact_maintenance_record
+       │               │         (维保记录)
+       │               │
+       └───────────────┴──── fact_equipment_plan
+                              (运行计划)
+```
+
+**关系清单（16 条）**：
+
+| 关系 ID | **347 分类** | 类型 | 从表 | 到表 | join_keys | 说明 |
+| ------- | ------------ | ---- | ---- | ---- | --------- | ---- |
+| rel_ops_date | **时间关联** | many_to_one | fact_equipment_daily_ops | dim_date | date_key → date_key | 日运行→日历 |
+| rel_downtime_date | **时间关联** | many_to_one | fact_downtime_event | dim_date | date_key → date_key | 停机→日历 |
+| rel_maint_date | **时间关联** | many_to_one | fact_maintenance_record | dim_date | date_key → date_key | 维保→日历 |
+| rel_plan_date | **时间关联** | many_to_one | fact_equipment_plan | dim_date | date_key → date_key | 计划→日历 |
+| rel_unit_plant | **主数据关联** | many_to_one | dim_process_unit | dim_plant | plant_id → plant_id | 单元→厂区 |
+| rel_equip_type | **主数据关联** | many_to_one | dim_equipment | dim_equipment_type | equip_type_id → equip_type_id | 设备→类型 |
+| rel_equip_plant | **主数据关联** | many_to_one | dim_equipment | dim_plant | plant_id → plant_id | 设备→厂区 |
+| rel_equip_unit | **主数据关联** | many_to_one | dim_equipment | dim_process_unit | unit_id → unit_id | 设备→单元 |
+| rel_ops_equip | **主数据关联** | many_to_one | fact_equipment_daily_ops | dim_equipment | equipment_id → equipment_id | 日运行→设备 |
+| rel_downtime_equip | **主数据关联** | many_to_one | fact_downtime_event | dim_equipment | equipment_id → equipment_id | 停机→设备 |
+| rel_downtime_reason | **主数据关联** | many_to_one | fact_downtime_event | dim_downtime_reason | reason_id → reason_id | 停机→原因 |
+| rel_maint_equip | **主数据关联** | many_to_one | fact_maintenance_record | dim_equipment | equipment_id → equipment_id | 维保→设备 |
+| rel_plan_equip | **主数据关联** | many_to_one | fact_equipment_plan | dim_equipment | equipment_id → equipment_id | 计划→设备 |
+| rel_equip_type_parent | **层级自关联** | many_to_one | dim_equipment_type | dim_equipment_type | parent_type_id → equip_type_id | 类型树 |
+| rel_reason_parent | **层级自关联** | many_to_one | dim_downtime_reason | dim_downtime_reason | parent_reason_id → reason_id | 原因树 |
+| rel_plan_vs_ops | **预实关联** | many_to_one | fact_equipment_plan | fact_equipment_daily_ops | equipment_id + date_key → equipment_id + date_key | 计划对比实际（逻辑关联，实施用 JOIN） |
+
+---
+
+## 四、Cube 层设计
+
+### 4.0 Cube 清单
+
+| Cube | 类别 | **347 分类** | 事实源 | 支撑对象 |
+| ---- | ---- | ------------ | ------ | -------- |
+| **OperationCube** | Process | **流程型** | fact_equipment_daily_ops | OperationSnapshot, EquipmentAnalysis |
+| **EquipmentCube** | Subject | **主体型** | fact_equipment_daily_ops | Equipment |
+| **PlantCube** | Subject | **主体型** | fact_equipment_daily_ops | Plant |
+| **ProcessUnitCube** | Subject | **主体型** | fact_equipment_daily_ops | ProcessUnit |
+| **DowntimeCube** | Process | **流程型** | fact_downtime_event | DowntimeEvent |
+| **MaintenanceCube** | Process | **流程型** | fact_maintenance_record | MaintenanceRecord |
+| **PlanVsActualCube** | Comparison | **对比型** | fact_equipment_plan + fact_equipment_daily_ops | PlanAnalysis |
+
+### 4.1 OperationCube（Process · 日运行主 Cube）
+
+**事实源**：`fact_equipment_daily_ops`
+
+**维度**：ops_id, date_key, calendar_date, year, month, equipment_id, equipment_code, equipment_name, plant_id, plant_name, unit_id, unit_name, equip_type_id, category, shift_code
+
+**度量**：
+
+| 度量名 | 列名 | 聚合 | 说明 |
+| ------ | ---- | ---- | ---- |
+| calendar_minutes_total | calendar_minutes | sum | 日历时间合计 |
+| planned_downtime_total | planned_downtime_min | sum | 计划停机合计 |
+| unplanned_downtime_total | unplanned_downtime_min | sum | 非计划停机合计 |
+| runtime_total | runtime_min | sum | 运行时间合计 |
+| actual_output_total | actual_output_qty | sum | 实际产量 |
+| qualified_output_total | qualified_output_qty | sum | 合格产量 |
+| energy_total | energy_consumption | sum | 能耗合计 |
+| ops_days | ops_id | count | 汇总行数 |
+
+**派生度量**：
+
+| 度量名 | 表达式（示意） | 说明 |
+| ------ | -------------- | ---- |
+| availability | runtime_total / (calendar_minutes_total - planned_downtime_total) | 可用率 |
+| performance | (actual_output_total / runtime_total) / avg(ideal_cycle_rate) | 性能率（按聚合层重算） |
+| quality | qualified_output_total / actual_output_total | 质量率 |
+| oee | availability * performance * quality | 综合效率 |
+| load_rate | runtime_total / (calendar_minutes_total - planned_downtime_total) | 负荷率 |
+| energy_per_output | energy_total / actual_output_total | 单位产量能耗 |
+
+### 4.2 EquipmentCube（Subject · 设备运营）
+
+**目的**：Equipment 对象 bind_source
+
+**维度**：equipment_id, equipment_code, equipment_name, equip_type_id, equip_type_name, category, plant_id, plant_name, unit_id, unit_name, criticality, production_mode, year, month
+
+**度量**：runtime_total, unplanned_downtime_total, actual_output_total, energy_total, ops_days
+
+**派生度量**：availability, performance, quality, oee, energy_per_output, mtbf_hours（示意：runtime_total / downtime_event_count，函数层 JOIN 停机表）
+
+### 4.3 PlantCube（Subject · 厂区）
+
+**维度**：plant_id, plant_name, plant_type, year, month
+
+**度量**：runtime_total, unplanned_downtime_total, actual_output_total, energy_total
+
+**派生度量**：availability, oee, energy_per_output
+
+### 4.4 ProcessUnitCube（Subject · 工艺单元）
+
+**维度**：unit_id, unit_name, unit_type, plant_id, plant_name, criticality, year, month
+
+**度量**：runtime_total, unplanned_downtime_total, actual_output_total, energy_total
+
+**派生度量**：availability, oee, load_rate
+
+### 4.5 DowntimeCube（Process · 停机事件）
+
+**事实源**：`fact_downtime_event`
+
+**维度**：event_id, date_key, equipment_id, equipment_code, plant_id, unit_id, reason_id, reason_code, reason_name, reason_category, is_planned, responsible_dept, year, month
+
+**度量**：
+
+| 度量名 | 列名 | 聚合 | 说明 |
+| ------ | ---- | ---- | ---- |
+| downtime_minutes | duration_min | sum | 停机时长 |
+| event_count | event_id | count | 事件次数 |
+
+**派生度量**：avg_downtime = downtime_minutes / event_count
+
+### 4.6 MaintenanceCube（Process · 维保）
+
+**事实源**：`fact_maintenance_record`
+
+**维度**：maint_id, date_key, equipment_id, plant_id, unit_id, maint_type, status, year, month
+
+**度量**：plan_hours, actual_hours, plan_cost, actual_cost, maint_count（count maint_id）
+
+**派生度量**：schedule_rate = sumIf(1, is_on_schedule=1) / maint_count；cost_variance = actual_cost - plan_cost
+
+### 4.7 PlanVsActualCube（Comparison · 计划 vs 实际）
+
+**目的**：运行计划对比读模型
+
+**维度**：fiscal_year, fiscal_month, equipment_id, equipment_code, plant_id, unit_id, plan_version
+
+**度量**：planned_runtime_min, planned_output_qty, planned_energy（来自 plan）；actual_runtime_min, actual_output_qty, actual_energy（来自 OperationCube 聚合）；variance_runtime, variance_output, execution_rate（派生）
+
+---
+
+## 五、本体层设计
+
+### 5.1 对象类型（10 种）
+
+| code | 分类 | **347 分类** | 名称 | bind_source | 主物理支撑 |
+| ---- | ---- | ------------ | ---- | ----------- | ---------- |
+| Plant | Master | **主数据** | 厂区/装置区 | PlantCube | dim_plant |
+| ProcessUnit | Master | **主数据** | 工艺单元 | ProcessUnitCube | dim_process_unit |
+| EquipmentType | Master | **主数据** | 设备类型 | — | dim_equipment_type |
+| Equipment | Master | **主数据** | 设备 | EquipmentCube | dim_equipment |
+| DowntimeReason | Reference | **参考** | 停机原因 | — | dim_downtime_reason |
+| OperationSnapshot | Transaction | **事务** | 日运行汇总 | OperationCube | fact_equipment_daily_ops |
+| DowntimeEvent | Transaction | **事务** | 停机事件 | DowntimeCube | fact_downtime_event |
+| MaintenanceRecord | Transaction | **事务** | 维保记录 | MaintenanceCube | fact_maintenance_record |
+| EquipmentAnalysis | Analytical | **分析** | 设备运营分析 | OperationCube | fact_equipment_daily_ops |
+| PlanAnalysis | Analytical | **分析** | 计划对比分析 | PlanVsActualCube | fact_equipment_plan + fact_equipment_daily_ops |
+
+### 5.2 对象属性（节选）
+
+#### Equipment（设备）
+
+| 属性 code | 名称 | semantic_role | qualified_name |
+| --------- | ---- | ------------- | -------------- |
+| id | 设备 ID | dimension | EquipmentCube.equipment_id |
+| code | 设备位号 | dimension | EquipmentCube.equipment_code |
+| name | 设备名称 | dimension | EquipmentCube.equipment_name |
+| category | 设备大类 | dimension | EquipmentCube.category |
+| criticality | 关键等级 | dimension | EquipmentCube.criticality |
+| runtime | 运行时间 | measure | EquipmentCube.runtime_total |
+| availability | 可用率 | measure | EquipmentCube.availability |
+| oee | 综合效率 | measure | EquipmentCube.oee |
+| energy_per_output | 单位产量能耗 | measure | EquipmentCube.energy_per_output |
+
+#### DowntimeEvent（停机事件）
+
+| 属性 code | 名称 | semantic_role | qualified_name |
+| --------- | ---- | ------------- | -------------- |
+| id | 事件 ID | dimension | DowntimeCube.event_id |
+| duration | 停机时长 | measure | DowntimeCube.downtime_minutes |
+| reason | 原因名称 | dimension | DowntimeCube.reason_name |
+| is_planned | 是否计划 | dimension | DowntimeCube.is_planned |
+
+#### Plant（厂区）
+
+| 属性 code | 名称 | semantic_role | qualified_name |
+| --------- | ---- | ------------- | -------------- |
+| id | 厂区 ID | dimension | PlantCube.plant_id |
+| name | 厂区名称 | dimension | PlantCube.plant_name |
+| oee | 装置 OEE | measure | PlantCube.oee |
+| availability | 可用率 | measure | PlantCube.availability |
+
+### 5.3 链接类型（16 种）
+
+| 链接 code | **347 分类** | 名称 | from | to | 说明 |
+| --------- | ------------ | ---- | ---- | -- | ---- |
+| unit_belongs_plant | **归属关系** | 单元归属厂区 | ProcessUnit | Plant | 组织层级 |
+| equipment_belongs_plant | **归属关系** | 设备归属厂区 | Equipment | Plant | |
+| equipment_belongs_unit | **归属关系** | 设备归属单元 | Equipment | ProcessUnit | |
+| equipment_has_type | **归属关系** | 设备属于类型 | Equipment | EquipmentType | |
+| snapshot_for_equipment | **归属关系** | 日运行归属设备 | OperationSnapshot | Equipment | |
+| downtime_on_equipment | **归属关系** | 停机发生于设备 | DowntimeEvent | Equipment | |
+| downtime_has_reason | **归属关系** | 停机对应原因 | DowntimeEvent | DowntimeReason | |
+| maint_for_equipment | **归属关系** | 维保针对设备 | MaintenanceRecord | Equipment | |
+| equip_type_has_parent | **层级关系** | 类型上级 | EquipmentType | EquipmentType | 类型树 |
+| reason_has_parent | **层级关系** | 原因上级 | DowntimeReason | DowntimeReason | 原因树 |
+| plan_compared_to_actual | **对比关系** | 计划对比实际 | PlanAnalysis | EquipmentAnalysis | 预实分析 |
+| analysis_by_equipment | **分析归因** | 分析归因设备 | EquipmentAnalysis | Equipment | |
+| analysis_by_plant | **分析归因** | 分析归因厂区 | EquipmentAnalysis | Plant | |
+| analysis_by_unit | **分析归因** | 分析归因单元 | EquipmentAnalysis | ProcessUnit | |
+| analysis_by_downtime | **分析归因** | 分析归因停机 | EquipmentAnalysis | DowntimeEvent | 停机驱动 |
+| analysis_by_maintenance | **分析归因** | 分析归因维保 | EquipmentAnalysis | MaintenanceRecord | 维保影响 |
+
+---
+
+## 六、本体函数设计
+
+### 6.1 函数清单
+
+| 函数 ID | **347 分类** | 功能 | 参数 |
+| ------- | ------------ | ---- | ---- |
+| equip_ops.fn.get_summary | **总览分析** | 设备运营总览 | start_date, end_date, plant_id（可选） |
+| equip_ops.fn.oee_analysis | **总览分析** | OEE 分解（可用/性能/质量） | start_date, end_date, equipment_id（可选）, group_by |
+| equip_ops.fn.availability_analysis | **结构分析** | 可用率与停机结构 | start_date, end_date, plant_id（可选） |
+| equip_ops.fn.downtime_breakdown | **结构分析** | 停机原因结构 | start_date, end_date, reason_level, plant_id（可选） |
+| equip_ops.fn.yoy_analysis | **趋势分析** | 同比分析 | start_date, end_date, metric, plant_id（可选） |
+| equip_ops.fn.mom_analysis | **趋势分析** | 环比分析 | start_date, end_date, metric, unit_id（可选） |
+| equip_ops.fn.top_fault_equipment | **结构分析** | 故障 TOP 设备 | start_date, end_date, limit, plant_id（可选） |
+| equip_ops.fn.maintenance_compliance | **组织分析** | 维保达成分析 | start_date, end_date, plant_id（可选） |
+| equip_ops.fn.energy_intensity | **结构分析** | 能耗强度分析 | start_date, end_date, group_by, plant_id（可选） |
+| equip_ops.fn.plan_vs_actual | **预实分析** | 运行计划对比 | fiscal_year, fiscal_month, plan_version, plant_id（可选） |
+| equip_ops.fn.unit_comparison | **组织分析** | 工艺单元对标 | start_date, end_date, metric, plant_id |
+
+### 6.2 函数示例：equip_ops.fn.get_summary
+
+**功能**：期间设备运营总览
+
+**返回值**：
+
+| 字段名 | 类型 | 说明 |
+| ------ | ---- | ---- |
+| equipment_count | Int | 纳入统计设备数 |
+| avg_availability | Float64 | 平均可用率 |
+| avg_oee | Float64 | 平均 OEE |
+| total_runtime_hours | Float64 | 总运行小时 |
+| total_unplanned_downtime_hours | Float64 | 非计划停机小时 |
+| total_output_qty | Float64 | 总产量 |
+| total_energy | Float64 | 总能耗 |
+| energy_per_output | Float64 | 单位产量能耗 |
+| downtime_event_count | Int | 停机事件次数 |
+
+### 6.3 函数示例：equip_ops.fn.oee_analysis
+
+**功能**：OEE 三分解及分组汇总
+
+**参数**：`group_by` = `equipment` | `unit` | `plant` | `equip_type`
+
+**返回值**：group_id, group_name, availability, performance, quality, oee, runtime_hours, output_qty
+
+### 6.4 函数示例：equip_ops.fn.downtime_breakdown
+
+**功能**：按停机原因层级展开结构与占比
+
+**返回值**：reason_code, reason_name, reason_category, is_planned, downtime_hours, event_count, share_pct
+
+### 6.5 测试参数（test_arguments）
+
+| 函数 ID | 默认 arguments 要点 |
+| ------- | ------------------- |
+| equip_ops.fn.get_summary | start_date=2025-01-01, end_date=2026-06-30 |
+| equip_ops.fn.oee_analysis | 同上, group_by=plant |
+| equip_ops.fn.availability_analysis | 同上 |
+| equip_ops.fn.downtime_breakdown | reason_level=2 |
+| equip_ops.fn.yoy_analysis | metric=oee |
+| equip_ops.fn.mom_analysis | metric=availability |
+| equip_ops.fn.top_fault_equipment | limit=10 |
+| equip_ops.fn.maintenance_compliance | 2025-01-01 ~ 2026-06-30 |
+| equip_ops.fn.energy_intensity | group_by=plant |
+| equip_ops.fn.plan_vs_actual | fiscal_year=2026, fiscal_month=6, plan_version=2026月度计划 |
+| equip_ops.fn.unit_comparison | metric=oee, plant_id（如有） |
+
+---
+
+## 七、实施计划
+
+### 7.1 阶段一：物理层
+
+| 步骤 | 任务 | 说明 |
+| ---- | ---- | ---- |
+| 1 | **dim_date** | 共用或 ensure |
+| 2 | dim_plant | 厂区维 |
+| 3 | dim_process_unit | 工艺单元维 |
+| 4 | dim_equipment_type | 设备类型维 |
+| 5 | dim_equipment | 设备台账 |
+| 6 | dim_downtime_reason | 停机原因维 |
+| 7 | fact_equipment_daily_ops | 含 **date_key** |
+| 8 | fact_downtime_event | 含 **date_key** |
+| 9 | fact_maintenance_record | 含 **date_key** |
+| 10 | fact_equipment_plan | 含 **date_key** |
+| 11 | **TABLE_REGISTRY** + `register_with_meta` | |
+| 12 | **表间关系（16 条）** | 含 4 条 fact→dim_date |
+
+### 7.2 阶段二：Cube 层
+
+| 步骤 | 任务 |
+| ---- | ---- |
+| 13 | 注册 **7 个 Cube** |
+| 14 | 派生度量 availability/performance/quality/oee/energy_per_output |
+
+### 7.3 阶段三：本体层
+
+| 步骤 | 任务 |
+| ---- | ---- |
+| 15 | define_object_type（10 种） |
+| 16 | bind_source |
+| 17 | define_property |
+| 18 | define_link_type（16 种） |
+| 19 | sync_metric_refs |
+| 20 | **CATEGORY_REGISTRY** + `apply_registry`（独立 category_mount 脚本） |
+
+### 7.4 阶段四：函数与数据
+
+| 步骤 | 任务 |
+| ---- | ---- |
+| 21 | `equip_ops_ontology_init.py` + `equip_ops_seed_data.py` |
+| 22 | 11 个 `equip_ops_fn_*.py` |
+| 23 | publish + run → save-test-arguments |
+| 24 | `equip_ops_category_mount.py` 最后执行 |
+
+---
+
+## 八、风险与验收
+
+### 8.1 风险
+
+| 等级 | 风险 | 缓解措施 |
+| ---- | ---- | -------- |
+| 中 | OEE 口径与 DCS/MES 不一致 | 规划与 seed 统一公式；函数注释写明口径 |
+| 中 | 计划停机计入可用率分母 | seed 区分 planned/unplanned；函数与 Cube 一致 |
+| 中 | 多班次同日多行重复计量 | ops_id 含 shift；汇总函数按 equipment+date 去重或 sum |
+| 低 | 多域共用 space_id | init 仅创建本域表 |
+| 低 | 能耗单位不统一 | seed 固定 energy_unit；强度函数按单位过滤 |
+
+### 8.2 验收标准
+
+| 验收项 | 标准 |
+| ------ | ---- |
+| dim_date | 可查询；fact 的 date_key 可 JOIN |
+| 维度表 | 5 张（plant/unit/equip_type/equipment/downtime_reason）可查询 |
+| fact_equipment_daily_ops | OEE 手工 SQL 与 get_summary 一致 |
+| fact_downtime_event | 停机时长汇总与 downtime_breakdown 一致 |
+| **表间关系** | **16 条** |
+| Cube | **7 个** + 派生度量 |
+| 对象 | 10 种 + 分类；16 种链接 |
+| 函数 | get_summary、oee_analysis、downtime_breakdown 可运行 |
+
+---
+
+## 附录 B：347 分类挂载对照表（CATEGORY_REGISTRY）
+
+### B.1 物理表（table）
+
+| 347 分类 | 表名 |
+| -------- | ---- |
+| 时间维 | dim_date |
+| 维度表 | dim_plant, dim_process_unit, dim_equipment_type, dim_equipment, dim_downtime_reason |
+| 事实表 | fact_equipment_daily_ops, fact_downtime_event, fact_maintenance_record, fact_equipment_plan |
+
+### B.2 Cube
+
+| 347 分类 | Cube 名 |
+| -------- | ------- |
+| 流程型 | OperationCube, DowntimeCube, MaintenanceCube |
+| 主体型 | EquipmentCube, PlantCube, ProcessUnitCube |
+| 对比型 | PlanVsActualCube |
+
+### B.3 对象类型
+
+| 347 分类 | 对象 code |
+| -------- | --------- |
+| 主数据 | Plant, ProcessUnit, EquipmentType, Equipment |
+| 参考 | DowntimeReason |
+| 事务 | OperationSnapshot, DowntimeEvent, MaintenanceRecord |
+| 分析 | EquipmentAnalysis, PlanAnalysis |
+
+### B.4 链接类型
+
+| 347 分类 | 链接 code |
+| -------- | --------- |
+| 归属关系 | unit_belongs_plant, equipment_belongs_plant, equipment_belongs_unit, equipment_has_type, snapshot_for_equipment, downtime_on_equipment, downtime_has_reason, maint_for_equipment |
+| 层级关系 | equip_type_has_parent, reason_has_parent |
+| 对比关系 | plan_compared_to_actual |
+| 分析归因 | analysis_by_equipment, analysis_by_plant, analysis_by_unit, analysis_by_downtime, analysis_by_maintenance |
+
+### B.5 函数
+
+| 347 分类 | 函数 ID |
+| -------- | ------- |
+| 总览分析 | equip_ops.fn.get_summary, equip_ops.fn.oee_analysis |
+| 趋势分析 | equip_ops.fn.yoy_analysis, equip_ops.fn.mom_analysis |
+| 结构分析 | equip_ops.fn.availability_analysis, equip_ops.fn.downtime_breakdown, equip_ops.fn.top_fault_equipment, equip_ops.fn.energy_intensity |
+| 预实分析 | equip_ops.fn.plan_vs_actual |
+| 组织分析 | equip_ops.fn.maintenance_compliance, equip_ops.fn.unit_comparison |
+
+---
+
+## 附录：规划完整性自检清单
+
+- [ ] 业务场景：化工设备运营域边界、OEE/停机/维保/能耗目标已写清
+- [ ] 物理层：dim_date（含 date_key）、5 张维度表、4 张事实表
+- [ ] 表间关系：16 条（含 dim_date 关联、层级自关联、预实关联）
+- [ ] Cube 层：7 个 Cube（含 PlanVsActualCube）、派生度量
+- [ ] 本体层：10 种对象类型、16 种链接类型
+- [ ] 函数设计：11 个函数（含 test_arguments 要点）
+- [ ] 347 分类：附录 B 完整
+- [ ] 与参照示例差异说明：已填写（§1.3）