三面拆分⑬:触发确认链路 + 运营中心「工作流」区 —— 设计只管设计,运营管细节

**触发确认链路**(用户口述五步的第 4/5 步):
  接收邮件 → 分类识别 → 命中 RFQ 事件 → ④(可选,运营勾)系统消息到指定人
  工作台(带邮件内容)→ ⑤ 工作台点「确认起单」,流程才起。
  · 命中不等于必起:勾了「需人工确认」,装配好的入参存成待确认单
    (sys.trigger_pending,migration 0019),ConfirmDesk 端口把带来件内容的
    系统消息送指定人(eventRef 挂票号,消息列表就地贴确认状态与那枚钮)。
  · 先认领后起单:consumed_at 空才认得到 —— 两人同时点、一人点两次,都只起一条流;
    起单失败退回认领,不留死票。确认人记进 source.by,留痕可查。
  · 登记触发不走确认(登记那一下本身就是人在确认);勾了没指定人 = 配置错误入死信。
  · 4 条单测 + 全链实测:投信 → triggersHit=1 且零直起 → AI 工作台收到确认消息
    → 确认起单 → 二次确认幂等回同一流号 → source.by = AI。

**运营中心重排**(区名即运行时:工作流是流程包的运行时,任务是活动的运行时):
  · 新「工作流」区:在途看板(从任务区迁入)+ 运行配置 —— 每包的触发器
    起单开关 / 确认打勾 / 确认人,和节点负责人(sys.node_owner)。
  · 负责人三层:显式指派 > 运营配置 > 轮值 —— 合并点在 process.start,
    复用既有派发链一行不改。
  · 任务区瘦身成活动运行时(任务/审批/需处置);知识库区改名「数据」
    (与设计中心的知识库解开同名);系统区只剩通道实例。
  · 设计中心触发器详情页摘掉启停按钮 —— 设计只管设计,启停/确认全在运营。
  · 旧深链有改嫁:tasks/board → runs/board,tasks/trg → runs/conf。

reset-runs 补 sys.trigger_pending(待确认单是运行痕 —— 和上回漏 trace_span 同类洞)。
邮件分类 Agent(第 ② 步)现由抽键正则 + S-FEEL 代位,升级路径记进 debt.md。
产品设计.md 运营章、trigger/process 两份 CONTRACT.md 同步。

