@guandata/guanvis 0.1.16

package/skills/guanvis/evals/rank_advcalc_roundtrip/verify_default_roundtrip.sh

@@ -0,0 +1,135 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+ROOT_DIR="$(cd "$(dirname "$0")/../.." && pwd)"
+EVAL_DIR="$ROOT_DIR/evals/rank_advcalc_roundtrip"
+OUT_DIR="$EVAL_DIR/.roundtrip"
+
+mkdir -p "$OUT_DIR"
+
+cd "$ROOT_DIR"
+
+export GUANCLI_PROFILE=default
+
+go run ./cmd/guanvis preview "$EVAL_DIR" > "$OUT_DIR/preview_payload.json"
+go run ./cmd/guanvis publish "$EVAL_DIR" > "$OUT_DIR/publish.log"
+
+guancli card get r3f01a02b03c04d05e06f07a --profile default --raw > "$OUT_DIR/raw_range.json"
+guancli card get r4f01a02b03c04d05e06f08a --profile default --raw > "$OUT_DIR/raw_topn.json"
+guancli card preview r3f01a02b03c04d05e06f07a --profile default --limit 50 -f json > "$OUT_DIR/preview_range.json"
+guancli card preview r4f01a02b03c04d05e06f08a --profile default --limit 50 -f json > "$OUT_DIR/preview_topn.json"
+
+python3 - "$OUT_DIR" <<'PY'
+import json
+import sys
+from pathlib import Path
+
+out = Path(sys.argv[1])
+
+cases = [
+    {
+        "kind": "range",
+        "raw": out / "raw_range.json",
+        "preview": out / "preview_range.json",
+        "expected": {
+            "按列RANK降序": {
+                "calDimension": "COLUMN",
+                "rankType": "RANK",
+                "sorting": "desc",
+                "tfdId": "",
+                "topN": {"topType": "ALL", "count": 10, "calculationType": "COUNT"},
+            },
+            "按行DENSE升序": {
+                "calDimension": "ROW",
+                "rankType": "DENSE_RANK",
+                "sorting": "asc",
+                "tfdId": "",
+                "topN": {"topType": "ALL", "count": 10, "calculationType": "COUNT"},
+            },
+            "地区组内ROW_NUMBER降序": {
+                "calDimension": "FIELD",
+                "rankType": "ROW_NUMBER",
+                "sorting": "desc",
+                "tfdId": "xe01f39825ccc428eaf67911",
+                "topN": {"topType": "ALL", "count": 10, "calculationType": "COUNT"},
+            },
+            "类别维度项RANK升序": {
+                "calDimension": "DIMENSION_ITEM",
+                "rankType": "RANK",
+                "sorting": "asc",
+                "tfdId": "cece9879e99f545449909a82",
+                "topN": {"topType": "ALL", "count": 10, "calculationType": "COUNT"},
+            },
+        },
+    },
+    {
+        "kind": "topn",
+        "raw": out / "raw_topn.json",
+        "preview": out / "preview_topn.json",
+        "expected": {
+            "Top3适用小计": {
+                "calDimension": "COLUMN",
+                "rankType": "RANK",
+                "sorting": "desc",
+                "tfdId": "",
+                "topN": {"topType": "CUSTOM_NUMBER", "count": 3, "calculationType": "COUNT", "applyToSubtotal": True},
+            },
+            "Top5不适用小计": {
+                "calDimension": "DIMENSION_ITEM",
+                "rankType": "DENSE_RANK",
+                "sorting": "desc",
+                "tfdId": "xe01f39825ccc428eaf67911",
+                "topN": {"topType": "CUSTOM_NUMBER", "count": 5, "calculationType": "COUNT", "applyToSubtotal": False},
+            },
+        },
+    },
+]
+
+summary = {"cards": []}
+
+for case in cases:
+    raw_obj = json.loads(case["raw"].read_text())
+    response = raw_obj.get("response") or raw_obj.get("data") or raw_obj
+    zone_data = response["content"]["meta"]["chartMain"]["zoneData"]
+    metrics = zone_data.get("metric", [])
+    by_alias = {m.get("alias"): m for m in metrics if m.get("alias")}
+    rows = json.loads(case["preview"].read_text())
+
+    card_summary = {
+        "kind": case["kind"],
+        "cardId": response.get("cdId") or response.get("id"),
+        "name": response.get("name"),
+        "previewRows": len(rows),
+        "aliases": {},
+    }
+
+    for alias, expected in case["expected"].items():
+        metric = by_alias.get(alias)
+        if metric is None:
+            raise SystemExit(f"{case['kind']}: missing metric alias {alias}")
+        if "formula" in metric:
+            raise SystemExit(f"{case['kind']}: {alias} degraded to formula")
+        adv_calc = metric.get("advCalc")
+        if not adv_calc:
+            raise SystemExit(f"{case['kind']}: {alias} missing advCalc")
+        if adv_calc.get("advType") != "RANK":
+            raise SystemExit(f"{case['kind']}: {alias} advType is not RANK")
+        adv_value = adv_calc.get("advValue") or {}
+        if adv_value.get("advType") != "RANK":
+            raise SystemExit(f"{case['kind']}: {alias} advValue.advType is not RANK")
+        for key in ("calDimension", "rankType", "sorting", "tfdId"):
+            if adv_value.get(key, "") != expected[key]:
+                raise SystemExit(f"{case['kind']}: {alias} {key}={adv_value.get(key)!r}, want {expected[key]!r}")
+        top_n = adv_value.get("topN") or {}
+        for key, want in expected["topN"].items():
+            if top_n.get(key) != want:
+                raise SystemExit(f"{case['kind']}: {alias} topN.{key}={top_n.get(key)!r}, want {want!r}")
+        if not any(isinstance(row, dict) and row.get(alias) not in ("", None) for row in rows):
+            raise SystemExit(f"{case['kind']}: {alias} has no non-empty preview value")
+        card_summary["aliases"][alias] = adv_value
+
+    summary["cards"].append(card_summary)
+
+(out / "summary.json").write_text(json.dumps(summary, ensure_ascii=False, indent=2), encoding="utf-8")
+print(json.dumps(summary, ensure_ascii=False, indent=2))
+PY

