@dazitech/cli 3.0.7 → 3.0.8

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

@@ -0,0 +1,213 @@
+"""利润分析演示数据灌入 — space__zlj
+
+前置：先执行 profit_ontology_init.py 建表。
+幂等：actual_journal_entry 已有数据则跳过。
+
+放置：项目/潘达石化/本体/ontos/利润分析本体方案/setup/profit_seed_data.py
+发布：dazi onto script publish 项目/潘达石化/本体/ontos/利润分析本体方案/setup/profit_seed_data.py --space space__zlj --type data
+"""
+
+import json
+import random
+from datetime import date, datetime, timedelta
+
+_SEED_DT = datetime(2025, 1, 1, 0, 0, 0)
+_BUDGET_VERSION = "2026年度预算"
+
+
+def _calc_signed(account_type, debit, credit):
+    if account_type == "收入":
+        return round(credit - debit, 2)
+    if account_type in ("成本", "费用"):
+        return round(debit - credit, 2)
+    return round(debit - credit, 2)
+
+
+def _make_entry_line(seq, posting_date, account, cc, amount):
+    account_type = account["account_type"]
+    debit = amount if account_type in ("成本", "费用") else 0.0
+    credit = amount if account_type == "收入" else 0.0
+    if account_type == "收入":
+        debit, credit = 0.0, amount
+    signed = _calc_signed(account_type, debit, credit)
+    fy = posting_date.year
+    fp = posting_date.month
+    entry_id = f"JE{posting_date.strftime('%Y%m%d')}{seq // 10:04d}"
+    line_id = f"JL{posting_date.strftime('%Y%m%d')}{seq:05d}"
+    return {
+        "entry_id": entry_id,
+        "line_id": line_id,
+        "posting_date": posting_date,
+        "fiscal_year": fy,
+        "fiscal_period": fp,
+        "account_id": account["account_id"],
+        "account_code": account["account_code"],
+        "account_name": account["account_name"],
+        "account_type": account["account_type"],
+        "pl_category": account["pl_category"],
+        "account_level": account["account_level"],
+        "cost_center_id": cc["cost_center_id"],
+        "cost_center_name": cc["cost_center_name"],
+        "department": cc["department"],
+        "profit_center": cc["profit_center"],
+        "debit_amount": round(debit, 2),
+        "credit_amount": round(credit, 2),
+        "amount_signed": signed,
+        "currency": "CNY",
+        "voucher_no": f"V{posting_date.strftime('%Y%m')}{seq:04d}",
+        "source_system": "GL",
+        "description": f"{account['account_name']}-{cc['cost_center_name']}",
+        "created_at": datetime.combine(posting_date, datetime.min.time()),
+    }
+
+
+def main():
+    space_id = "space__zlj"
+    s = space.get(space_id)
+
+    output.print("=== 利润分析演示数据灌入 ===")
+
+    try:
+        n = int(s.sql.query_one("SELECT count() FROM actual_journal_entry") or 0)
+    except Exception:
+        n = 0
+    if n > 0:
+        output.print(f"actual_journal_entry 已有 {n} 行，跳过灌数")
+        output.print("__JSON_SUMMARY__" + json.dumps({"ok": True, "skipped": True, "rows": n}, ensure_ascii=True))
+        return
+
+    accounts = [
+        {"account_id": "ACC6000", "account_code": "6000", "account_name": "营业收入", "account_type": "收入", "pl_category": "营业收入", "parent_account_id": "", "account_level": 1, "is_leaf": False, "normal_balance": "贷", "status": "启用"},
+        {"account_id": "ACC6001", "account_code": "6001", "account_name": "主营业务收入", "account_type": "收入", "pl_category": "营业收入", "parent_account_id": "ACC6000", "account_level": 2, "is_leaf": True, "normal_balance": "贷", "status": "启用"},
+        {"account_id": "ACC6050", "account_code": "6050", "account_name": "其他业务收入", "account_type": "收入", "pl_category": "营业收入", "parent_account_id": "ACC6000", "account_level": 2, "is_leaf": True, "normal_balance": "贷", "status": "启用"},
+        {"account_id": "ACC6400", "account_code": "6400", "account_name": "营业成本", "account_type": "成本", "pl_category": "营业成本", "parent_account_id": "", "account_level": 1, "is_leaf": False, "normal_balance": "借", "status": "启用"},
+        {"account_id": "ACC6401", "account_code": "6401", "account_name": "主营业务成本", "account_type": "成本", "pl_category": "营业成本", "parent_account_id": "ACC6400", "account_level": 2, "is_leaf": True, "normal_balance": "借", "status": "启用"},
+        {"account_id": "ACC6402", "account_code": "6402", "account_name": "原材料成本", "account_type": "成本", "pl_category": "营业成本", "parent_account_id": "ACC6400", "account_level": 2, "is_leaf": True, "normal_balance": "借", "status": "启用"},
+        {"account_id": "ACC6600", "account_code": "6600", "account_name": "期间费用", "account_type": "费用", "pl_category": "期间费用", "parent_account_id": "", "account_level": 1, "is_leaf": False, "normal_balance": "借", "status": "启用"},
+        {"account_id": "ACC6601", "account_code": "6601", "account_name": "销售费用", "account_type": "费用", "pl_category": "期间费用", "parent_account_id": "ACC6600", "account_level": 2, "is_leaf": True, "normal_balance": "借", "status": "启用"},
+        {"account_id": "ACC6602", "account_code": "6602", "account_name": "管理费用", "account_type": "费用", "pl_category": "期间费用", "parent_account_id": "ACC6600", "account_level": 2, "is_leaf": True, "normal_balance": "借", "status": "启用"},
+        {"account_id": "ACC6603", "account_code": "6603", "account_name": "财务费用", "account_type": "费用", "pl_category": "期间费用", "parent_account_id": "ACC6600", "account_level": 2, "is_leaf": True, "normal_balance": "借", "status": "启用"},
+    ]
+    for a in accounts:
+        a["created_at"] = _SEED_DT
+
+    cost_centers = [
+        {"cost_center_id": "CC01", "cost_center_code": "PC-PROD", "cost_center_name": "生产中心", "department": "生产部", "company_code": "PD", "profit_center": "制造利润中心", "status": "启用"},
+        {"cost_center_id": "CC02", "cost_center_code": "PC-SALE", "cost_center_name": "销售中心", "department": "销售部", "company_code": "PD", "profit_center": "销售利润中心", "status": "启用"},
+        {"cost_center_id": "CC03", "cost_center_code": "PC-MGMT", "cost_center_name": "管理中心", "department": "管理部", "company_code": "PD", "profit_center": "管理利润中心", "status": "启用"},
+        {"cost_center_id": "CC04", "cost_center_code": "PC-RD", "cost_center_name": "研发中心", "department": "研发部", "company_code": "PD", "profit_center": "研发利润中心", "status": "启用"},
+        {"cost_center_id": "CC05", "cost_center_code": "PC-FIN", "cost_center_name": "财务中心", "department": "财务部", "company_code": "PD", "profit_center": "财务利润中心", "status": "启用"},
+    ]
+    for c in cost_centers:
+        c["created_at"] = _SEED_DT
+
+    s.sql.insert_rows("account_master", accounts)
+    s.sql.insert_rows("cost_center_dimension", cost_centers)
+    output.print("OK 维表数据")
+
+    leaf_accounts = [a for a in accounts if a["is_leaf"]]
+    acct_dict = {a["account_id"]: a for a in accounts}
+    cc_dict = {c["cost_center_id"]: c for c in cost_centers}
+
+    random.seed(9520)
+    fact_rows = []
+    seq = 1
+    start = date(2025, 1, 1)
+    end = date(2026, 6, 30)
+
+    # 科目基准金额（月）
+    base_amounts = {
+        "ACC6001": 800000,
+        "ACC6050": 50000,
+        "ACC6401": 480000,
+        "ACC6402": 120000,
+        "ACC6601": 80000,
+        "ACC6602": 60000,
+        "ACC6603": 20000,
+    }
+
+    d = start
+    while d <= end:
+        if d.day <= 3:
+            for acc_id, base in base_amounts.items():
+                account = acct_dict[acc_id]
+                for cc in cost_centers:
+                    if account["account_type"] == "收入" and cc["cost_center_id"] not in ("CC01", "CC02"):
+                        continue
+                    if account["account_type"] == "成本" and cc["cost_center_id"] not in ("CC01", "CC04"):
+                        continue
+                    if account["account_type"] == "费用":
+                        if account["account_id"] == "ACC6601" and cc["cost_center_id"] != "CC02":
+                            continue
+                        if account["account_id"] == "ACC6602" and cc["cost_center_id"] not in ("CC03", "CC04"):
+                            continue
+                        if account["account_id"] == "ACC6603" and cc["cost_center_id"] != "CC05":
+                            continue
+                    jitter = random.uniform(0.85, 1.15)
+                    seasonal = 1.0 + 0.1 * ((d.month - 1) % 3)
+                    amount = round(base * jitter * seasonal / max(len(cost_centers), 1) / 3, 2)
+                    if amount <= 0:
+                        continue
+                    fact_rows.append(_make_entry_line(seq, d, account, cc, amount))
+                    seq += 1
+        d += timedelta(days=1)
+
+    inserted = s.sql.insert_rows("actual_journal_entry", fact_rows)
+    output.print(f"OK 实际分录表插入 {inserted} 行")
+
+    budget_rows = []
+    bseq = 1
+    for year in (2025, 2026):
+        version = _BUDGET_VERSION if year == 2026 else f"{year}年度预算"
+        for period in range(1, 13):
+            if year == 2026 and period > 6:
+                continue
+            for account in leaf_accounts:
+                base = base_amounts.get(account["account_id"], 50000)
+                for cc in cost_centers:
+                    if account["account_type"] == "收入" and cc["cost_center_id"] not in ("CC01", "CC02"):
+                        continue
+                    if account["account_type"] == "成本" and cc["cost_center_id"] not in ("CC01", "CC04"):
+                        continue
+                    if account["account_type"] == "费用":
+                        if account["account_id"] == "ACC6601" and cc["cost_center_id"] != "CC02":
+                            continue
+                        if account["account_id"] == "ACC6602" and cc["cost_center_id"] not in ("CC03", "CC04"):
+                            continue
+                        if account["account_id"] == "ACC6603" and cc["cost_center_id"] != "CC05":
+                            continue
+                    budget_amt = round(base / 6 * random.uniform(0.95, 1.05), 2)
+                    budget_rows.append({
+                        "budget_id": f"BUD{year}",
+                        "line_id": f"BL{year}{period:02d}{bseq:05d}",
+                        "budget_version": version,
+                        "fiscal_year": year,
+                        "fiscal_period": period,
+                        "account_id": account["account_id"],
+                        "account_code": account["account_code"],
+                        "account_name": account["account_name"],
+                        "account_type": account["account_type"],
+                        "pl_category": account["pl_category"],
+                        "cost_center_id": cc["cost_center_id"],
+                        "cost_center_name": cc["cost_center_name"],
+                        "department": cc["department"],
+                        "budget_amount": budget_amt,
+                        "currency": "CNY",
+                        "status": "已发布",
+                        "created_at": _SEED_DT,
+                    })
+                    bseq += 1
+
+    binserted = s.sql.insert_rows("budget_entry", budget_rows)
+    output.print(f"OK 预算表插入 {binserted} 行")
+
+    summary = {
+        "ok": True,
+        "space_id": space_id,
+        "accounts": len(accounts),
+        "cost_centers": len(cost_centers),
+        "fact_inserted": inserted,
+        "budget_inserted": binserted,
+    }
+    output.success("灌数完成")
+    output.print("__JSON_SUMMARY__" + json.dumps(summary, ensure_ascii=True, default=str))

