@dazitech/cli 3.0.7 → 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,541 +1,680 @@
-# 规划示例\_利润分析本体方案
-
----
-
-## 一、空间概述
-
-| 项目     | 说明                             |
-| -------- | -------------------------------- |
-| 空间ID   | space\_\_profit0520              |
-| 空间名称 | 利润分析0520                     |
-| 空间状态 | 空白空间（无表、无Cube、无本体） |
-| 规划日期 | 2026-05-20                       |
-
----
-
-## 二、需求分析
-
-### 2.1 业务背景
-
-构建利润分析本体，实现多维度、多层级的利润分析能力，支持：
-
-- 按产品、客户、时间等多维度利润分析
-- 同比、环比趋势分析
-- 产品利润排行与客户分层
-- 利润归因与成本结构分析
-
-### 2.2 核心业务问题
-
-| 问题           | 说明               |
-| -------------- | ------------------ |
-| 利润从哪里来   | 收入来源结构分析   |
-| 成本消耗在哪里 | 成本去向与结构分析 |
-| 利润变化原因   | 影响利润的关键因素 |
-| 如何提升利润   | 优化方向与建议     |
-
----
-
-## 三、物理层设计
-
-### 3.1 表设计
-
-#### 3.1.1 事实表：profit_analysis_fact（利润分析事实表）
-
-**用途**：存储订单维度的收入、成本、利润数据
-
-**表结构**：
-
-| 字段名           | 类型    | 说明     | 主键/索引 |
-| ---------------- | ------- | -------- | --------- |
-| order_id         | String  | 订单ID   | PK        |
-| product_id       | String  | 产品ID   |           |
-| customer_id      | String  | 客户ID   |           |
-| order_date       | Date    | 订单日期 |           |
-| product_category | String  | 产品类别 |           |
-| customer_region  | String  | 客户区域 |           |
-| customer_type    | String  | 客户类型 |           |
-| quantity         | Int32   | 销售数量 |           |
-| unit_price       | Float64 | 单价     |           |
-| revenue          | Float64 | 收入     |           |
-| cost             | Float64 | 成本     |           |
-| profit           | Float64 | 利润     |           |
-
-**排序键**：`ORDER BY (order_date, order_id)`  
-**引擎**：`MergeTree()`
-
-#### 3.1.2 维度表：product_dimension（产品维度表）
-
-**用途**：存储产品主数据
-
-**表结构**：
-
-| 字段名           | 类型     | 说明       |
-| ---------------- | -------- | ---------- |
-| product_id       | String   | 产品ID     |
-| product_name     | String   | 产品名称   |
-| product_category | String   | 产品类别   |
-| cost_price       | Float64  | 成本单价   |
-| margin_ratio     | Float64  | 毛利率目标 |
-| created_at       | DateTime | 创建时间   |
-
-**排序键**：`ORDER BY (product_id)`
-
-#### 3.1.3 维度表：customer_dimension（客户维度表）
-
-**用途**：存储客户主数据
-
-**表结构**：
-
-| 字段名          | 类型     | 说明                 |
-| --------------- | -------- | -------------------- |
-| customer_id     | String   | 客户ID               |
-| customer_name   | String   | 客户名称             |
-| customer_region | String   | 客户区域             |
-| customer_type   | String   | 客户类型（VIP/普通） |
-| credit_level    | String   | 信用等级             |
-| created_at      | DateTime | 创建时间             |
-
-**排序键**：`ORDER BY (customer_id)`
-
----
-
-## 四、Cube 层设计
-
-### 4.1 ProfitCube（利润分析主Cube）
-
-**目的**：支持全局利润分析
-
-**维度**：
-
-| 维度名           | 列名             | 类型   | 说明     |
-| ---------------- | ---------------- | ------ | -------- |
-| order_id         | order_id         | string | 订单ID   |
-| order_date       | order_date       | date   | 订单日期 |
-| product_id       | product_id       | string | 产品ID   |
-| product_category | product_category | string | 产品类别 |
-| customer_id      | customer_id      | string | 客户ID   |
-| customer_region  | customer_region  | string | 客户区域 |
-| customer_type    | customer_type    | string | 客户类型 |
-
-**度量**：
-
-| 度量名      | 列名     | 聚合 | 说明     |
-| ----------- | -------- | ---- | -------- |
-| quantity    | quantity | sum  | 销售数量 |
-| revenue     | revenue  | sum  | 收入     |
-| cost        | cost     | sum  | 成本     |
-| order_count | order_id | uniq | 订单数量 |
-
-**派生度量**：
-
-| 度量名        | 表达式                               | 说明   |
-| ------------- | ------------------------------------ | ------ |
-| profit        | revenue - cost                       | 利润   |
-| profit_margin | if(revenue > 0, profit / revenue, 0) | 利润率 |
-
-### 4.2 ProductCube（产品分析Cube）
-
-**目的**：支持按产品维度的利润分析
-
-**维度**：
-
-| 维度名           | 列名             | 类型   | 说明     |
-| ---------------- | ---------------- | ------ | -------- |
-| product_id       | product_id       | string | 产品ID   |
-| product_category | product_category | string | 产品类别 |
-
-**度量**：
-
-| 度量名      | 列名     | 聚合 | 说明     |
-| ----------- | -------- | ---- | -------- |
-| revenue     | revenue  | sum  | 收入     |
-| cost        | cost     | sum  | 成本     |
-| order_count | order_id | uniq | 订单数量 |
-
-**派生度量**：
-
-| 度量名        | 表达式                               | 说明   |
-| ------------- | ------------------------------------ | ------ |
-| profit        | revenue - cost                       | 利润   |
-| profit_margin | if(revenue > 0, profit / revenue, 0) | 利润率 |
-
-### 4.3 CustomerCube（客户分析Cube）
-
-**目的**：支持按客户维度的利润分析
-
-**维度**：
-
-| 维度名          | 列名            | 类型   | 说明     |
-| --------------- | --------------- | ------ | -------- |
-| customer_id     | customer_id     | string | 客户ID   |
-| customer_region | customer_region | string | 客户区域 |
-| customer_type   | customer_type   | string | 客户类型 |
-
-**度量**：
-
-| 度量名      | 列名     | 聚合 | 说明     |
-| ----------- | -------- | ---- | -------- |
-| revenue     | revenue  | sum  | 收入     |
-| cost        | cost     | sum  | 成本     |
-| order_count | order_id | uniq | 订单数量 |
-
-**派生度量**：
-
-| 度量名        | 表达式                               | 说明   |
-| ------------- | ------------------------------------ | ------ |
-| profit        | revenue - cost                       | 利润   |
-| profit_margin | if(revenue > 0, profit / revenue, 0) | 利润率 |
-
-### 4.4 TimeCube（时间维度Cube）
-
-**目的**：支持同比、环比分析
-
-**维度**：
-
-| 维度名     | 列名       | 类型   | 说明 |
-| ---------- | ---------- | ------ | ---- |
-| year       | order_date | date   | 年份 |
-| year_month | order_date | string | 年月 |
-| quarter    | order_date | string | 季度 |
-
-**度量**：
-
-| 度量名  | 列名    | 聚合 | 说明 |
-| ------- | ------- | ---- | ---- |
-| revenue | revenue | sum  | 收入 |
-| cost    | cost    | sum  | 成本 |
-
-**派生度量**：
-
-| 度量名        | 表达式                               | 说明   |
-| ------------- | ------------------------------------ | ------ |
-| profit        | revenue - cost                       | 利润   |
-| profit_margin | if(revenue > 0, profit / revenue, 0) | 利润率 |
-
----
-
-## 五、本体层设计
-
-### 5.1 对象类型（4种）
-
-| 对象类型code   | 名称     | 说明         | bind_source  |
-| -------------- | -------- | ------------ | ------------ |
-| Order          | 订单     | 订单业务对象 | ProfitCube   |
-| Product        | 产品     | 产品业务对象 | ProductCube  |
-| Customer       | 客户     | 客户业务对象 | CustomerCube |
-| ProfitAnalysis | 利润分析 | 利润聚合对象 | ProfitCube   |
-
-### 5.2 对象属性
-
-#### 5.2.1 Order（订单）属性
-
-| 属性code      | 名称     | semantic_role | qualified_name           |
-| ------------- | -------- | ------------- | ------------------------ |
-| id            | 订单ID   | dimension     | ProfitCube.order_id      |
-| date          | 订单日期 | dimension     | ProfitCube.order_date    |
-| quantity      | 销售数量 | measure       | ProfitCube.quantity      |
-| revenue       | 收入     | measure       | ProfitCube.revenue       |
-| cost          | 成本     | measure       | ProfitCube.cost          |
-| profit        | 利润     | measure       | ProfitCube.profit        |
-| profit_margin | 利润率   | measure       | ProfitCube.profit_margin |
-
-#### 5.2.2 Product（产品）属性
-
-| 属性code      | 名称     | semantic_role | qualified_name               |
-| ------------- | -------- | ------------- | ---------------------------- |
-| id            | 产品ID   | dimension     | ProductCube.product_id       |
-| category      | 产品类别 | dimension     | ProductCube.product_category |
-| revenue       | 累计收入 | measure       | ProductCube.revenue          |
-| cost          | 累计成本 | measure       | ProductCube.cost             |
-| profit        | 累计利润 | measure       | ProductCube.profit           |
-| profit_margin | 利润率   | measure       | ProductCube.profit_margin    |
-| order_count   | 订单数   | measure       | ProductCube.order_count      |
-
-#### 5.2.3 Customer（客户）属性
-
-| 属性code      | 名称     | semantic_role | qualified_name               |
-| ------------- | -------- | ------------- | ---------------------------- |
-| id            | 客户ID   | dimension     | CustomerCube.customer_id     |
-| region        | 客户区域 | dimension     | CustomerCube.customer_region |
-| type          | 客户类型 | dimension     | CustomerCube.customer_type   |
-| revenue       | 累计收入 | measure       | CustomerCube.revenue         |
-| cost          | 累计成本 | measure       | CustomerCube.cost            |
-| profit        | 累计利润 | measure       | CustomerCube.profit          |
-| profit_margin | 利润率   | measure       | CustomerCube.profit_margin   |
-| order_count   | 订单数   | measure       | CustomerCube.order_count     |
-
-#### 5.2.4 ProfitAnalysis（利润分析）属性
-
-| 属性code         | 名称     | semantic_role | qualified_name              |
-| ---------------- | -------- | ------------- | --------------------------- |
-| date             | 日期     | dimension     | ProfitCube.order_date       |
-| product_category | 产品类别 | dimension     | ProfitCube.product_category |
-| customer_region  | 客户区域 | dimension     | ProfitCube.customer_region  |
-| customer_type    | 客户类型 | dimension     | ProfitCube.customer_type    |
-| revenue          | 收入     | measure       | ProfitCube.revenue          |
-| cost             | 成本     | measure       | ProfitCube.cost             |
-| profit           | 利润     | measure       | ProfitCube.profit           |
-| profit_margin    | 利润率   | measure       | ProfitCube.profit_margin    |
-
-### 5.3 链接类型（6种）
-
-| 链接code           | 名称         | from           | to             | 说明           |
-| ------------------ | ------------ | -------------- | -------------- | -------------- |
-| order_to_product   | 订单关联产品 | Order          | Product        | 订单包含的产品 |
-| order_to_customer  | 订单关联客户 | Order          | Customer       | 订单归属客户   |
-| profit_to_product  | 利润关联产品 | ProfitAnalysis | Product        | 利润归因到产品 |
-| profit_to_customer | 利润关联客户 | ProfitAnalysis | Customer       | 利润归因到客户 |
-| product_to_profit  | 产品归属利润 | Product        | ProfitAnalysis | 产品利润聚合   |
-| customer_to_profit | 客户归属利润 | Customer       | ProfitAnalysis | 客户利润聚合   |
-
----
-
-## 六、本体函数设计
-
-### 6.1 函数清单
-
-| 函数ID                          | 功能         | 参数                                 |
-| ------------------------------- | ------------ | ------------------------------------ |
-| profit.fn.get_summary           | 利润总览     | -                                    |
-| profit.fn.yoy_analysis          | 同比分析     | start_date, end_date                 |
-| profit.fn.mom_analysis          | 环比分析     | start_date, end_date                 |
-| profit.fn.top_products          | 产品利润排行 | limit, metric, start_date, end_date  |
-| profit.fn.customer_segmentation | 客户分层     | metric, method, start_date, end_date |
-
-### 6.2 函数详细设计
-
-#### 6.2.1 profit.fn.get_summary（利润总览）
-
-**功能**：获取利润总览数据
-
-**参数**：无
-
-**返回值**：
-
-| 字段名        | 类型    | 说明     |
-| ------------- | ------- | -------- |
-| total_revenue | Float64 | 总收入   |
-| total_cost    | Float64 | 总成本   |
-| total_profit  | Float64 | 总利润   |
-| profit_margin | Float64 | 利润率   |
-| order_count   | Int     | 订单数量 |
-
-#### 6.2.2 profit.fn.yoy_analysis（同比分析）
-
-**功能**：计算指定时间范围内的年度同比分析
-
-**参数**：
-
-| 参数名     | 类型   | 默认值 | 说明     |
-| ---------- | ------ | ------ | -------- |
-| start_date | String | -      | 开始日期 |
-| end_date   | String | -      | 结束日期 |
-
-**返回值**：
-
-| 字段名        | 类型    | 说明       |
-| ------------- | ------- | ---------- |
-| year          | Int     | 年份       |
-| revenue       | Float64 | 收入       |
-| cost          | Float64 | 成本       |
-| profit        | Float64 | 利润       |
-| profit_margin | Float64 | 利润率     |
-| yoy_growth    | Float64 | 同比增长率 |
-
-#### 6.2.3 profit.fn.mom_analysis（环比分析）
-
-**功能**：计算指定时间范围内的月度环比分析
-
-**参数**：
-
-| 参数名     | 类型   | 默认值 | 说明     |
-| ---------- | ------ | ------ | -------- |
-| start_date | String | -      | 开始日期 |
-| end_date   | String | -      | 结束日期 |
-
-**返回值**：
-
-| 字段名        | 类型    | 说明       |
-| ------------- | ------- | ---------- |
-| year_month    | String  | 年月       |
-| revenue       | Float64 | 收入       |
-| cost          | Float64 | 成本       |
-| profit        | Float64 | 利润       |
-| profit_margin | Float64 | 利润率     |
-| mom_growth    | Float64 | 环比增长率 |
-
-#### 6.2.4 profit.fn.top_products（产品利润排行）
-
-**功能**：按利润或利润率排序，获取Top N产品
-
-**参数**：
-
-| 参数名     | 类型   | 默认值 | 说明                      |
-| ---------- | ------ | ------ | ------------------------- |
-| limit      | Int    | 10     | 返回数量                  |
-| metric     | String | profit | 排序指标（profit/margin） |
-| start_date | String | -      | 开始日期（可选）          |
-| end_date   | String | -      | 结束日期（可选）          |
-
-**返回值**：
-
-| 字段名           | 类型    | 说明     |
-| ---------------- | ------- | -------- |
-| rank             | Int     | 排名     |
-| product_id       | String  | 产品ID   |
-| product_category | String  | 产品类别 |
-| revenue          | Float64 | 收入     |
-| cost             | Float64 | 成本     |
-| profit           | Float64 | 利润     |
-| profit_margin    | Float64 | 利润率   |
-
-#### 6.2.5 profit.fn.customer_segmentation（客户分层）
-
-**功能**：基于利润贡献对客户进行分层
-
-**参数**：
-
-| 参数名     | 类型   | 默认值   | 说明                            |
-| ---------- | ------ | -------- | ------------------------------- |
-| metric     | String | profit   | 分层指标（profit/revenue）      |
-| method     | String | quartile | 分层方法（quartile/percentile） |
-| start_date | String | -        | 开始日期（可选）                |
-| end_date   | String | -        | 结束日期（可选）                |
-
-**返回值**：
-
-| 字段名          | 类型    | 说明                        |
-| --------------- | ------- | --------------------------- |
-| customer_id     | String  | 客户ID                      |
-| customer_region | String  | 客户区域                    |
-| revenue         | Float64 | 收入                        |
-| profit          | Float64 | 利润                        |
-| segment         | String  | 分层（VIP/High/Medium/Low） |
-
----
-
-## 七、实施计划
-
-> **dazi-vscode v3 命令对照**（`space_id` 见本文「一、空间概述」；项目目录 `项目/onto_<名称>/` 在新建项目时绑定该空间）  
-> 环境：`dazi doctor` · 现网表/Cube：**数据资源** 侧栏 ·  
-> 发布：`dazi onto script publish 项目/onto_<名称>/脚本/<file>.py --space space__profit0520 --register-function-id <id>` ·  
-> 运行：`dazi onto function run <function_id> --space space__profit0520 --params '{}'`  
-> 细则见 **`本体规划指南.md`**「LLM 执行指引」。
-
-### 7.1 阶段一：物理层（优先级：高）
-
-| 步骤 | 任务                      | 说明                   |
-| ---- | ------------------------- | ---------------------- |
-| 1    | 创建 profit_analysis_fact | 利润分析事实表         |
-| 2    | 创建 product_dimension    | 产品维度表             |
-| 3    | 创建 customer_dimension   | 客户维度表             |
-| 4    | 注册表到空间              | 使用 s.tables.register |
-
-### 7.2 阶段二：Cube层（优先级：高）
-
-| 步骤 | 任务              | 说明                  |
-| ---- | ----------------- | --------------------- |
-| 5    | 注册 ProfitCube   | 主分析Cube            |
-| 6    | 注册 ProductCube  | 产品分析Cube          |
-| 7    | 注册 CustomerCube | 客户分析Cube          |
-| 8    | 注册 TimeCube     | 时间维度Cube          |
-| 9    | 添加派生度量      | profit, profit_margin |
-
-### 7.3 阶段三：本体层（优先级：高）
-
-| 步骤 | 任务         | 说明                                     |
-| ---- | ------------ | ---------------------------------------- |
-| 10   | 定义对象类型 | Order, Product, Customer, ProfitAnalysis |
-| 11   | 绑定数据源   | bind_source                              |
-| 12   | 定义属性     | 属性映射                                 |
-| 13   | 定义链接     | 6种链接关系                              |
-| 14   | 同步指标引用 | sync_metric_refs                         |
-
-### 7.4 阶段四：函数层（优先级：中）
-
-| 步骤 | 任务                       | 说明                                                                          |
-| ---- | -------------------------- | ----------------------------------------------------------------------------- |
-| 15   | 开发 get_summary           | 利润总览函数                                                                  |
-| 16   | 开发 yoy_analysis          | 同比分析函数                                                                  |
-| 17   | 开发 mom_analysis          | 环比分析函数                                                                  |
-| 18   | 开发 top_products          | 产品排行函数                                                                  |
-| 19   | 开发 customer_segmentation | 客户分层函数                                                                  |
-| 20   | 发布并注册函数             | `dazi onto script publish … --space space__profit0520 --register-function-id` |
-
-### 7.5 阶段五：数据层（优先级：中）
-
-| 步骤 | 任务         | 说明                     |
-| ---- | ------------ | ------------------------ |
-| 21   | 生成模拟数据 | 2025年1-6月、2026年1-6月 |
-| 22   | 数据验证     | 验证查询结果             |
-
-### 7.6 阶段六：验证与交付（优先级：高）
-
-| 步骤 | 任务     | 说明                                                                                    |
-| ---- | -------- | --------------------------------------------------------------------------------------- |
-| 23   | 验收核对 | 侧栏 **数据资源** 查表/Cube；`dazi onto function list --space space__profit0520` 查函数 |
-| 24   | 函数测试 | 验证函数功能                                                                            |
-| 25   | 文档归档 | 更新规划文档                                                                            |
-
----
-
-## 八、风险与验收
-
-### 8.1 风险识别
-
-| 风险等级 | 风险描述           | 缓解措施                    |
-| -------- | ------------------ | --------------------------- |
-| 中       | 数据量不足影响分析 | 生成足够的模拟数据          |
-| 低       | 派生度量表达式错误 | 先测试SQL，再迁移到派生度量 |
-| 低       | 函数查询性能       | 优化SQL，使用索引           |
-
-### 8.2 验收标准
-
-| 验收项   | 验收标准                       |
-| -------- | ------------------------------ |
-| 物理表   | 3张表创建成功，可正常查询      |
-| Cube     | 4个Cube正确注册，维度/度量完整 |
-| 对象类型 | 4种对象类型定义正确            |
-| 链接类型 | 6种链接关系定义正确            |
-| 属性     | 25个属性定义正确               |
-| 本体函数 | 5个函数可正常执行              |
-| 数据     | 可查询正确利润数据             |
-
----
-
-## 九、预期成果
-
-### 9.1 能力矩阵
-
-| 分析能力   | 说明                    |
-| ---------- | ----------------------- |
-| 多维度分析 | 产品、客户、时间多维度  |
-| 趋势分析   | 同比、环比增长率        |
-| 排行分析   | Top N产品利润排行       |
-| 客户分层   | VIP/High/Medium/Low分层 |
-| 利润归因   | 产品/客户利润贡献       |
-
-### 9.2 业务价值
-
-- **决策支持**：提供多维度利润数据支持经营决策
-- **趋势洞察**：识别利润变化趋势和异常
-- **客户价值**：识别高价值客户，优化客户策略
-- **产品优化**：识别高利润产品，优化产品组合
-
----
-
-## 十、相关文档
-
-| 文档路径                                    | 说明                                           |
-| ------------------------------------------- | ---------------------------------------------- |
-| `本体规划指南.md`                           | 规划方法、空间约束、**LLM 执行指引（v3 CLI）** |
-| `本体脚本编写指南.md`                       | 项目内 `脚本/` 目录约定                        |
-| `本体脚本编写指南.md` / `function-guide.md` | `dazi onto` 脚本发布与函数生命周期             |
-| `guides/workspace-v3.md`                    | 工作区 `项目/`、`资源/` 布局                   |
-
----
-
-**方案版本**：v1.0  
-**创建日期**：2026-05-20  
-**适用空间**：space\_\_profit0520  
-**状态**：待评审
+# 规划示例 · 利润分析本体方案
+
+**文档 ID**: `onto/planning-example-profit`
+
+> 表/Cube/对象命名遵循 [本体命名规范](./本体命名规范_物理表Cube与对象.md)。  
+> 工程模式参考：[规划示例_产品销售本体规划方案.md](./规划示例_产品销售本体规划方案.md)
+
+**占位符**（复制到工作区 `plans/` 后替换为实际值）：
+
+| 占位符 | 含义 | 权威来源 |
+| ------ | ---- | -------- |
+| `<space-id>` | 数据空间 ID | `项目/<业务名>/本体/ontos/<实现名>/README.md` |
+| `<业务名>` | 业务项目目录名 | 工作区 `项目/` 下文件夹 |
+| `<实现名>` | 本体实现单元名 | 如 `利润分析本体方案` |
+| `<item-path>` | 实现单元根路径 | `项目/<业务名>/本体/ontos/<实现名>` |
+
+---
+
+## 一、空间概述
+
+| 项目     | 说明 |
+| -------- | ---- |
+| 空间 ID  | `<space-id>`（示例：`space__acme`） |
+| 空间名称 | `<空间名称>`（与平台数据空间显示名一致） |
+| 空间状态 | 可与销售等其他域**共用**同一 `<space-id>`；利润域表/Cube/对象独立建设 |
+| 规划日期 | （填写定稿日期） |
+| 实现单元 | `<item-path>/` |
+
+> **共存说明**：本空间可能已有销售域 `dim_product`、`fact_sales_order_line` 等表。利润域 init **仅**创建/注册本域表；若 **`dim_date`** 已存在则 **ensure** 不重复建表。  
+> **与销售域关系**：销售收入可通过科目映射与实际分录对齐；勾稽函数可 LEFT JOIN `fact_sales_order_line`，**本体对象不以订单为主锚点**。
+
+---
+
+## 二、需求分析
+
+### 2.1 业务背景
+
+某制造企业（示例）财务利润分析场景，需构建**利润分析本体**，以业务语言描述「会计科目」「实际分录」「预算」及其关系，支撑：
+
+- **损益总览**：收入、成本、费用、营业利润、利润率
+- **科目结构**：按科目层级展开收入/成本/费用构成
+- **实际 vs 预算**：按期间、科目、成本中心的预算执行率与差异分析
+- **组织维度**：按成本中心/部门贡献与超支预警
+- **趋势分析**：同比、环比利润与关键科目走势
+- **归因分析**：利润变动由哪些科目/组织驱动
+
+### 2.2 核心业务问题
+
+| 问题            | 说明                           |
+| --------------- | ------------------------------ |
+| 利润是多少      | 期间营业利润、利润率           |
+| 钱从哪来/到哪去 | 收入、成本、费用科目结构       |
+| 预算执行如何    | 预算额、实际额、差异额、执行率 |
+| 哪个部门拖后腿  | 成本中心维度利润与预算偏差     |
+| 哪些科目异常    | 科目 Top N、同比/环比异动      |
+| 趋势如何        | 按月/季/年利润与关键科目走势   |
+
+### 2.3 规划范围说明
+
+**物理表清单**（命名见 [命名规范 §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 |
+
+> 规划原则：先定义 **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.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 表间关系设计（物理层 · 数据空间）
+
+> **与本体链接的区别**：本节描述 **ClickHouse 物理表 FK/JOIN**，供侧栏 **数据资源 → 表间关系** 与 AI 多表 JOIN。本体链接见第五节。
+
+**关系模型**：
+
+```text
+                    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（自关联）
+```
+
+**关系清单（8 条）**：
+
+| 关系 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="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="实际分录关联会计科目",
+)
+```
+
+**与本体链接对照**：
+
+| 物理表关系             | 对应本体链接（业务层）    |
+| ---------------------- | ------------------------- |
+| 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.0 Cube 清单与类别
+
+| 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 待补**） |
+
+> 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
+
+**度量**：
+
+| 度量名       | 列名          | 聚合  | 说明       |
+| ------------ | ------------- | ----- | ---------- |
+| debit_total  | debit_amount  | sum   | 借方合计   |
+| credit_total | credit_amount | sum   | 贷方合计   |
+| net_amount   | amount_signed | sum   | 损益符号额 |
+| line_count   | line_id       | count | 分录行数   |
+
+**派生度量**（按科目类型切片，表达式示意）：
+
+| 度量名           | 表达式（示意）                             | 说明     |
+| ---------------- | ------------------------------------------ | -------- |
+| revenue          | sumIf(amount_signed, account_type='收入')  | 收入     |
+| cost             | sumIf(amount_signed, account_type='成本')  | 营业成本 |
+| expense          | sumIf(amount_signed, account_type='费用')  | 期间费用 |
+| operating_profit | revenue - cost - expense                   | 营业利润 |
+| profit_margin    | if(revenue>0, operating_profit/revenue, 0) | 利润率   |
+
+### 4.2 AccountActualCube（Subject · 科目实际）
+
+**目的**：Account 对象 bind_source
+
+**维度**：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
+
+### 4.3 CostCenterActualCube（Subject · 成本中心实际）
+
+**维度**：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（Process · 预算）
+
+**事实源**：`fact_budget_entry`
+
+**维度**：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_revenue / budget_cost / budget_expense（按 account_type 切片）
+
+### 4.5 BudgetVsActualCube（Comparison · 预实对比）
+
+**目的**：`profit.fn.budget_vs_actual` 读模型；JOIN budget 与 actual 同维（account + cost_center + fiscal_period）
+
+**维度**：fiscal_year, fiscal_period, account_id, cost_center_id, budget_version
+
+**度量**：budget_amount, actual_amount（来自 ActualCube 聚合）, variance, execution_rate（派生）
+
+---
+
+## 五、本体层设计
+
+### 5.1 对象类型（6 种）
+
+| 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` 无前缀**；分类见 [命名规范 §5.3](./本体命名规范_物理表Cube与对象.md#53-对象分类无-code-前缀)。
+
+### 5.2 对象属性（摘要）
+
+#### Account（会计科目）
+
+| 属性 code   | 名称     | semantic_role | qualified_name                  |
+| ----------- | -------- | ------------- | ------------------------------- |
+| id          | 科目 ID  | dimension     | AccountActualCube.account_id    |
+| code        | 科目编码 | dimension     | AccountActualCube.account_code  |
+| name        | 科目名称 | dimension     | AccountActualCube.account_name  |
+| type        | 科目类型 | dimension     | AccountActualCube.account_type  |
+| pl_category | 损益大类 | dimension     | AccountActualCube.pl_category   |
+| level       | 科目层级 | dimension     | AccountActualCube.account_level |
+| net_amount  | 实际发生 | measure       | AccountActualCube.net_amount    |
+| revenue     | 收入     | measure       | AccountActualCube.revenue       |
+| cost        | 成本     | measure       | AccountActualCube.cost          |
+| expense     | 费用     | measure       | AccountActualCube.expense       |
+
+#### JournalEntry（实际分录）
+
+| 属性 code     | 名称     | semantic_role | qualified_name           |
+| ------------- | -------- | ------------- | ------------------------ |
+| id            | 行 ID    | dimension     | ActualCube.line_id       |
+| posting_date  | 记账日期 | dimension     | ActualCube.posting_date  |
+| fiscal_period | 会计期间 | dimension     | ActualCube.fiscal_period |
+| net_amount    | 损益金额 | measure       | ActualCube.net_amount    |
+| debit         | 借方     | measure       | ActualCube.debit_total   |
+| credit        | 贷方     | measure       | ActualCube.credit_total  |
+
+#### BudgetLine（预算行）
+
+| 属性 code     | 名称      | semantic_role | qualified_name            |
+| ------------- | --------- | ------------- | ------------------------- |
+| id            | 预算行 ID | dimension     | BudgetCube.line_id        |
+| version       | 预算版本  | dimension     | BudgetCube.budget_version |
+| fiscal_period | 预算期间  | dimension     | BudgetCube.fiscal_period  |
+| budget_amount | 预算金额  | measure       | BudgetCube.budget_amount  |
+
+#### CostCenter / ProfitAnalysis / BudgetAnalysis
+
+与 Cube 维/度量映射一致（约 **42** 个属性）；实施参照 `利润示例/setup/profit_ontology_init.py`（表名按本规划迁移）。
+
+### 5.3 链接类型（10 种）
+
+| 链接 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 |
+
+---
+
+## 六、本体函数设计
+
+### 6.1 函数清单
+
+| 函数 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` 勾稽销售表。
+
+### 6.2 函数示例：profit.fn.get_summary
+
+**功能**：期间损益总览（基于实际分录）
+
+**返回值**：
+
+| 字段名           | 类型    | 说明     |
+| ---------------- | ------- | -------- |
+| total_revenue    | Float64 | 总收入   |
+| total_cost       | Float64 | 总成本   |
+| total_expense    | Float64 | 总费用   |
+| operating_profit | Float64 | 营业利润 |
+| profit_margin    | Float64 | 利润率   |
+| line_count       | Int     | 分录行数 |
+
+### 6.3 函数示例：profit.fn.budget_vs_actual
+
+**功能**：按科目/成本中心对比预算与实际，输出差异与执行率
+
+**参数**：fiscal_year, fiscal_period（可选 0=全年）, budget_version, cost_center_id（可选）
+
+**返回值**：
+
+| 字段名           | 类型    | 说明                                     |
+| ---------------- | ------- | ---------------------------------------- |
+| account_code     | String  | 科目编码                                 |
+| account_name     | String  | 科目名称                                 |
+| pl_category      | String  | 损益大类                                 |
+| cost_center_name | String  | 成本中心                                 |
+| budget_amount    | Float64 | 预算额                                   |
+| actual_amount    | Float64 | 实际额                                   |
+| variance         | Float64 | 差异（实际-预算，收入/利润类为正向有利） |
+| execution_rate   | Float64 | 执行率（实际/预算）                      |
+
+### 6.4 函数示例：profit.fn.account_breakdown
+
+**功能**：按科目层级展开损益结构（树形或扁平）
+
+**返回值**：account_code, account_name, account_level, pl_category, revenue, cost, expense, net_impact, share_pct
+
+### 6.5 测试参数（test_arguments）
+
+| 函数 ID                      | test_arguments 文件                                   | 默认 arguments 要点                           |
+| ---------------------------- | ----------------------------------------------------- | --------------------------------------------- |
+| profit.fn.get_summary        | `functions/test_arguments/profit.fn.get_summary.json` | 2025-01-01 ~ 2026-06-30                       |
+| profit.fn.yoy_analysis       | `.../profit.fn.yoy_analysis.json`                     | 同上                                          |
+| profit.fn.mom_analysis       | `.../profit.fn.mom_analysis.json`                     | 同上                                          |
+| profit.fn.budget_vs_actual   | `.../profit.fn.budget_vs_actual.json`                 | fiscal_year=2026, budget_version=2026年度预算 |
+| profit.fn.account_breakdown  | `.../profit.fn.account_breakdown.json`                | account_level=2                               |
+| 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/利润示例/functions/test_arguments/`（复制到实现单元 `functions/test_arguments/`）。
+
+批量入库（实现单元 `functions/` 下，dazi-work 根）：
+
+```powershell
+.\<item-path>\functions\save_test_arguments.ps1
+```
+
+> 参考实现：`资源/examples/onto/利润示例/`（init + seed + 7 个 `profit_fn_*.py` + test_arguments）。
+
+---
+
+## 七、实施计划
+
+> **dazi-vscode v3** · 空间 `<space-id>` · 脚本目录 `setup/`、`functions/`  
+> 发布示例：  
+> `dazi onto script publish <item-path>/setup/profit_ontology_init.py --space <space-id> --type setup`
+
+### 7.1 阶段一：物理层（高）
+
+| 步骤 | 任务 | 说明 |
+| ---- | ---- | ---- |
+| 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 层（高）
+
+| 步骤 | 任务 |
+| ---- | ---- |
+| 8 | 注册 **5 个 Cube**（含 BudgetVsActualCube；无 Time Cube） |
+| 9 | 派生度量 revenue/cost/expense/operating_profit |
+
+### 7.3 阶段三：本体层（高）
+
+| 步骤 | 任务 |
+| ---- | ---- |
+| 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 阶段四：函数与数据（中）
+
+| 步骤 | 任务 |
+| ---- | ---- |
+| 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/利润示例/` | init/seed/函数完整示例 | 复制到 `<item-path>/` 后改 `<space-id>` |
+| [规划示例：产品销售](./规划示例_产品销售本体规划方案.md) | 工程模式对照 | 表结构与函数逻辑不同 |
+
+**seed 数据建议**：
+
+- 科目：一级 4–6 个（收入/成本/费用），二级 15–20 个
+- 成本中心：5–8 个（生产/销售/管理/财务等）
+- 实际分录：2025-01 ~ 2026-06 按月随机凭证，2000+ 行
+- 预算：同科目×成本中心×12 期，与 actual 同维便于预实对比
+
+---
+
+## 八、风险与验收
+
+### 8.1 风险
+
+| 等级 | 风险                      | 缓解措施                                    |
+| ---- | ------------------------- | ------------------------------------------- |
+| 中 | 多域共用 `<space-id>` | init 仅创建利润域表；**dim_date** 共用 ensure |
+| 中   | 借贷方向与符号口径不一致  | seed 统一计算 `amount_signed`；文档约定口径 |
+| 中   | 预实 JOIN 期间粒度不一致  | budget/actual 均含 fiscal_year/period       |
+| 低   | 旧示例订单模型混淆        | 规划与函数 ID 明确以 GL 为准                |
+
+### 8.2 验收标准
+
+| 验收项 | 标准 |
+| ------ | ---- |
+| 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 可运行 |
+| 数据         | 种子灌入后预实差异可解释                                |
+
+---
+
+## 九、预期成果
+
+| 分析能力     | 说明                           |
+| ------------ | ------------------------------ |
+| 损益总览     | 收入/成本/费用/营业利润/利润率 |
+| 科目结构     | 按层级与 pl_category 展开      |
+| **预实分析** | 预算、实际、差异、执行率       |
+| 组织利润     | 成本中心/部门贡献              |
+| 趋势分析     | 同比、环比                     |
+| 科目排行     | Top N 异动科目                 |
+| 业务语义     | 科目—分录—预算—组织链接可导航  |
+
+---
+
+## 附录 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） |
+
+---
+
+## 十、相关文档
+
+| 文档 | 路径 |
+| ---- | ---- |
+| 本体命名规范 | [本体命名规范_物理表Cube与对象.md](./本体命名规范_物理表Cube与对象.md) |
+| 本体规划指南 | [本体规划指南.md](./本体规划指南.md) |
+| 规划示例（产品销售） | [规划示例_产品销售本体规划方案.md](./规划示例_产品销售本体规划方案.md) |
+| **内置脚本示例** | `资源/examples/onto/利润示例/`（`dazi examples sync`；表名迁移中） |
+| 349 · 分类方案 | [本体分类规划与 SDK 扩展方案](./本体分类规划与SDK扩展方案.md) |
+
+---
+
+**方案版本**：v2.2（+347 分类列与附录 B CATEGORY_REGISTRY）  
+**创建日期**：（定稿日）  
+**适用**：复制到 `<item-path>/plans/`；`<space-id>` 以该实现单元 `README.md` 为准  
+**状态**：规划示例（公共模板）