package/skills/guanvis/evals/running_total_advcalc_roundtrip/README.md

@@ -0,0 +1,15 @@
+This eval verifies the L3 native BI `RUNNING_TOTAL` advanced calculation builder against a real `default` BI environment.
+
+It publishes fixed card/page IDs, reads the created cards back, and verifies:
+
+- `COLUMN` accumulation.
+- `ROW` accumulation.
+- `FIELD` accumulation by a non-date dimension.
+- date field accumulation with `DAY`, `WEEK`, `MONTH`, `YEAR`, and `NONE`.
+- sub-date field accumulation with `QUARTER` and `NONE`.
+- `advCalc` is preserved in `zoneData.metric[*].advCalc`.
+- preview returns non-empty accumulated metric values.
+
+The default-environment roundtrip runner is intentionally not committed with this eval.
+Its command sequence and assertions are recorded in the knowledge base:
+`01-Projects/L3-running-total-advcalc-golden-answer.md`.

package/skills/guanvis/evals/running_total_advcalc_roundtrip/card_01_running_total_advcalc.js

@@ -0,0 +1,74 @@
+var orderDate = f("订单日期");
+var orderMonth = f("订单日期", { granularity: Granularity.MONTH });
+var region = f("地区");
+var province = f("省/自治区");
+var category = f("类别");
+
+var rangeCard = createCard(ChartType.PIVOT_TABLE, "L3 累计高级计算 范围")
+    .setId("t3f01a02b03c04d05e06f07a")
+    .bindDataset(DS)
+    .addRow(orderDate)
+    .addRow(region)
+    .addRow(province)
+    .addColumn(category)
+    .addMetric(f("销售额", {
+        alias: "按列累计",
+        aggrType: AggrType.SUM,
+        advCalc: runningTotal.byColumn()
+    }))
+    .addMetric(f("销售额", {
+        alias: "按行累计",
+        aggrType: AggrType.SUM,
+        advCalc: runningTotal.byRow()
+    }))
+    .addMetric(f("销售额", {
+        alias: "地区组内累计",
+        aggrType: AggrType.SUM,
+        advCalc: runningTotal.byField(region)
+    }))
+    .addMetric(f("销售额", {
+        alias: "订单日期日累计",
+        aggrType: AggrType.SUM,
+        advCalc: runningTotal.byDateField(orderDate, RunningTotalGranularity.DAY)
+    }))
+    .addMetric(f("销售额", {
+        alias: "订单日期周累计",
+        aggrType: AggrType.SUM,
+        advCalc: runningTotal.byDateField(orderDate, RunningTotalGranularity.WEEK)
+    }))
+    .addMetric(f("销售额", {
+        alias: "订单日期月累计",
+        aggrType: AggrType.SUM,
+        advCalc: runningTotal.byDateField(orderDate, RunningTotalGranularity.MONTH)
+    }))
+    .addMetric(f("销售额", {
+        alias: "订单日期当年累计",
+        aggrType: AggrType.SUM,
+        advCalc: runningTotal.byDateField(orderDate, RunningTotalGranularity.YEAR)
+    }))
+    .addMetric(f("销售额", {
+        alias: "订单日期历年累计",
+        aggrType: AggrType.SUM,
+        advCalc: runningTotal.byDateField(orderDate, RunningTotalGranularity.ALL_YEARS)
+    }));
+
+registerCard(rangeCard.build());
+
+var subDateCard = createCard(ChartType.PIVOT_TABLE, "L3 累计高级计算 子日期")
+    .setId("t4f01a02b03c04d05e06f08a")
+    .bindDataset(DS)
+    .addRow(orderMonth)
+    .addRow(region)
+    .addColumn(category)
+    .addMetric(f("利润", {
+        alias: "订单月季度累计",
+        aggrType: AggrType.SUM,
+        advCalc: runningTotal.byDateField(orderMonth, RunningTotalGranularity.QUARTER)
+    }))
+    .addMetric(f("利润", {
+        alias: "订单月历年累计",
+        aggrType: AggrType.SUM,
+        advCalc: runningTotal.byDateField(orderMonth, RunningTotalGranularity.ALL_YEARS)
+    }));
+
+registerCard(subDateCard.build());

