Archived
用户要的是运行时机制:新建 + 编辑,存下去就生效,旧任务走完旧版本, 新任务调用时才加载新编排。所以「草稿 → 发布」两态整套去掉。 ## 闸从「发布」挪到「保存」 `savePackage` 现在先跑闭合校验,不闭合抛 `NotClosedError`(路由 412 带报告)—— **一个字节都不落库**。存进来的每一版都能起单,所以不需要「已发布」这个标记。 `publish` 用例、路由、`publishPackage` 存储方法一并删掉。 实测:把进 A6 的边映射清空后保存 → 412,逐条点名「边 e-g3-a6 未完成载荷映射; 节点「报价议价」的必填字段未映射:rows」。 ## 保存恒新增版本号,服务端说了算 这不是可选项,是「旧任务走完旧版本」的前提:工作流按 (包id, 版本) 去读定义, 就地覆盖 v1 就等于改掉所有在途 v1 任务正在读的编排 —— 它们会中途换了规则却毫不知情。 版本号由用例层算(当前最大 + 1),**不采信入参**。实测:入参故意填 version: 999, 落的是 v2。store 层因此改成**只插不改**:撞键宁可让唯一约束报错,也不静默覆盖。 起单取版从「最新已发布」改为「最新一版」(retired 除外);触发器的 requiredInputs 同口径。 实测:改完描述存成 v2 后,新起的单用 v2,早先那单仍挂 v1。 ## 迁移:旧状态值不归一就是一读就炸 状态枚举从 draft/published/retired 收成 active/retired。列上和 definition 这个 jsonb 里 各存着一份 state,两处都要改 —— 不改,`processPackageSchema.parse` 读一行就抛。 这不是开发期小麻烦,任何已部署实例都会中招。加了迁移 0012。 ## 界面:恒为 0 的假指标撤掉,不换个说法留着 - 编排面板:「已发布/草稿」芯片 → 「生效中/历史版本」(真正的区别是哪一版会被新起单取到); 发布按钮撤掉,保存按钮改成「保存并生效(存为 vN)」并在确认卡里说清影响面 - 历史版本只读,但就地指路:「去 v(N-1) 改(生效中)」,不让人自己找 - 蓝图面:「草稿 N · 未闭合 M」两个计数在新机制下**结构上恒为 0**(不闭合存不进来), 换成「共 N 个版本,保存即生效」 - 驾驶舱:「未闭合草稿」卡整张撤掉 —— 同理恒为 0。天然的第三张是「死路」 (route-dead-end 事件),但那需要一条按事件类型聚合的路由,没有之前不摆(同死信卡的规矩) ## 顺手修:种子的幂等判断本来是坏的 比对用 `JSON.stringify` 认键序,而 jsonb 从 PG 读回来键是重排过的 —— 永远判不等, 每播一次种就多存一版一模一样的定义(实测一口气堆到 v3)。改成递归按键名排序后比对。 连播三次,只第一次存。 ## 契约变更(破坏性,一步到位) `publish` 删除、`NotPublishableError` → `NotClosedError`、`publishable` → `closed`、 状态枚举收窄。按规矩破坏性变更该走三步弃用 —— 这里一步改完,因为: ① depcruise 反查下游全在仓内(374 模块无违规),同批改完; ② 要弃用的是一个**产品决定不再存在**的机制,留弃用窗口没有意义。 CONTRACT.md 已同步,快照单独说明。 typecheck ✓ lint ✓ depcruise 374 模块 ✓ 495 测试 ✓ Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01KeDBx2PHLavbURXB8LJJ7m
157 lines
6.4 KiB
TypeScript
157 lines
6.4 KiB
TypeScript
/**
|
|
* feature `gov-blueprint` —— 设计中心首页:企业蓝图。
|
|
*
|
|
* 一屏回答两个问题:**这家企业被定义成什么样**,**哪里还没定义完**。
|
|
*
|
|
* 因果链:流程包(战略)→ 活动库(方法)→ 工具箱(能力)→ 数据域(对象)。
|
|
* 四库各自有页,但「为什么是这四库、它们怎么相互决定」得有一屏能讲 —— 就是这一屏。
|
|
*
|
|
* 这里**不出现任何运行态数字**(在跑几单、30 天起单数、死信数)。
|
|
* 设计者看的是定义完不完整,不是今天忙不忙 —— 混进运行数字,这页就退化成第二个驾驶舱。
|
|
*/
|
|
import { Ico } from '@web-shared/Ico.tsx';
|
|
import { Clear, Sec, Todo } from '@web-shared/gov/primitives.tsx';
|
|
import type { Nav } from '@web-shared/gov/gov-route.ts';
|
|
import {
|
|
useGovActivities,
|
|
useGovObjects,
|
|
useGovPackages,
|
|
useGovTools,
|
|
useGovTriggers,
|
|
} from '@web-shared/gov/gov-api.ts';
|
|
|
|
export type HomeProps = { tab: string; nav: Nav };
|
|
|
|
export function BlueprintHome({ nav }: HomeProps) {
|
|
const pkgs = useGovPackages();
|
|
const acts = useGovActivities();
|
|
const tools = useGovTools();
|
|
const objs = useGovObjects();
|
|
const trgs = useGovTriggers();
|
|
|
|
const packages = pkgs.data?.packages ?? [];
|
|
|
|
/*
|
|
* 没有「草稿」也没有「未闭合」可数了 —— 严格检查 + 保存即生效:不闭合的包**存不进来**。
|
|
* 硬摆这两个计数就是摆两个恒为 0 的假指标。改数真能说话的:每条流有几版、最新是第几版。
|
|
*/
|
|
const flowCount = new Set(packages.map((p) => p.id)).size;
|
|
const activities = acts.data?.activities ?? [];
|
|
const toolRows = tools.data?.tools ?? [];
|
|
const objectRows = objs.data?.objects ?? [];
|
|
const domains = [...new Set(objectRows.map((o) => o.domain))];
|
|
const triggers = trgs.data?.triggers ?? [];
|
|
|
|
/** 编排里引用了、但活动库装不出来的活动 —— 图画得通,活儿没人干 */
|
|
const referenced = [
|
|
...new Set(
|
|
packages.flatMap((p) =>
|
|
p.nodes.flatMap((n) => (n.kind === 'activity' && n.activityId !== undefined ? [n.activityId] : [])),
|
|
),
|
|
),
|
|
];
|
|
const missingActivities = referenced.filter((id) => !activities.some((a) => a.activityId === id));
|
|
|
|
/** 没有任何触发器指向的流程包 —— 定义完整,但没人调得起来 */
|
|
const uncalled = [...new Set(packages.map((p) => p.id))].filter(
|
|
(id) => !triggers.some((t) => t.processPackageId === id),
|
|
);
|
|
|
|
const gaps = missingActivities.length + uncalled.length;
|
|
|
|
// 因果链是这一屏的主角:四库以真箭头相连 —— 箭头编码的是真实依赖
|
|
// (流程包引用活动、活动调工具、活动物化数据),节点卡即入口,点卡即入库。
|
|
return (
|
|
<>
|
|
<div className="g-chain">
|
|
<button className="g-chain-node t-brand" onClick={() => nav.jump('workflows', 'pkgs')}>
|
|
<span className="g-chain-k">
|
|
<span className="ic">
|
|
<Ico name="workflow" s={13} />
|
|
</span>
|
|
战略 · 流程包
|
|
</span>
|
|
<span className="g-chain-v">{flowCount}</span>
|
|
<span className="g-chain-h">
|
|
企业以哪些流转运转 —— 共 {packages.length} 个版本,保存即生效
|
|
</span>
|
|
</button>
|
|
<span className="g-chain-arr">
|
|
<Ico name="chevron-right" s={15} />
|
|
</span>
|
|
<button className="g-chain-node t-auto" onClick={() => nav.jump('library', 'shelf')}>
|
|
<span className="g-chain-k">
|
|
<span className="ic">
|
|
<Ico name="boxes" s={13} />
|
|
</span>
|
|
方法 · 活动库
|
|
</span>
|
|
<span className="g-chain-v">{activities.length}</span>
|
|
<span className="g-chain-h">每件事怎么干 —— 一个活动 = 一个任务的定义</span>
|
|
</button>
|
|
<span className="g-chain-arr">
|
|
<Ico name="chevron-right" s={15} />
|
|
</span>
|
|
<button className="g-chain-node t-collab" onClick={() => nav.jump('tools', 'catalog')}>
|
|
<span className="g-chain-k">
|
|
<span className="ic">
|
|
<Ico name="wrench" s={13} />
|
|
</span>
|
|
能力 · 工具箱
|
|
</span>
|
|
<span className="g-chain-v">{toolRows.length}</span>
|
|
<span className="g-chain-h">
|
|
系统能对世界做什么 —— 读类 {toolRows.filter((t) => t.effect === 'read').length} · 写类{' '}
|
|
{toolRows.filter((t) => t.effect === 'write').length}
|
|
</span>
|
|
</button>
|
|
<span className="g-chain-arr">
|
|
<Ico name="chevron-right" s={15} />
|
|
</span>
|
|
<button className="g-chain-node t-ok" onClick={() => nav.jump('data', 'domains')}>
|
|
<span className="g-chain-k">
|
|
<span className="ic">
|
|
<Ico name="database" s={13} />
|
|
</span>
|
|
对象 · 数据域
|
|
</span>
|
|
<span className="g-chain-v">{domains.length}</span>
|
|
<span className="g-chain-h">
|
|
企业运营什么 —— {objectRows.length} 个对象,发布即入运营台账
|
|
</span>
|
|
</button>
|
|
</div>
|
|
|
|
<Sec ico="flag" title="待补清单" extra="定义上的缺口聚在这里,点进即改 —— 不散落在四库">
|
|
{gaps === 0 ? (
|
|
<Clear>没有缺口 —— 引用的活动都装好了,每条流也都有触发器调得起来。</Clear>
|
|
) : (
|
|
<div className="g-todo">
|
|
{missingActivities.map((id) => (
|
|
<Todo
|
|
key={`miss-${id}`}
|
|
tone="danger"
|
|
ico="boxes"
|
|
title={`编排引用了未安装的活动:${id}`}
|
|
desc="图上画得通,运行时长不出任务 —— 去活动库把它装上,或在编排里换一个已装的活动。"
|
|
acts={[{ label: '去活动库', ico: 'boxes', onClick: () => nav.jump('library', 'shelf') }]}
|
|
/>
|
|
))}
|
|
{uncalled.map((id) => (
|
|
<Todo
|
|
key={`uncalled-${id}`}
|
|
tone="warn"
|
|
ico="zap"
|
|
title={`${packages.find((p) => p.id === id)?.name ?? id} 没有任何调起规则`}
|
|
desc="流程定义完整,但没人调得起来 —— 给它配一条周期 / 事件 / 登记触发器。"
|
|
acts={[{ label: '去配规则', ico: 'zap', onClick: () => nav.jump('workflows', 'rules') }]}
|
|
/>
|
|
))}
|
|
</div>
|
|
)}
|
|
</Sec>
|
|
|
|
</>
|
|
);
|
|
}
|