@dazitech/cli 3.0.8 → 3.1.0

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

@@ -1,34 +1,69 @@
-"""产品销售演示数据灌入 — space__zlj
+"""产品销售演示数据灌入 — space__misc_01
 
 前置：先执行 sales_ontology_init.py 建表。
-幂等：sales_order_fact 已有数据则跳过。
+幂等：fact_sales_order_line 已有数据则跳过。
 
-放置：项目/潘达石化/本体/ontos/产品销售本体方案/setup/sales_seed_data.py
-发布：dazi onto script publish 项目/潘达石化/本体/ontos/产品销售本体方案/setup/sales_seed_data.py --space space__zlj --type data
+放置：项目/DAZI_TEST/本体/ontos/销售本体示例/setup/sales_seed_data.py
+发布：dazi onto script publish 项目/DAZI_TEST/本体/ontos/销售本体示例/setup/sales_seed_data.py --space space__misc_01 --type data
 """
 
 import json
 import random
 from datetime import date, datetime, timedelta
 
+
 _SEED_DT = datetime(2025, 1, 1, 0, 0, 0)
 
 
 def main():
-    space_id = "space__zlj"
+    space_id = "space__misc_01"
     s = space.get(space_id)
 
     output.print("=== 产品销售演示数据灌入 ===")
 
+    # 检查是否已有数据
     try:
-        n = int(s.sql.query_one("SELECT count() FROM sales_order_fact") or 0)
+        n = int(s.sql.query_one("SELECT count() FROM fact_sales_order_line") or 0)
     except Exception:
         n = 0
     if n > 0:
-        output.print(f"sales_order_fact 已有 {n} 行，跳过灌数")
-        output.print("__JSON_SUMMARY__" + json.dumps({"ok": True, "skipped": True, "rows": n}, ensure_ascii=True))
+        output.print(f"fact_sales_order_line 已有 {n} 行，跳过灌数")
+        output.print("__JSON_SUMMARY__" + json.dumps({"ok": True, "skipped": True, "rows": n}, ensure_ascii=False))
         return
 
+    # 1. 灌入 dim_date
+    output.print("\n[1/4] 灌入 dim_date...")
+    dim_date_rows = []
+    start_date = date(2025, 1, 1)
+    end_date = date(2026, 6, 30)
+    current = start_date
+    while current <= end_date:
+        date_key = int(current.strftime("%Y%m%d"))
+        year = current.year
+        month = current.month
+        quarter = (month - 1) // 3 + 1
+        week_of_year = current.isocalendar()[1]
+        day_of_week = current.weekday()
+        is_weekend = 1 if day_of_week >= 5 else 0
+        year_month = current.strftime("%Y-%m")
+        dim_date_rows.append({
+            "date_key": date_key,
+            "calendar_date": current,
+            "year": year,
+            "quarter": quarter,
+            "month": month,
+            "week_of_year": week_of_year,
+            "day_of_week": day_of_week,
+            "is_weekend": is_weekend,
+            "year_month": year_month,
+        })
+        current += timedelta(days=1)
+    s.sql.insert_rows("dim_date", dim_date_rows)
+    output.print(f"OK dim_date 插入 {len(dim_date_rows)} 行")
+
+    # 2. 灌入维表
+    output.print("\n[2/4] 灌入维表...")
+
     products = [
         {"product_id": "P001", "product_code": "OIL-92", "product_name": "92号汽油", "product_category": "成品油", "product_subcategory": "汽油", "brand": "潘达", "unit": "吨", "list_price": 8200.0, "cost_price": 7100.0, "status": "在售"},
         {"product_id": "P002", "product_code": "OIL-0", "product_name": "0号柴油", "product_category": "成品油", "product_subcategory": "柴油", "brand": "潘达", "unit": "吨", "list_price": 7500.0, "cost_price": 6500.0, "status": "在售"},
@@ -57,11 +92,13 @@ def main():
         {"channel_id": "CH03", "channel_code": "B2B", "channel_name": "B2B平台", "channel_type": "线上"},
     ]
 
-    s.sql.insert_rows("product_master", products)
-    s.sql.insert_rows("customer_dimension", customers)
-    s.sql.insert_rows("channel_dimension", channels)
-    output.print("OK 维表数据")
+    s.sql.insert_rows("dim_product", products)
+    s.sql.insert_rows("dim_customer", customers)
+    s.sql.insert_rows("dim_channel", channels)
+    output.print(f"OK dim_product {len(products)} 行, dim_customer {len(customers)} 行, dim_channel {len(channels)} 行")
 
+    # 3. 生成销售事实数据
+    output.print("\n[3/4] 生成销售事实数据...")
     random.seed(627)
     regions = {c["customer_id"]: c["customer_region"] for c in customers}
     ctypes = {c["customer_id"]: c["customer_type"] for c in customers}
@@ -70,12 +107,10 @@ def main():
 
     fact_rows = []
     line_seq = 1
-    start = date(2025, 1, 1)
-    end = date(2026, 6, 30)
-    days = (end - start).days + 1
+    days = (end_date - start_date).days + 1
 
     for d_offset in range(days):
-        order_date = start + timedelta(days=d_offset)
+        order_date = start_date + timedelta(days=d_offset)
         if random.random() > 0.35:
             continue
         daily_orders = random.randint(2, 8)
@@ -90,9 +125,11 @@ def main():
                 unit_price = round(prices[product_id] * random.uniform(0.92, 1.0), 2)
                 discount = round(unit_price * qty * random.uniform(0, 0.05), 2)
                 sales_amount = round(unit_price * qty - discount, 2)
+                date_key = int(order_date.strftime("%Y%m%d"))
                 fact_rows.append({
                     "order_id": order_id,
                     "order_line_id": f"L{line_seq:06d}",
+                    "date_key": date_key,
                     "order_date": order_date,
                     "product_id": product_id,
                     "product_category": pcats[product_id],
@@ -109,16 +146,18 @@ def main():
                 })
                 line_seq += 1
 
-    inserted = s.sql.insert_rows("sales_order_fact", fact_rows)
-    output.print(f"OK 销售事实表插入 {inserted} 行")
+    s.sql.insert_rows("fact_sales_order_line", fact_rows)
+    output.print(f"OK fact_sales_order_line 插入 {len(fact_rows)} 行")
 
+    # 4. 完成
     summary = {
         "ok": True,
         "space_id": space_id,
+        "dim_date": len(dim_date_rows),
         "products": len(products),
         "customers": len(customers),
         "channels": len(channels),
-        "fact_inserted": inserted,
+        "fact_inserted": len(fact_rows),
     }
     output.success("灌数完成")
-    output.print("__JSON_SUMMARY__" + json.dumps(summary, ensure_ascii=True, default=str))
+    output.print("__JSON_SUMMARY__" + json.dumps(summary, ensure_ascii=False, default=str))

package/dist/prompts/index.json

@@ -1,7 +1,14 @@
 {
-  "version": "3.0.8",
+  "version": "3.1.0",
   "updatedAt": "2026-06-05T00:00:00.000Z",
   "prompts": [
+    {
+      "id": "onto/planning-design",
+      "title": "本体规划设计（TRAE/智能体 · 默认）",
+      "category": "onto",
+      "file": "onto/planning-design.md",
+      "featured": true
+    },
     {
       "id": "onto/script-publish-run",
       "title": "本体脚本发布与运行（TRAE/智能体）",

package/dist/prompts/onto/function-design.md

@@ -1,53 +1,73 @@
-# 提示词：本体函数设计
-
-**提示词 ID**: `onto/function-design`  
-**场景**: 设计新的本体函数
-
----
-
-你是一名搭子平台本体工程师。请根据以下需求设计一个本体函数（ontology function）。
-
-## 函数需求
-
-{{function_description}}
-
-## 要求
-
-1. 函数名使用 snake_case，以动词开头（如 `calc_balance`、`get_user_info`）
-2. `main(params: dict) -> dict` 为入口函数
-3. 参数通过 `params` 字典传入，输出通过 return 返回
-4. 包含完整的 docstring（中文），说明：函数目的、参数说明、返回值说明
-5. 包含基本的错误处理（try/except）
-6. 引用的搭子数据空间对象通过 `s` 上下文访问
-7. 在脚本顶部定义 `TEST_ARGUMENTS` 常量（与 `functions/test_arguments/<function_id>.json` 同步），供发布后 `save-test-arguments` 入库
-
-## 输出格式
-
-```python
-def main(params: dict, s=None) -> dict:
-    """
-    [函数说明]
-
-    Args:
-        params: 包含 xxx（说明）
-
-    Returns:
-        包含 xxx（说明）
-    """
-    # 实现
-```
-
-脚本落盘路径：`项目/<业务名>/本体/ontos/<实现名>/functions/<file>.py`  
-`space_id` 取自同目录上级的 `README.md`（`ontos/<实现名>/README.md`）。
-
-发布与运行（v3，工作区根目录；**勿用** `dazi-onto`）：
-
-```powershell
-dazi onto script publish 项目/<业务名>/本体/ontos/<实现名>/functions/<file>.py --space <space-id> --register-function-id <id>
-dazi onto function run <id> --space <space-id>
-# run 验证通过后，保存 test_arguments（侧栏「运行函数」预填；须用 ofn_xxx 内部 id，见 script-publish-run §7）
-dazi onto function save-test-arguments <ofn_internal_id> --space <space-id> `
-  --arguments-json-file 项目/<业务名>/本体/ontos/<实现名>/functions/test_arguments/<id>.json
-```
-
-详见提示词 `onto/script-publish-run`（侧栏 帮助 → 提示词），含 `test_arguments` JSON 格式与批量 `save_test_arguments.ps1`。
+# 提示词：本体函数设计
+
+**提示词 ID**: `onto/function-design`  
+**场景**: 设计新的本体函数
+
+---
+
+你是一名搭子平台本体工程师。请根据以下需求设计一个本体函数（ontology function）。
+
+**执行脚本前必读**：`资源/docs/onto/脚本运行常见错误处理.md`（`onto/script-run-troubleshooting`）。  
+**必须复制结构**：`资源/examples/onto/_templates/ontology_function_template.py` 或 `销售示例/functions/sales_fn_get_summary.py`。
+
+## 函数需求
+
+{{function_description}}
+
+## 要求
+
+1. 文件名 `snake_case`，如 `cost_fn_get_summary.py`；`function_id` 如 `domain.fn.get_summary`
+2. **`def main():` 无参** — 禁止 `main(params: dict)`；入参来自 `ctx.params`
+3. 业务逻辑写在 **`_ontology_fn_body(p)`**；`main()` 末尾 **`return _ontology_fn_body(p)`**
+4. 输出使用 **`return p.function_result(columns=..., data=..., row_count=...)`** — **禁止** `output.print_json()`、`print()` 作为平台输出
+5. SQL 用 **`p.sql.query()`** 取多列；聚合勿误用 `query_one().get()`
+6. 脚本顶部 **`TEST_ARGUMENTS`** 与 `functions/test_arguments/<function_id>.json` 同步
+7. 中文 docstring：目的、参数、返回值、发布命令
+
+## 输出格式（必须遵循）
+
+```python
+TEST_ARGUMENTS = {
+    "v": 1,
+    "arguments": { ... },
+    "object_type_code": "<ObjectTypeCode>",
+}
+
+
+def _ontology_fn_body(p):
+    params = dict(p.get_params() or {})
+    # ... p.sql.query(...)
+    return p.function_result(
+        columns=[...],
+        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)
+```
+
+脚本落盘：`项目/<业务名>/本体/ontos/<实现名>/functions/<file>.py`
+
+发布与运行（dazi-work 根；**勿用** `dazi-onto`）：
+
+```powershell
+dazi onto script publish 项目/<业务名>/本体/ontos/<实现名>/functions/<file>.py --space <space-id> --register-function-id <id>
+dazi onto function run <id> --space <space-id>
+dazi onto function save-test-arguments <ofn_internal_id> --space <space-id> `
+  --arguments-json-file 项目/<业务名>/本体/ontos/<实现名>/functions/test_arguments/<id>.json
+```
+
+详见 `onto/script-publish-run`、`onto/function-guide`。

package/dist/prompts/onto/planning-design.md

@@ -0,0 +1,104 @@
+# 本体规划设计（TRAE / 智能体）
+
+**文档 ID**: `onto/planning-design`  
+**场景**: 新建本体实现、撰写 `plans/` 规划、能力评估（**默认任务模式**）  
+**前置**: 已打开本体实现单元；`README.md` / `快速启动_*.md` 中有 `space_id`
+
+---
+
+## 0. 任务边界（强制）
+
+本提示词用于 **规划阶段**，产出仅为 **`plans/<主题>.md`**（及自检附录）。
+
+| 允许 | 禁止（未获用户明确要求「快速 demo」前） |
+| ---- | ---------------------------------------- |
+| 阅读 `资源/docs/onto/规划示例_*.md` **学结构** | 复制 `资源/examples/onto/**/setup/*.py` 到本项目 |
+| 阅读 `本体规划指南.md`、`本体命名规范_*.md` | 复制 `项目/*/本体/ontos/*` 整目录到其他实现 |
+| 在 `plans/` **独立撰写**业务方案 | 把规划示例全文另存为 `plans/` |
+| 对照侧栏 **数据资源** 了解现网表/Cube | `dazi onto script publish` / 写 `setup/`、`functions/` |
+
+**用户说「创建/设计本体方案」** → 先规划，**不是**先复制 init。
+
+---
+
+## 1. 开始前读取
+
+1. `项目/<业务>/本体/ontos/<实现名>/README.md` — **space_id**
+2. `快速启动_<实现名>.md` — §0 任务模式、§2 域路由表
+3. `dazi docs sync` 后：`资源/docs/onto/本体规划指南.md`
+
+```powershell
+dazi doctor
+dazi auth whoami
+dazi onto space get <space-id>   # 可选：现网资产
+```
+
+---
+
+## 2. 业务域路由（只读参照）
+
+| 用户意图关键词 | 只读对照规划 | 勿混用 |
+| -------------- | ------------ | ------ |
+| 销售、订单、产品、渠道、SKU | `规划示例_产品销售本体规划方案.md` | 利润 GL 表结构 |
+| 利润、科目、预算、GL、成本中心、预实 | `规划示例_利润分析本体方案.md` | 销售订单事实表 |
+
+规划示例是 **参照答案**，须结合本实现的业务背景 **重写**，并写 **「与参照示例的差异说明」** 章节。
+
+---
+
+## 3. 规划方法（业务世界 → 三层）
+
+**顺序**：对象类型 + 链接（业务语言）→ 反推物理表 + 表间关系 → Cube 读模型 → 函数清单。
+
+每层须 **独立成章**（见规划指南标准结构）：
+
+| 章节 | 必填要点 |
+| ---- | -------- |
+| 业务场景 | 域边界、分析问题、空间约束 |
+| 物理层 | `dim_date` + `fact_*` 含 `date_key`；表/列 **显示名+说明** |
+| 表间关系 | 从事实到维表；`join_keys`；与本体链接对照 |
+| **Cube 层** | 每 Cube：类别、事实源、维度、度量、派生度量、支撑对象 |
+| 本体层 | 对象 `code`、分类、bind_source、属性、链接 |
+| 函数 | function_id、参数、返回值、test_arguments |
+| 差异说明 | 与所选规划示例的业务/表/Cube/对象差异 |
+| 附录 B | CATEGORY_REGISTRY 对照（平台分类） |
+
+---
+
+## 4. 产出路径
+
+```
+项目/<业务>/本体/ontos/<实现名>/plans/<主题>.md
+```
+
+定稿前勾选 [规划完整性自检清单](资源/docs/onto/本体规划指南.md)（含 Cube 层、6a–6e 分类）。
+
+规划阶段 **不** 创建或发布 `setup/`、`functions/` 脚本。
+
+---
+
+## 5. 反模式（视为不合格）
+
+- `plans/` 为空即开始写 init
+- 表名/Cube/对象与规划示例 **逐字相同** 且无差异说明
+- 利润域任务却使用销售域 `fact_sales_order_line` 等且无业务论证
+- 复制潘达石化或其他 `项目/` 下历史实现充数
+- 规划缺 **Cube 独立章节**（仅表+对象+函数）
+
+---
+
+## 6. 进入实施
+
+规划定稿且用户确认后，切换提示词 **`onto/script-publish-run`**，按 `plans/` 实现 `setup/`、`functions/`。
+
+实施顺序：**init → seed → 发布全部函数 → `*_category_mount.py`**（类灌数，含附录 B 全量六类）。可选：各 publish 带 `--register-platform-category` 与 category_mount 幂等并存。
+
+---
+
+## 7. 相关文档
+
+- `onto/本体规划指南.md`
+- `onto/规划示例_产品销售本体规划方案.md`
+- `onto/规划示例_利润分析本体方案.md`
+- `onto/本体命名规范_物理表Cube与对象.md`
+- `onto/本体分类规划与SDK扩展方案.md`