package/skills/guanvis/evals/running_total_advcalc_roundtrip/page.js

@@ -0,0 +1,6 @@
+var page = createPage("L3 累计高级计算 RoundTrip")
+    .setId("t5f01a02b03c04d05e06f09a")
+    .addFullWidthCard("t3f01a02b03c04d05e06f07a", 8)
+    .addFullWidthCard("t4f01a02b03c04d05e06f08a", 8);
+
+registerPage(page.build());

package/skills/guanvis/evals/running_total_advcalc_roundtrip/schema.js

@@ -0,0 +1,22 @@
+// Dataset: 订单表 (default)
+defineDataset("a184fe1b1c27941a9ac977bc", [
+    { fdId: "o0f29e706bf1041d9ab0da11", name: "订单 ID", fdType: "STRING", metaType: "DIM" },
+    { fdId: "r739b62cd3dab49ff9bb7134", name: "订单日期", fdType: "DATE", metaType: "DIM" },
+    { fdId: "o82eaae89ecd046a4b531ce4", name: "发货日期", fdType: "DATE", metaType: "DIM" },
+    { fdId: "k673939fff12744b786d8d44", name: "邮寄方式", fdType: "STRING", metaType: "DIM" },
+    { fdId: "me4783b3bf8984906a32e5ce", name: "客户 ID", fdType: "STRING", metaType: "DIM" },
+    { fdId: "v2a8590c1236e4e58882ee9c", name: "客户名称", fdType: "STRING", metaType: "DIM" },
+    { fdId: "j81f7f09ab6c84168924f9aa", name: "细分", fdType: "STRING", metaType: "DIM" },
+    { fdId: "s99bcae4ac5a045ebae87762", name: "城市", fdType: "STRING", metaType: "DIM" },
+    { fdId: "ufe7632b5afa44dd7a79194e", name: "省/自治区", fdType: "STRING", metaType: "DIM" },
+    { fdId: "e2a051c6ebda04917a10cc14", name: "国家", fdType: "STRING", metaType: "DIM" },
+    { fdId: "xe01f39825ccc428eaf67911", name: "地区", fdType: "STRING", metaType: "DIM" },
+    { fdId: "cd9b3a6c556ef4c53a08df16", name: "产品 ID", fdType: "STRING", metaType: "DIM" },
+    { fdId: "cece9879e99f545449909a82", name: "类别", fdType: "STRING", metaType: "DIM" },
+    { fdId: "k15359167149d4d02bbede2b", name: "子类别", fdType: "STRING", metaType: "DIM" },
+    { fdId: "f247afa584af241dba64821d", name: "产品名称", fdType: "STRING", metaType: "DIM" },
+    { fdId: "g4a34bd7bcb78425aa5485d1", name: "销售额", fdType: "DOUBLE", metaType: "METRIC" },
+    { fdId: "xd21ba1d7fd19433ebc728b6", name: "数量", fdType: "LONG", metaType: "METRIC" },
+    { fdId: "l0dbffcc612e047c9a6dae7b", name: "折扣", fdType: "DOUBLE", metaType: "METRIC" },
+    { fdId: "s1c05aa5e4bdd4a54a60e811", name: "利润", fdType: "DOUBLE", metaType: "METRIC" }
+], { displayType: "DATAFLOW" });

package/skills/guanvis/evals/sales_dashboard/card_01_revenue_column.js

@@ -0,0 +1,10 @@
+var card = createCard(ChartType.GROUPED_COLUMN, "区域营收分析")
+    .setId("qe122aaf82e38c1fa369325e")
+    .bindDataset(DS)
+    .addRow(f("区域"))
+    .addMetric(f("营收", { aggrType: AggrType.SUM, numberFormat: NumberFormat.currency("¥", 0) }))
+    .addColumn(f("产品"))
+    .setShowLegend(true, "right")
+    .setDataLabel({ show: true, showNumber: true });
+
+registerCard(card.build());

package/skills/guanvis/evals/sales_dashboard/card_02_trend_line.js

