@dazitech/cli 3.0.0

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

@@ -0,0 +1,541 @@
+# 规划示例\_利润分析本体方案
+
+---
+
+## 一、空间概述
+
+| 项目     | 说明                             |
+| -------- | -------------------------------- |
+| 空间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_<名称>/` 在新建项目时绑定该空间）  
+> 环境：`.\scripts\dazi.ps1 doctor` · 现网表/Cube：**数据资源** 侧栏 ·  
+> 发布：`.\scripts\dazi.ps1 onto script publish 项目/onto_<名称>/脚本/<file>.py --space space__profit0520 --register-function-id <id>` ·  
+> 运行：`.\scripts\dazi.ps1 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   | 发布并注册函数             | `.\scripts\dazi.ps1 onto script publish … --space space__profit0520 --register-function-id` |
+
+### 7.5 阶段五：数据层（优先级：中）
+
+| 步骤 | 任务         | 说明                     |
+| ---- | ------------ | ------------------------ |
+| 21   | 生成模拟数据 | 2025年1-6月、2026年1-6月 |
+| 22   | 数据验证     | 验证查询结果             |
+
+### 7.6 阶段六：验证与交付（优先级：高）
+
+| 步骤 | 任务     | 说明                                                                                    |
+| ---- | -------- | --------------------------------------------------------------------------------------- |
+| 23   | 验收核对 | 侧栏 **数据资源** 查表/Cube；`.\scripts\dazi.ps1 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` | `.\scripts\dazi.ps1 onto` 脚本发布与函数生命周期 |
+| `guides/workspace-v3.md`                | 工作区 `项目/`、`资源/` 布局                   |
+
+---
+
+**方案版本**：v1.0  
+**创建日期**：2026-05-20  
+**适用空间**：space\_\_profit0520  
+**状态**：待评审

package/dist/examples/index.json

@@ -0,0 +1,36 @@
+{
+  "version": "3.0.0",
+  "updatedAt": "2026-05-25T00:00:00.000Z",
+  "examples": [
+    {
+      "id": "onto/setup/profit-ontology-init",
+      "title": "利润分析本体初始化",
+      "category": "onto-setup",
+      "file": "onto/setup/profit_ontology_init.py"
+    },
+    {
+      "id": "onto/function/profit-fn-yoy",
+      "title": "利润同比分析 (YoY)",
+      "category": "onto-function",
+      "file": "onto/function/profit_fn_yoy_analysis.py"
+    },
+    {
+      "id": "onto/function/profit-fn-mom",
+      "title": "利润环比分析 (MoM)",
+      "category": "onto-function",
+      "file": "onto/function/profit_fn_mom_analysis.py"
+    },
+    {
+      "id": "onto/function/profit-fn-top-products",
+      "title": "产品利润排行",
+      "category": "onto-function",
+      "file": "onto/function/profit_fn_top_products.py"
+    },
+    {
+      "id": "onto/function/profit-fn-customer-segmentation",
+      "title": "客户分层",
+      "category": "onto-function",
+      "file": "onto/function/profit_fn_customer_segmentation.py"
+    }
+  ]
+}

package/dist/examples/onto/function/profit_fn_customer_segmentation.py

@@ -0,0 +1,117 @@
+"""Customer Segmentation Function
+
+功能：基于利润贡献对客户进行分层
+参数：metric, method, start_date, end_date
+返回：客户分层数据（VIP/High/Medium/Low）
+
+放置位置：spaces/space__profit0520/editorial/scripts/ontology_functions/profit_fn_customer_segmentation.py
+检索关键字：profit customer_segmentation
+"""
+
+
+def _ontology_fn_body(p):
+    params = dict(p.get_params() or {})
+
+    metric = params.get("metric", "profit")
+    method = params.get("method", "quartile")
+    start_date = params.get("start_date", "")
+    end_date = params.get("end_date", "")
+
+    where_clause = ""
+    if start_date and end_date:
+        where_clause = f"WHERE order_date >= '{start_date}' AND order_date <= '{end_date}'"
+
+    sql = f"""
+    SELECT
+        customer_id,
+        customer_region,
+        sum(revenue) as revenue,
+        sum(cost) as cost,
+        sum(revenue) - sum(cost) as profit
+    FROM profit_analysis_fact
+    {where_clause}
+    GROUP BY customer_id, customer_region
+    ORDER BY profit DESC
+    """
+
+    result = p.sql.query(sql)
+
+    if not result:
+        return p.function_result(
+            columns=["customer_id", "customer_region", "revenue", "cost", "profit", "segment"],
+            data=[],
+            row_count=0
+        )
+
+    profits = [float(row.get("profit", 0) or 0) for row in result]
+    total = len(profits)
+
+    if total == 0:
+        return p.function_result(
+            columns=["customer_id", "customer_region", "revenue", "cost", "profit", "segment"],
+            data=[],
+            row_count=0
+        )
+
+    if method == "percentile":
+        sorted_profits = sorted(profits, reverse=True)
+        p80_idx = min(int(total * 0.8), total - 1)
+        p50_idx = min(int(total * 0.5), total - 1)
+        p20_idx = min(int(total * 0.2), total - 1)
+        p80 = sorted_profits[p80_idx]
+        p50 = sorted_profits[p50_idx]
+        p20 = sorted_profits[p20_idx]
+    else:
+        sorted_profits = sorted(profits, reverse=True)
+        q1_idx = min(int(total * 0.25), total - 1)
+        q2_idx = min(int(total * 0.5), total - 1)
+        q3_idx = min(int(total * 0.75), total - 1)
+        p80 = sorted_profits[q1_idx]
+        p50 = sorted_profits[q2_idx]
+        p20 = sorted_profits[q3_idx]
+
+    def get_segment(profit_val):
+        if profit_val >= p80:
+            return "VIP"
+        elif profit_val >= p50:
+            return "High"
+        elif profit_val >= p20:
+            return "Medium"
+        else:
+            return "Low"
+
+    data = []
+    for row in result:
+        profit = float(row.get("profit", 0) or 0)
+        data.append({
+            "customer_id": str(row.get("customer_id", "")),
+            "customer_region": str(row.get("customer_region", "")),
+            "revenue": round(float(row.get("revenue", 0) or 0), 2),
+            "cost": round(float(row.get("cost", 0) or 0), 2),
+            "profit": round(profit, 2),
+            "segment": get_segment(profit),
+        })
+
+    return p.function_result(
+        columns=["customer_id", "customer_region", "revenue", "cost", "profit", "segment"],
+        data=data,
+        row_count=len(data)
+    )
+
+
+def main():
+    s = space.get(ctx.space_id or "")
+
+    _Ports = type(
+        "_Ports",
+        (),
+        {
+            "get_params": lambda self: dict(ctx.params or {}),
+            "function_result": lambda self, **kw: onto.function_result(**kw),
+        },
+    )
+    p = _Ports()
+    p.space_id = str(ctx.space_id or "")
+    p.sql = s.sql
+
+    return _ontology_fn_body(p)