From 27d2fe6bb4e8bdaab7647d9f63570b301c0798ce Mon Sep 17 00:00:00 2001 From: shanqin <45168502@qq.com> Date: Thu, 27 Aug 2026 15:04:18 +0800 Subject: [PATCH] =?UTF-8?q?=E8=BF=9B=E5=BA=A6=E6=9A=82=E5=AD=98:=E5=90=AF?= =?UTF-8?q?=E5=8A=A8=E6=8A=BD=E5=B1=89=E5=8A=A0=E5=9B=BA=E5=AE=9A=E5=8F=82?= =?UTF-8?q?=E6=95=B0=E3=80=8C=E8=B4=A3=E4=BB=BB=E4=BA=BA=E3=80=8D(?= =?UTF-8?q?=E5=90=8D=E5=86=8C=E4=B8=8B=E6=8B=89=E3=80=81=E9=BB=98=E8=AE=A4?= =?UTF-8?q?=E5=BD=93=E5=89=8D=E7=99=BB=E5=BD=95=E4=BA=BA);=E6=8E=A5?= =?UTF-8?q?=E5=8F=A3=E6=96=87=E6=A1=A3=20=C2=A75=20=E5=8A=A0=20ownerId=20?= =?UTF-8?q?=E5=9B=BA=E5=AE=9A=E5=AD=97=E6=AE=B5;=E9=9C=80=E6=B1=82?= =?UTF-8?q?=E6=96=87=E6=A1=A3=E8=AE=B0=202026-08-27=20=E4=B8=A4=E6=9D=A1?= =?UTF-8?q?=E5=86=B3=E7=AD=96?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- .../src/features/gov-task/internal/panel.tsx | 49 ++++++++++++++++--- docs/API文档-活动模块.md | 7 ++- docs/活动模块重构需求-2026-08-25.md | 1 + 3 files changed, 48 insertions(+), 9 deletions(-) diff --git a/apps/web/src/features/gov-task/internal/panel.tsx b/apps/web/src/features/gov-task/internal/panel.tsx index 22d77b0..83455b2 100644 --- a/apps/web/src/features/gov-task/internal/panel.tsx +++ b/apps/web/src/features/gov-task/internal/panel.tsx @@ -7,17 +7,18 @@ */ import { useEffect, useState } from 'react'; import { createPortal } from 'react-dom'; -import { useMutation, useQueryClient } from '@tanstack/react-query'; +import { useMutation, useQuery, useQueryClient } from '@tanstack/react-query'; import { CONTROL_SEMANTIC_LABEL, TASK_RUNTIME_STATE_LABEL, TERMINAL_STATE_LABEL, WORKFLOW_STATE_LABEL, controlTaskRoute, + meRoute, reassignTaskRoute, resumeTaskRoute, } from '@contracts'; -import type { ControlSemantic } from '@contracts'; +import type { ControlSemantic, Principal } from '@contracts'; import { Ico } from '@web-shared/Ico.tsx'; import { call } from '@web-shared/typed-fetch.ts'; import { Ava, Card, Chip, Clear, Entry, Facts, NList, NRow, Note, PageHead, Sec } from '@web-shared/gov/primitives.tsx'; @@ -27,6 +28,7 @@ import type { Nav } from '@web-shared/gov/gov-route.ts'; import { FlowFigure } from '@web-shared/gov/flow/FlowFigure.tsx'; import { atFull, atMinute } from '@web-shared/at.ts'; import { Btn } from '@web-shared/Btn.tsx'; +import { queryKeys } from '@web-shared/query-keys.ts'; import { useGovStaff, useGovTaskLog, useGovTasks, useGovWorkflow } from '@web-shared/gov/gov-api.ts'; export type HomeProps = { tab: string; nav: Nav }; @@ -447,8 +449,16 @@ function ComboInput({ p, value, onChange }: { p: LaunchParam; value: string; onC * 挂 body portal:详情页容器带入场动画 transform,fixed 抽屉不 portal 会被钉进卡片盒子里(2026-07-30 实测); * `gov-root` 类必须跟着挂:设计令牌定义在它上面,出了作用域面板背景会变透明。 */ -function LaunchDrawer({ name, spec, onCancel, onLaunch }: { name: string; spec: readonly LaunchParam[]; onCancel: () => void; onLaunch: (values: LaunchValues) => void }) { +function LaunchDrawer({ name, spec, onCancel, onLaunch }: { name: string; spec: readonly LaunchParam[]; onCancel: () => void; onLaunch: (values: LaunchValues, owner: { id: string; name: string }) => void }) { const [values, setValues] = useState(() => initLaunchValues(spec)); + /* 责任人(2026-08-27 用户定):**固定参数,每个活动都要**,不进按活动下发的参数表 —— + 候选 = 员工名册(GET /api/gov/staff,真接口),默认 = 当前登录人;只列在职的 */ + const staffQ = useGovStaff(); + const meQ = useQuery({ queryKey: queryKeys.me, queryFn: () => call(meRoute) }); + const staff = (staffQ.data?.staff ?? []).filter((s) => s.state === 'active'); + const meId = meQ.data?.staff.id; + const [pickedOwner, setPickedOwner] = useState(undefined); + const ownerId = pickedOwner ?? meId ?? ''; /* Esc 关抽屉 —— 抽屉盖住整屏,不给键盘出路是把人关在里面 */ useEffect(() => { const onKey = (e: KeyboardEvent) => { @@ -459,7 +469,7 @@ function LaunchDrawer({ name, spec, onCancel, onLaunch }: { name: string; spec: }, [onCancel]); const setVal = (key: string, v: string | string[]) => setValues((cur) => ({ ...cur, [key]: v })); - const invalid = spec.some((p) => p.required === true && !paramFilled(p, values[p.key] ?? '')); + const invalid = ownerId === '' || spec.some((p) => p.required === true && !paramFilled(p, values[p.key] ?? '')); return createPortal(
@@ -476,6 +486,25 @@ function LaunchDrawer({ name, spec, onCancel, onLaunch }: { name: string; spec:
+ {/* 固定参数(2026-08-27 用户定):责任人 —— 每个活动启动都要,与按活动下发的业务参数分开摆 */} +
+

固定参数

+ +

启动参数

{spec.map((p) => ( @@ -539,7 +568,11 @@ function LaunchDrawer({ name, spec, onCancel, onLaunch }: { name: string; spec: 取消 - onLaunch(values)}> + onLaunch(values, { id: ownerId, name: staff.find((s) => s.id === ownerId)?.name ?? '' })} + > 启动活动 @@ -619,16 +652,16 @@ export function ActvPage({ id, nav }: { id: string; nav: Nav }) { setPage(0); }; /** 启动提交(2026-08-27):启动接口未接 —— 先在清单头落一条「待执行」演示全链路; - 输入摘要取第一个填了值的参数,让人认得出这是刚启动的那条 */ + 输入摘要取第一个填了值的参数,让人认得出这是刚启动的那条;负责人 = 抽屉里选的责任人 */ const launchSpec = LAUNCH_PARAMS[a.id] ?? LAUNCH_PARAMS_FALLBACK; - const onLaunch = (values: LaunchValues): void => { + const onLaunch = (values: LaunchValues, owner: { id: string; name: string }): void => { const first = launchSpec.map((p) => values[p.key]).flat().find((v): v is string => typeof v === 'string' && v.trim() !== ''); setRows((cur) => [ { id: `INS-${2418 + launchN}`, input: `${(first ?? '手动启动').trim().slice(0, 24)} · ${launchSpec.length} 项参数`, state: '待执行' as InstanceState, - owner: a.owner, + owner: owner.name === '' ? a.owner : owner.name, startedAt: fmtMinute(Date.now()), output: '—', }, diff --git a/docs/API文档-活动模块.md b/docs/API文档-活动模块.md index 9ae0d51..cbad09e 100644 --- a/docs/API文档-活动模块.md +++ b/docs/API文档-活动模块.md @@ -203,6 +203,7 @@ iframe 带不了 Authorization 头,走票据(`GET /api/auth/ticket`,ADR-012 §6) ```json { "idempotencyKey": "01J9…", + "ownerId": "8f3c1a2b-6c1e-4b3a-9f0e-2d5c7a1b9e44", "params": { "customer_id": "cust-itelma", "request_description": "车身控制器询价 · 3 项物料,期望 9 月交期", @@ -212,6 +213,9 @@ iframe 带不了 Authorization 头,走票据(`GET /api/auth/ticket`,ADR-012 §6) } ``` +**`ownerId`(必填,2026-08-27 用户定)是启动契约的固定字段,不进 §4 参数表** —— 每个活动启动都要指定这次实例的**责任人**:负责人验收、存在性检查派出的数据工单都落到责任人身上。候选名单 = 既有 `GET /api/gov/staff`(前端只列 `state='active'` 的);前端默认填当前登录人,允许改。服务端要验:ownerId 是名册里在职的人(400),不验「是不是启动人自己」(代别人启动是合法场景)。 +启动成功后,实例视图(§3/§6)里的 `owner` 就是它。 + → 200 一条实例详情(同 §6)。**同一 `idempotencyKey` 重放返回第一次创建的实例,不起第二个**(前端每开一次抽屉生成一枚;重复点提交、网络重试都靠它挡住)。 `params` 的键值形状由 §4 参数表决定:`list` 回字符串数组,其余回字符串;`select` 回 `options` 里某个 `value`;**`combo` 回候选的 `value` 或新增的原样字符串,两种都合法**。 412:活动已禁用(先激活再启动)。400:缺必填 / 类型不符 / select 的值不在 options 里(**combo 不适用这条** —— 候选之外的值是合法新增)。 @@ -309,7 +313,7 @@ type LaunchParamType = 'text' | 'textarea' | 'select' | 'combo' | 'list'; type LaunchParam = { key: string; label: string; type: LaunchParamType; required?: boolean; desc?: string; placeholder?: string; options?: { value: string; label: string }[] /* select / combo 必填 */; default?: string | string[] }; type LaunchParams = { activityId: string; version: string; params: LaunchParam[] }; -type LaunchInput = { idempotencyKey: string; params: Record }; +type LaunchInput = { idempotencyKey: string; ownerId: string /* 责任人,固定字段,名册 staffId */; params: Record }; type InstanceFile = { index: number; name: string; contentType: string; size: number }; type InstanceReason = { kind: 'rejected' | 'failed' | 'terminated'; text: string }; @@ -331,6 +335,7 @@ type InstanceDetail = InstanceSummary & { activityId: string; llm: string; ended | 统计带由前端从全量数组数 | §3 `stats`(服务端给,分页下才数得准) | | `LAUNCH_PARAMS` 占位参数表 | §4;`options` 从纯字符串升级为 `{value,label}` 两段(渲染器小改);控件种类已含 `combo`(选择+新增,前端已实现) | | `onLaunch` 在清单头落假行 | §5;抽屉每开一次生成 `idempotencyKey`,提交走 mutation,成功失效 `['gov']` | +| —(新增)责任人固定字段 | §5 `ownerId`;抽屉「固定参数」段已实现(名册下拉、默认当前登录人),接接口后直接随 body 走 | | 禁用/激活/终止就地改 state | §8;mutation 成功后由服务端重投影(广播 → 失效 → 重取) | | `demoSteps` / `terminatedSteps` 五步占位 | §6 `steps`;终止归态以 `reason.kind='terminated'` 为准,前端不再落「失败」占位 | | 沙箱 `src="/sandbox-demo/activity-view.html"` 固定 480 高 | §2 `view.url` + 票据;`view` 为 null 藏起沙箱区;高度 postMessage 随第一版视图定 | diff --git a/docs/活动模块重构需求-2026-08-25.md b/docs/活动模块重构需求-2026-08-25.md index ad284ff..9d3fa09 100644 --- a/docs/活动模块重构需求-2026-08-25.md +++ b/docs/活动模块重构需求-2026-08-25.md @@ -95,6 +95,7 @@ L1（模块首页 · 活动清单）需要一个**标签页**切换，因为活 - 2026-08-27 · **「启动活动」按钮接功能（用户定）**：L2 头部「启动活动」不再占位 —— 点击弹**参数抽屉**（复用全局 `g-drawer` 右抽屉骨架），填启动参数后启动。**参数表由服务端按活动下发**（参数名 / 中文名 / 控件种类 / 必填 / 描述），每个活动要的参数不一样，前端只按规格渲染不写死字段；控件种类已支持单行 / 多行 / 单选 / 字符串数组（可传多个，如候选 PN）。接口未落地前用 `LAUNCH_PARAMS` 占位表（询价接收与结构化 = 入参说明的极简四参），提交先在历史活动清单头落一条「待执行」演示全链路，接口对接后换启动 mutation。**已禁用的活动不能启动**（钮置灰，先激活再启动）。 - 2026-08-27 · **禁用规则重定（用户定，废除 08-25 的「有实例不能禁用」）**：**任何时刻都可以禁用活动** —— 禁用后只拦「新启动」（启动接口返回 412）；已完成的实例是历史留痕、进行中的实例继续跑完，都不受影响；激活即恢复。前端占位的拦截逻辑（有实例弹「无法禁用」提示条）已随此删除；接口口径见 `docs/API文档-活动模块.md` §0/§8。 - 2026-08-27 · **启动参数的控件口径（用户定）**：启动表单**大部分是自由输入框**；客户 / 料号这类「台账里可能有」的参数用 **combo（选择+新增）** —— 先摆选择框，候选末项「新增」选了换输入框自己填。**填了库里没有的值不拦启动**：启动后服务端做存在性检查，查不到就派**数据工单**到工作台补档案（客户进客户台账、PN 补参数，确认即入库，活动从断点续跑）。前端已加 `combo` 控件类型；接口口径见 `docs/API文档-活动模块.md` §4「combo 语义」/§5。 +- 2026-08-27 · **启动固定参数「责任人」（用户定）**：每次启动必须指定这次实例的责任人（负责人验收、数据工单都落到他身上）—— 它是**启动契约的固定字段 `ownerId`**，不进按活动下发的参数表。抽屉里已加「固定参数」段：人员下拉来自员工名册真接口（`GET /api/gov/staff`，只列在职），默认当前登录人（标注「我自己」）；接口口径见 `docs/API文档-活动模块.md` §5。 ## 三、功能表（整理稿）