@dazitech/cli 3.0.8 → 3.0.9

package/dist/docs/onto//350/247/204/345/210/222/347/244/272/344/276/213_/345/210/251/346/266/246/345/210/206/346/236/220/346/234/254/344/275/223/346/226/271/346/241/210.md

@@ -1,19 +1,33 @@
-# 利润分析本体规划方案
+# 规划示例 · 利润分析本体方案
+
+**文档 ID**: `onto/planning-example-profit`
+
+> 表/Cube/对象命名遵循 [本体命名规范](./本体命名规范_物理表Cube与对象.md)。  
+> 工程模式参考：[规划示例_产品销售本体规划方案.md](./规划示例_产品销售本体规划方案.md)
+
+**占位符**（复制到工作区 `plans/` 后替换为实际值）：
+
+| 占位符 | 含义 | 权威来源 |
+| ------ | ---- | -------- |
+| `<space-id>` | 数据空间 ID | `项目/<业务名>/本体/ontos/<实现名>/README.md` |
+| `<业务名>` | 业务项目目录名 | 工作区 `项目/` 下文件夹 |
+| `<实现名>` | 本体实现单元名 | 如 `利润分析本体方案` |
+| `<item-path>` | 实现单元根路径 | `项目/<业务名>/本体/ontos/<实现名>` |
 
 ---
 
 ## 一、空间概述
 
-| 项目     | 说明                                                                         |
-| -------- | ---------------------------------------------------------------------------- |
-| 空间 ID  | `space__zlj`                                                                 |
-| 空间名称 | 数据空间zlj                                                                  |
-| 空间状态 | 与「产品销售」「员工培训」等**共用同一数据空间**；利润域表/Cube/对象独立建设 |
-| 规划日期 | 2026-06-06                                                                   |
-| 实现单元 | `项目/潘达石化/本体/ontos/利润分析本体方案/`                                 |
+| 项目     | 说明 |
+| -------- | ---- |
+| 空间 ID  | `<space-id>`（示例：`space__acme`） |
+| 空间名称 | `<空间名称>`（与平台数据空间显示名一致） |
+| 空间状态 | 可与销售等其他域**共用**同一 `<space-id>`；利润域表/Cube/对象独立建设 |
+| 规划日期 | （填写定稿日期） |
+| 实现单元 | `<item-path>/` |
 
-> **共存说明**：本空间可能已有 `product_master`、`sales_order_fact`、`training_record` 等表。利润分析域以 **会计科目 + 实际分录 + 预算** 为读模型根基，init 脚本**仅**创建/注册利润域表，不覆盖其他域资产。  
-> **与销售域关系**：销售收入可通过科目映射（如「6001 主营业务收入」）与实际分录对齐；必要时函数层 LEFT JOIN `sales_order_fact` 做勾稽，但**本体对象不以订单为主锚点**。
+> **共存说明**：本空间可能已有销售域 `dim_product`、`fact_sales_order_line` 等表。利润域 init **仅**创建/注册本域表；若 **`dim_date`** 已存在则 **ensure** 不重复建表。  
+> **与销售域关系**：销售收入可通过科目映射与实际分录对齐；勾稽函数可 LEFT JOIN `fact_sales_order_line`，**本体对象不以订单为主锚点**。
 
 ---
 
@@ -21,7 +35,7 @@
 
 ### 2.1 业务背景
 
-潘达石化财务利润分析场景，需构建**利润分析本体**，以业务语言描述「会计科目」「实际分录」「预算」及其关系，支撑：
+某制造企业（示例）财务利润分析场景，需构建**利润分析本体**，以业务语言描述「会计科目」「实际分录」「预算」及其关系，支撑：
 
 - **损益总览**：收入、成本、费用、营业利润、利润率
 - **科目结构**：按科目层级展开收入/成本/费用构成
@@ -43,155 +57,122 @@
 
 ### 2.3 规划范围说明
 
