@dazitech/cli 3.0.6 → 3.0.8

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,597 @@
-# 规划示例\_利润分析本体方案
-
----
-
-## 一、空间概述
-
-| 项目     | 说明                             |
-| -------- | -------------------------------- |
-| 空间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  | `space__zlj`                                                                 |
+| 空间名称 | 数据空间zlj                                                                  |
+| 空间状态 | 与「产品销售」「员工培训」等**共用同一数据空间**；利润域表/Cube/对象独立建设 |
+| 规划日期 | 2026-06-06                                                                   |
+| 实现单元 | `项目/潘达石化/本体/ontos/利润分析本体方案/`                                 |
+
+> **共存说明**：本空间可能已有 `product_master`、`sales_order_fact`、`training_record` 等表。利润分析域以 **会计科目 + 实际分录 + 预算** 为读模型根基，init 脚本**仅**创建/注册利润域表，不覆盖其他域资产。  
+> **与销售域关系**：销售收入可通过科目映射（如「6001 主营业务收入」）与实际分录对齐；必要时函数层 LEFT JOIN `sales_order_fact` 做勾稽，但**本体对象不以订单为主锚点**。
+
+---
+
+## 二、需求分析
+
+### 2.1 业务背景
+
+潘达石化财务利润分析场景，需构建**利润分析本体**，以业务语言描述「会计科目」「实际分录」「预算」及其关系，支撑：
+
+- **损益总览**：收入、成本、费用、营业利润、利润率
+- **科目结构**：按科目层级展开收入/成本/费用构成
+- **实际 vs 预算**：按期间、科目、成本中心的预算执行率与差异分析
+- **组织维度**：按成本中心/部门贡献与超支预警
+- **趋势分析**：同比、环比利润与关键科目走势
+- **归因分析**：利润变动由哪些科目/组织驱动
+
+### 2.2 核心业务问题
+
+| 问题            | 说明                           |
+| --------------- | ------------------------------ |
+| 利润是多少      | 期间营业利润、利润率           |
+| 钱从哪来/到哪去 | 收入、成本、费用科目结构       |
+| 预算执行如何    | 预算额、实际额、差异额、执行率 |
+| 哪个部门拖后腿  | 成本中心维度利润与预算偏差     |
+| 哪些科目异常    | 科目 Top N、同比/环比异动      |
+| 趋势如何        | 按月/季/年利润与关键科目走势   |
+
+### 2.3 规划范围说明
+
+**核心物理表（本方案重点）**：
+
+| 表名                   | 中文名         | 角色                            |
+| ---------------------- | -------------- | ------------------------------- |
+| `account_master`       | **科目表**     | 会计科目主数据（维表）          |
+| `actual_journal_entry` | **实际分录表** | 总账/财务实际记账流水（事实表） |
+| `budget_entry`         | **预算表**     | 预算编制明细（事实表）          |
+
+**辅助维表**：
+
+| 表名                    | 中文名       | 角色                     |
+| ----------------------- | ------------ | ------------------------ |
+| `cost_center_dimension` | 成本中心维表 | 组织/部门/利润中心主数据 |
+
+> 规划原则：先定义**业务对象**（Account、JournalEntry、BudgetLine 等）与**链接**，再反推物理表。  
+> **实际分录**承载「实际发生」；**预算表**承载「计划数」；**科目表**统一语义与损益口径（收入/成本/费用）。  
+> 旧版示例中的 `profit_analysis_fact`（订单粒度收入/成本）**不作为本方案主模型**；若需订单维度利润，可另建与销售域的映射函数，不替代 GL 分录。
+
+---
+
+## 三、物理层设计
+
+### 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.5 表间关系设计（物理层 · 数据空间）
+
+> **与本体链接的区别**：本节描述 **ClickHouse 物理表 FK/JOIN**，供侧栏 **数据资源 → 表间关系** 与 AI 多表 JOIN。本体链接见第五节。
+
+**关系模型**：
+
+```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（自关联，科目树）
+```
+
+**关系清单（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 时加期间条件） |
+
+> **说明**：`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。
+
+**实施 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",
+    join_keys=[{"from": "account_id", "to": "account_id"}],
+    relationship_type="many_to_one",
+    description="实际分录关联会计科目",
+)
+```
+
+**与本体链接对照**：
+
+| 物理表关系             | 对应本体链接（业务层）    |
+| ---------------------- | ------------------------- |
+| 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 |
+
+---
+
+## 四、Cube 层设计
+
+### 4.1 ActualCube（实际发生主 Cube）
+
+**事实源**：`actual_journal_entry`
+
+**维度**：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
+
+**度量**：
+
+| 度量名       | 列名          | 聚合  | 说明       |
+| ------------ | ------------- | ----- | ---------- |
+| 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（科目实际 Cube）
+
+**目的**：Account 对象 bind_source
+
+**维度**：account_id, account_code, account_name, account_type, pl_category, account_level, fiscal_year, fiscal_period
+
+**度量**：net_amount, line_count
+
+**派生度量**：revenue, cost, expense（同上，按 account_type 聚合）
+
+### 4.3 CostCenterActualCube（成本中心实际 Cube）
+
+**维度**：cost_center_id, cost_center_name, department, profit_center, fiscal_year, fiscal_period
+
+**度量**：net_amount, line_count
+
+**派生度量**：revenue, cost, expense, operating_profit, profit_margin
+
+### 4.4 BudgetCube（预算 Cube）
+
+**事实源**：`budget_entry`
+
+**维度**：budget_version, fiscal_year, fiscal_period, account_id, account_code, account_type, pl_category, cost_center_id, department
+
+**度量**：
+
+| 度量名        | 列名          | 聚合  | 说明     |
+| ------------- | ------------- | ----- | -------- |
+| budget_amount | budget_amount | sum   | 预算金额 |
+| budget_lines  | line_id       | count | 预算行数 |
+
+**派生度量**：budget_revenue / budget_cost / budget_expense（按 account_type 切片，同 ActualCube 逻辑）
+
+### 4.5 TimeActualCube（时间维度 Cube）
+
+**维度**：posting_date, fiscal_year, fiscal_period, year_month, quarter
+
+**度量**：net_amount, revenue, cost, expense, operating_profit（派生）
+
+---
+
+## 五、本体层设计
+
+### 5.1 对象类型（6 种）
+
+| 对象类型 code  | 名称     | 说明                    | bind_source          |
+| -------------- | -------- | ----------------------- | -------------------- |
+| Account        | 会计科目 | 科目业务对象            | AccountActualCube    |
+| CostCenter     | 成本中心 | 组织/利润中心业务对象   | CostCenterActualCube |
+| JournalEntry   | 实际分录 | 凭证行/实际发生业务对象 | ActualCube           |
+| BudgetLine     | 预算行   | 预算编制明细业务对象    | BudgetCube           |
+| ProfitAnalysis | 利润分析 | 多维度损益指标聚合对象  | ActualCube           |
+| BudgetAnalysis | 预算分析 | 预算执行与差异分析对象  | BudgetCube           |
+
+> 对象类型 `code` 使用稳定英文标识；与表名、Cube 名刻意区分。
+
+### 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** 个属性，实施时参照 init 脚本）。
+
+### 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 | 成本中心利润贡献 |
+
+---
+
+## 六、本体函数设计
+
+### 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（可选）          |
+
+> 旧示例中的 `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/利润示例/function/test_arguments/`（复制到实现单元 `functions/test_arguments/`）。
+
+批量入库（实现单元 `functions/` 下，dazi-work 根）：
+
+```powershell
+.\项目\潘达石化\本体\ontos\利润分析本体方案\functions\save_test_arguments.ps1
+```
+
+> 参考实现：`资源/examples/onto/利润示例/`（init + seed + 7 个 `profit_fn_*.py` + test_arguments）。
+
+---
+
+## 七、实施计划
+
+> **dazi-vscode v3** · 空间 `space__zlj` · 脚本目录 `setup/`、`functions/`  
+> 发布示例：  
+> `dazi onto script publish 项目/潘达石化/本体/ontos/利润分析本体方案/setup/profit_ontology_init.py --space space__zlj --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        |
+
+### 7.2 阶段二：Cube 层（高）
+
+| 步骤 | 任务                                               |
+| ---- | -------------------------------------------------- |
+| 7    | 注册 ActualCube / AccountActualCube 等 5 个 Cube   |
+| 8    | 配置派生度量 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            |
+
+### 7.4 阶段四：函数与数据（中）
+
+| 步骤 | 任务                                                                              |
+| ---- | --------------------------------------------------------------------------------- |
+| 14   | 新建 `profit_ontology_init.py`、`profit_seed_data.py`（科目树+分录+预算演示数据） |
+| 15   | 适配/新建 7 个 `profit_fn_*.py`                                                   |
+| 16   | 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 工程模式 | 表结构与函数逻辑不同           |
+
+**seed 数据建议**：
+
+- 科目：一级 4–6 个（收入/成本/费用），二级 15–20 个
+- 成本中心：5–8 个（生产/销售/管理/财务等）
+- 实际分录：2025-01 ~ 2026-06 按月随机凭证，2000+ 行
+- 预算：同科目×成本中心×12 期，与 actual 同维便于预实对比
+
+---
+
+## 八、风险与验收
+
+### 8.1 风险
+
+| 等级 | 风险                      | 缓解措施                                    |
+| ---- | ------------------------- | ------------------------------------------- |
+| 中   | 与销售域共用 space\_\_zlj | init 仅创建利润域 4 表                      |
+| 中   | 借贷方向与符号口径不一致  | 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 可运行 |
+| 数据         | 种子灌入后预实差异可解释                                |
+
+---
+
+## 九、预期成果
+
+| 分析能力     | 说明                           |
+| ------------ | ------------------------------ |
+| 损益总览     | 收入/成本/费用/营业利润/利润率 |
+| 科目结构     | 按层级与 pl_category 展开      |
+| **预实分析** | 预算、实际、差异、执行率       |
+| 组织利润     | 成本中心/部门贡献              |
+| 趋势分析     | 同比、环比                     |
+| 科目排行     | Top N 异动科目                 |
+| 业务语义     | 科目—分录—预算—组织链接可导航  |
+
+---
+
+## 十、相关文档
+
+| 文档                               | 路径                                                                          |
+| ---------------------------------- | ----------------------------------------------------------------------------- |
+| 快速启动                           | [../快速启动\_利润分析本体方案.md](../快速启动_利润分析本体方案.md)           |
+| 本体规划指南                       | `资源/docs/onto/本体规划指南.md`                                              |
+| 规划示例（产品销售，推荐工程模式） | `资源/docs/onto/规划示例_产品销售本体规划方案.md`                             |
+| 规划示例（利润·GL 域）             | `资源/docs/onto/规划示例_利润分析本体方案.md`                                 |
+| **内置脚本示例**                   | `资源/examples/onto/利润示例/`（`dazi examples sync`）                        |
+
+---
+
+**方案版本**：v2.0  
+**创建日期**：2026-06-06  
+**适用空间**：`space__zlj`  
+**状态**：已落地