@dazitech/cli 3.0.8 → 3.0.9

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

@@ -1,32 +1,175 @@
-"""产品销售本体初始化脚本 — space__zlj
+"""产品销售本体初始化脚本 — space__misc_01
 
 初始化内容：
-1. 创建物理表（4 张：产品表、销售表、客户维表、渠道维表）
+1. 创建物理表（dim_date + 3 维表 + 1 事实表）
 2. 注册表到空间
-3. 注册表间关系（3 条：事实表 → 维表）
-4. 注册 Cube（5 个）及派生度量
+3. 注册表间关系（4 条，含 fact → dim_date）
+4. 注册 Cube（4 个）及派生度量
 5. 定义对象类型（5 种）、绑定数据源、属性、链接
 6. 同步指标引用
+7. 配置 347 对齐分类（ads_categories + 桥表）
 
-放置：项目/潘达石化/本体/ontos/产品销售本体方案/setup/sales_ontology_init.py
-发布：dazi onto script publish 项目/潘达石化/本体/ontos/产品销售本体方案/setup/sales_ontology_init.py --space space__zlj --type setup
+放置：资源/examples/onto/销售示例/setup/sales_ontology_init.py（复制到项目 ontos/<实现名>/setup/）
+发布：dazi onto script publish <item-path>/setup/sales_ontology_init.py --space <space-id> --type setup
+规划对照：资源/docs/onto/规划示例_产品销售本体规划方案.md
 """
 
 import json
 
+# 与 规划示例_产品销售本体规划方案.md §2.3、§3.x 对齐：display_name=侧栏显示名，description=业务说明
+TABLE_REGISTRY = {
+    "dim_date": {
+        "display_name": "日期维表",
+        "description": "全空间共享日历，事实表通过 date_key 关联",
+        "columns": [
+            {"name": "date_key", "display_name": "日期键", "description": "YYYYMMDD，主键"},
+            {"name": "calendar_date", "display_name": "自然日"},
+            {"name": "year", "display_name": "公历年"},
+            {"name": "quarter", "display_name": "季度", "description": "1-4"},
+            {"name": "month", "display_name": "月", "description": "1-12"},
+            {"name": "week_of_year", "display_name": "周"},
+            {"name": "day_of_week", "display_name": "星期"},
+            {"name": "is_weekend", "display_name": "是否周末", "description": "0/1"},
+            {"name": "year_month", "display_name": "年月", "description": "如 2025-06"},
+        ],
+    },
+    "dim_product": {
+        "display_name": "产品维表",
+        "description": "可售产品主数据",
+        "columns": [
+            {"name": "product_id", "display_name": "产品 ID", "description": "主键"},
+            {"name": "product_code", "display_name": "产品编码"},
+            {"name": "product_name", "display_name": "产品名称"},
+            {"name": "product_category", "display_name": "产品大类"},
+            {"name": "product_subcategory", "display_name": "产品小类"},
+            {"name": "brand", "display_name": "品牌"},
+            {"name": "unit", "display_name": "计量单位"},
+            {"name": "list_price", "display_name": "挂牌价"},
+            {"name": "cost_price", "display_name": "成本单价"},
+            {"name": "status", "display_name": "状态", "description": "在售/停售"},
+            {"name": "created_at", "display_name": "创建时间"},
+            {"name": "updated_at", "display_name": "更新时间"},
+        ],
+    },
+    "dim_customer": {
+        "display_name": "客户维表",
+        "description": "购买方主数据",
+        "columns": [
+            {"name": "customer_id", "display_name": "客户 ID", "description": "主键"},
+            {"name": "customer_code", "display_name": "客户编码"},
+            {"name": "customer_name", "display_name": "客户名称"},
+            {"name": "customer_region", "display_name": "销售区域"},
+            {"name": "customer_type", "display_name": "客户类型"},
+            {"name": "industry", "display_name": "所属行业"},
+            {"name": "created_at", "display_name": "创建时间"},
+        ],
+    },
+    "dim_channel": {
+        "display_name": "渠道维表",
+        "description": "销售渠道主数据",
+        "columns": [
+            {"name": "channel_id", "display_name": "渠道 ID", "description": "主键"},
+            {"name": "channel_code", "display_name": "渠道编码"},
+            {"name": "channel_name", "display_name": "渠道名称"},
+            {"name": "channel_type", "display_name": "渠道类型"},
+        ],
+    },
+    "fact_sales_order_line": {
+        "display_name": "销售订单行事实表",
+        "description": "订单行粒度销售流水",
+        "columns": [
+            {"name": "order_id", "display_name": "订单 ID"},
+            {"name": "order_line_id", "display_name": "订单行 ID", "description": "主键组合"},
+            {"name": "date_key", "display_name": "日期键", "description": "关联 dim_date"},
+            {"name": "order_date", "display_name": "订单日期"},
+            {"name": "product_id", "display_name": "产品 ID", "description": "关联 dim_product"},
+            {"name": "product_category", "display_name": "产品大类", "description": "冗余"},
+            {"name": "customer_id", "display_name": "客户 ID", "description": "关联 dim_customer"},
+            {"name": "customer_region", "display_name": "销售区域", "description": "冗余"},
+            {"name": "customer_type", "display_name": "客户类型", "description": "冗余"},
+            {"name": "channel_id", "display_name": "渠道 ID", "description": "关联 dim_channel"},
+            {"name": "quantity", "display_name": "销售数量"},
+            {"name": "unit_price", "display_name": "成交单价"},
+            {"name": "discount_amount", "display_name": "折扣金额"},
+            {"name": "sales_amount", "display_name": "销售金额"},
+            {"name": "currency", "display_name": "币种"},
+            {"name": "order_status", "display_name": "订单状态"},
+        ],
+    },
+}
+
+# 与 347 + 附录 B 对齐；category 值必须是 347 标准中文名
+CATEGORY_REGISTRY = {
+    "table": {
+        "时间维": ["dim_date"],
+        "维度表": ["dim_product", "dim_customer", "dim_channel"],
+        "事实表": ["fact_sales_order_line"],
+    },
+    "cube": {
+        "流程型": ["SalesCube"],
+        "主体型": ["ProductSalesCube", "CustomerSalesCube", "ChannelSalesCube"],
+    },
+    "object": {
+        "主数据": ["Product", "Customer"],
+        "参考": ["SalesChannel"],
+        "事务": ["SalesOrder"],
+        "分析": ["SalesAnalysis"],
+    },
+    "relation": {
+        "时间关联": [("fact_sales_order_line", "dim_date")],
+        "主数据关联": [
+            ("fact_sales_order_line", "dim_product"),
+            ("fact_sales_order_line", "dim_customer"),
+            ("fact_sales_order_line", "dim_channel"),
+        ],
+    },
+    "link": {
+        "归属关系": [
+            "order_contains_product",
+            "order_belongs_customer",
+            "order_via_channel",
+            "product_has_orders",
+            "customer_places_orders",
+        ],
+        "分析归因": [
+            "analysis_by_product",
+            "analysis_by_customer",
+            "analysis_by_channel",
+        ],
+    },
+}
+
 
 def main():
-    space_id = "space__zlj"
+    space_id = "space__misc_01"
     s = space.get(space_id)
 
     output.print("=== 产品销售本体初始化 ===")
     output.print(f"空间: {space_id}")
 
     # 1. 创建物理表
-    output.print("\n[1/9] 创建物理表...")
+    output.print("\n[1/10] 创建物理表...")
+
+    # dim_date（强制时间维）
+    s.sql.execute("""
+        CREATE TABLE IF NOT EXISTS dim_date (
+            date_key Int32,
+            calendar_date Date,
+            year Int16,
+            quarter Int8,
+            month Int8,
+            week_of_year Int8,
+            day_of_week Int8,
+            is_weekend UInt8,
+            year_month String
+        ) ENGINE = MergeTree()
+        ORDER BY (date_key)
+    """)
+    output.print("OK dim_date")
 
+    # dim_product
     s.sql.execute("""
