仿真测试台(后端):节点指派 + 全链 Trace —— 起单定向到指定账号,真实任务落工作台

用户定的形态:测试台是**后端检测活动与流程**的,真实任务照旧到工作台 (不然指定账号干嘛)—— 所以测试台只管「起单 + 看穿」,人那一环还是真的。 **节点指派**(迁移 0016 workflow.assignments): - StartWorkflowInput 增 `assignments {节点id → 员工id}`;分派改三级取人: ①节点指派(点名的人在岗就是他)②员工组轮值 ③全员轮值 —— 指派是加法不是替换, 点名的人不在岗退回轮值(单不能没人接);事件里如实记 `(节点指派)` - **顺带修一个真 bug**:`node_instance.assignee_id` 写了但 `listInstances` 从没读回来 (审批箱收件、员工面链条、治理列表全按它认人 —— 写了不读等于没写) **全链 Trace**(新模块 trace,L2;迁移 0017 sys.trace_span): - span 由 **Mastra Observability 组件**产出(执行不经 Mastra 图,所以手动打点), 一开就落库、一收就补 —— 观测面不该比被观测的事晚(不走 exporter 的批量异步路) - 打点覆盖:工作流 root → 节点(记着派给了谁)→ 活动内每次工具调用 / 模型调用 / 人卡 - **root span 挂在 `runtime.begin`**:那是「单已建好、还没进第一个节点」那一刻 —— 挂在 start 返回之后就晚了,起单同步走到第一个节点,节点 span 会先出生、另起孤树(实测) - 观测尽力而为:写 span 失败吞掉,不掀翻业务 - 三样东西各管各的:trace(机器读时间轴)/ 任务记忆(人读留痕)/ **工作区报告(活动自持的 HTML)** —— 谁也不替代谁路由:`POST /api/gov/testbed/run`(带指派起单)、`GET /api/gov/workflows/:id/trace`。端到端六例(真库):指派生效 / 任务真落到被指派人手上并由他答单 / 下游节点同样生效 / 全链 span 逐层挂得上且耗时齐备 / 一条流一个 traceId / 不指派照旧轮值。五闸全过。 Co-Authored-By: Claude Fable 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01KeDBx2PHLavbURXB8LJJ7m
2026-07-29 01:43:49 +08:00
parent 9df2294f6e
commit 5fc6dfdfe1
34 changed files with 1301 additions and 41 deletions
@@ -23,7 +23,7 @@ module.exports = [
      "path": "^apps/api/src/modules/channel/"
    },
    "to": {
-      "path": "^apps/api/src/modules/(activity-registry|flow-engine|human-tool|interaction|loop-engine|memory|message|minute|process|release|report|skill-engine|task|toolbox|trigger)/"
+      "path": "^apps/api/src/modules/(activity-registry|flow-engine|human-tool|interaction|loop-engine|memory|message|minute|process|release|report|skill-engine|task|toolbox|trace|trigger)/"
    }
  },
  {
@@ -34,7 +34,7 @@ module.exports = [
      "path": "^apps/api/src/modules/event/"
    },
    "to": {
-      "path": "^apps/api/src/modules/(activity-registry|channel|flow-engine|human-tool|interaction|ledger|llm|loop-engine|memory|message|minute|org|process|release|report|skill-engine|task|toolbox|trigger)/"
+      "path": "^apps/api/src/modules/(activity-registry|channel|flow-engine|human-tool|interaction|ledger|llm|loop-engine|memory|message|minute|org|process|release|report|skill-engine|task|toolbox|trace|trigger)/"
    }
  },
  {
@@ -78,7 +78,7 @@ module.exports = [
      "path": "^apps/api/src/modules/ledger/"
    },
    "to": {
-      "path": "^apps/api/src/modules/(activity-registry|channel|event|flow-engine|human-tool|interaction|llm|loop-engine|memory|message|minute|org|process|release|report|skill-engine|task|toolbox|trigger)/"
+      "path": "^apps/api/src/modules/(activity-registry|channel|event|flow-engine|human-tool|interaction|llm|loop-engine|memory|message|minute|org|process|release|report|skill-engine|task|toolbox|trace|trigger)/"
    }
  },
  {
@@ -89,7 +89,7 @@ module.exports = [
      "path": "^apps/api/src/modules/llm/"
    },
    "to": {
-      "path": "^apps/api/src/modules/(activity-registry|channel|event|flow-engine|human-tool|interaction|ledger|loop-engine|memory|message|minute|org|process|release|report|skill-engine|task|toolbox|trigger)/"
+      "path": "^apps/api/src/modules/(activity-registry|channel|event|flow-engine|human-tool|interaction|ledger|loop-engine|memory|message|minute|org|process|release|report|skill-engine|task|toolbox|trace|trigger)/"
    }
  },
  {
@@ -111,7 +111,7 @@ module.exports = [
      "path": "^apps/api/src/modules/memory/"
    },
    "to": {
-      "path": "^apps/api/src/modules/(activity-registry|channel|flow-engine|human-tool|interaction|loop-engine|message|minute|process|release|report|skill-engine|task|toolbox|trigger)/"
+      "path": "^apps/api/src/modules/(activity-registry|channel|flow-engine|human-tool|interaction|loop-engine|message|minute|process|release|report|skill-engine|task|toolbox|trace|trigger)/"
    }
  },
  {
@@ -122,7 +122,7 @@ module.exports = [
      "path": "^apps/api/src/modules/message/"
    },
    "to": {
-      "path": "^apps/api/src/modules/(activity-registry|channel|flow-engine|human-tool|interaction|loop-engine|memory|minute|process|release|report|skill-engine|task|toolbox|trigger)/"
+      "path": "^apps/api/src/modules/(activity-registry|channel|flow-engine|human-tool|interaction|loop-engine|memory|minute|process|release|report|skill-engine|task|toolbox|trace|trigger)/"
    }
  },
  {
@@ -144,7 +144,7 @@ module.exports = [
      "path": "^apps/api/src/modules/org/"
    },
    "to": {
-      "path": "^apps/api/src/modules/(activity-registry|channel|event|flow-engine|human-tool|interaction|ledger|llm|loop-engine|memory|message|minute|process|release|report|skill-engine|task|toolbox|trigger)/"
+      "path": "^apps/api/src/modules/(activity-registry|channel|event|flow-engine|human-tool|interaction|ledger|llm|loop-engine|memory|message|minute|process|release|report|skill-engine|task|toolbox|trace|trigger)/"
    }
  },
  {
@@ -210,7 +210,18 @@ module.exports = [
      "path": "^apps/api/src/modules/toolbox/"
    },
    "to": {
-      "path": "^apps/api/src/modules/(activity-registry|channel|flow-engine|human-tool|interaction|loop-engine|memory|message|minute|process|release|report|skill-engine|task|trigger)/"
+      "path": "^apps/api/src/modules/(activity-registry|channel|flow-engine|human-tool|interaction|loop-engine|memory|message|minute|process|release|report|skill-engine|task|trace|trigger)/"
+    }
+  },
+  {
+    "name": "tier-order-trace",
+    "comment": "模块 trace(L2)只准依赖更低层级模块;同层互需一律 port + app 装配(编码规范 §4 / §5.2)",
+    "severity": "error",
+    "from": {
+      "path": "^apps/api/src/modules/trace/"
+    },
+    "to": {
+      "path": "^apps/api/src/modules/(activity-registry|channel|flow-engine|human-tool|interaction|loop-engine|memory|message|minute|process|release|report|skill-engine|task|toolbox|trigger)/"
    }
  },
  {
@@ -231,7 +242,7 @@ module.exports = [
    "from": {},
    "to": {
      "path": "^apps/api/src/modules/([^/]+)/",
-      "pathNot": "^apps/api/src/modules/(activity-registry|channel|event|flow-engine|human-tool|interaction|ledger|llm|loop-engine|memory|message|minute|org|process|release|report|skill-engine|task|toolbox|trigger)/"
+      "pathNot": "^apps/api/src/modules/(activity-registry|channel|event|flow-engine|human-tool|interaction|ledger|llm|loop-engine|memory|message|minute|org|process|release|report|skill-engine|task|toolbox|trace|trigger)/"
    }
  }
 ];
@@ -1,13 +1,42 @@
 {
  "$comment": "编码规范 §4 后端模块层级表的机器形式。改层级 = 改本文件 + 改 编码规范.md §4,一起提交(§11.4)。",
  "tiers": {
-    "1": ["event", "org", "llm", "ledger"],
-    "2": ["memory", "toolbox", "channel", "message"],
-    "3": ["interaction", "human-tool"],
-    "4": ["release", "activity-registry", "skill-engine"],
-    "5": ["loop-engine", "flow-engine"],
-    "6": ["task"],
-    "7": ["process", "trigger"],
-    "8": ["minute", "report"]
+    "1": [
+      "event",
+      "org",
+      "llm",
+      "ledger"
+    ],
+    "2": [
+      "memory",
+      "toolbox",
+      "channel",
+      "message",
+      "trace"
+    ],
+    "3": [
+      "interaction",
+      "human-tool"
+    ],
+    "4": [
+      "release",
+      "activity-registry",
+      "skill-engine"
+    ],
+    "5": [
+      "loop-engine",
+      "flow-engine"
+    ],
+    "6": [
+      "task"
+    ],
+    "7": [
+      "process",
+      "trigger"
+    ],
+    "8": [
+      "minute",
+      "report"
+    ]
  }
 }