M6(2/n): 治理台九功能 + SSE 订阅层 + 读/治分权

治理台按 §9.1 拆成九个 gov-* feature,共用件落 shared/gov:
  · 外壳(左轨/顶栏/面包屑/页签/整页下钻)自原型 Governance.tsx 平移,
    DOM 与 g-* 类名原样;路由状态即应用状态,区/页签/下钻栈全编码进 hash 可深链
  · 编排画布 diagram-js 画布件 1:1 平移(flow-layout/flow-node-paint/FlowDiagram),
    新增 pkg-to-graph 把 ProcessPackage 转成画布图模型;统一报价 v1 全图 12 节点 15 边渲染通过
  · 后端补四路由:审批单 / 工作流下钻 / 通道实例 / 度量仪表

SSE 订阅层(§9.2):app 层单一连接,按信封目标失效缓存;
组件不再自行轮询(去掉 refetchInterval)。广播只说「哪个目标动了」,不带业务载荷,
且在投递已落库已送达之后才发 —— 不是第二条投递链路。

两处实质修正:
  · 治理路由一律要 govern → 读路由改要 read。客体三类 × 动作三种的分法就是为此:
    BD 有 task:read 能看在途、动不了控制事件;一律 govern 等于把三种动作压成一种
  · 控制事件/恢复/改派原记为 engine-transition(归机器产出)→ 新增 control 条目种类,
    归人裁决侧。归侧是按动作类型的纯推导,所以「谁干的」必须体现在 kind 上;
    否则人的叫停会被算进自主率的机器分子

判据 ⑩ 治理台一半跑通:在途监控 / 叫停 / 恢复,治理动作留痕可查。
无权查看不再画成空清单,按岗位说明缺哪一项。

gates: tsc / eslint / depcruise(286 模块)/ api-report / 360 测试 全绿

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01KeDBx2PHLavbURXB8LJJ7m
This commit is contained in:
2026-07-27 03:28:40 +08:00
co-authored by Claude Opus 5
parent 594a0a9ca0
commit a9cd6d10c7
47 changed files with 7272 additions and 11 deletions
+48
View File
@@ -0,0 +1,48 @@
/**
* SSE 订阅层 —— apps/web 唯一一条服务端推送连接(编码规范 §9.2)。
*
* 「SSE 事件到达 → **按信封目标**失效对应 TanStack Query 缓存,由订阅层统一做;
* 组件禁止自行轮询或手写缓存。」
*
* 推送不带业务载荷:它只说「哪个目标动了」,画面照旧由服务端投影重建 —— 前端零过程状态。
* 断线由 `EventSource` 自行重连;重连后整体失效一次,补上断线期间错过的变更。
*/
import type { QueryClient } from '@tanstack/react-query';
type Touch = { kind: 'task' | 'workflow' | 'staff' | 'system'; id: string; reason: string };
export function connectStream(queryClient: QueryClient): () => void {
const source = new EventSource('/api/stream');
source.addEventListener('touch', (event) => {
const touch = JSON.parse((event as MessageEvent<string>).data) as Touch;
switch (touch.kind) {
case 'task':
// 工作台三处 + 治理台任务面都以任务为轴,一起失效
void queryClient.invalidateQueries({ queryKey: ['task', touch.id] });
void queryClient.invalidateQueries({ queryKey: ['tasks'] });
void queryClient.invalidateQueries({ queryKey: ['gov', 'tasks'] });
void queryClient.invalidateQueries({ queryKey: ['gov', 'tasklog', touch.id] });
break;
case 'workflow':
void queryClient.invalidateQueries({ queryKey: ['gov', 'workflow', touch.id] });
void queryClient.invalidateQueries({ queryKey: ['gov', 'tasks'] });
void queryClient.invalidateQueries({ queryKey: ['gov', 'approvals'] });
break;
case 'staff':
void queryClient.invalidateQueries({ queryKey: ['messages'] });
void queryClient.invalidateQueries({ queryKey: ['gov', 'staff'] });
break;
case 'system':
void queryClient.invalidateQueries({ queryKey: ['gov'] });
break;
}
});
// 重连即补课:断线期间的推送收不到,回来先整体失效一次
source.addEventListener('open', () => {
void queryClient.invalidateQueries();
});
return () => source.close();
}