端到端验收修复与指标出具:

- 身份与工具:登录页建第一个管理员(认人接口的 401 说明能不能建);搭建者有只读的人和组名录,选人给候选并核对名字;授权三行带标题;端点请求头名校验(空名、非法名存不进、发不出时说清原因);写入能力在工具页试运行一律演练、不发送,HTTP 状态照实说成败;写记忆不算只读、查询能力只能选同一端点上的只读能力;审批与遮罩的说法和实际规则一致;开登录时不要署名、导入和发布记登录的人;使用者不显示推演等只给搭建者的操作,403 按是否开登录说话;登录页只认一次人
- 流程与实例:图里用到的岗位(派给谁、超时升级给谁、发送确认派给谁)全部派生、没绑人的发布时报错;写外部系统的参数按能力声明的类型收拢后再算哈希和发送,收不成就不发;发起人的实例页只看这一步的状态,处理人才给待办卡;会签进度带登录核实和时间,升级后照实写规则;实例状态写流程的结论(已退回、未确认、等待核实写入结果),核实生效后不再挂失败原因;流程应用首页不派生最近封存运行的结果块,看板没数据时是安静的空态;样例⑩的金额带类型和下限、待办标题带金额,表单上下限前后端一起生效
- 看板与证据:定时任务模板加 ISO 周、上一 ISO 周、本月、上月;出处链穿过原样解析查询结果的整形节点,追不到原始数据的照实说停在哪里,样例⑨改用 cell();应用首页和版本历史都能做成应用;指标块单位不重复;版本列表带退役说明;定时任务页头跟着刷新;删视图要确认、新视图能起名;编辑器属性用中文名、术语带解释
- 指标出具(用户 2026-10-15 拍板):契约只写「指标来自」、上游没有报告撰写节点、成果里没有模型写的话时按指标出具——必需指标齐、指标输入追到原始数据、成果字段里的数回指得上才完整出具;受管级要求每个指标静态地追到原始数据(governed.metric_untraced);出具横幅和应用印章写明按指标
- 受管工作流降为已发布只给管理员(Q8 顺延,服务端同样拦);工作流接口带当前发布版的级别,画布上改过之后也认得出受管工作流
This commit is contained in:
ThearchyHelios
2026-10-15 07:15:37 +08:00
parent 5d42ffb62b
commit 941723b17c
116 changed files with 4917 additions and 631 deletions
+4 -1
View File
@@ -100,7 +100,10 @@ export function MetricBlock({ node }: NodeProps) {
const label = str(node.props.label) || str(data.name) || node.id
const state = blockState(node)
const text = str(data.text)
const unit = str(node.props.unit) || str(data.unit)
// 单位只写一处。口径卡写了单位的,服务端交来的字已经带着它(render_metric:「18,218.54元」),data.unit 只是说明是哪个
// 单位,不再在下面另写一行;口径卡没写单位(data.unit 是空串)、绑定单元格(字不带单位,render_cell)的,写搭建者在
// 属性里填的单位
const unit = str(data.unit) ? '' : str(node.props.unit)
return (
<div className="rounded-lg border bg-panel p-3" data-component="metric" data-metric-state={str(data.state) || 'ok'}>
<div className="text-2xs text-faint">{label}</div>
+96 -33
View File
@@ -11,12 +11,15 @@ import { ArrowRight, Hourglass, Play } from 'lucide-react'
import clsx from 'clsx'
import { api } from '../../api/client'
import { ErrorState, Spinner, StatusPill, useTicker } from '../../components/ui'
import { Due, TaskCard, Signoffs } from '../../run/TaskCard'
import { formatDateTime, formatRelative } from '../../lib/format'
import {
ACTION_ENV_LABEL, ACTION_STATE_LABEL, ACTION_TEXT, APP_TEXT, ENTRY_TEXT, INSTANCE_TEXT, TASK_KIND_LABEL, VIEW_TEXT,
Due, Resolved, SignoffHead, Signoffs, TaskCard, assigneeName, respondedText,
} from '../../run/TaskCard'
import { formatDateTime, formatRelative, formatTime } from '../../lib/format'
import {
ACTION_ENV_LABEL, ACTION_STATE_LABEL, ACTION_TEXT, APP_TEXT, ENTRY_TEXT, INSTANCE_TEXT, TASK_KIND_LABEL,
TASK_STATUS_LABEL, TASK_TEXT, VIEW_TEXT,
} from '../../lib/termsApp'
import type { ActionRecordRow, ActionState, InstanceRow, Task } from '../../typesApp'
import type { ActionRecordRow, ActionState, InstanceRow, Task, TaskAssignment } from '../../typesApp'
import { Stamp } from '../Stamp'
import { sourceOf, str, useView, type NodeProps } from '../context'
@@ -88,7 +91,7 @@ export function InstanceItem({ row, appId, preview }: { row: InstanceRow; appId:
<Hourglass size={10} aria-hidden /> {APP_TEXT.pendingTasks(row.pending_tasks)}
</span>
)}
<StatusPill status={row.status} short />
<StatusPill status={row.status_code ?? row.status} label={row.status_text} short />
<span className="shrink-0 text-2xs text-faint" title={formatDateTime(row.created_at)}>{formatRelative(row.created_at)}</span>
</>
)
@@ -109,7 +112,7 @@ export function InstanceHeader({ node }: NodeProps) {
<header className="space-y-1.5" data-component="instance_header">
<div className="flex flex-wrap items-center gap-2">
<h2 className="min-w-0 truncate text-base font-semibold">{str(d.title) || model.page.title}</h2>
{d.status && <StatusPill status={str(d.status)} />}
{d.status && <StatusPill status={str(d.status_code) || str(d.status)} label={str(d.status_text) || undefined} />}
</div>
<div className="flex flex-wrap gap-x-2 text-2xs text-dim">
{d.started_by && <span>{INSTANCE_TEXT.startedBy(str(d.started_by))}</span>}
@@ -121,13 +124,17 @@ export function InstanceHeader({ node }: NodeProps) {
)
}
/** 实例进度:服务端按节点给一行(标题、状态、时间),不下发原始事件。状态的剪影同运行的状态徽标 */
/**
* 实例进度:服务端按节点给一行(标题、状态、给人看的说法、时间),不下发原始事件。状态的剪影同运行的状态徽标:
* 结果未知(unknown)画成等人处理,被人驳回而结束(rejected)画成取消——是人的决定,不是故障
*/
const STEP_STATUS: Record<string, string> = {
running: 'running', done: 'succeeded', failed: 'failed', skipped: 'skipped', waiting: 'interrupted',
unknown: 'interrupted', rejected: 'cancelled',
}
export function InstanceTimeline({ node }: NodeProps) {
const steps: { node?: string; title?: string; state?: string; at?: string }[] =
const steps: { node?: string; title?: string; state?: string; text?: string; at?: string }[] =
Array.isArray(node.data?.steps) ? node.data!.steps : []
return (
<div className="rounded-lg border bg-panel p-3" data-component="instance_timeline">
@@ -135,8 +142,8 @@ export function InstanceTimeline({ node }: NodeProps) {
<ol className="space-y-1.5">
{steps.map((it, i) => (
<li key={it.node ?? i} className="flex items-center gap-2 text-xs" data-timeline-step={it.state ?? ''}>
<StatusPill status={STEP_STATUS[it.state ?? ''] ?? 'pending'} plain short
pendingApproval={it.state === 'waiting'} />
<StatusPill status={STEP_STATUS[it.state ?? ''] ?? 'pending'} plain short label={it.text}
pendingApproval={it.state === 'waiting' || it.state === 'unknown'} />
<span className="min-w-0 flex-1 truncate text-fg">{it.title || it.node}</span>
{it.at && <span className="shrink-0 text-2xs text-faint" title={formatDateTime(it.at)}>{formatRelative(it.at)}</span>}
</li>
@@ -186,36 +193,67 @@ export function TaskList({ node }: NodeProps) {
}
/** 待办的摘要(页面解析给的那几项) */
type TaskSummary = Pick<Task, 'id' | 'run_id' | 'node_id' | 'kind' | 'title' | 'status' | 'due_at' | 'escalation_level'>
type TaskSummary = Pick<Task, 'id' | 'run_id' | 'node_id' | 'kind' | 'title' | 'status' | 'due_at' | 'escalation_level'
| 'created_at' | 'instance_title'>
/** 一行待办:标题之外写所属实例和开出的时间——同一个节点开出的待办标题一样,靠它们分开 */
function TaskRow({ task }: { task: TaskSummary }) {
const now = useTicker(60_000)
const where = [task.instance_title, task.created_at ? TASK_TEXT.createdAt(formatTime(task.created_at)) : null].filter(Boolean)
return (
<div className="flex items-center gap-2 border-b px-3 py-2 text-xs" data-task-row={task.id}>
<span className="chip shrink-0">{TASK_KIND_LABEL[task.kind] ?? task.kind}</span>
<span className="min-w-0 flex-1 truncate">{task.title}</span>
<span className="min-w-0 flex-1">
<span className="block truncate">{task.title}</span>
{where.length > 0 && <span className="block truncate text-2xs text-faint" data-task-row-where="">{where.join(' · ')}</span>}
</span>
<Due dueAt={task.due_at} now={now} />
<ArrowRight size={12} aria-hidden className="shrink-0 text-faint" />
</div>
)
}
/** 一条待办(task_form、signoffs):服务端给的是摘要,按 id 取完整的再画;预览里只读 */
function useFullTask(summary: TaskSummary | undefined, preview: boolean) {
/**
* 页面解析给的这一步(task_form、signoffs)拼成待办的样子:摘要、派给谁(服务端给的原样)、会签进度、我的回复。
* 只用来画状态,不能拿去处理——处理的待办卡要按 id 取完整的
*/
function taskOf(data: Record<string, any>): Task {
const summary = data.task as TaskSummary & Partial<Task>
const raw: Partial<TaskAssignment>[] = Array.isArray(data.assignments) ? data.assignments : []
return {
...summary, policy: summary.policy ?? { kind: 'any' }, payload: {}, can_respond: false,
outcome: summary.outcome ?? null, resolved_by: summary.resolved_by ?? null, resolved_at: summary.resolved_at ?? null,
progress: data.progress ?? null, my_response: data.my_response ?? null,
assignments: raw.map((a, i) => ({
id: a.id ?? String(i), principal_kind: a.principal_kind ?? 'anyone', principal: str(a.principal),
source: str(a.source), status: a.status ?? 'pending', responded_by: a.responded_by ?? null,
responded_at: a.responded_at ?? null, decision: a.decision ?? null, verified: !!a.verified,
})),
} as Task
}
/** 一条待办(task_form):处理人按 id 取完整的再画待办卡;预览里只读 */
function useFullTask(summary: TaskSummary | undefined, enabled: boolean) {
const id = summary?.id
const fetcher = id && !preview ? () => api.tasks.get(id).then((t) => ({ items: [t] })) : null
const fetcher = id && enabled ? () => api.tasks.get(id).then((t) => ({ items: [t] })) : null
const { items, error, retry } = useList<Task>(undefined, fetcher, id)
return { task: items?.[0], error, retry }
}
/**
* 待办表单:服务端解析时就判定了读者是不是这条待办的处理人(data.handler)。是的按 id 取完整的待办画待办卡(能处理的给
* 表单);不是的(发起人、旁观的人)只画这一步的状态——派给了谁、会签进度、时限——不去取待办(取了也是「待办不存在」)
*/
export function TaskForm({ node }: NodeProps) {
const { preview, onReload } = useView()
const summary = node.data?.task as TaskSummary | undefined
const { task, error, retry } = useFullTask(summary, preview)
const handler = node.data?.handler !== false
const { task, error, retry } = useFullTask(summary, !preview && handler)
if (!summary) return <div className="text-2xs text-faint" data-component="task_form">{VIEW_TEXT.tasks.empty}</div>
return (
<div className="overflow-hidden rounded-lg border" data-component="task_form">
<div className="overflow-hidden rounded-lg border" data-component="task_form" data-task-handler={handler ? 'yes' : 'no'}>
{preview ? <TaskRow task={summary} />
: !handler ? <TaskState task={taskOf(node.data!)} />
: error ? <ErrorState compact error={error} onRetry={retry} className="m-2" />
: !task ? <div className="px-3 py-3"><Spinner size={11} /></div>
: <TaskCard task={task} onResolved={() => { retry(); onReload?.() }} />}
@@ -223,20 +261,41 @@ export function TaskForm({ node }: NodeProps) {
)
}
/** 会签进度:页面解析给了派给谁、谁回复了什么,拼成待办卡上那一块的样子 */
/** 这一步的状态(不是处理人看的):种类、标题、状态、时限、升级;在等谁、会签进度;处理完了写谁、什么时候、结果 */
function TaskState({ task }: { task: Task }) {
const now = useTicker(60_000)
const pending = task.status === 'pending'
const waiting = task.assignments.filter((a) => a.status === 'pending').map(assigneeName)
const voting = task.progress && (task.assignments.length > 1 || task.policy.kind !== 'any')
return (
<div className="space-y-1.5 p-3" data-task-state={task.status} data-task={task.id}>
<div className="tnum flex flex-wrap items-center gap-x-2 gap-y-0.5 text-xs">
<span className="chip shrink-0">{TASK_KIND_LABEL[task.kind] ?? task.kind}</span>
<span className="min-w-0 truncate font-medium text-fg">{task.title || TASK_TEXT.untitled}</span>
{pending && <span className="chip shrink-0">{TASK_STATUS_LABEL.pending}</span>}
{pending && <Due dueAt={task.due_at} now={now} />}
{task.escalation_level > 0 && (
<span className="chip shrink-0" style={{ color: 'var(--st-waiting)' }} title={TASK_TEXT.escalatedHint}>
{TASK_TEXT.escalated(task.escalation_level)}
</span>
)}
</div>
{!pending && <Resolved task={task} />}
{pending && waiting.length > 0 && (
<div className="text-2xs text-dim" data-task-waiting-on="">{TASK_TEXT.waitingOn(waiting.join('、'))}</div>
)}
{voting && <div className="rounded border bg-bg p-2"><SignoffHead task={task} /></div>}
{pending && task.my_response && (
<div className="text-2xs text-dim" data-task-readonly="responded">{respondedText(task.my_response)}</div>
)}
</div>
)
}
/** 会签进度:页面解析给了派给谁、谁回复了什么(登录核实与否、什么时候)、会签进度,拼成待办卡上那一块的样子 */
export function SignoffsBlock({ node }: NodeProps) {
const summary = node.data?.task as (TaskSummary & { policy?: Task['policy'] }) | undefined
const raw: Record<string, any>[] = Array.isArray(node.data?.assignments) ? node.data!.assignments : []
if (!summary) return <div className="text-2xs text-faint" data-component="signoffs">{VIEW_TEXT.tasks.empty}</div>
const task = {
...summary, policy: summary.policy ?? { kind: 'any' },
assignments: raw.map((a, i) => ({
id: String(i), principal_kind: a.principal_kind, principal: str(a.principal), source: '', status: a.status,
responded_by: a.responded_by ?? null, responded_at: a.responded_at ?? null, decision: a.decision ?? null,
verified: !!a.verified,
})),
} as unknown as Task
return <div data-component="signoffs"><Signoffs task={task} /></div>
if (!node.data?.task) return <div className="text-2xs text-faint" data-component="signoffs">{VIEW_TEXT.tasks.empty}</div>
return <div data-component="signoffs"><Signoffs task={taskOf(node.data)} /></div>
}
const STATE_COLOR: Record<ActionState, string> = {
@@ -244,10 +303,13 @@ const STATE_COLOR: Record<ActionState, string> = {
unknown: 'var(--st-waiting)', simulated: 'var(--text-dim)',
}
/** 动作状态:状态、环境、哈希前 8 位、回执(开登录时使用者看不到回执原文);失败写原因 */
/**
* 动作状态:状态、环境、哈希前 8 位、回执(开登录时使用者看不到回执原文)。确定没生效的写失败原因(error);结果未知、
* 事后核实的经过(note,如「发送时没有拿到确定的结果……经按幂等键查询核实为已生效」)只记一笔,不当失败原因
*/
export function ActionStatus({ node }: NodeProps) {
const label = str(node.props.label)
const records: Partial<ActionRecordRow>[] = Array.isArray(node.data?.records) ? node.data!.records : []
const records: (Partial<ActionRecordRow> & { note?: string })[] = Array.isArray(node.data?.records) ? node.data!.records : []
return (
<div className="rounded-lg border bg-panel p-3" data-component="action_status">
{label && <div className="mb-1.5 text-xs font-medium">{label}</div>}
@@ -263,7 +325,8 @@ export function ActionStatus({ node }: NodeProps) {
{(a.attempt ?? 1) > 1 && <span className="text-dim">{ACTION_TEXT.attempt(a.attempt!)}</span>}
{a.payload_hash && <code className="mono text-faint">{ACTION_TEXT.hash(a.payload_hash.slice(0, 8))}</code>}
</div>
{a.error && <div style={{ color: 'var(--err)' }}>{ACTION_TEXT.error}:{a.error}</div>}
{a.error && <div style={{ color: 'var(--err)' }} data-action-error="">{ACTION_TEXT.error}:{a.error}</div>}
{a.note && <div className="leading-relaxed text-dim" data-action-note="">{a.note}</div>}
{a.receipt && (
<details>
<summary className="cursor-pointer text-dim">{ACTION_TEXT.receipt}</summary>
+10 -6
View File
@@ -8,7 +8,8 @@
* 各组件的 data(ViewNode.data,照 backend/app/apps/resolve.py 的 _data),没有的键都可以缺。绑定了视图的组件都带
* state(ok / missing / masked / withheld / empty / running / error)和可选的 message,说这一块为什么没有数据:
* - stamp:{view, state, stamp, message?}
* - metric:{state, text, name, unit, evidence}(evidence 的 kind 为 metric,点开走指标链接口)
* - metric:{state, text, name, unit, evidence}(evidence 的 kind 为 metric,点开走指标链接口)。text 已按口径卡带着
* 单位,unit 只说明是哪个单位;绑定单元格时是 {state, text, evidence},text 不带单位
* - series:{state, mode(single / dual / incomparable / recompute), unit, series: [{version, label, points: [{run_id,
* as_of, value, text, evidence}]}], breaks: [{after_run?, from, to, text}]}
* - table、chart:{state, columns, rows(二维数组,遮罩的格子服务端已换成「已遮罩」), masked, total_rows, truncated,
@@ -18,11 +19,14 @@
* - form:{form}(表单名,表单在 ViewModel.forms 里)。提交即按这些值重新解析本页(按需视图的参数),见 input.tsx
* - entry_button:{entry, label, disabled, reason?}
* - instance_list:{who, entry, items: InstanceRow[]}
* - instance_header:InstanceRow 的各项加 {state, status_text, stamp}
* - instance_timeline:{state, status, status_text, steps: [{node, title, state, started_at, at}]}
* - task_list:{scope, items}(待办的摘要,不是完整的待办;要处理时按 id 取完整的)
* - task_form、signoffs:{state, task(摘要), task_ui, assignments?}
* - action_status:{state, node, records: [{id, state, environment, attempt, payload_hash(前 8 位), error, receipt?}]}
* - instance_header:InstanceRow 的各项(含 status_code、status_text:给人看的状态和结论)加 {state, stamp}
* - instance_timeline:{state, status, status_code, status_text, steps: [{node, title, state, text, started_at, at}]}
* (state 另有 unknown:写入结果未知;rejected:被人驳回而结束。text 是这一步给人看的说法)
* - task_list:{scope, items}(待办的摘要,带 instance_title、created_at;要处理时按 id 取完整的)
* - task_form、signoffs:{state, task(摘要), task_ui, handler(读者是不是处理人), assignments, progress, my_response}
* ——不是处理人的不取待办,只画这一步的状态
* - action_status:{state, node, records: [{id, state, environment, attempt, payload_hash(前 8 位), error?(确定没生效
* 的原因), note?(结果未知、事后核实的经过), receipt?}]}
*/
import { createContext, useContext } from 'react'
import type { ReactNode } from 'react'