@dazitech/cli 3.0.7 → 3.0.9

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,84 @@
+"""区域销售分布 sales.fn.region_breakdown
+
+参数：start_date, end_date
+返回：各区域销售额、销量、订单数及占比
+
+发布：
+  dazi onto script publish 项目/DAZI_TEST/本体/ontos/销售本体示例/functions/sales_fn_region_breakdown.py \
+    --space space__misc_01 --register-function-id sales.fn.region_breakdown
+"""
+
+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 fact_sales_order_line
+    {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)
+        share_pct = sales_amount / total if total > 0 else 0.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(share_pct, 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,98 @@
+"""产品销量/销售额排行 sales.fn.top_products
+
+参数：limit, metric(sales_amount|quantity), start_date, end_date
+返回：产品排行及销售占比
+
+发布：
+  dazi onto script publish 项目/DAZI_TEST/本体/ontos/销售本体示例/functions/sales_fn_top_products.py \
+    --space space__misc_01 --register-function-id sales.fn.top_products
+"""
+
+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(dp.product_name) AS product_name,
+        f.product_category,
+        sum(f.sales_amount) AS sales_amount,
+        sum(f.quantity) AS quantity
+    FROM fact_sales_order_line AS f
+    LEFT JOIN dim_product AS dp ON f.product_id = dp.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,87 @@
+"""年度同比分析 sales.fn.yoy_analysis
+
+参数：start_date, end_date
+返回：年度销售额、销量、订单数及同比增长率
+
+发布：
+  dazi onto script publish 项目/DAZI_TEST/本体/ontos/销售本体示例/functions/sales_fn_yoy_analysis.py \
+    --space space__misc_01 --register-function-id sales.fn.yoy_analysis
+"""
+
+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 fact_sales_order_line
+    {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,38 @@
+# save_test_arguments.ps1
+# 批量保存各函数的 test_arguments
+# 用法：在 dazi-work 根目录执行 .\项目\DAZI_TEST\本体\ontos\销售本体示例\functions\save_test_arguments.ps1
+
+$spaceId = "space__misc_01"
+$itemPath = "项目/DAZI_TEST/本体/ontos/销售本体示例/functions"
+
+$functions = @(
+    @{fn_id="sales.fn.get_summary"; file="sales.fn.get_summary.json"},
+    @{fn_id="sales.fn.yoy_analysis"; file="sales.fn.yoy_analysis.json"},
+    @{fn_id="sales.fn.mom_analysis"; file="sales.fn.mom_analysis.json"},
+    @{fn_id="sales.fn.top_products"; file="sales.fn.top_products.json"},
+    @{fn_id="sales.fn.customer_segmentation"; file="sales.fn.customer_segmentation.json"},
+    @{fn_id="sales.fn.region_breakdown"; file="sales.fn.region_breakdown.json"},
+    @{fn_id="sales.fn.channel_mix"; file="sales.fn.channel_mix.json"}
+)
+
+# 先获取 function list 获取 ofn_xxx 内部 id
+Write-Host "获取函数列表..."
+$fnList = & dazi onto function list --space $spaceId --output json 2>$null | ConvertFrom-Json
+
+foreach ($fn in $functions) {
+    $fnId = $fn.fn_id
+    $fileName = $fn.file
+    $jsonPath = "$PSScriptRoot/test_arguments/$fileName"
+
+    # 查找 ofn_xxx 内部 id
+    $fnInfo = $fnList | Where-Object { $_.function_id -eq $fnId }
+    if ($fnInfo) {
+        $ofnId = $fnInfo.id
+        Write-Host "保存 $fnId (ofnId=$ofnId)..."
+        & dazi onto function save-test-arguments $ofnId --space $spaceId --arguments-json-file $jsonPath
+    } else {
+        Write-Host "函数 $fnId 未找到，请先发布函数"
+    }
+}
+
+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,5 @@
+{
+  "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.customer_segmentation.json

@@ -0,0 +1,5 @@
+{
+  "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,5 @@
+{
+  "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,5 @@
+{
+  "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,5 @@
+{
+  "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,5 @@
+{
+  "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,5 @@
+{
+  "v": 1,
+  "arguments": {"start_date": "2025-01-01", "end_date": "2026-06-30"},
+  "object_type_code": "SalesAnalysis"
+}