-        CREATE TABLE IF NOT EXISTS product_master (
+        CREATE TABLE IF NOT EXISTS dim_product (
             product_id String,
             product_code String,
             product_name String,
@@ -42,10 +185,11 @@ def main():
         ) ENGINE = MergeTree()
         ORDER BY (product_id)
     """)
-    output.print("OK product_master")
+    output.print("OK dim_product")
 
+    # dim_customer
     s.sql.execute("""
-        CREATE TABLE IF NOT EXISTS customer_dimension (
+        CREATE TABLE IF NOT EXISTS dim_customer (
             customer_id String,
             customer_code String,
             customer_name String,
@@ -56,10 +200,11 @@ def main():
         ) ENGINE = MergeTree()
         ORDER BY (customer_id)
     """)
-    output.print("OK customer_dimension")
+    output.print("OK dim_customer")
 
+    # dim_channel
     s.sql.execute("""
-        CREATE TABLE IF NOT EXISTS channel_dimension (
+        CREATE TABLE IF NOT EXISTS dim_channel (
             channel_id String,
             channel_code String,
             channel_name String,
@@ -67,12 +212,14 @@ def main():
         ) ENGINE = MergeTree()
         ORDER BY (channel_id)
     """)
-    output.print("OK channel_dimension")
+    output.print("OK dim_channel")
 
+    # fact_sales_order_line（含 date_key）
     s.sql.execute("""
-        CREATE TABLE IF NOT EXISTS sales_order_fact (
+        CREATE TABLE IF NOT EXISTS fact_sales_order_line (
             order_id String,
             order_line_id String,
+            date_key Int32,
             order_date Date,
             product_id String,
             product_category String,
@@ -87,60 +234,68 @@ def main():
             currency String,
             order_status String
         ) ENGINE = MergeTree()
-        ORDER BY (order_date, order_id, order_line_id)
+        ORDER BY (date_key, order_id, order_line_id)
     """)
-    output.print("OK sales_order_fact")
-
-    # 2. 注册表
-    output.print("\n[2/9] 注册表到空间...")
-
-    for tbl, label in [
-        ("product_master", "产品主数据表"),
-        ("customer_dimension", "客户维度表"),
-        ("channel_dimension", "销售渠道表"),
-        ("sales_order_fact", "销售订单事实表"),
-    ]:
-        s.tables.register(tbl, label=label)
-        s.tables.sync_columns(tbl)
-        output.print(f"OK {tbl}")
+    output.print("OK fact_sales_order_line")
+
+    # 2. 注册表（含 display_name / description）
+    output.print("\n[2/10] 注册表到空间...")
+
+    for tbl_name, meta in TABLE_REGISTRY.items():
+        s.tables.register_with_meta(
+            table_name=tbl_name,
+            display_name=meta["display_name"],
+            description=meta.get("description"),
+            columns=meta["columns"],
+            force_column_meta=True,
+        )
+        output.print(f"OK {tbl_name} ({meta['display_name']})")
 
-    # 3. 注册表间关系（数据空间「表间关系」，供 JOIN / 侧栏展示）
-    output.print("\n[3/9] 注册表间关系...")
+    # 3. 注册表间关系（4 条，含 fact → dim_date）
+    output.print("\n[3/10] 注册表间关系...")
 
     table_relationships = [
         {
-            "from_table": "sales_order_fact",
-            "to_table": "product_master",
-            "join_sql": "sales_order_fact.product_id = product_master.product_id",
+            "from_table": "fact_sales_order_line",
+            "to_table": "dim_date",
+            "join_sql": "fact_sales_order_line.date_key = dim_date.date_key",
+            "join_keys": [{"from": "date_key", "to": "date_key"}],
+            "relationship_type": "many_to_one",
+            "description": "销售订单行关联日期",
+        },
+        {
+            "from_table": "fact_sales_order_line",
+            "to_table": "dim_product",
+            "join_sql": "fact_sales_order_line.product_id = dim_product.product_id",
             "join_keys": [{"from": "product_id", "to": "product_id"}],
             "relationship_type": "many_to_one",
-            "description": "销售订单行关联产品主数据",
+            "description": "销售订单行关联产品",
         },
         {
-            "from_table": "sales_order_fact",
-            "to_table": "customer_dimension",
-            "join_sql": "sales_order_fact.customer_id = customer_dimension.customer_id",
+            "from_table": "fact_sales_order_line",
+            "to_table": "dim_customer",
+            "join_sql": "fact_sales_order_line.customer_id = dim_customer.customer_id",
             "join_keys": [{"from": "customer_id", "to": "customer_id"}],
             "relationship_type": "many_to_one",
             "description": "销售订单行关联客户",
         },
         {
-            "from_table": "sales_order_fact",
-            "to_table": "channel_dimension",
-            "join_sql": "sales_order_fact.channel_id = channel_dimension.channel_id",
+            "from_table": "fact_sales_order_line",
+            "to_table": "dim_channel",
+            "join_sql": "fact_sales_order_line.channel_id = dim_channel.channel_id",
             "join_keys": [{"from": "channel_id", "to": "channel_id"}],
             "relationship_type": "many_to_one",
-            "description": "销售订单行关联销售渠道",
+            "description": "销售订单行关联渠道",
         },
     ]
     for rel in table_relationships:
         rid = s.tables.add_relationship(**rel)
         output.print(f"OK {rel['from_table']} -> {rel['to_table']} ({rid})")
 
-    # 4. 注册 Cube
-    output.print("\n[4/9] 注册 Cube...")
+    # 4. 注册 Cube（4 个）
+    output.print("\n[4/10] 注册 Cube...")
 
-    fact = "sales_order_fact"
+    fact = "fact_sales_order_line"
     common_measures = [
         {"name": "quantity", "col": "quantity", "agg": "sum", "title": "销售数量"},
         {"name": "sales_amount", "col": "sales_amount", "agg": "sum", "title": "销售金额"},
@@ -149,6 +304,7 @@ def main():
         {"name": "line_count", "col": "order_line_id", "agg": "uniq", "title": "订单行数"},
     ]
 
+    # SalesCube（Process · 销售分析主 Cube）
     s.register_cube(
         name="SalesCube",
         table=fact,
@@ -157,16 +313,19 @@ def main():
         dimensions=[
             {"name": "order_id", "col": "order_id", "type": "string", "title": "订单ID"},
             {"name": "order_line_id", "col": "order_line_id", "type": "string", "title": "订单行ID"},
+            {"name": "date_key", "col": "date_key", "type": "int32", "title": "日期键"},
             {"name": "order_date", "col": "order_date", "type": "date", "title": "订单日期"},
             {"name": "product_id", "col": "product_id", "type": "string", "title": "产品ID"},
             {"name": "product_category", "col": "product_category", "type": "string", "title": "产品大类"},
             {"name": "customer_id", "col": "customer_id", "type": "string", "title": "客户ID"},
             {"name": "customer_region", "col": "customer_region", "type": "string", "title": "销售区域"},
+            {"name": "customer_type", "col": "customer_type", "type": "string", "title": "客户类型"},
             {"name": "channel_id", "col": "channel_id", "type": "string", "title": "渠道ID"},
         ],
     )
     output.print("OK SalesCube")
 
+    # ProductSalesCube（Subject · 产品销售）
     s.register_cube(
         name="ProductSalesCube",
         table=fact,
@@ -183,6 +342,7 @@ def main():
     )
     output.print("OK ProductSalesCube")
 
+    # CustomerSalesCube（Subject · 客户销售）
     s.register_cube(
         name="CustomerSalesCube",
         table=fact,
@@ -200,6 +360,7 @@ def main():
     )
     output.print("OK CustomerSalesCube")
 
+    # ChannelSalesCube（Subject · 渠道销售）
     s.register_cube(
         name="ChannelSalesCube",
         table=fact,
@@ -215,26 +376,8 @@ def main():
     )
     output.print("OK ChannelSalesCube")
 
-    s.register_cube(
-        name="TimeSalesCube",
-        table=fact,
-        title="时间维度销售Cube",
-        measures=[
-            {"name": "sales_amount", "col": "sales_amount", "agg": "sum", "title": "销售金额"},
-            {"name": "quantity", "col": "quantity", "agg": "sum", "title": "销售数量"},
-            {"name": "order_count", "col": "order_id", "agg": "uniq", "title": "订单数"},
-        ],
-        dimensions=[
-            {"name": "order_date", "col": "order_date", "type": "date", "title": "订单日期"},
-            {"name": "year_month", "col": "order_date", "type": "string", "title": "年月"},
-            {"name": "quarter", "col": "order_date", "type": "string", "title": "季度"},
-            {"name": "year", "col": "order_date", "type": "date", "title": "年份"},
-        ],
-    )
-    output.print("OK TimeSalesCube")
-
     # 5. 派生度量
-    output.print("\n[5/9] 配置派生度量...")
+    output.print("\n[5/10] 配置派生度量...")
 
     s.upsert_derived_measures(
         "SalesCube",
@@ -253,6 +396,8 @@ def main():
             },
         ],
     )
+    output.print("OK SalesCube 派生度量")
+
     s.upsert_derived_measures(
         "ProductSalesCube",
         [
@@ -264,6 +409,8 @@ def main():
             },
         ],
     )
+    output.print("OK ProductSalesCube 派生度量")
+
     s.upsert_derived_measures(
         "CustomerSalesCube",
         [
@@ -275,10 +422,10 @@ def main():
             },
         ],
     )
-    output.print("OK 派生度量")
+    output.print("OK CustomerSalesCube 派生度量")
 
     # 6. 对象类型
-    output.print("\n[6/9] 定义对象类型...")
+    output.print("\n[6/10] 定义对象类型...")
 
     object_types = [
         ("Product", "产品", "可售产品业务对象"),
@@ -292,7 +439,7 @@ def main():
         output.print(f"OK {code}")
 
     # 7. 绑定数据源
-    output.print("\n[7/9] 绑定数据源...")
+    output.print("\n[7/10] 绑定数据源...")
 
     bindings = [
         ("Product", "ProductSalesCube"),
@@ -301,103 +448,92 @@ def main():
         ("SalesOrder", "SalesCube"),
         ("SalesAnalysis", "SalesCube"),
     ]
-    for obj, cube in bindings:
-        s.onto.bind_source(obj, "dazi_cube", config={"cube": cube})
-        output.print(f"OK {obj} -> {cube}")
-
-    # 8. 属性
-    output.print("\n[8/9] 定义属性...")
-
-    def define_props(obj_code, props):
-        for code, name, role, qn in props:
-            s.onto.define_property(obj_code, code, name, semantic_role=role, qualified_name=qn)
-
-    define_props("Product", [
-        ("id", "产品ID", "dimension", "ProductSalesCube.product_id"),
-        ("category", "产品大类", "dimension", "ProductSalesCube.product_category"),
-        ("quantity", "累计销量", "measure", "ProductSalesCube.quantity"),
-        ("sales_amount", "累计销售额", "measure", "ProductSalesCube.sales_amount"),
-        ("order_count", "订单数", "measure", "ProductSalesCube.order_count"),
-        ("avg_unit_price", "平均单价", "measure", "ProductSalesCube.avg_unit_price"),
-    ])
-    output.print("OK Product 属性 (6)")
-
-    define_props("Customer", [
-        ("id", "客户ID", "dimension", "CustomerSalesCube.customer_id"),
-        ("region", "销售区域", "dimension", "CustomerSalesCube.customer_region"),
-        ("type", "客户类型", "dimension", "CustomerSalesCube.customer_type"),
-        ("sales_amount", "累计销售额", "measure", "CustomerSalesCube.sales_amount"),
-        ("order_count", "订单数", "measure", "CustomerSalesCube.order_count"),
-        ("avg_order_value", "客单价", "measure", "CustomerSalesCube.avg_order_value"),
-    ])
-    output.print("OK Customer 属性 (6)")
-
-    define_props("SalesChannel", [
-        ("id", "渠道ID", "dimension", "ChannelSalesCube.channel_id"),
-        ("sales_amount", "销售额", "measure", "ChannelSalesCube.sales_amount"),
-        ("order_count", "订单数", "measure", "ChannelSalesCube.order_count"),
-    ])
-    output.print("OK SalesChannel 属性 (3)")
-
-    define_props("SalesOrder", [
-        ("id", "订单ID", "dimension", "SalesCube.order_id"),
-        ("line_id", "订单行", "dimension", "SalesCube.order_line_id"),
-        ("date", "订单日期", "dimension", "SalesCube.order_date"),
-        ("quantity", "数量", "measure", "SalesCube.quantity"),
-        ("sales_amount", "销售金额", "measure", "SalesCube.sales_amount"),
-        ("unit_price", "成交单价", "measure", "SalesCube.avg_unit_price"),
-    ])
-    output.print("OK SalesOrder 属性 (6)")
-
-    define_props("SalesAnalysis", [
-        ("date", "日期", "dimension", "SalesCube.order_date"),
-        ("product_category", "产品大类", "dimension", "SalesCube.product_category"),
-        ("customer_region", "销售区域", "dimension", "SalesCube.customer_region"),
-        ("channel_id", "渠道", "dimension", "SalesCube.channel_id"),
-        ("quantity", "销量", "measure", "SalesCube.quantity"),
-        ("sales_amount", "销售额", "measure", "SalesCube.sales_amount"),
-        ("order_count", "订单数", "measure", "SalesCube.order_count"),
-        ("avg_order_value", "客单价", "measure", "SalesCube.avg_order_value"),
-    ])
-    output.print("OK SalesAnalysis 属性 (8)")
-
-    # 9. 链接类型
-    output.print("\n[9/9] 定义链接与同步指标...")
+    for code, cube in bindings:
+        s.onto.bind_source(code, "dazi_cube", config={"cube": cube})
+        output.print(f"OK {code} -> {cube}")
+
+    # 8. 定义属性
+    output.print("\n[8/10] 定义属性...")
+
+    properties = [
+        # Product 属性
+        ("Product", "id", "产品ID", "dimension", "ProductSalesCube.product_id"),
+        ("Product", "category", "产品大类", "dimension", "ProductSalesCube.product_category"),
+        ("Product", "quantity", "累计销量", "measure", "ProductSalesCube.quantity"),
+        ("Product", "sales_amount", "累计销售额", "measure", "ProductSalesCube.sales_amount"),
+        ("Product", "order_count", "订单数", "measure", "ProductSalesCube.order_count"),
+        ("Product", "avg_unit_price", "平均单价", "measure", "ProductSalesCube.avg_unit_price"),
+        # Customer 属性
+        ("Customer", "id", "客户ID", "dimension", "CustomerSalesCube.customer_id"),
+        ("Customer", "region", "销售区域", "dimension", "CustomerSalesCube.customer_region"),
+        ("Customer", "type", "客户类型", "dimension", "CustomerSalesCube.customer_type"),
+        ("Customer", "quantity", "累计销量", "measure", "CustomerSalesCube.quantity"),
+        ("Customer", "sales_amount", "累计销售额", "measure", "CustomerSalesCube.sales_amount"),
+        ("Customer", "order_count", "订单数", "measure", "CustomerSalesCube.order_count"),
+        ("Customer", "avg_order_value", "客单价", "measure", "CustomerSalesCube.avg_order_value"),
+        # SalesChannel 属性
+        ("SalesChannel", "id", "渠道ID", "dimension", "ChannelSalesCube.channel_id"),
+        ("SalesChannel", "quantity", "累计销量", "measure", "ChannelSalesCube.quantity"),
+        ("SalesChannel", "sales_amount", "累计销售额", "measure", "ChannelSalesCube.sales_amount"),
+        ("SalesChannel", "order_count", "订单数", "measure", "ChannelSalesCube.order_count"),
+        # SalesOrder 属性
+        ("SalesOrder", "id", "订单ID", "dimension", "SalesCube.order_id"),
+        ("SalesOrder", "line_id", "订单行", "dimension", "SalesCube.order_line_id"),
+        ("SalesOrder", "date", "订单日期", "dimension", "SalesCube.order_date"),
+        ("SalesOrder", "quantity", "数量", "measure", "SalesCube.quantity"),
+        ("SalesOrder", "sales_amount", "销售金额", "measure", "SalesCube.sales_amount"),
+        ("SalesOrder", "unit_price", "成交单价", "measure", "SalesCube.avg_unit_price"),
+        # SalesAnalysis 属性
+        ("SalesAnalysis", "total_sales", "总销售额", "measure", "SalesCube.sales_amount"),
+        ("SalesAnalysis", "total_quantity", "总销量", "measure", "SalesCube.quantity"),
+        ("SalesAnalysis", "order_count", "订单数", "measure", "SalesCube.order_count"),
+        ("SalesAnalysis", "avg_order_value", "客单价", "measure", "SalesCube.avg_order_value"),
+        ("SalesAnalysis", "avg_unit_price", "平均单价", "measure", "SalesCube.avg_unit_price"),
+    ]
+    for obj_code, prop_code, title, role, qualified_name in properties:
+        s.onto.define_property(obj_code, prop_code, title, semantic_role=role, qualified_name=qualified_name)
+    output.print(f"OK {len(properties)} 个属性")
+
+    # 9. 定义链接类型
+    output.print("\n[9/10] 定义链接类型...")
 
     link_types = [
-        ("order_contains_product", "订单包含产品", "SalesOrder", "Product", "订单行对应产品"),
-        ("order_belongs_customer", "订单归属客户", "SalesOrder", "Customer", "订单归属客户"),
-        ("order_via_channel", "订单经渠道成交", "SalesOrder", "SalesChannel", "订单销售渠道"),
-        ("product_has_orders", "产品有订单", "Product", "SalesOrder", "产品被哪些订单购买"),
-        ("customer_places_orders", "客户下单", "Customer", "SalesOrder", "客户历史订单"),
-        ("analysis_by_product", "分析归因产品", "SalesAnalysis", "Product", "指标按产品切片"),
-        ("analysis_by_customer", "分析归因客户", "SalesAnalysis", "Customer", "指标按客户切片"),
-        ("analysis_by_channel", "分析归因渠道", "SalesAnalysis", "SalesChannel", "指标按渠道切片"),
+        ("order_contains_product", "订单包含产品", "SalesOrder", "Product"),
+        ("order_belongs_customer", "订单归属客户", "SalesOrder", "Customer"),
+        ("order_via_channel", "订单经渠道成交", "SalesOrder", "SalesChannel"),
+        ("product_has_orders", "产品有订单", "Product", "SalesOrder"),
+        ("customer_places_orders", "客户下单", "Customer", "SalesOrder"),
+        ("analysis_by_product", "分析归因产品", "SalesAnalysis", "Product"),
+        ("analysis_by_customer", "分析归因客户", "SalesAnalysis", "Customer"),
+        ("analysis_by_channel", "分析归因渠道", "SalesAnalysis", "SalesChannel"),
     ]
-    for code, name, from_obj, to_obj, desc in link_types:
-        s.onto.define_link_type(
-            code=code,
-            name=name,
-            from_object_type_code=from_obj,
-            to_object_type_code=to_obj,
-            description=desc,
-        )
+    for code, name, from_obj, to_obj in link_types:
+        s.onto.define_link_type(code, name, from_object_type_code=from_obj, to_object_type_code=to_obj)
         output.print(f"OK {code}")
 
+    # 同步指标引用
     s.sync_metric_refs()
     output.print("OK sync_metric_refs")
 
+    # 10. 347 对齐分类
+    output.print("\n[10/10] 配置对象分类（347 对齐）...")
+
+    cat_counts = s.categories.apply_registry(CATEGORY_REGISTRY, skip_missing=True)
+    for kind, cnt in cat_counts.items():
+        if cnt:
+            output.print(f"OK 分类[{kind}] 挂载 {cnt} 项")
+
     summary = {
         "ok": True,
         "space_id": space_id,
-        "tables": 4,
-        "table_relationships": 3,
-        "cubes": 5,
+        "tables": 5,
+        "table_relationships": 4,
+        "cubes": 4,
         "object_types": 5,
-        "properties": 29,
-        "link_types": 8,
+        "properties": len(properties),
+        "link_types": len(link_types),
+        "category_mounts": cat_counts,
     }
-
-    output.print("\n=== 产品销售本体初始化完成 ===")
-    output.success("初始化成功")
-    output.print("__JSON_SUMMARY__" + json.dumps(summary, ensure_ascii=True, default=str))
+    output.success("本体初始化完成")
+    output.print(f"space_id: {space_id}")
+    output.print("__JSON_SUMMARY__" + json.dumps(summary, ensure_ascii=False))