@dazitech/cli 3.0.7 → 3.0.8

package/dist/examples/index.json

@@ -1,36 +1,216 @@
 {
-  "version": "3.0.5",
-  "updatedAt": "2026-05-25T00:00:00.000Z",
+  "version": "3.1.0",
+  "updatedAt": "2026-06-06T12:00:00.000Z",
   "examples": [
     {
-      "id": "onto/setup/profit-ontology-init",
-      "title": "利润分析本体初始化",
-      "category": "onto-setup",
-      "file": "onto/setup/profit_ontology_init.py"
+      "id": "onto/readme",
+      "title": "Onto 示例总览（利润 + 销售）",
+      "category": "onto",
+      "file": "onto/README.md"
     },
     {
-      "id": "onto/function/profit-fn-yoy",
-      "title": "利润同比分析 (YoY)",
-      "category": "onto-function",
-      "file": "onto/function/profit_fn_yoy_analysis.py"
+      "id": "onto/profit/setup/ontology-init",
+      "title": "利润分析 · 本体初始化",
+      "category": "onto-利润-初始化",
+      "file": "onto/利润示例/setup/profit_ontology_init.py"
     },
     {
-      "id": "onto/function/profit-fn-mom",
-      "title": "利润环比分析 (MoM)",
-      "category": "onto-function",
-      "file": "onto/function/profit_fn_mom_analysis.py"
+      "id": "onto/profit/setup/seed-data",
+      "title": "利润分析 · 演示灌数",
+      "category": "onto-利润-初始化",
+      "file": "onto/利润示例/setup/profit_seed_data.py"
     },
     {
-      "id": "onto/function/profit-fn-top-products",
-      "title": "产品利润排行",
-      "category": "onto-function",
-      "file": "onto/function/profit_fn_top_products.py"
+      "id": "onto/profit/function/get-summary",
+      "title": "利润分析 · 利润总览",
+      "category": "onto-利润-函数",
+      "file": "onto/利润示例/function/profit_fn_get_summary.py"
     },
     {
-      "id": "onto/function/profit-fn-customer-segmentation",
-      "title": "客户分层",
-      "category": "onto-function",
-      "file": "onto/function/profit_fn_customer_segmentation.py"
+      "id": "onto/profit/function/yoy",
+      "title": "利润分析 · 同比 (YoY)",
+      "category": "onto-利润-函数",
+      "file": "onto/利润示例/function/profit_fn_yoy_analysis.py"
+    },
+    {
+      "id": "onto/profit/function/mom",
+      "title": "利润分析 · 环比 (MoM)",
+      "category": "onto-利润-函数",
+      "file": "onto/利润示例/function/profit_fn_mom_analysis.py"
+    },
+    {
+      "id": "onto/profit/function/budget-vs-actual",
+      "title": "利润分析 · 预实对比",
+      "category": "onto-利润-函数",
+      "file": "onto/利润示例/function/profit_fn_budget_vs_actual.py"
+    },
+    {
+      "id": "onto/profit/function/account-breakdown",
+      "title": "利润分析 · 科目结构",
+      "category": "onto-利润-函数",
+      "file": "onto/利润示例/function/profit_fn_account_breakdown.py"
+    },
+    {
+      "id": "onto/profit/function/cost-center-profit",
+      "title": "利润分析 · 组织利润",
+      "category": "onto-利润-函数",
+      "file": "onto/利润示例/function/profit_fn_cost_center_profit.py"
+    },
+    {
+      "id": "onto/profit/function/top-accounts",
+      "title": "利润分析 · 科目 Top N",
+      "category": "onto-利润-函数",
+      "file": "onto/利润示例/function/profit_fn_top_accounts.py"
+    },
+    {
+      "id": "onto/profit/function/save-test-arguments",
+      "title": "利润分析 · 批量保存 test_arguments",
+      "category": "onto-利润-工具",
+      "file": "onto/利润示例/function/save_test_arguments.ps1"
+    },
+    {
+      "id": "onto/profit/test-args/get-summary",
+      "title": "test_arguments · profit.fn.get_summary",
+      "category": "onto-利润-测试参数",
+      "file": "onto/利润示例/function/test_arguments/profit.fn.get_summary.json"
+    },
+    {
+      "id": "onto/profit/test-args/yoy",
+      "title": "test_arguments · profit.fn.yoy_analysis",
+      "category": "onto-利润-测试参数",
+      "file": "onto/利润示例/function/test_arguments/profit.fn.yoy_analysis.json"
+    },
+    {
+      "id": "onto/profit/test-args/mom",
+      "title": "test_arguments · profit.fn.mom_analysis",
+      "category": "onto-利润-测试参数",
+      "file": "onto/利润示例/function/test_arguments/profit.fn.mom_analysis.json"
+    },
+    {
+      "id": "onto/profit/test-args/budget-vs-actual",
+      "title": "test_arguments · profit.fn.budget_vs_actual",
+      "category": "onto-利润-测试参数",
+      "file": "onto/利润示例/function/test_arguments/profit.fn.budget_vs_actual.json"
+    },
+    {
+      "id": "onto/profit/test-args/account-breakdown",
+      "title": "test_arguments · profit.fn.account_breakdown",
+      "category": "onto-利润-测试参数",
+      "file": "onto/利润示例/function/test_arguments/profit.fn.account_breakdown.json"
+    },
+    {
+      "id": "onto/profit/test-args/cost-center-profit",
+      "title": "test_arguments · profit.fn.cost_center_profit",
+      "category": "onto-利润-测试参数",
+      "file": "onto/利润示例/function/test_arguments/profit.fn.cost_center_profit.json"
+    },
+    {
+      "id": "onto/profit/test-args/top-accounts",
+      "title": "test_arguments · profit.fn.top_accounts",
+      "category": "onto-利润-测试参数",
+      "file": "onto/利润示例/function/test_arguments/profit.fn.top_accounts.json"
+    },
+    {
+      "id": "onto/sales/setup/ontology-init",
+      "title": "产品销售 · 本体初始化",
+      "category": "onto-销售-初始化",
+      "file": "onto/销售示例/setup/sales_ontology_init.py"
+    },
+    {
+      "id": "onto/sales/setup/seed-data",
+      "title": "产品销售 · 演示灌数",
+      "category": "onto-销售-初始化",
+      "file": "onto/销售示例/setup/sales_seed_data.py"
+    },
+    {
+      "id": "onto/sales/function/get-summary",
+      "title": "产品销售 · 销售概览",
+      "category": "onto-销售-函数",
+      "file": "onto/销售示例/functions/sales_fn_get_summary.py"
+    },
+    {
+      "id": "onto/sales/function/yoy",
+      "title": "产品销售 · 同比分析",
+      "category": "onto-销售-函数",
+      "file": "onto/销售示例/functions/sales_fn_yoy_analysis.py"
+    },
+    {
+      "id": "onto/sales/function/mom",
+      "title": "产品销售 · 环比分析",
+      "category": "onto-销售-函数",
+      "file": "onto/销售示例/functions/sales_fn_mom_analysis.py"
+    },
+    {
+      "id": "onto/sales/function/top-products",
+      "title": "产品销售 · Top 产品",
+      "category": "onto-销售-函数",
+      "file": "onto/销售示例/functions/sales_fn_top_products.py"
+    },
+    {
+      "id": "onto/sales/function/customer-segmentation",
+      "title": "产品销售 · 客户分层",
+      "category": "onto-销售-函数",
+      "file": "onto/销售示例/functions/sales_fn_customer_segmentation.py"
+    },
+    {
+      "id": "onto/sales/function/region-breakdown",
+      "title": "产品销售 · 区域分布",
+      "category": "onto-销售-函数",
+      "file": "onto/销售示例/functions/sales_fn_region_breakdown.py"
+    },
+    {
+      "id": "onto/sales/function/channel-mix",
+      "title": "产品销售 · 渠道结构",
+      "category": "onto-销售-函数",
+      "file": "onto/销售示例/functions/sales_fn_channel_mix.py"
+    },
+    {
+      "id": "onto/sales/function/save-test-arguments",
+      "title": "产品销售 · 批量保存 test_arguments",
+      "category": "onto-销售-工具",
+      "file": "onto/销售示例/functions/save_test_arguments.ps1"
+    },
+    {
+      "id": "onto/sales/test-args/get-summary",
+      "title": "test_arguments · sales.fn.get_summary",
+      "category": "onto-销售-测试参数",
+      "file": "onto/销售示例/functions/test_arguments/sales.fn.get_summary.json"
+    },
+    {
+      "id": "onto/sales/test-args/yoy",
+      "title": "test_arguments · sales.fn.yoy_analysis",
+      "category": "onto-销售-测试参数",
+      "file": "onto/销售示例/functions/test_arguments/sales.fn.yoy_analysis.json"
+    },
+    {
+      "id": "onto/sales/test-args/mom",
+      "title": "test_arguments · sales.fn.mom_analysis",
+      "category": "onto-销售-测试参数",
+      "file": "onto/销售示例/functions/test_arguments/sales.fn.mom_analysis.json"
+    },
+    {
+      "id": "onto/sales/test-args/top-products",
+      "title": "test_arguments · sales.fn.top_products",
+      "category": "onto-销售-测试参数",
+      "file": "onto/销售示例/functions/test_arguments/sales.fn.top_products.json"
+    },
+    {
+      "id": "onto/sales/test-args/customer-segmentation",
+      "title": "test_arguments · sales.fn.customer_segmentation",
+      "category": "onto-销售-测试参数",
+      "file": "onto/销售示例/functions/test_arguments/sales.fn.customer_segmentation.json"
+    },
+    {
+      "id": "onto/sales/test-args/region-breakdown",
+      "title": "test_arguments · sales.fn.region_breakdown",
+      "category": "onto-销售-测试参数",
+      "file": "onto/销售示例/functions/test_arguments/sales.fn.region_breakdown.json"
+    },
+    {
+      "id": "onto/sales/test-args/channel-mix",
+      "title": "test_arguments · sales.fn.channel_mix",
+      "category": "onto-销售-测试参数",
+      "file": "onto/销售示例/functions/test_arguments/sales.fn.channel_mix.json"
     },
     {
       "id": "flow/minimal-excel-python",

package/dist/examples/onto/README.md

@@ -0,0 +1,43 @@
+# Onto 内置示例
+
+`dazi examples sync` 后位于 **`资源/examples/onto/`**。复制到业务项目的 **`项目/<业务名>/本体/ontos/<实现名>/`** 对应子目录后再改 `space_id` 与业务字段。
+
+## 利润示例（`利润示例/`）
+
+| 路径 | 说明 | 规划文档 |
+|------|------|----------|
+| `setup/profit_ontology_init.py` | GL 域 init（科目/分录/预算表、Cube、对象、链接） | [规划示例_利润分析本体方案](../../docs/onto/规划示例_利润分析本体方案.md) |
+| `setup/profit_seed_data.py` | 演示灌数（科目树、成本中心、实际分录、预算） | 同上 |
+| `function/profit_fn_*.py` | 7 个 GL 分析函数（总览/同比/环比/预实/科目/组织/Top 科目） | 同上 |
+| `function/test_arguments/*.json` | 各 `profit.fn.*` 默认测试入参 | 规划 §6.5 |
+| `function/save_test_arguments.ps1` | 批量写入平台 `test_arguments` | 发布函数后执行 |
+
+发布后须 **`function run` 验证** → **`save-test-arguments`** 写入默认测试入参（见规划 §6.5）。
+
+推荐空间：`space__zlj`（以你的实现单元 README 为准）。
+
+## 销售示例（`销售示例/`）
+
+| 路径 | 说明 | 规划文档 |
+|------|------|----------|
+| `setup/sales_ontology_init.py` | 产品销售 init（表间关系 + Cube + 本体） | [规划示例_产品销售本体规划方案](../../docs/onto/规划示例_产品销售本体规划方案.md) |
+| `setup/sales_seed_data.py` | 演示灌数（产品/销售/维表） | 同上 |
+| `functions/sales_fn_*.py` | 7 个销售分析函数 | 同上 |
+| `functions/test_arguments/*.json` | 各 `function_id` 默认测试入参 | 与规划 §函数清单一致 |
+| `functions/save_test_arguments.ps1` | 批量写入平台 `test_arguments` | 发布函数后执行 |
+
+推荐空间：`space__zlj`（以你的实现单元 README 为准）。
+
+## 复制示例
+
+```text
+资源/examples/onto/利润示例/setup/*.py              → 项目/<业务>/本体/ontos/<实现>/setup/
+资源/examples/onto/利润示例/function/*.py            → 项目/<业务>/本体/ontos/<实现>/functions/
+资源/examples/onto/利润示例/function/test_arguments/ → .../functions/test_arguments/
+
+资源/examples/onto/销售示例/setup/*.py              → 项目/<业务>/本体/ontos/<实现>/setup/
+资源/examples/onto/销售示例/functions/*.py            → 项目/<业务>/本体/ontos/<实现>/functions/
+资源/examples/onto/销售示例/functions/test_arguments/ → .../functions/test_arguments/
+```
+
+侧栏 **帮助 → 示例** 可按分类浏览；`dazi examples list --category onto-利润-函数` 可过滤。

package/dist/examples/onto//345/210/251/346/266/246/347/244/272/344/276/213/function/profit_fn_account_breakdown.py

@@ -0,0 +1,99 @@
+"""科目结构分析函数 profit.fn.account_breakdown
+
+参数：start_date, end_date, account_level, pl_category（均可选）
+返回：科目层级的收入、成本、费用、净影响、占比
+
+发布：
+  dazi onto script publish 项目/潘达石化/本体/ontos/利润分析本体方案/functions/profit_fn_account_breakdown.py \\
+    --space space__zlj --register-function-id profit.fn.account_breakdown
+"""
+
+TEST_ARGUMENTS = {
+    "v": 1,
+    "arguments": {"start_date": "2025-01-01", "end_date": "2026-06-30", "account_level": 2, "pl_category": ""},
+    "object_type_code": "ProfitAnalysis",
+}
+
+
+def _build_where(start_date, end_date, account_level, pl_category):
+    clauses = ["account_type IN ('收入','成本','费用')"]
+    if start_date and end_date:
+        clauses.append(f"posting_date >= '{start_date}' AND posting_date <= '{end_date}'")
+    if account_level:
+        clauses.append(f"account_level = {int(account_level)}")
+    if pl_category:
+        clauses.append(f"pl_category = '{pl_category}'")
+    return "WHERE " + " AND ".join(clauses)
+
+
+def _ontology_fn_body(p):
+    params = dict(p.get_params() or {})
+    where_clause = _build_where(
+        params.get("start_date", ""),
+        params.get("end_date", ""),
+        params.get("account_level", ""),
+        params.get("pl_category", ""),
+    )
+
+    sql = f"""
+    SELECT
+        account_code,
+        account_name,
+        account_level,
+        pl_category,
+        account_type,
+        sum(if(account_type = '收入', amount_signed, 0)) AS revenue,
+        sum(if(account_type = '成本', amount_signed, 0)) AS cost,
+        sum(if(account_type = '费用', amount_signed, 0)) AS expense
+    FROM actual_journal_entry
+    {where_clause}
+    GROUP BY account_code, account_name, account_level, pl_category, account_type
+    ORDER BY account_code
+    """
+
+    rows = p.sql.query(sql)
+    total_impact = 0.0
+    parsed = []
+    for row in rows:
+        rev = float(row.get("revenue", 0) or 0)
+        cost = float(row.get("cost", 0) or 0)
+        exp = float(row.get("expense", 0) or 0)
+        acct_type = row.get("account_type", "")
+        if acct_type == "收入":
+            net = rev
+        else:
+            net = -(cost + exp)
+        total_impact += abs(net)
+        parsed.append((row, rev, cost, exp, net))
+
+    data = []
+    for row, rev, cost, exp, net in parsed:
+        share = abs(net) / total_impact * 100 if total_impact > 0 else 0.0
+        data.append({
+            "account_code": row.get("account_code", ""),
+            "account_name": row.get("account_name", ""),
+            "account_level": int(row.get("account_level", 0) or 0),
+            "pl_category": row.get("pl_category", ""),
+            "revenue": round(rev, 2),
+            "cost": round(cost, 2),
+            "expense": round(exp, 2),
+            "net_impact": round(net, 2),
+            "share_pct": round(share, 2),
+        })
+
+    return p.function_result(
+        columns=["account_code", "account_name", "account_level", "pl_category", "revenue", "cost", "expense", "net_impact", "share_pct"],
+        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.sql = s.sql
+    return _ontology_fn_body(p)

package/dist/examples/onto//345/210/251/346/266/246/347/244/272/344/276/213/function/profit_fn_budget_vs_actual.py

@@ -0,0 +1,116 @@
+"""预实对比函数 profit.fn.budget_vs_actual
+
+参数：fiscal_year, fiscal_period（0=全年）, budget_version, cost_center_id（可选）
+返回：科目×成本中心的预算额、实际额、差异、执行率
+
+发布：
+  dazi onto script publish 项目/潘达石化/本体/ontos/利润分析本体方案/functions/profit_fn_budget_vs_actual.py \\
+    --space space__zlj --register-function-id profit.fn.budget_vs_actual
+"""
+
+TEST_ARGUMENTS = {
+    "v": 1,
+    "arguments": {
+        "fiscal_year": 2026,
+        "fiscal_period": 0,
+        "budget_version": "2026年度预算",
+        "cost_center_id": "",
+    },
+    "object_type_code": "BudgetAnalysis",
+}
+
+
+def _ontology_fn_body(p):
+    params = dict(p.get_params() or {})
+    fiscal_year = int(params.get("fiscal_year", 2026) or 2026)
+    fiscal_period = int(params.get("fiscal_period", 0) or 0)
+    budget_version = params.get("budget_version", "2026年度预算")
+    cost_center_id = params.get("cost_center_id", "")
+
+    period_filter_b = ""
+    period_filter_a = ""
+    if fiscal_period > 0:
+        period_filter_b = f"AND fiscal_period = {fiscal_period}"
+        period_filter_a = f"AND fiscal_period = {fiscal_period}"
+
+    cc_filter_b = f"AND cost_center_id = '{cost_center_id}'" if cost_center_id else ""
+    cc_filter_a = cc_filter_b
+
+    sql = f"""
+    SELECT
+        coalesce(b.account_code, a.account_code) AS account_code,
+        coalesce(b.account_name, a.account_name) AS account_name,
+        coalesce(b.pl_category, a.pl_category) AS pl_category,
+        coalesce(b.cost_center_name, a.cost_center_name) AS cost_center_name,
+        coalesce(b.budget_amount, 0) AS budget_amount,
+        coalesce(a.actual_amount, 0) AS actual_amount
+    FROM (
+        SELECT
+            account_id,
+            account_code,
+            account_name,
+            pl_category,
+            cost_center_id,
+            cost_center_name,
+            sum(budget_amount) AS budget_amount
+        FROM budget_entry
+        WHERE fiscal_year = {fiscal_year}
+          AND budget_version = '{budget_version}'
+          AND status = '已发布'
+          {period_filter_b}
+          {cc_filter_b}
+        GROUP BY account_id, account_code, account_name, pl_category, cost_center_id, cost_center_name
+    ) b
+    FULL OUTER JOIN (
+        SELECT
+            account_id,
+            account_code,
+            account_name,
+            pl_category,
+            cost_center_id,
+            cost_center_name,
+            sum(amount_signed) AS actual_amount
+        FROM actual_journal_entry
+        WHERE fiscal_year = {fiscal_year}
+          AND account_type IN ('收入','成本','费用')
+          {period_filter_a}
+          {cc_filter_a}
+        GROUP BY account_id, account_code, account_name, pl_category, cost_center_id, cost_center_name
+    ) a ON b.account_id = a.account_id AND b.cost_center_id = a.cost_center_id
+    ORDER BY abs(coalesce(a.actual_amount, 0) - coalesce(b.budget_amount, 0)) DESC
+    """
+
+    rows = p.sql.query(sql)
+    data = []
+    for row in rows:
+        budget_amt = float(row.get("budget_amount", 0) or 0)
+        actual_amt = float(row.get("actual_amount", 0) or 0)
+        variance = actual_amt - budget_amt
+        exec_rate = actual_amt / budget_amt if budget_amt != 0 else 0.0
+        data.append({
+            "account_code": row.get("account_code", ""),
+            "account_name": row.get("account_name", ""),
+            "pl_category": row.get("pl_category", ""),
+            "cost_center_name": row.get("cost_center_name", ""),
+            "budget_amount": round(budget_amt, 2),
+            "actual_amount": round(actual_amt, 2),
+            "variance": round(variance, 2),
+            "execution_rate": round(exec_rate, 4),
+        })
+
+    return p.function_result(
+        columns=["account_code", "account_name", "pl_category", "cost_center_name", "budget_amount", "actual_amount", "variance", "execution_rate"],
+        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.sql = s.sql
+    return _ontology_fn_body(p)

package/dist/examples/onto//345/210/251/346/266/246/347/244/272/344/276/213/function/profit_fn_cost_center_profit.py

@@ -0,0 +1,85 @@
+"""组织利润分析函数 profit.fn.cost_center_profit
+
+参数：start_date, end_date, department（可选）
+返回：各成本中心收入、成本、费用、营业利润、利润率
+
+发布：
+  dazi onto script publish 项目/潘达石化/本体/ontos/利润分析本体方案/functions/profit_fn_cost_center_profit.py \\
+    --space space__zlj --register-function-id profit.fn.cost_center_profit
+"""
+
+TEST_ARGUMENTS = {
+    "v": 1,
+    "arguments": {"start_date": "2025-01-01", "end_date": "2026-06-30", "department": ""},
+    "object_type_code": "ProfitAnalysis",
+}
+
+
+def _build_where(start_date, end_date, department):
+    clauses = ["account_type IN ('收入','成本','费用')"]
+    if start_date and end_date:
+        clauses.append(f"posting_date >= '{start_date}' AND posting_date <= '{end_date}'")
+    if department:
+        clauses.append(f"department = '{department}'")
+    return "WHERE " + " AND ".join(clauses)
+
+
+def _ontology_fn_body(p):
+    params = dict(p.get_params() or {})
+    where_clause = _build_where(
+        params.get("start_date", ""),
+        params.get("end_date", ""),
+        params.get("department", ""),
+    )
+
+    sql = f"""
+    SELECT
+        cost_center_id,
+        cost_center_name,
+        department,
+        profit_center,
+        sum(if(account_type = '收入', amount_signed, 0)) AS revenue,
+        sum(if(account_type = '成本', amount_signed, 0)) AS cost,
+        sum(if(account_type = '费用', amount_signed, 0)) AS expense
+    FROM actual_journal_entry
+    {where_clause}
+    GROUP BY cost_center_id, cost_center_name, department, profit_center
+    ORDER BY revenue - cost - expense DESC
+    """
+
+    rows = p.sql.query(sql)
+    data = []
+    for row in rows:
+        rev = float(row.get("revenue", 0) or 0)
+        cost = float(row.get("cost", 0) or 0)
+        exp = float(row.get("expense", 0) or 0)
+        profit = rev - cost - exp
+        margin = profit / rev if rev > 0 else 0.0
+        data.append({
+            "cost_center_id": row.get("cost_center_id", ""),
+            "cost_center_name": row.get("cost_center_name", ""),
+            "department": row.get("department", ""),
+            "profit_center": row.get("profit_center", ""),
+            "revenue": round(rev, 2),
+            "cost": round(cost, 2),
+            "expense": round(exp, 2),
+            "operating_profit": round(profit, 2),
+            "profit_margin": round(margin, 4),
+        })
+
+    return p.function_result(
+        columns=["cost_center_id", "cost_center_name", "department", "profit_center", "revenue", "cost", "expense", "operating_profit", "profit_margin"],
+        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.sql = s.sql
+    return _ontology_fn_body(p)

package/dist/examples/onto//345/210/251/346/266/246/347/244/272/344/276/213/function/profit_fn_get_summary.py

@@ -0,0 +1,76 @@
+"""利润总览函数 profit.fn.get_summary
+
+参数：start_date, end_date, cost_center_id（可选）
+返回：总收入、总成本、总费用、营业利润、利润率、分录行数
+
+发布：
+  dazi onto script publish 项目/潘达石化/本体/ontos/利润分析本体方案/functions/profit_fn_get_summary.py \\
+    --space space__zlj --register-function-id profit.fn.get_summary
+"""
+
+TEST_ARGUMENTS = {
+    "v": 1,
+    "arguments": {"start_date": "2025-01-01", "end_date": "2026-06-30", "cost_center_id": ""},
+    "object_type_code": "ProfitAnalysis",
+}
+
+
+def _build_where(start_date, end_date, cost_center_id):
+    clauses = ["account_type IN ('收入','成本','费用')"]
+    if start_date and end_date:
+        clauses.append(f"posting_date >= '{start_date}' AND posting_date <= '{end_date}'")
+    if cost_center_id:
+        clauses.append(f"cost_center_id = '{cost_center_id}'")
+    return "WHERE " + " AND ".join(clauses)
+
+
+def _ontology_fn_body(p):
+    params = dict(p.get_params() or {})
+    start_date = params.get("start_date", "")
+    end_date = params.get("end_date", "")
+    cost_center_id = params.get("cost_center_id", "")
+    where_clause = _build_where(start_date, end_date, cost_center_id)
+
+    sql = f"""
+    SELECT
+        sum(if(account_type = '收入', amount_signed, 0)) AS total_revenue,
+        sum(if(account_type = '成本', amount_signed, 0)) AS total_cost,
+        sum(if(account_type = '费用', amount_signed, 0)) AS total_expense,
+        count(line_id) AS line_count
+    FROM actual_journal_entry
+    {where_clause}
+    """
+
+    rows = p.sql.query(sql)
+    row = rows[0] if rows else {}
+    rev = float(row.get("total_revenue", 0) or 0)
+    cost = float(row.get("total_cost", 0) or 0)
+    exp = float(row.get("total_expense", 0) or 0)
+    profit = rev - cost - exp
+    margin = profit / rev if rev > 0 else 0.0
+
+    data = [{
+        "total_revenue": round(rev, 2),
+        "total_cost": round(cost, 2),
+        "total_expense": round(exp, 2),
+        "operating_profit": round(profit, 2),
+        "profit_margin": round(margin, 4),
+        "line_count": int(row.get("line_count", 0) or 0),
+    }]
+
+    return p.function_result(
+        columns=["total_revenue", "total_cost", "total_expense", "operating_profit", "profit_margin", "line_count"],
+        data=data,
+        row_count=1,
+    )
+
+
+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.sql = s.sql
+    return _ontology_fn_body(p)