@@ -0,0 +1,9 @@
+var card = createCard(ChartType.MULTI_LINE, "月度趋势")
+    .setId("p3e20cf5d750ee644259f7b8")
+    .bindDataset(DS)
+    .addRow(f("月份"))
+    .addMetric(f("营收", { aggrType: AggrType.SUM, numberFormat: NumberFormat.auto("万") }))
+    .addMetric(f("成本", { aggrType: AggrType.SUM, numberFormat: NumberFormat.auto("万") }))
+    .setShowLegend(true, "bottom");
+
+registerCard(card.build());

package/skills/guanvis/evals/sales_dashboard/card_03_kpi.js

@@ -0,0 +1,6 @@
+var card = createCard(ChartType.KPI_CARD, "总营收")
+    .setId("o1c1e4431cc0c6dcc30663a1")
+    .bindDataset(DS)
+    .addMetric(f("营收", { aggrType: AggrType.SUM, numberFormat: NumberFormat.currency("¥", 0) }));
+
+registerCard(card.build());

package/skills/guanvis/evals/sales_dashboard/card_04_pie.js

@@ -0,0 +1,9 @@
+var card = createCard(ChartType.PIE, "产品分布")
+    .setId("s1fa6bd1b68a4974f7ad0202")
+    .bindDataset(DS)
+    .addRow(f("产品"))
+    .addMetric(f("营收", { aggrType: AggrType.SUM }))
+    .setDataLabel({ show: true, showPercentage: true, showCategory: true })
+    .setPieSetting({ innerRadius: 0 });
+
+registerCard(card.build());

package/skills/guanvis/evals/sales_dashboard/card_05_calc_field_test.js

@@ -0,0 +1,12 @@
+var card = createCard(ChartType.GROUPED_COLUMN, "利润率-计算字段测试")
+    .setId("te122aaf82e38c1fa3693250")
+    .bindDataset(DS)
+    .addRow(f("区域"))
+    .addMetric(f("营收", { aggrType: AggrType.SUM }))
+    .addMetric(calcField("利润", "(SUM([营收])-SUM([成本]))", { calculationType: "aggregation" }))
+    .addMetric(calcField("毛利率", "(SUM([营收])-SUM([成本]))/SUM([营收])", {
+        calculationType: "aggregation",
+        numberFormat: NumberFormat.percentage(1)
+    }));
+
+registerCard(card.build());

package/skills/guanvis/evals/sales_dashboard/page.js

@@ -0,0 +1,11 @@
+var page = createPage("销售分析仪表板")
+    .setId("a67a1cddb97678851fe1317f")
+    .setDescription("综合销售数据分析看板")
+    .setBackgroundColor("#f5f5f5")
+    .setCardMargin(8)
+    .placeCard(2, 0, 0, 4, 4)
+    .placeCard(3, 4, 0, 8, 4)
+    .addFullWidthCard(0, 6)
+    .addFullWidthCard(1, 6);
+
+registerPage(page.build());

package/skills/guanvis/evals/sales_dashboard/schema.js

@@ -0,0 +1,14 @@
+// Auto-generated by guanvis schema command
+// DO NOT EDIT — regenerate with: guanvis schema s9ded2338f43807b095fbb4f
+// This file defines dataset schemas for field() references in card scripts.
+
+// Dataset: 销售数据 (example, 7 fields)
+defineDataset("s9ded2338f43807b095fbb4f", [
+    { fdId: "jb16f22f6c1c21c3f6e8e293", name: "区域", fdType: "STRING", metaType: "DIM" },
+    { fdId: "o7093aaf2b2f32c9e964c41a", name: "产品", fdType: "STRING", metaType: "DIM" },
+    { fdId: "p2670dd6b74fc78c3e9c57ad", name: "月份", fdType: "DATE", metaType: "DIM" },
+    { fdId: "lb1c31b4dc86511a27049a98", name: "营收", fdType: "DOUBLE", metaType: "METRIC" },
+    { fdId: "aece10cd6806966be56f52ff", name: "成本", fdType: "DOUBLE", metaType: "METRIC" },
+    { fdId: "g1b16b52a16eb10c5e26d4bb", name: "数量", fdType: "INT", metaType: "METRIC" },
+    { fdId: "eae7cae6fbdcde68acdf5d1f", name: "利润率", fdType: "DOUBLE", metaType: "METRIC" }
+]);

package/skills/guanvis/evals/sales_dashboard/selector_01_region.js

@@ -0,0 +1,10 @@
+// Selector: Region filter with auto-link to all cards
+var sel = createSelector("区域筛选")
+    .setId("j423ad9cedf3b4bb1336fd6b")
+    .bindField(f("区域"))
+    .setMultiSelect(true)
+    .setDefaultType(SelectorDefaultType.FIRST_PICK)
+    .linkToAll()
+    .build();
+
+registerSelector(sel);