-**核心物理表（本方案重点）**：
-
-| 表名                   | 中文名         | 角色                            |
-| ---------------------- | -------------- | ------------------------------- |
-| `account_master`       | **科目表**     | 会计科目主数据（维表）          |
-| `actual_journal_entry` | **实际分录表** | 总账/财务实际记账流水（事实表） |
-| `budget_entry`         | **预算表**     | 预算编制明细（事实表）          |
+**物理表清单**（命名见 [命名规范 §2](./本体命名规范_物理表Cube与对象.md#2-物理表类别与前缀)）：
 
-**辅助维表**：
+| 表名 | 前缀类别 | **347 分类** | 显示名 | 说明 | 角色 |
+| ---- | -------- | ------------ | ------ | ---- | ---- |
+| **`dim_date`** | 时间维（**强制**） | **时间维** | 日期维表 | 与 sales 域共用；PK **`date_key`** | 时间维 |
+| `dim_account` | dim | **维度表** | 科目维表 | 会计科目主数据 | dim |
+| `dim_cost_center` | dim | **维度表** | 成本中心维表 | 组织/利润中心主数据 | dim |
+| **`fact_gl_journal_entry`** | fact | **事实表** | 总账实际分录 | 凭证行粒度损益流水；含 **date_key** | fact |
+| **`fact_budget_entry`** | fact | **事实表** | 预算明细 | 预算行粒度编制数据；含 **date_key** | fact |
 
-| 表名                    | 中文名       | 角色                     |
-| ----------------------- | ------------ | ------------------------ |
-| `cost_center_dimension` | 成本中心维表 | 组织/部门/利润中心主数据 |
-
-> 规划原则：先定义**业务对象**（Account、JournalEntry、BudgetLine 等）与**链接**，再反推物理表。  
-> **实际分录**承载「实际发生」；**预算表**承载「计划数」；**科目表**统一语义与损益口径（收入/成本/费用）。  
-> 旧版示例中的 `profit_analysis_fact`（订单粒度收入/成本）**不作为本方案主模型**；若需订单维度利润，可另建与销售域的映射函数，不替代 GL 分录。
-
----
+> 规划原则：先定义 **Account、JournalEntry、BudgetLine** 等业务对象与链接，再反推 Cube 与物理表。旧版 `profit_analysis_fact`（订单粒度）**不作为主模型**。  
+> init 脚本 `资源/examples/onto/利润示例/setup/profit_ontology_init.py` 顶部 **`TABLE_REGISTRY`** 与上表及 §3.x 字段 **显示名/说明** 一一对应，经 `s.tables.register_with_meta` 注册；**`CATEGORY_REGISTRY`** 见 [附录 B](#附录-b347-分类挂载对照表category_registry)。
 
 ## 三、物理层设计
 
-### 3.1 科目表：account_master
-
-**用途**：存储会计科目主数据，定义损益口径与层级，供实际分录、预算关联及科目树分析。
-
-**表结构**：
-
-| 字段名            | 类型     | 说明                                        | 主键/索引 |
-| ----------------- | -------- | ------------------------------------------- | --------- |
-| account_id        | String   | 科目 ID                                     | PK        |
-| account_code      | String   | 科目编码（如 6001、6401）                   |           |
-| account_name      | String   | 科目名称                                    |           |
-| account_type      | String   | 科目类型（资产/负债/权益/收入/成本/费用）   |           |
-| pl_category       | String   | 损益大类（营业收入/营业成本/期间费用/其他） |           |
-| parent_account_id | String   | 上级科目 ID（根节点为空）                   | FK 语义   |
-| account_level     | Int32    | 科目层级（1=一级，2=二级…）                 |           |
-| is_leaf           | Boolean  | 是否末级科目                                |           |
-| normal_balance    | String   | 余额方向（借/贷）                           |           |
-| status            | String   | 状态（启用/停用）                           |           |
-| created_at        | DateTime | 创建时间                                    |           |
-
-**排序键**：`ORDER BY (account_code)`  
-**引擎**：`MergeTree()`
-
-**业务规则**：
-
-- 损益分析默认过滤 `account_type IN ('收入','成本','费用')`
-- `pl_category` 用于利润表行项目归集；函数层可按一级科目 + `pl_category` 双轨展示
-- 收入类科目：`amount_signed` 为正表示增加利润；成本/费用类为负向影响（见 §3.3 符号约定）
-
-### 3.2 成本中心维表：cost_center_dimension
-
-**用途**：组织/部门/利润中心主数据，支撑分录与预算的多维切片。
-
-| 字段名           | 类型     | 说明              |
-| ---------------- | -------- | ----------------- |
-| cost_center_id   | String   | 成本中心 ID（PK） |
-| cost_center_code | String   | 编码              |
-| cost_center_name | String   | 名称              |
-| department       | String   | 所属部门          |
-| company_code     | String   | 公司代码          |
-| profit_center    | String   | 利润中心          |
-| status           | String   | 状态              |
-| created_at       | DateTime | 创建时间          |
-
-**排序键**：`ORDER BY (cost_center_id)`
-
-### 3.3 实际分录表：actual_journal_entry
-
-**用途**：存储总账凭证行粒度实际发生额，是 ActualCube / JournalEntry 对象的主要事实来源。
-
-**表结构**：
-
-| 字段名           | 类型     | 说明                                | 主键/索引 |
-| ---------------- | -------- | ----------------------------------- | --------- |
-| entry_id         | String   | 凭证 ID                             |           |
-| line_id          | String   | 凭证行 ID                           | PK 组合   |
-| posting_date     | Date     | 记账日期                            |           |
-| fiscal_year      | Int32    | 会计年度                            |           |
-| fiscal_period    | Int32    | 会计期间（1–12）                    |           |
-| account_id       | String   | 科目 ID → account_master            | FK 语义   |
-| account_code     | String   | 科目编码（冗余）                    |           |
-| account_name     | String   | 科目名称（冗余）                    |           |
-| account_type     | String   | 科目类型（冗余）                    |           |
-| pl_category      | String   | 损益大类（冗余）                    |           |
-| cost_center_id   | String   | 成本中心 ID → cost_center_dimension | FK 语义   |
-| cost_center_name | String   | 成本中心名称（冗余）                |           |
-| department       | String   | 部门（冗余）                        |           |
-| debit_amount     | Float64  | 借方金额                            |           |
-| credit_amount    | Float64  | 贷方金额                            |           |
-| amount_signed    | Float64  | **损益符号金额**（见下）            |           |
-| currency         | String   | 币种                                |           |
-| voucher_no       | String   | 凭证号                              |           |
-| source_system    | String   | 来源系统（GL/ERP）                  |           |
-| description      | String   | 摘要                                |           |
-| created_at       | DateTime | 创建时间                            |           |
-
-**排序键**：`ORDER BY (posting_date, entry_id, line_id)`  
-**引擎**：`MergeTree()`
-
-**损益符号约定 `amount_signed`**（写入 ETL/seed 时统一计算，便于 Cube 聚合）：
-
-| account_type | 计算规则（示例）               | 含义        |
-| ------------ | ------------------------------ | ----------- |
-| 收入         | `credit_amount - debit_amount` | 正=收入增加 |
-| 成本         | `debit_amount - credit_amount` | 正=成本发生 |
-| 费用         | `debit_amount - credit_amount` | 正=费用发生 |
-
-**分析口径**：
-
-- `revenue` = Σ `amount_signed` where `account_type='收入'`
-- `cost` = Σ `amount_signed` where `account_type='成本'`
-- `expense` = Σ `amount_signed` where `account_type='费用'`
-- `operating_profit` = `revenue - cost - expense`
-
-### 3.4 预算表：budget_entry
-
-**用途**：存储预算编制明细（年度/月度预算版本），支撑预算 vs 实际分析。
-
-**表结构**：
-
-| 字段名           | 类型     | 说明                                    | 主键/索引 |
-| ---------------- | -------- | --------------------------------------- | --------- |
-| budget_id        | String   | 预算批次 ID                             |           |
-| line_id          | String   | 预算行 ID                               | PK 组合   |
-| budget_version   | String   | 预算版本（如 2026年度预算）             |           |
-| fiscal_year      | Int32    | 预算年度                                |           |
-| fiscal_period    | Int32    | 预算期间（1–12，0=全年）                |           |
-| account_id       | String   | 科目 ID → account_master                | FK 语义   |
-| account_code     | String   | 科目编码（冗余）                        |           |
-| account_name     | String   | 科目名称（冗余）                        |           |
-| account_type     | String   | 科目类型（冗余）                        |           |
-| pl_category      | String   | 损益大类（冗余）                        |           |
-| cost_center_id   | String   | 成本中心 ID                             | FK 语义   |
-| cost_center_name | String   | 成本中心名称（冗余）                    |           |
-| department       | String   | 部门（冗余）                            |           |
-| budget_amount    | Float64  | 预算金额（与 `amount_signed` 同向符号） |           |
-| currency         | String   | 币种                                    |           |
-| status           | String   | 状态（草稿/已发布）                     |           |
-| created_at       | DateTime | 创建时间                                |           |
-
-**排序键**：`ORDER BY (fiscal_year, fiscal_period, account_id, line_id)`  
-**引擎**：`MergeTree()`
-
-**业务规则**：
-
-- 分析默认 `status = '已发布'`
-- 月度预算：`fiscal_period BETWEEN 1 AND 12`；年度汇总：`fiscal_period = 0` 或由函数按月 SUM
+### 3.0 时间维：dim_date（强制）
+
+与销售域共用；字段定义见 [销售规划示例 §3.0](./规划示例_产品销售本体规划方案.md#30-时间维dim_date强制)。分录 **`date_key = toYYYYMMDD(posting_date)`**；预算行可用 **`toYYYYMMDD(toDate(concat(toString(fiscal_year), '-', lpad(toString(fiscal_period), 2, '0'), '-01')))`** 或 period 末代表日，规划须写清口径。
+
+### 3.1 维度表：dim_account
+
+**用途**：会计科目主数据；科目树与损益口径。
+
+| 字段名 | 类型 | 显示名 | 说明 |
+| ------ | ---- | ------ | ---- |
+| account_id | String | 科目 ID | 主键 |
+| account_code | String | 科目编码 | |
+| account_name | String | 科目名称 | |
+| account_type | String | 科目类型 | 资产/负债/权益/收入/成本/费用 |
+| pl_category | String | 损益大类 | |
+| parent_account_id | String | 上级科目 | 关联 dim_account |
+| account_level | Int32 | 层级 | |
+| is_leaf | Boolean | 末级 | |
+| normal_balance | String | 余额方向 | 借/贷 |
+| status | String | 状态 | 启用/停用 |
+| created_at | DateTime | 创建时间 | |
+
+**排序键**：`ORDER BY (account_code)`
+
+### 3.2 维度表：dim_cost_center
+
+| 字段名 | 类型 | 显示名 | 说明 |
+| ------ | ---- | ------ | ---- |
+| cost_center_id | String | 成本中心 ID | 主键 |
+| cost_center_code | String | 编码 | |
+| cost_center_name | String | 名称 | |
+| department | String | 部门 | |
+| company_code | String | 公司代码 | |
+| profit_center | String | 利润中心 | |
+| status | String | 状态 | |
+| created_at | DateTime | 创建时间 | |
+
+### 3.3 事实表：fact_gl_journal_entry
+
+**用途**：总账凭证行实际发生额；ActualCube / JournalEntry 主源。
+
+| 字段名 | 类型 | 显示名 | 说明 |
+| ------ | ---- | ------ | ---- |
+| entry_id | String | 凭证 ID | |
+| line_id | String | 凭证行 ID | 主键组合 |
+| **date_key** | Int32 | 日期键 | 关联 dim_date，YYYYMMDD |
+| posting_date | Date | 记账日期 | |
+| fiscal_year | Int32 | 会计年度 | |
+| fiscal_period | Int32 | 会计期间 | 1–12 |
+| account_id | String | 科目 ID | 关联 dim_account |
+| account_code | String | 科目编码 | 冗余 |
+| account_name | String | 科目名称 | 冗余 |
+| account_type | String | 科目类型 | 冗余 |
+| pl_category | String | 损益大类 | 冗余 |
+| account_level | Int32 | 科目层级 | 冗余 |
+| cost_center_id | String | 成本中心 ID | 关联 dim_cost_center |
+| cost_center_name | String | 成本中心 | 冗余 |
+| department | String | 部门 | 冗余 |
+| profit_center | String | 利润中心 | 冗余 |
+| debit_amount | Float64 | 借方 | |
+| credit_amount | Float64 | 贷方 | |
+| amount_signed | Float64 | 损益金额 | 收入为正、成本费用为负 |
+| currency | String | 币种 | |
+| voucher_no | String | 凭证号 | |
+| source_system | String | 来源系统 | |
+| description | String | 摘要 | 凭证行摘要文本 |
+| created_at | DateTime | 创建时间 | |
+
+**排序键**：`ORDER BY (date_key, entry_id, line_id)`
+
+**损益符号 `amount_signed`**（seed 统一计算）：
+
+| account_type | 规则 | 含义 |
+| ------------ | ---- | ---- |
+| 收入 | credit - debit | 正=收入增加 |
+| 成本/费用 | debit - credit | 正=成本/费用发生 |
+
+### 3.4 事实表：fact_budget_entry
+
+| 字段名 | 类型 | 显示名 | 说明 |
+| ------ | ---- | ------ | ---- |
+| budget_id | String | 预算批次 | |
+| line_id | String | 预算行 ID | 主键组合 |
+| **date_key** | Int32 | 日期键 | 关联 dim_date（期间代表日） |
+| budget_version | String | 预算版本 | |
+| fiscal_year | Int32 | 预算年度 | |
+| fiscal_period | Int32 | 预算期间 | 1–12；0=全年 |
+| account_id | String | 科目 ID | 关联 dim_account |
+| account_code | String | 科目编码 | 冗余 |
+| account_name | String | 科目名称 | 冗余 |
+| account_type | String | 科目类型 | 冗余 |
+| pl_category | String | 损益大类 | 冗余 |
+| cost_center_id | String | 成本中心 ID | 关联 dim_cost_center |
+| cost_center_name | String | 成本中心 | 冗余 |
+| department | String | 部门 | 冗余 |
+| budget_amount | Float64 | 预算金额 | |
+| currency | String | 币种 | |
+| status | String | 状态 | 草稿/已发布 |
+| created_at | DateTime | 创建时间 | |
+
+**排序键**：`ORDER BY (fiscal_year, fiscal_period, account_id, line_id)`
 
 ### 3.5 表间关系设计（物理层 · 数据空间）
 
@@ -200,45 +181,46 @@
 **关系模型**：
 
 ```text
-                    account_master
-                   (account_id PK)
-                     ▲         ▲
-                     │         │
-         many_to_one │         │ many_to_one
-                     │         │
-    actual_journal_entry    budget_entry
-         (分录行)              (预算行)
-                     │
-                     │ many_to_one
-                     ▼
-              cost_center_dimension
-              (cost_center_id PK)
-
-account_master.parent_account_id ──► account_master（自关联，科目树）
+                    dim_date
+                   (date_key PK)
+                     ▲    ▲
+                     │    │
+         date_key    │    │ date_key
+                     │    │
+    dim_account ◄────┼────┼────► dim_cost_center
+   (account_id PK)  │    │      (cost_center_id PK)
+         ▲           │    │            ▲
+         │           │    │            │
+         │    fact_gl_journal_entry    │
+         │         (分录行)            │
+         │           │    │            │
+         │           │    fact_budget_entry
+         │           │         (预算行)
+         │           └─────────┘
+         │
+ dim_account.parent_account_id ──► dim_account（自关联）
 ```
 
-**关系清单（6 条）**：
-
-| 关系 ID（建议）        | 类型        | 从表                 | 到表                  | join_keys                               | 说明                                              |
-| ---------------------- | ----------- | -------------------- | --------------------- | --------------------------------------- | ------------------------------------------------- |
-| rel_actual_account     | many_to_one | actual_journal_entry | account_master        | account_id → account_id                 | 分录关联科目                                      |
-| rel_actual_cost_center | many_to_one | actual_journal_entry | cost_center_dimension | cost_center_id → cost_center_id         | 分录关联成本中心                                  |
-| rel_budget_account     | many_to_one | budget_entry         | account_master        | account_id → account_id                 | 预算关联科目                                      |
-| rel_budget_cost_center | many_to_one | budget_entry         | cost_center_dimension | cost_center_id → cost_center_id         | 预算关联成本中心                                  |
-| rel_account_parent     | many_to_one | account_master       | account_master        | parent_account_id → account_id          | 科目上级（树形）                                  |
-| rel_budget_actual      | many_to_one | budget_entry         | actual_journal_entry  | account_id+cost_center_id+fiscal_period | 预算与实际同维对齐（语义关联，JOIN 时加期间条件） |
+**关系清单（8 条）**：
 
-> **说明**：`rel_budget_actual` 为 **同维关联**（非严格 FK），`join_sql` 示例：  
-> `budget_entry.account_id = actual_journal_entry.account_id AND budget_entry.cost_center_id = actual_journal_entry.cost_center_id AND budget_entry.fiscal_year = actual_journal_entry.fiscal_year AND budget_entry.fiscal_period = actual_journal_entry.fiscal_period`  
-> 函数 `profit.fn.budget_vs_actual` 主要基于此 JOIN。
+| 关系 ID | **347 分类** | 类型 | 从表 | 到表 | join_keys | 说明 |
+| ------- | ------------ | ---- | ---- | ---- | --------- | ---- |
+| rel_journal_date | **时间关联** | many_to_one | fact_gl_journal_entry | dim_date | date_key → date_key | 分录关联日历 |
+| rel_budget_date | **时间关联** | many_to_one | fact_budget_entry | dim_date | date_key → date_key | 预算关联日历 |
+| rel_journal_account | **主数据关联** | many_to_one | fact_gl_journal_entry | dim_account | account_id → account_id | 分录→科目 |
+| rel_journal_cost_center | **主数据关联** | many_to_one | fact_gl_journal_entry | dim_cost_center | cost_center_id → cost_center_id | 分录→成本中心 |
+| rel_budget_account | **主数据关联** | many_to_one | fact_budget_entry | dim_account | account_id → account_id | 预算→科目 |
+| rel_budget_cost_center | **主数据关联** | many_to_one | fact_budget_entry | dim_cost_center | cost_center_id → cost_center_id | 预算→成本中心 |
+| rel_account_parent | **层级自关联** | many_to_one | dim_account | dim_account | parent_account_id → account_id | 科目树 |
+| rel_budget_actual | **预实关联** | many_to_one | fact_budget_entry | fact_gl_journal_entry | account_id+cost_center_id+fiscal_period | 预实同维（语义 JOIN；**init 待补**） |
 
 **实施 API**（`setup/profit_ontology_init.py`）：
 
 ```python
 s.tables.add_relationship(
-    from_table="actual_journal_entry",
-    to_table="account_master",
-    join_sql="actual_journal_entry.account_id = account_master.account_id",
+    from_table="fact_gl_journal_entry",
+    to_table="dim_account",
+    join_sql="fact_gl_journal_entry.account_id = dim_account.account_id",
     join_keys=[{"from": "account_id", "to": "account_id"}],
     relationship_type="many_to_one",
     description="实际分录关联会计科目",
@@ -249,22 +231,35 @@ s.tables.add_relationship(
 
 | 物理表关系             | 对应本体链接（业务层）    |
 | ---------------------- | ------------------------- |
-| rel_actual_account     | entry_belongs_account     |
-| rel_actual_cost_center | entry_belongs_cost_center |
-| rel_budget_account     | budget_for_account        |
-| rel_budget_cost_center | budget_for_cost_center    |
-| rel_account_parent     | account_has_parent        |
-| rel_budget_actual      | budget_compared_to_actual |
+| rel_journal_account | entry_belongs_account |
+| rel_journal_cost_center | entry_belongs_cost_center |
+| rel_budget_account | budget_for_account |
+| rel_budget_cost_center | budget_for_cost_center |
+| rel_account_parent | account_has_parent |
+| rel_budget_actual | budget_compared_to_actual |
 
 ---
 
 ## 四、Cube 层设计
 
-### 4.1 ActualCube（实际发生主 Cube）
+### 4.0 Cube 清单与类别
 
-**事实源**：`actual_journal_entry`
+| Cube | 类别 | **347 分类** | 事实源 | 时间维 | 支撑对象 |
+| ---- | ---- | ------------ | ------ | ------ | -------- |
+| **ActualCube** | Process | **流程型** | fact_gl_journal_entry | dim_date + fiscal_* | JournalEntry, ProfitAnalysis |
+| **AccountActualCube** | Subject | **主体型** | fact_gl_journal_entry | 同上 | Account |
+| **CostCenterActualCube** | Subject | **主体型** | fact_gl_journal_entry | 同上 | CostCenter |
+| **BudgetCube** | Process | **流程型** | fact_budget_entry | 同上 | BudgetLine, BudgetAnalysis |
+| **TimeActualCube** | Subject | **主体型** | fact_gl_journal_entry | 同上 | （时间切片；**init 已注册**，347 建议后续并入 Process） |
+| **BudgetVsActualCube** | Comparison | **对比型** | fact_budget_entry + fact_gl_journal_entry | fiscal_year/period | BudgetAnalysis（预实；**规划目标，init 待补**） |
 
-**维度**：entry_id, line_id, posting_date, fiscal_year, fiscal_period, account_id, account_code, account_name, account_type, pl_category, cost_center_id, cost_center_name, department, voucher_no, source_system
+> 347 §4.2 建议时间增强不单独建 Cube；当前示例 init 仍含 **TimeActualCube** 并归 **主体型**，后续可合并进 ActualCube 后从注册表移除。
+
+### 4.1 ActualCube（Process · 实际发生主 Cube）
+
+**事实源**：`fact_gl_journal_entry`
+
+**维度**：entry_id, line_id, date_key, posting_date, fiscal_year, fiscal_period, year, month, account_id, account_code, account_name, account_type, pl_category, cost_center_id, cost_center_name, department, voucher_no, source_system
 
 **度量**：
 
@@ -285,44 +280,41 @@ s.tables.add_relationship(
 | operating_profit | revenue - cost - expense                   | 营业利润 |
 | profit_margin    | if(revenue>0, operating_profit/revenue, 0) | 利润率   |
 
-### 4.2 AccountActualCube（科目实际 Cube）
+### 4.2 AccountActualCube（Subject · 科目实际）
 
 **目的**：Account 对象 bind_source
 
-**维度**：account_id, account_code, account_name, account_type, pl_category, account_level, fiscal_year, fiscal_period
+**维度**：account_id, account_code, account_name, account_type, pl_category, account_level, fiscal_year, fiscal_period, year, month
 
 **度量**：net_amount, line_count
 
-**派生度量**：revenue, cost, expense（同上，按 account_type 聚合）
+**派生度量**：revenue, cost, expense
 
-### 4.3 CostCenterActualCube（成本中心实际 Cube）
+### 4.3 CostCenterActualCube（Subject · 成本中心实际）
 
-**维度**：cost_center_id, cost_center_name, department, profit_center, fiscal_year, fiscal_period
+**维度**：cost_center_id, cost_center_name, department, profit_center, fiscal_year, fiscal_period, year, month
 
 **度量**：net_amount, line_count
 
 **派生度量**：revenue, cost, expense, operating_profit, profit_margin
 
-### 4.4 BudgetCube（预算 Cube）
+### 4.4 BudgetCube（Process · 预算）
 
-**事实源**：`budget_entry`
+**事实源**：`fact_budget_entry`
 
-**维度**：budget_version, fiscal_year, fiscal_period, account_id, account_code, account_type, pl_category, cost_center_id, department
+**维度**：budget_version, fiscal_year, fiscal_period, date_key, account_id, account_code, account_type, pl_category, cost_center_id, department
 
-**度量**：
+**度量**：budget_amount（sum）, budget_lines（count）
 
-| 度量名        | 列名          | 聚合  | 说明     |
-| ------------- | ------------- | ----- | -------- |
-| budget_amount | budget_amount | sum   | 预算金额 |
-| budget_lines  | line_id       | count | 预算行数 |
+**派生度量**：budget_revenue / budget_cost / budget_expense（按 account_type 切片）
 
-**派生度量**：budget_revenue / budget_cost / budget_expense（按 account_type 切片，同 ActualCube 逻辑）
+### 4.5 BudgetVsActualCube（Comparison · 预实对比）
 
-### 4.5 TimeActualCube（时间维度 Cube）
+**目的**：`profit.fn.budget_vs_actual` 读模型；JOIN budget 与 actual 同维（account + cost_center + fiscal_period）
 
-**维度**：posting_date, fiscal_year, fiscal_period, year_month, quarter
+**维度**：fiscal_year, fiscal_period, account_id, cost_center_id, budget_version
 
-**度量**：net_amount, revenue, cost, expense, operating_profit（派生）
+**度量**：budget_amount, actual_amount（来自 ActualCube 聚合）, variance, execution_rate（派生）
 
 ---
 
@@ -330,16 +322,16 @@ s.tables.add_relationship(
 
 ### 5.1 对象类型（6 种）
 
-| 对象类型 code  | 名称     | 说明                    | bind_source          |
-| -------------- | -------- | ----------------------- | -------------------- |
-| Account        | 会计科目 | 科目业务对象            | AccountActualCube    |
-| CostCenter     | 成本中心 | 组织/利润中心业务对象   | CostCenterActualCube |
-| JournalEntry   | 实际分录 | 凭证行/实际发生业务对象 | ActualCube           |
-| BudgetLine     | 预算行   | 预算编制明细业务对象    | BudgetCube           |
-| ProfitAnalysis | 利润分析 | 多维度损益指标聚合对象  | ActualCube           |
-| BudgetAnalysis | 预算分析 | 预算执行与差异分析对象  | BudgetCube           |
+| code | 分类 | **347 分类** | 名称 | bind_source | 主物理支撑 |
+| ---- | ---- | ------------ | ---- | ------------- | ---------- |
+| Account | Master | **主数据** | 会计科目 | AccountActualCube | dim_account |
+| CostCenter | Master | **主数据** | 成本中心 | CostCenterActualCube | dim_cost_center |
+| JournalEntry | Transaction | **事务** | 实际分录 | ActualCube | fact_gl_journal_entry |
+| BudgetLine | Transaction | **事务** | 预算行 | BudgetCube | fact_budget_entry |
+| ProfitAnalysis | Analytical | **分析** | 利润分析 | ActualCube | fact_gl_journal_entry |
+| BudgetAnalysis | Analytical | **分析** | 预算分析 | BudgetCube / BudgetVsActualCube | fact_budget_entry |
 
-> 对象类型 `code` 使用稳定英文标识；与表名、Cube 名刻意区分。
+> 对象 **`code` 无前缀**；分类见 [命名规范 §5.3](./本体命名规范_物理表Cube与对象.md#53-对象分类无-code-前缀)。
 
 ### 5.2 对象属性（摘要）
 
@@ -380,22 +372,34 @@ s.tables.add_relationship(
 
 #### CostCenter / ProfitAnalysis / BudgetAnalysis
 
-与 Cube 维/度量映射一致（约 **42** 个属性，实施时参照 init 脚本）。
+与 Cube 维/度量映射一致（约 **42** 个属性）；实施参照 `利润示例/setup/profit_ontology_init.py`（表名按本规划迁移）。
 
 ### 5.3 链接类型（10 种）
 
-| 链接 code                      | 名称             | from           | to             | 说明             |
-| ------------------------------ | ---------------- | -------------- | -------------- | ---------------- |
-| entry_belongs_account          | 分录归属科目     | JournalEntry   | Account        | 分录行对应科目   |
-| entry_belongs_cost_center      | 分录归属成本中心 | JournalEntry   | CostCenter     | 分录行对应组织   |
-| budget_for_account             | 预算对应科目     | BudgetLine     | Account        | 预算行对应科目   |
-| budget_for_cost_center         | 预算对应成本中心 | BudgetLine     | CostCenter     | 预算行对应组织   |
-| account_has_parent             | 科目上级         | Account        | Account        | 科目树父级       |
-| budget_compared_to_actual      | 预算对比实际     | BudgetAnalysis | ProfitAnalysis | 预实差异分析     |
-| analysis_by_account            | 分析归因科目     | ProfitAnalysis | Account        | 指标按科目切片   |
-| analysis_by_cost_center        | 分析归因成本中心 | ProfitAnalysis | CostCenter     | 指标按组织切片   |
-| account_contributes_profit     | 科目贡献利润     | Account        | ProfitAnalysis | 科目损益贡献     |
-| cost_center_contributes_profit | 组织贡献利润     | CostCenter     | ProfitAnalysis | 成本中心利润贡献 |
+| 链接 code                      | **347 分类** | 名称             | from           | to             | 说明             |
+| ------------------------------ | ------------ | ---------------- | -------------- | -------------- | ---------------- |
+| entry_belongs_account          | **归属关系** | 分录归属科目     | JournalEntry   | Account        | 分录行对应科目   |
+| entry_belongs_cost_center      | **归属关系** | 分录归属成本中心 | JournalEntry   | CostCenter     | 分录行对应组织   |
+| budget_for_account             | **归属关系** | 预算对应科目     | BudgetLine     | Account        | 预算行对应科目   |
+| budget_for_cost_center         | **归属关系** | 预算对应成本中心 | BudgetLine     | CostCenter     | 预算行对应组织   |
+| account_has_parent             | **层级关系** | 科目上级         | Account        | Account        | 科目树父级       |
+| budget_compared_to_actual      | **对比关系** | 预算对比实际     | BudgetAnalysis | ProfitAnalysis | 预实差异分析     |
+| analysis_by_account            | **分析归因** | 分析归因科目     | ProfitAnalysis | Account        | 指标按科目切片   |
+| analysis_by_cost_center        | **分析归因** | 分析归因成本中心 | ProfitAnalysis | CostCenter     | 指标按组织切片   |
+| account_contributes_profit     | **分析归因** | 科目贡献利润     | Account        | ProfitAnalysis | 科目损益贡献     |
+| cost_center_contributes_profit | **分析归因** | 组织贡献利润     | CostCenter     | ProfitAnalysis | 成本中心利润贡献 |
+
+### 5.4 三层对照总表
+
+| 对象 code | 分类 | Cube | 主 fact / dim |
+| --------- | ---- | ---- | ------------- |
+| Account | Master | AccountActualCube | dim_account |
+| CostCenter | Master | CostCenterActualCube | dim_cost_center |
+| JournalEntry | Transaction | ActualCube | fact_gl_journal_entry |
+| BudgetLine | Transaction | BudgetCube | fact_budget_entry |
+| ProfitAnalysis | Analytical | ActualCube | fact_gl_journal_entry |
+| BudgetAnalysis | Analytical | BudgetVsActualCube | fact_budget_entry + fact_gl_journal_entry |
+| （时间） | — | ActualCube / BudgetCube | dim_date |
 
 ---
 
@@ -403,15 +407,15 @@ s.tables.add_relationship(
 
 ### 6.1 函数清单
 
-| 函数 ID                      | 功能         | 参数                                                               |
-| ---------------------------- | ------------ | ------------------------------------------------------------------ |
-| profit.fn.get_summary        | 利润总览     | start_date, end_date, cost_center_id（可选）                       |
-| profit.fn.yoy_analysis       | 同比分析     | start_date, end_date, pl_category（可选）                          |
-| profit.fn.mom_analysis       | 环比分析     | start_date, end_date, pl_category（可选）                          |
-| profit.fn.budget_vs_actual   | **预实对比** | fiscal_year, fiscal_period, budget_version, cost_center_id（可选） |
-| profit.fn.account_breakdown  | **科目结构** | start_date, end_date, account_level, pl_category（可选）           |
-| profit.fn.cost_center_profit | **组织利润** | start_date, end_date, department（可选）                           |
-| profit.fn.top_accounts       | 科目 Top N   | limit, metric, start_date, end_date, account_type（可选）          |
+| 函数 ID                      | **347 分类** | 功能         | 参数                                                               |
+| ---------------------------- | ------------ | ------------ | ------------------------------------------------------------------ |
+| profit.fn.get_summary        | **总览分析** | 利润总览     | start_date, end_date, cost_center_id（可选）                       |
+| profit.fn.yoy_analysis       | **趋势分析** | 同比分析     | start_date, end_date, pl_category（可选）                          |
+| profit.fn.mom_analysis       | **趋势分析** | 环比分析     | start_date, end_date, pl_category（可选）                          |
+| profit.fn.budget_vs_actual   | **预实分析** | **预实对比** | fiscal_year, fiscal_period, budget_version, cost_center_id（可选） |
+| profit.fn.account_breakdown  | **结构分析** | **科目结构** | start_date, end_date, account_level, pl_category（可选）           |
+| profit.fn.cost_center_profit | **组织分析** | **组织利润** | start_date, end_date, department（可选）                           |
+| profit.fn.top_accounts       | **结构分析** | 科目 Top N   | limit, metric, start_date, end_date, account_type（可选）          |
 
 > 旧示例中的 `profit.fn.top_products`、`profit.fn.customer_segmentation` 属**订单/产品域**，本方案以 GL 为主，**不纳入**默认函数集；若需产品利润，可单独增加 `profit.fn.sales_reconciliation` 勾稽销售表。
 
@@ -467,12 +471,12 @@ s.tables.add_relationship(
 | profit.fn.cost_center_profit | `.../profit.fn.cost_center_profit.json`               | 日期范围                                      |
 | profit.fn.top_accounts       | `.../profit.fn.top_accounts.json`                     | limit=10, metric=net_impact                   |
 
-> 内置示例路径：`资源/examples/onto/利润示例/function/test_arguments/`（复制到实现单元 `functions/test_arguments/`）。
+> 内置示例路径：`资源/examples/onto/利润示例/functions/test_arguments/`（复制到实现单元 `functions/test_arguments/`）。
 
 批量入库（实现单元 `functions/` 下，dazi-work 根）：
 
 ```powershell
-.\项目\潘达石化\本体\ontos\利润分析本体方案\functions\save_test_arguments.ps1
+.\<item-path>\functions\save_test_arguments.ps1
 ```
 
 > 参考实现：`资源/examples/onto/利润示例/`（init + seed + 7 个 `profit_fn_*.py` + test_arguments）。
@@ -481,54 +485,54 @@ s.tables.add_relationship(
 
 ## 七、实施计划
 
-> **dazi-vscode v3** · 空间 `space__zlj` · 脚本目录 `setup/`、`functions/`  
+> **dazi-vscode v3** · 空间 `<space-id>` · 脚本目录 `setup/`、`functions/`  
 > 发布示例：  
-> `dazi onto script publish 项目/潘达石化/本体/ontos/利润分析本体方案/setup/profit_ontology_init.py --space space__zlj --type setup`
+> `dazi onto script publish <item-path>/setup/profit_ontology_init.py --space <space-id> --type setup`
 
 ### 7.1 阶段一：物理层（高）
 
-| 步骤 | 任务                       | 说明                    |
-| ---- | -------------------------- | ----------------------- |
-| 1    | 创建 account_master        | **科目表**              |
-| 2    | 创建 cost_center_dimension | 成本中心维表            |
-| 3    | 创建 actual_journal_entry  | **实际分录表**          |
-| 4    | 创建 budget_entry          | **预算表**              |
-| 5    | 注册表到空间               | register + sync_columns |
-| 6    | **注册表间关系（6 条）**   | add_relationship        |
+| 步骤 | 任务 | 说明 |
+| ---- | ---- | ---- |
+| 1 | **dim_date** | 共用或 ensure |
+| 2 | dim_account | 科目维 |
+| 3 | dim_cost_center | 成本中心维 |
+| 4 | fact_gl_journal_entry | 含 **date_key** |
+| 5 | fact_budget_entry | 含 **date_key** |
+| 6 | **TABLE_REGISTRY** + `register_with_meta` | 表/列 display_name、description |
+| 7 | **表间关系（8 条）** | 含两条 fact→dim_date |
 
 ### 7.2 阶段二：Cube 层（高）
 
-| 步骤 | 任务                                               |
-| ---- | -------------------------------------------------- |
-| 7    | 注册 ActualCube / AccountActualCube 等 5 个 Cube   |
-| 8    | 配置派生度量 revenue/cost/expense/operating_profit |
+| 步骤 | 任务 |
+| ---- | ---- |
+| 8 | 注册 **5 个 Cube**（含 BudgetVsActualCube；无 Time Cube） |
+| 9 | 派生度量 revenue/cost/expense/operating_profit |
 
 ### 7.3 阶段三：本体层（高）
 
-| 步骤 | 任务                        |
-| ---- | --------------------------- |
-| 9    | define_object_type（6 种）  |
-| 10   | bind_source                 |
-| 11   | define_property（约 42 个） |
-| 12   | define_link_type（10 种）   |
-| 13   | sync_metric_refs            |
+| 步骤 | 任务 |
+| ---- | ---- |
+| 10 | define_object_type（6 种） |
+| 11 | bind_source |
+| 12 | define_property（约 42 个） |
+| 13 | define_link_type（10 种） |
+| 14 | sync_metric_refs |
+| 15 | **CATEGORY_REGISTRY** + `s.categories.apply_registry`（347 对齐） |
 
 ### 7.4 阶段四：函数与数据（中）
 
-| 步骤 | 任务                                                                              |
-| ---- | --------------------------------------------------------------------------------- |
-| 14   | 新建 `profit_ontology_init.py`、`profit_seed_data.py`（科目树+分录+预算演示数据） |
-| 15   | 适配/新建 7 个 `profit_fn_*.py`                                                   |
-| 16   | publish + run 验证 → save-test-arguments                                          |
+| 步骤 | 任务 |
+| ---- | ---- |
+| 15 | profit_ontology_init.py、profit_seed_data.py（含 dim_date / date_key） |
+| 16 | 7 个 profit_fn_*.py |
+| 17 | publish + run → save-test-arguments |
 
 ### 7.5 快速实施路径
 
 | 来源                                                       | 可复用内容                        | 需改造                         |
 | ---------------------------------------------------------- | --------------------------------- | ------------------------------ |
-| `资源/examples/onto/利润示例/setup/profit_ontology_init.py` | GL 表/Cube/对象/链接完整 init     | 按业务改 `space_id` 与科目口径 |
-| `资源/examples/onto/利润示例/setup/profit_seed_data.py`     | 科目树+分录+预算演示数据          | 同上                           |
-| `资源/examples/onto/利润示例/function/profit_fn_*.py`       | 7 个 GL 分析函数 + test_arguments | 复制到 `functions/` 后发布     |
-| `项目/潘达石化/本体/ontos/产品销售本体方案/`               | init/seed/test_arguments 工程模式 | 表结构与函数逻辑不同           |
+| `资源/examples/onto/利润示例/` | init/seed/函数完整示例 | 复制到 `<item-path>/` 后改 `<space-id>` |
+| [规划示例：产品销售](./规划示例_产品销售本体规划方案.md) | 工程模式对照 | 表结构与函数逻辑不同 |
 
 **seed 数据建议**：
 
@@ -545,22 +549,25 @@ s.tables.add_relationship(
 
 | 等级 | 风险                      | 缓解措施                                    |
 | ---- | ------------------------- | ------------------------------------------- |
-| 中   | 与销售域共用 space\_\_zlj | init 仅创建利润域 4 表                      |
+| 中 | 多域共用 `<space-id>` | init 仅创建利润域表；**dim_date** 共用 ensure |
 | 中   | 借贷方向与符号口径不一致  | seed 统一计算 `amount_signed`；文档约定口径 |
 | 中   | 预实 JOIN 期间粒度不一致  | budget/actual 均含 fiscal_year/period       |
 | 低   | 旧示例订单模型混淆        | 规划与函数 ID 明确以 GL 为准                |
 
 ### 8.2 验收标准
 
-| 验收项       | 标准                                                    |
-| ------------ | ------------------------------------------------------- |
-| 科目表       | account_master 可查询，树形 parent 可解析               |
-| 实际分录表   | actual_journal_entry 可查询，损益汇总与手工 SQL 一致    |
-| 预算表       | budget_entry 可查询，与 actual 同维可 JOIN              |
-| **表间关系** | **6 条**注册成功                                        |
-| Cube         | 5 个 Cube + 派生度量可算                                |
-| 对象类型     | 6 种对象 + 10 种链接                                    |
-| 函数         | get_summary、budget_vs_actual、account_breakdown 可运行 |
+| 验收项 | 标准 |
+| ------ | ---- |
+| dim_date | 可查询；fact 的 date_key 可 JOIN |
+| dim_account | 树形 parent 可解析 |
+| fact_gl_journal_entry | 损益汇总与手工 SQL 一致 |
+| fact_budget_entry | 与 actual 同维可 JOIN |
+| 表/列元数据 | 侧栏与表预览显示名、说明与 §3.x 一致 |
+| **表间关系** | **8 条** |
+| Cube | **5 个** + 派生度量 |
+| 对象 | 6 种 + 分类；10 种链接 |
+| **347 平台分类** | 侧栏分类名与附录 B 一致；`category_mounts` 非空 |
+| 函数 | get_summary、budget_vs_actual、account_breakdown 可运行 |
 | 数据         | 种子灌入后预实差异可解释                                |
 
 ---
@@ -579,19 +586,95 @@ s.tables.add_relationship(
 
 ---
 
+## 附录 B：347 分类挂载对照表（CATEGORY_REGISTRY）
+
+与 `利润示例/setup/profit_ontology_init.py` 顶部 **`CATEGORY_REGISTRY`** 一一对应（见 [349 方案](./本体分类规划与SDK扩展方案.md)）。
+
+### B.1 物理表（table）
+
+| 347 分类 | 表名 |
+| -------- | ---- |
+| 维度表 | dim_account, dim_cost_center |
+| 事实表 | fact_gl_journal_entry, fact_budget_entry |
+
+> `dim_date` 为 **时间维**，多域共用；由销售域 init 创建时，利润域 `CATEGORY_REGISTRY` 可不重复挂载。
+
+### B.2 Cube（cube）
+
+| 347 分类 | Cube |
+| -------- | ---- |
+| 流程型 | ActualCube, BudgetCube |
+| 主体型 | AccountActualCube, CostCenterActualCube, TimeActualCube |
+
+### B.3 对象类型（object）
+
+| 347 分类 | code |
+| -------- | ---- |
+| 主数据 | Account, CostCenter |
+| 事务 | JournalEntry, BudgetLine |
+| 分析 | ProfitAnalysis, BudgetAnalysis |
+
+### B.4 表间关系（relation）
+
+| 347 分类 | 从表 → 到表 |
+| -------- | ----------- |
+| 时间关联 | fact_gl_journal_entry → dim_date；fact_budget_entry → dim_date |
+| 主数据关联 | fact_gl_journal_entry → dim_account / dim_cost_center；fact_budget_entry → dim_account / dim_cost_center |
+| 层级自关联 | dim_account → dim_account |
+
+### B.5 链接类型（link）
+
+| 347 分类 | link code |
+| -------- | --------- |
+| 归属关系 | entry_belongs_account, entry_belongs_cost_center, budget_for_account, budget_for_cost_center |
+| 分析归因 | analysis_by_account, analysis_by_cost_center, account_contributes_profit, cost_center_contributes_profit |
+| 层级关系 | account_has_parent |
+| 对比关系 | budget_compared_to_actual |
+
+### B.6 本体函数（function）
+
+init **不**注册函数；`apply_registry(..., skip_missing=True)` 跳过未发布函数。建议分类：
+
+| 347 分类 | function_id |
+| -------- | ----------- |
+| 总览分析 | profit.fn.get_summary |
+| 趋势分析 | profit.fn.yoy_analysis, profit.fn.mom_analysis |
+| 结构分析 | profit.fn.account_breakdown, profit.fn.top_accounts |
+| 预实分析 | profit.fn.budget_vs_actual |
+| 组织分析 | profit.fn.cost_center_profit |
+
+---
+
+## 附录：规划完整性自检清单
+
+定稿前逐项勾选（完整说明见 [本体规划指南 · 规划文档完整性自检清单](./本体规划指南.md#规划文档完整性自检清单)）。
+
+| # | 检查项 | 本方案 |
+| - | ------ | ------ |
+| 1 | 业务场景 | ☑ |
+| 2 | 物理表 | ☑（dim_date + 2 dim + 2 fact） |
+| 2a–2c | 命名规范 | ☑ |
+| 3 | 表间关系 | ☑（**8 条**） |
+| 4 | Cube 层 | ☑（**5 个**，§4.0） |
+| 5 | 对象 + 分类 | ☑（§5.1、§5.4） |
+| 6–10 | 同指南 | ☑ |
+| 6a–6e | 347 平台分类 | ☑（附录 B + init 步骤 10） |
+
+---
+
 ## 十、相关文档
 
-| 文档                               | 路径                                                                          |
-| ---------------------------------- | ----------------------------------------------------------------------------- |
-| 快速启动                           | [../快速启动\_利润分析本体方案.md](../快速启动_利润分析本体方案.md)           |
-| 本体规划指南                       | `资源/docs/onto/本体规划指南.md`                                              |
-| 规划示例（产品销售，推荐工程模式） | `资源/docs/onto/规划示例_产品销售本体规划方案.md`                             |
-| 规划示例（利润·GL 域）             | `资源/docs/onto/规划示例_利润分析本体方案.md`                                 |
-| **内置脚本示例**                   | `资源/examples/onto/利润示例/`（`dazi examples sync`）                        |
+| 文档 | 路径 |
+| ---- | ---- |
+| 本体命名规范 | [本体命名规范_物理表Cube与对象.md](./本体命名规范_物理表Cube与对象.md) |
+| 本体规划指南 | [本体规划指南.md](./本体规划指南.md) |
+| 规划示例（产品销售） | [规划示例_产品销售本体规划方案.md](./规划示例_产品销售本体规划方案.md) |
+| **内置脚本示例** | `资源/examples/onto/利润示例/`（`dazi examples sync`；表名迁移中） |
+| 349 · 分类方案 | [本体分类规划与 SDK 扩展方案](./本体分类规划与SDK扩展方案.md) |
 
 ---
 
-**方案版本**：v2.0  
-**创建日期**：2026-06-06  
-**适用空间**：`space__zlj`  
-**状态**：已落地
+**方案版本**：v2.2（+347 分类列与附录 B CATEGORY_REGISTRY）  
+**创建日期**：（定稿日）  
+**适用**：复制到 `<item-path>/plans/`；`<space-id>` 以该实现单元 `README.md` 为准  
+**状态**：规划示例（公共模板）