@dazitech/cli 3.0.6 → 3.0.8

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

@@ -0,0 +1,85 @@
+"""区域销售分布 sales.fn.region_breakdown
+
+参数：start_date, end_date
+返回：各区域销售额、销量、订单数及占比
+
+发布：
+  dazi onto script publish 项目/潘达石化/本体/ontos/产品销售本体方案/functions/sales_fn_region_breakdown.py \\
+    --space space__zlj --register-function-id sales.fn.region_breakdown
+
+保存测试参数（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
+        customer_region,
+        sum(sales_amount) AS sales_amount,
+        sum(quantity) AS quantity,
+        uniq(order_id) AS order_count
+    FROM sales_order_fact
+    {where_clause}
+    GROUP BY customer_region
+    ORDER BY sales_amount DESC
+    """
+
+    result = p.sql.query(sql)
+    if not result:
+        return p.function_result(
+            columns=["customer_region", "sales_amount", "quantity", "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({
+            "customer_region": str(row.get("customer_region", "")),
+            "sales_amount": round(sales_amount, 2),
+            "quantity": int(row.get("quantity", 0) or 0),
+            "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=["customer_region", "sales_amount", "quantity", "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_top_products.py

@@ -0,0 +1,101 @@
+"""产品销量/销售额排行 sales.fn.top_products
+
+参数：limit, metric(sales_amount|quantity), start_date, end_date
+返回：产品排行及销售占比
+
+发布：
+  dazi onto script publish 项目/潘达石化/本体/ontos/产品销售本体方案/functions/sales_fn_top_products.py \\
+    --space space__zlj --register-function-id sales.fn.top_products
+
+保存测试参数（function run 验证通过后；侧栏「运行函数」预填）：
+  见 functions/README.md；推荐 save_test_arguments.ps1（CLI 须 ofn_xxx 内部 id，勿直接用 function_id）
+"""
+
+TEST_ARGUMENTS = {
+    "v": 1,
+    "arguments": {
+        "limit": 5,
+        "metric": "sales_amount",
+        "start_date": "2025-01-01",
+        "end_date": "2026-06-30",
+    },
+    "object_type_code": "Product",
+}
+
+
+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 {})
+    limit = int(params.get("limit", 10) or 10)
+    metric = params.get("metric", "sales_amount")
+    start_date = params.get("start_date", "")
+    end_date = params.get("end_date", "")
+    where_clause = _build_where(start_date, end_date)
+    order_by = "quantity DESC" if metric == "quantity" else "sales_amount DESC"
+
+    sql = f"""
+    SELECT
+        f.product_id,
+        any(pm.product_name) AS product_name,
+        f.product_category,
+        sum(f.sales_amount) AS sales_amount,
+        sum(f.quantity) AS quantity
+    FROM sales_order_fact AS f
+    LEFT JOIN product_master AS pm ON f.product_id = pm.product_id
+    {where_clause}
+    GROUP BY f.product_id, f.product_category
+    ORDER BY {order_by}
+    LIMIT {limit}
+    """
+
+    result = p.sql.query(sql)
+    if not result:
+        return p.function_result(
+            columns=["rank", "product_id", "product_name", "product_category", "sales_amount", "quantity", "share_pct"],
+            data=[],
+            row_count=0,
+        )
+
+    total_key = "quantity" if metric == "quantity" else "sales_amount"
+    total = sum(float(r.get(total_key, 0) or 0) for r in result)
+
+    data = []
+    for rank, row in enumerate(result, start=1):
+        val = float(row.get(total_key, 0) or 0)
+        share_pct = val / total if total > 0 else 0.0
+        data.append({
+            "rank": rank,
+            "product_id": str(row.get("product_id", "")),
+            "product_name": str(row.get("product_name", "")),
+            "product_category": str(row.get("product_category", "")),
+            "sales_amount": round(float(row.get("sales_amount", 0) or 0), 2),
+            "quantity": int(row.get("quantity", 0) or 0),
+            "share_pct": round(share_pct, 4),
+        })
+
+    return p.function_result(
+        columns=["rank", "product_id", "product_name", "product_category", "sales_amount", "quantity", "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_yoy_analysis.py

@@ -0,0 +1,90 @@
+"""年度同比分析 sales.fn.yoy_analysis
+
+参数：start_date, end_date
+返回：年度销售额、销量、订单数及同比增长率
+
+发布：
+  dazi onto script publish 项目/潘达石化/本体/ontos/产品销售本体方案/functions/sales_fn_yoy_analysis.py \\
+    --space space__zlj --register-function-id sales.fn.yoy_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
+        toYear(order_date) AS year,
+        sum(sales_amount) AS sales_amount,
+        sum(quantity) AS quantity,
+        uniq(order_id) AS order_count
+    FROM sales_order_fact
+    {where_clause}
+    GROUP BY toYear(order_date)
+    ORDER BY year
+    """
+
+    result = p.sql.query(sql)
+    if not result:
+        return p.function_result(
+            columns=["year", "sales_amount", "quantity", "order_count", "yoy_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:
+            yoy_growth = (sales_amount - prev_sales) / prev_sales
+        else:
+            yoy_growth = 0.0
+        data.append({
+            "year": int(row.get("year", 0)),
+            "sales_amount": round(sales_amount, 2),
+            "quantity": int(row.get("quantity", 0) or 0),
+            "order_count": int(row.get("order_count", 0) or 0),
+            "yoy_growth": round(yoy_growth, 4),
+        })
+        prev_sales = sales_amount
+
+    return p.function_result(
+        columns=["year", "sales_amount", "quantity", "order_count", "yoy_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)

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

@@ -0,0 +1,25 @@
+# 批量保存函数 test_arguments 到平台（space__zlj）
+# 用法：在 dazi-work 根目录执行 .\项目\潘达石化\本体\ontos\产品销售本体方案\functions\save_test_arguments.ps1
+
+$ErrorActionPreference = "Stop"
+$space = "space__zlj"
+$base = "项目/潘达石化/本体/ontos/产品销售本体方案/functions/test_arguments"
+
+$raw = dazi onto function list --space $space 2>&1 | Out-String
+$jsonPart = ($raw -split '__JSON_SUMMARY__')[-1].Trim()
+$data = $jsonPart | ConvertFrom-Json
+
+foreach ($fn in $data.data.functions) {
+    $fid = $fn.function_id
+    $ofn = $fn.id
+    $file = Join-Path $base "$fid.json"
+    if (-not (Test-Path $file)) {
+        Write-Host "SKIP 无 JSON: $fid"
+        continue
+    }
+    Write-Host "save $fid ..."
+    # 注意：CLI 须用平台内部 id（ofn_xxx），不能用 function_id 字符串
+    dazi onto function save-test-arguments $ofn --space $space --arguments-json-file $file
+}
+
+Write-Host "完成。"

package/dist/examples/onto//351/224/200/345/224/256/347/244/272/344/276/213/functions/test_arguments/sales.fn.channel_mix.json

@@ -0,0 +1,8 @@
+{
+  "v": 1,
+  "arguments": {
+    "start_date": "2025-01-01",
+    "end_date": "2026-06-30"
+  },
+  "object_type_code": "SalesChannel"
+}

package/dist/examples/onto//351/224/200/345/224/256/347/244/272/344/276/213/functions/test_arguments/sales.fn.customer_segmentation.json

@@ -0,0 +1,10 @@
+{
+  "v": 1,
+  "arguments": {
+    "metric": "sales_amount",
+    "method": "quartile",
+    "start_date": "2025-01-01",
+    "end_date": "2026-06-30"
+  },
+  "object_type_code": "Customer"
+}

package/dist/examples/onto//351/224/200/345/224/256/347/244/272/344/276/213/functions/test_arguments/sales.fn.get_summary.json

@@ -0,0 +1,8 @@
+{
+  "v": 1,
+  "arguments": {
+    "start_date": "2025-01-01",
+    "end_date": "2026-06-30"
+  },
+  "object_type_code": "SalesAnalysis"
+}

package/dist/examples/onto//351/224/200/345/224/256/347/244/272/344/276/213/functions/test_arguments/sales.fn.mom_analysis.json

@@ -0,0 +1,8 @@
+{
+  "v": 1,
+  "arguments": {
+    "start_date": "2025-01-01",
+    "end_date": "2026-06-30"
+  },
+  "object_type_code": "SalesAnalysis"
+}

package/dist/examples/onto//351/224/200/345/224/256/347/244/272/344/276/213/functions/test_arguments/sales.fn.region_breakdown.json

@@ -0,0 +1,8 @@
+{
+  "v": 1,
+  "arguments": {
+    "start_date": "2025-01-01",
+    "end_date": "2026-06-30"
+  },
+  "object_type_code": "SalesAnalysis"
+}

package/dist/examples/onto//351/224/200/345/224/256/347/244/272/344/276/213/functions/test_arguments/sales.fn.top_products.json

@@ -0,0 +1,10 @@
+{
+  "v": 1,
+  "arguments": {
+    "limit": 5,
+    "metric": "sales_amount",
+    "start_date": "2025-01-01",
+    "end_date": "2026-06-30"
+  },
+  "object_type_code": "Product"
+}

package/dist/examples/onto//351/224/200/345/224/256/347/244/272/344/276/213/functions/test_arguments/sales.fn.yoy_analysis.json

@@ -0,0 +1,8 @@
+{
+  "v": 1,
+  "arguments": {
+    "start_date": "2025-01-01",
+    "end_date": "2026-06-30"
+  },
+  "object_type_code": "SalesAnalysis"
+}

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

@@ -0,0 +1,5 @@
+# setup
+
+初始化（`ontology_init`）与灌数（`seed`）脚本。
+
+发布示例：`dazi onto script publish 项目/<业务>/本体/ontos/<实现名>/setup/<file>.py --space <space_id> --type setup|data`