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
+5
View File
@@ -0,0 +1,5 @@
/**
* feature `gov-tool` 唯一出口(编码规范 §9.1)。
* 工具管理:注册、白名单、凭证绑定(只回键,永不回值)
*/
export { ToolsHome, ToolPage } from './internal/panel.tsx';
@@ -0,0 +1,109 @@
/**
* feature `gov-tool` —— 工具管理:注册、白名单、凭证绑定(只回键,永不回值)
*
* 自 `~/coding/JCAI_PRD/governance/_components/Governance.tsx` 平移:
* DOM 结构、类名(`g-*` + 色调 `t-*`)与文案原样保留,mock 常量换成服务端投影(README 平移规则 1/2/4)。
* 区首页只负责导航,治理动作一律落在下钻详情页的**就地确认带**(影响预览三必答)。
*/
import { Ico } from '@web-shared/Ico.tsx';
import { Card, Chip, Clear, NList, NRow, Note, PageHead, QueryGate } from '@web-shared/gov/primitives.tsx';
import type { Nav } from '@web-shared/gov/gov-route.ts';
import {
useGovTools,
} from '@web-shared/gov/gov-api.ts';
export type HomeProps = { tab: string; nav: Nav };
export function ToolsHome({ nav }: HomeProps) {
const q = useGovTools();
const tools = q.data?.tools ?? [];
const reads = tools.filter((t) => t.effect === 'read');
const writes = tools.filter((t) => t.effect === 'write');
return (
<QueryGate query={q}>
<>
<Note>
按<b>效应等级</b>分列:读类过程中自由调用;写类只登记<b>动作意向</b>,放行后统一落地。密钥只存治理台,不入包、不入活动。
</Note>
{[
{ label: '读类 · 过程中自由调用', items: reads, tone: 'brand', ico: 'search' },
{ label: '写类 · 登记意向,放行后落地', items: writes, tone: 'danger', ico: 'pen-line' },
].map((group) => (
<div key={group.label} className="g-sec">
<div className="g-band">
<Ico name={group.ico} s={13} />
{group.label}
<span className="x">{group.items.length}</span>
</div>
<NList>
{group.items.map((t) => (
<NRow
key={t.name}
tone={group.tone}
ico="wrench"
title={t.name}
sub={t.description}
cols={[
{ k: '版本', v: <span className="g-mono">{t.version}</span> },
{ k: '连接配置键', v: <span className="g-mono">{t.connectionKeys.join(', ') || '—'}</span> },
]}
right={t.pure ? <Chip tone="ok">纯工具</Chip> : <Chip tone={group.tone}>{t.effect === 'read' ? '读' : '写'}</Chip>}
onClick={() => nav.push({ k: 'tool', id: t.name })}
/>
))}
</NList>
</div>
))}
</>
</QueryGate>
);
}
/* ---------------- ⑦ 数据管理 ---------------- */
export function ToolPage({ id }: { id: string }) {
const q = useGovTools();
const t = (q.data?.tools ?? []).find((x) => x.name === id);
if (t === undefined) return <Note>工具不存在。</Note>;
const write = t.effect === 'write';
return (
<>
<PageHead
ico="wrench"
tone={write ? 'danger' : 'brand'}
kicker={`工具 · ${t.name}`}
title={t.name}
chips={
<>
<Chip tone={write ? 'danger' : 'brand'}>{write ? '写类' : '读类'}</Chip>
{t.pure && <Chip tone="ok">纯工具</Chip>}
<Chip ico="hash">v{t.version}</Chip>
</>
}
desc={
write
? '写类工具在过程中只登记动作意向,不改世界;放行通过后由落地收敛统一执行。'
: '读类工具过程中自由调用 —— 读不改世界,故不需放行。'
}
/>
<Card ico="info" title="说明">
<p className="g-desc">{t.description}</p>
</Card>
<Card ico="shield-check" title="连接配置">
<Note>凭证隔离:治理台只回<b>配置键</b>,永不回值;密钥不入包、不入活动、不入留痕明文。</Note>
<div className="g-rows">
{t.connectionKeys.map((k) => (
<div key={k}>
<em>{k}</em>
<b className="mono">已在治理台绑定</b>
</div>
))}
{t.connectionKeys.length === 0 && <Clear>此工具无需外部连接。</Clear>}
</div>
</Card>
</>
);
}
/* ---------------- 数据对象 ---------------- */