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
@@ -0,0 +1,138 @@
/**
* feature `gov-trigger` —— 触发器配置(周期 / 事件 / 登记三类):与流程包平级,启停不改任何版本
*
* 自 `~/coding/JCAI_PRD/governance/_components/Governance.tsx` 平移:
* DOM 结构、类名(`g-*` + 色调 `t-*`)与文案原样保留,mock 常量换成服务端投影(README 平移规则 1/2/4)。
* 区首页只负责导航,治理动作一律落在下钻详情页的**就地确认带**(影响预览三必答)。
*/
import { useMutation, useQueryClient } from '@tanstack/react-query';
import {
TRIGGER_KIND_LABEL,
toggleTriggerRoute,
triggerKindOf,
} from '@contracts';
import { call } from '@web-shared/typed-fetch.ts';
import { Card, Chip, NList, NRow, Note, PageHead, QueryGate, Rows, St } from '@web-shared/gov/primitives.tsx';
import type { Nav } from '@web-shared/gov/gov-route.ts';
import {
useGovTriggers,
} from '@web-shared/gov/gov-api.ts';
export type HomeProps = { tab: string; nav: Nav };
export function TriggersHome({ nav }: HomeProps) {
const q = useGovTriggers();
const triggers = q.data?.triggers ?? [];
return (
<QueryGate query={q}>
<>
<Note>
触发器与流程包<b>平级</b>——不入包结构、不随包版本,增删启停不改任何版本。周期 / 事件 / 登记三类。
</Note>
<NList>
{triggers.map((t) => {
const kind = triggerKindOf(t.spec);
return (
<NRow
key={t.id}
tone={t.enabled ? 'brand' : 'mute'}
ico="zap"
title={t.name}
sub={`调起 ${t.processPackageId} · ${t.mapping.length} 条起单映射`}
cols={[{ k: '类别', v: <Chip tone="brand">{TRIGGER_KIND_LABEL[kind]}</Chip> }]}
right={
<St tone={t.enabled ? 'ok' : 'mute'} ico={t.enabled ? 'circle-check' : 'power'}>
{t.enabled ? '已启用' : '已停用'}
</St>
}
onClick={() => nav.push({ k: 'trigger', id: t.id })}
/>
);
})}
</NList>
</>
</QueryGate>
);
}
/* ---------------- ⑤ 活动库管理 ---------------- */
/** 治理写动作统一入口:成功即失效相关查询,画面由服务端重投影 */
function useGovAction<TInput>(mutate: (input: TInput) => Promise<unknown>, keys: readonly string[]) {
const queryClient = useQueryClient();
return useMutation({
mutationFn: mutate,
onSuccess: () => {
for (const key of keys) void queryClient.invalidateQueries({ queryKey: ['gov', key] });
},
});
}
/* ---------------- 工作流 ---------------- */
export function TriggerPage({ id }: { id: string }) {
const q = useGovTriggers();
const t = (q.data?.triggers ?? []).find((x) => x.id === id);
const toggle = useGovAction(
(enabled: boolean) => call(toggleTriggerRoute, { params: { id }, body: { enabled } }),
['triggers'],
);
if (t === undefined) return <Note>触发器不存在。</Note>;
return (
<>
<PageHead
ico="zap"
tone={t.enabled ? 'brand' : 'mute'}
kicker={`触发器 · ${t.id}`}
title={t.name}
chips={
<>
<Chip tone="brand">{TRIGGER_KIND_LABEL[triggerKindOf(t.spec)]}</Chip>
<Chip ico="boxes">调起 {t.processPackageId}</Chip>
</>
}
desc="触发器与流程包平级——不入包结构、不随包版本,增删启停不改任何版本。"
acts={[
{
label: t.enabled ? '停用' : '启用',
ico: 'power',
danger: t.enabled,
ask: {
title: `${t.enabled ? '停用' : '启用'}触发器:${t.name}`,
note: <Note>启停不改任何版本;已起的单不受影响。</Note>,
impact: {
who: t.enabled ? '此后不再自动起单,已在途工作流不受影响' : '此后按规则自动起单',
undo: '可随时反向切换',
when: '确认后即时',
},
okLabel: t.enabled ? '确认停用' : '确认启用',
onOk: () => toggle.mutate(!t.enabled),
},
},
]}
/>
<Card ico="settings" title="起单规则">
<Rows
items={[
{ k: '类别', v: TRIGGER_KIND_LABEL[triggerKindOf(t.spec)] },
{ k: '规格', v: JSON.stringify(t.spec), mono: true },
{ k: '流程包', v: t.processPackageId, mono: true },
]}
/>
</Card>
<Card ico="arrow-left-right" title="起单映射" extra={<span className="g-mono">{t.mapping.length}</span>}>
<div className="g-rows">
{t.mapping.map((m, i) => (
<div key={i}>
<em>{m.target}</em>
<b className="mono">{JSON.stringify(m.source)}</b>
</div>
))}
</div>
</Card>
</>
);
}
/* ---------------- 活动 / 工具 ---------------- */