五闸绿;契约快照随本提交入库。

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-29 13:09:16 +08:00
co-authored by Claude Opus 5
parent 70b261d067
commit f9b2c07731
45 changed files with 1176 additions and 115 deletions
+5
View File
@@ -0,0 +1,5 @@
/**
* feature `gov-runs` —— 运营中心 · 工作流:**流程包的运行时**。
* 在途实例的监控,和每个包的运行配置(起单开关 / 人工确认 / 节点负责人)。
*/
export { RunsHome } from './internal/panel.tsx';
@@ -0,0 +1,211 @@
/**
* 运营中心 · 工作流 —— **流程包的运行时**(设计中心只负责设计,运营中心管细节)。
*
* 两页签:
* · 在途:工作流看板(从任务区迁入 —— 工作流一级归这儿,任务区只留活动一级);
* · 运行配置:每个包**今天怎么跑**的细节,设计一个字不碰 ——
* 触发器:起单开关 / 命中后要不要人工确认 / 谁来确认(触发确认链路第 4 步的配置面)
* 节点负责人:流程包的哪个节点归谁 —— 显式指派 > 这里 > 轮值
*/
import { useQuery, useQueryClient, useMutation } from '@tanstack/react-query';
import type { TriggerConfig } from '@contracts';
import {
listNodeOwnersRoute,
setNodeOwnerRoute,
setTriggerConfirmRoute,
toggleTriggerRoute,
} from '@contracts';
import { call } from '@web-shared/typed-fetch.ts';
import { Ico } from '@web-shared/Ico.tsx';
import { Card, Chip, Clear, QueryGate, St } from '@web-shared/gov/primitives.tsx';
import type { Nav } from '@web-shared/gov/gov-route.ts';
import { useGovPackages, useGovStaff, useGovTriggers } from '@web-shared/gov/gov-api.ts';
import { WorkflowBoard } from '@features/gov-task';
export function RunsHome({ tab, nav }: { tab: string; nav: Nav }) {
if (tab === 'conf') return <RunConfig />;
return <WorkflowBoard nav={nav} />;
}
/** 治理写动作统一入口:成功即失效相关查询,画面由服务端重投影 */
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] });
},
});
}
/* ==================== 运行配置:一包一节 ==================== */
function RunConfig() {
const pkgQ = useGovPackages();
const trgQ = useGovTriggers();
const staffQ = useGovStaff();
const packages = (pkgQ.data?.packages ?? []).filter((p) => p.state === 'active');
const triggers = trgQ.data?.triggers ?? [];
const staff = (staffQ.data?.staff ?? []).filter((s) => s.state === 'active');
return (
<QueryGate query={pkgQ}>
{packages.length === 0 ? (
<Clear>没有生效的流程包 —— 设计中心激活一版,这里就有它的运行配置。</Clear>
) : (
<>
{packages.map((p) => (
<PackageConfig
key={p.id}
packageId={p.id}
name={p.name}
nodes={p.nodes
.filter((n) => n.kind === 'activity' || n.kind === 'approval')
.map((n) => ({ id: n.id, label: n.label, kind: n.kind }))}
triggers={triggers.filter((t) => t.processPackageId === p.id)}
staff={staff.map((s) => ({ id: s.id, name: s.name, code: s.position.code }))}
/>
))}
</>
)}
</QueryGate>
);
}
type StaffOpt = { id: string; name: string; code: string };
function PackageConfig({
packageId,
name,
nodes,
triggers,
staff,
}: {
packageId: string;
name: string;
nodes: ReadonlyArray<{ id: string; label: string; kind: string }>;
triggers: readonly TriggerConfig[];
staff: readonly StaffOpt[];
}) {
const ownersQ = useQuery({
queryKey: ['gov', 'node-owners', packageId],
queryFn: () => call<{ owners: Array<{ nodeId: string; staffId: string }> }>(listNodeOwnersRoute, { params: { id: packageId } }),
});
const owners = new Map((ownersQ.data?.owners ?? []).map((o) => [o.nodeId, o.staffId]));
const toggle = useGovAction(
(input: { id: string; enabled: boolean }) =>
call(toggleTriggerRoute, { params: { id: input.id }, body: { enabled: input.enabled } }),
['triggers'],
);
const confirm = useGovAction(
(input: { id: string; required: boolean; staffId?: string }) =>
call(setTriggerConfirmRoute, {
params: { id: input.id },
body: { required: input.required, ...(input.staffId === undefined ? {} : { staffId: input.staffId }) },
}),
['triggers'],
);
const setOwner = useGovAction(
(input: { nodeId: string; staffId: string | null }) =>
call(setNodeOwnerRoute, { params: { id: packageId, nodeId: input.nodeId }, body: { staffId: input.staffId } }),
['node-owners'],
);
return (
<Card ico="workflow" title={name} extra={<span className="g-mono">{packageId}</span>}>
{/* ── 触发器的运营面:开不开 · 要不要人点头 · 谁点头 —— 规则本身在设计中心改 ── */}
<div className="g-runconf">
<div className="g-runconf-h">
<Ico name="zap" s={11} />
触发器 —— 起单开关与人工确认
</div>
{triggers.length === 0 ? (
<p className="g-runconf-none">这个包还没有调起规则 —— 去设计中心 · 触发器配一条。</p>
) : (
triggers.map((t) => {
const confirmed = t.confirm.required;
return (
<div key={t.id} className="g-runconf-r">
<St tone={t.enabled ? 'ok' : 'mute'} ico="zap">
{t.name}
</St>
<label className="g-runconf-k">
<input
type="checkbox"
checked={t.enabled}
onChange={(e) => toggle.mutate({ id: t.id, enabled: e.target.checked })}
/>
起单
</label>
<label className="g-runconf-k" title="勾了:命中后先发系统消息到指定人工作台,他点「确认起单」流程才起">
<input
type="checkbox"
checked={confirmed}
onChange={(e) =>
confirm.mutate({
id: t.id,
required: e.target.checked,
// 勾上时没选过人就先落到第一位 —— 服务端要求勾必有人,界面不递交半份配置
...(e.target.checked && (t.confirm.staffId ?? staff[0]?.id) !== undefined
? { staffId: t.confirm.staffId ?? staff[0]!.id }
: {}),
})
}
/>
命中后须人工确认
</label>
<select
className="g-select"
aria-label={`${t.name} 的确认人`}
disabled={!confirmed}
value={t.confirm.staffId ?? ''}
onChange={(e) => confirm.mutate({ id: t.id, required: true, staffId: e.target.value })}
>
<option value="" disabled>
确认人…
</option>
{staff.map((s) => (
<option key={s.id} value={s.id}>
{s.name} · {s.code}
</option>
))}
</select>
{confirmed && t.confirm.staffId === undefined && <Chip tone="warn">还没指定确认人</Chip>}
</div>
);
})
)}
</div>
{/* ── 节点负责人:显式指派 > 这里 > 轮值 ── */}
<div className="g-runconf">
<div className="g-runconf-h">
<Ico name="user-check" s={11} />
节点负责人 —— 留空即轮值(有员工组按组轮,没有按全员最闲者先)
</div>
<div className="g-runconf-own">
{nodes.map((n) => (
<label key={n.id} className="g-runconf-node">
<span className="nid">{n.id}</span>
<span className="lb">{n.label}</span>
{n.kind === 'approval' && <Chip tone="warn">审批</Chip>}
<select
className="g-select"
value={owners.get(n.id) ?? ''}
onChange={(e) => setOwner.mutate({ nodeId: n.id, staffId: e.target.value === '' ? null : e.target.value })}
>
<option value="">轮值</option>
{staff.map((s) => (
<option key={s.id} value={s.id}>
{s.name} · {s.code}
</option>
))}
</select>
</label>
))}
</div>
</div>
</Card>
);
}