package/dist/examples/onto//351/224/200/345/224/256/347/244/272/344/276/213/functions/README.md

@@ -0,0 +1,25 @@
+# functions
+
+本体函数脚本。发布须带 `--register-function-id`，与 `plans/` 规划文档中的 function_id 一致。
+
+## 测试参数（test_arguments）
+
+函数测试完成后，须将默认入参写入平台函数定义，侧栏 **Onto → 运行函数** 才会预填参数。
+
+1. 每个函数对应 `test_arguments/<function_id>.json`（与脚本内 `TEST_ARGUMENTS` 保持一致）
+2. 在 **dazi-work 根**批量入库（推荐）：
+
+```powershell
+.\项目\潘达石化\本体\ontos\产品销售本体方案\functions\save_test_arguments.ps1
+```
+
+或手动单条（**须用平台内部 id `ofn_xxx`**，可先 `dazi onto function list --space space__zlj` 查看）：
+
+```powershell
+dazi onto function save-test-arguments ofn_156a399fbe0e4636 --space space__zlj `
+  --arguments-json-file 项目/潘达石化/本体/ontos/产品销售本体方案/functions/test_arguments/sales.fn.get_summary.json
+```
+
+> CLI 的 `save-test-arguments` 当前 PATCH 路径使用内部 id，直接传 `sales.fn.get_summary` 会 404。
+
+**注意**：`arguments` 字段中的键名须与函数 `ctx.params` 读取一致；日期范围与 `sales_seed_data.py` 演示数据一致（2025-01-01 ~ 2026-06-30）。

package/dist/examples/onto//351/224/200/345/224/256/347/244/272/344/276/213/functions/sales_fn_channel_mix.py

@@ -0,0 +1,86 @@
+"""渠道销售占比 sales.fn.channel_mix
+
+参数：start_date, end_date
+返回：各渠道销售额、订单数及占比
+
+发布：
+  dazi onto script publish 项目/潘达石化/本体/ontos/产品销售本体方案/functions/sales_fn_channel_mix.py \\
+    --space space__zlj --register-function-id sales.fn.channel_mix
+
+保存测试参数（function run 验证通过后；侧栏「运行函数」预填）：
+  见 functions/README.md；推荐 save_test_arguments.ps1（CLI 须 ofn_xxx 内部 id，勿直接用 function_id）
+"""
+
+TEST_ARGUMENTS = {
+    "v": 1,
+    "arguments": {"start_date": "2025-01-01", "end_date": "2026-06-30"},
+    "object_type_code": "SalesChannel",
+}
+
+
+def _build_where(start_date, end_date):
+    clauses = ["f.order_status IN ('已完成', '已发货')"]
+    if start_date and end_date:
+        clauses.append(f"f.order_date >= '{start_date}' AND f.order_date <= '{end_date}'")
+    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", "")
+    where_clause = _build_where(start_date, end_date)
+
+    sql = f"""
+    SELECT
+        f.channel_id,
+        any(c.channel_name) AS channel_name,
+        sum(f.sales_amount) AS sales_amount,
+        uniq(f.order_id) AS order_count
+    FROM sales_order_fact AS f
+    LEFT JOIN channel_dimension AS c ON f.channel_id = c.channel_id
+    {where_clause}
+    GROUP BY f.channel_id
+    ORDER BY sales_amount DESC
+    """
+
+    result = p.sql.query(sql)
+    if not result:
+        return p.function_result(
+            columns=["channel_id", "channel_name", "sales_amount", "order_count", "share_pct"],
+            data=[],
+            row_count=0,
+        )
+
+    total = sum(float(r.get("sales_amount", 0) or 0) for r in result)
+    data = []
+    for row in result:
+        sales_amount = float(row.get("sales_amount", 0) or 0)
+        data.append({
+            "channel_id": str(row.get("channel_id", "")),
+            "channel_name": str(row.get("channel_name", "")),
+            "sales_amount": round(sales_amount, 2),
+            "order_count": int(row.get("order_count", 0) or 0),
+            "share_pct": round(sales_amount / total if total > 0 else 0.0, 4),
+        })
+
+    return p.function_result(
+        columns=["channel_id", "channel_name", "sales_amount", "order_count", "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//351/224/200/345/224/256/347/244/272/344/276/213/functions/sales_fn_customer_segmentation.py

@@ -0,0 +1,123 @@
+"""客户销售分层 sales.fn.customer_segmentation
+
+参数：metric(sales_amount|quantity), method(quartile|percentile), start_date, end_date
+返回：客户销售额及分层（VIP/High/Medium/Low）
+
+发布：
+  dazi onto script publish 项目/潘达石化/本体/ontos/产品销售本体方案/functions/sales_fn_customer_segmentation.py \\
+    --space space__zlj --register-function-id sales.fn.customer_segmentation
+
+保存测试参数（function run 验证通过后；侧栏「运行函数」预填）：
+  见 functions/README.md；推荐 save_test_arguments.ps1（CLI 须 ofn_xxx 内部 id，勿直接用 function_id）
+"""
+
+TEST_ARGUMENTS = {
+    "v": 1,
+    "arguments": {
+        "metric": "sales_amount",
+        "method": "quartile",
+        "start_date": "2025-01-01",
+        "end_date": "2026-06-30",
+    },
+    "object_type_code": "Customer",
+}
+
+
+def _build_where(start_date, end_date):
+    clauses = ["order_status IN ('已完成', '已发货')"]
+    if start_date and end_date:
+        clauses.append(f"order_date >= '{start_date}' AND order_date <= '{end_date}'")
+    return "WHERE " + " AND ".join(clauses)
+
+
+def _ontology_fn_body(p):
+    params = dict(p.get_params() or {})
+    metric = params.get("metric", "sales_amount")
+    method = params.get("method", "quartile")
+    start_date = params.get("start_date", "")
+    end_date = params.get("end_date", "")
+    where_clause = _build_where(start_date, end_date)
+    order_col = "quantity" if metric == "quantity" else "sales_amount"
+
+    sql = f"""
+    SELECT
+        customer_id,
+        customer_region,
+        sum(sales_amount) AS sales_amount,
+        sum(quantity) AS quantity
+    FROM sales_order_fact
+    {where_clause}
+    GROUP BY customer_id, customer_region
+    ORDER BY {order_col} DESC
+    """
+
+    result = p.sql.query(sql)
+    if not result:
+        return p.function_result(
+            columns=["customer_id", "customer_region", "sales_amount", "quantity", "segment"],
+            data=[],
+            row_count=0,
+        )
+
+    values = [float(row.get(order_col, 0) or 0) for row in result]
+    total = len(values)
+    if total == 0:
+        return p.function_result(
+            columns=["customer_id", "customer_region", "sales_amount", "quantity", "segment"],
+            data=[],
+            row_count=0,
+        )
+
+    sorted_vals = sorted(values, reverse=True)
+    if method == "percentile":
+        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)
+    else:
+        p80_idx = min(int(total * 0.25), total - 1)
+        p50_idx = min(int(total * 0.5), total - 1)
+        p20_idx = min(int(total * 0.75), total - 1)
+    p80 = sorted_vals[p80_idx]
+    p50 = sorted_vals[p50_idx]
+    p20 = sorted_vals[p20_idx]
+
+    def get_segment(val):
+        if val >= p80:
+            return "VIP"
+        if val >= p50:
+            return "High"
+        if val >= p20:
+            return "Medium"
+        return "Low"
+
+    data = []
+    for row in result:
+        val = float(row.get(order_col, 0) or 0)
+        data.append({
+            "customer_id": str(row.get("customer_id", "")),
+            "customer_region": str(row.get("customer_region", "")),
+            "sales_amount": round(float(row.get("sales_amount", 0) or 0), 2),
+            "quantity": int(row.get("quantity", 0) or 0),
+            "segment": get_segment(val),
+        })
+
+    return p.function_result(
+        columns=["customer_id", "customer_region", "sales_amount", "quantity", "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.sql = s.sql
+    return _ontology_fn_body(p)

package/dist/examples/onto//351/224/200/345/224/256/347/244/272/344/276/213/functions/sales_fn_get_summary.py

@@ -0,0 +1,81 @@
+"""销售总览函数 sales.fn.get_summary
+
+参数：start_date, end_date（可选）
+返回：总销售额、总销量、订单数、客单价、动销 SKU 数
+
+发布：
+  dazi onto script publish 项目/潘达石化/本体/ontos/产品销售本体方案/functions/sales_fn_get_summary.py \\
+    --space space__zlj --register-function-id sales.fn.get_summary
+
+保存测试参数（function run 验证通过后；侧栏「运行函数」预填）：
+  见 functions/README.md；推荐 save_test_arguments.ps1（CLI 须 ofn_xxx 内部 id，勿直接用 function_id）
+"""
+
+TEST_ARGUMENTS = {
+    "v": 1,
+    "arguments": {"start_date": "2025-01-01", "end_date": "2026-06-30"},
+    "object_type_code": "SalesAnalysis",
+}
+
+
+def _valid_order_clause():
+    return "order_status IN ('已完成', '已发货')"
+
+
+def _build_where(start_date, end_date):
+    clauses = [_valid_order_clause()]
+    if start_date and end_date:
+        clauses.append(f"order_date >= '{start_date}' AND order_date <= '{end_date}'")
+    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", "")
+    where_clause = _build_where(start_date, end_date)
+
+    sql = f"""
+    SELECT
+        sum(sales_amount) AS total_sales,
+        sum(quantity) AS total_quantity,
+        uniq(order_id) AS order_count,
+        uniq(product_id) AS product_count
+    FROM sales_order_fact
+    {where_clause}
+    """
+
+    rows = p.sql.query(sql)
+    row = rows[0] if rows else {}
+    total_sales = float(row.get("total_sales", 0) or 0)
+    order_count = int(row.get("order_count", 0) or 0)
+    avg_order_value = total_sales / order_count if order_count > 0 else 0.0
+
+    data = [{
+        "total_sales": round(total_sales, 2),
+        "total_quantity": int(row.get("total_quantity", 0) or 0),
+        "order_count": order_count,
+        "avg_order_value": round(avg_order_value, 2),
+        "product_count": int(row.get("product_count", 0) or 0),
+    }]
+
+    return p.function_result(
+        columns=["total_sales", "total_quantity", "order_count", "avg_order_value", "product_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)

package/dist/examples/onto//351/224/200/345/224/256/347/244/272/344/276/213/functions/sales_fn_mom_analysis.py

@@ -0,0 +1,90 @@
+"""月度环比分析 sales.fn.mom_analysis
+
+参数：start_date, end_date
+返回：月度销售额、销量、订单数及环比增长率
+
+发布：
+  dazi onto script publish 项目/潘达石化/本体/ontos/产品销售本体方案/functions/sales_fn_mom_analysis.py \\
+    --space space__zlj --register-function-id sales.fn.mom_analysis
+
+保存测试参数（function run 验证通过后；侧栏「运行函数」预填）：
+  见 functions/README.md；推荐 save_test_arguments.ps1（CLI 须 ofn_xxx 内部 id，勿直接用 function_id）
+"""
+
+TEST_ARGUMENTS = {
+    "v": 1,
+    "arguments": {"start_date": "2025-01-01", "end_date": "2026-06-30"},
+    "object_type_code": "SalesAnalysis",
+}
+
+
+def _build_where(start_date, end_date):
+    clauses = ["order_status IN ('已完成', '已发货')"]
+    if start_date and end_date:
+        clauses.append(f"order_date >= '{start_date}' AND order_date <= '{end_date}'")
+    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", "")
+    where_clause = _build_where(start_date, end_date)
+
+    sql = f"""
+    SELECT
+        formatDateTime(order_date, '%Y-%m') AS year_month,
+        sum(sales_amount) AS sales_amount,
+        sum(quantity) AS quantity,
+        uniq(order_id) AS order_count
+    FROM sales_order_fact
+    {where_clause}
+    GROUP BY formatDateTime(order_date, '%Y-%m')
+    ORDER BY year_month
+    """
+
+    result = p.sql.query(sql)
+    if not result:
+        return p.function_result(
+            columns=["year_month", "sales_amount", "quantity", "order_count", "mom_growth"],
+            data=[],
+            row_count=0,
+        )
+
+    data = []
+    prev_sales = None
+    for row in result:
+        sales_amount = float(row.get("sales_amount", 0) or 0)
+        if prev_sales is not None and prev_sales != 0:
+            mom_growth = (sales_amount - prev_sales) / prev_sales
+        else:
+            mom_growth = 0.0
+        data.append({
+            "year_month": str(row.get("year_month", "")),
+            "sales_amount": round(sales_amount, 2),
+            "quantity": int(row.get("quantity", 0) or 0),
+            "order_count": int(row.get("order_count", 0) or 0),
+            "mom_growth": round(mom_growth, 4),
+        })
+        prev_sales = sales_amount
+
+    return p.function_result(
+        columns=["year_month", "sales_amount", "quantity", "order_count", "mom_growth"],
+        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)