mirror of
https://github.com/ThearchyHelios/AgentLab.git
synced 2026-11-21 18:52:02 +00:00
端到端验收修复与指标出具:
- 身份与工具:登录页建第一个管理员(认人接口的 401 说明能不能建);搭建者有只读的人和组名录,选人给候选并核对名字;授权三行带标题;端点请求头名校验(空名、非法名存不进、发不出时说清原因);写入能力在工具页试运行一律演练、不发送,HTTP 状态照实说成败;写记忆不算只读、查询能力只能选同一端点上的只读能力;审批与遮罩的说法和实际规则一致;开登录时不要署名、导入和发布记登录的人;使用者不显示推演等只给搭建者的操作,403 按是否开登录说话;登录页只认一次人 - 流程与实例:图里用到的岗位(派给谁、超时升级给谁、发送确认派给谁)全部派生、没绑人的发布时报错;写外部系统的参数按能力声明的类型收拢后再算哈希和发送,收不成就不发;发起人的实例页只看这一步的状态,处理人才给待办卡;会签进度带登录核实和时间,升级后照实写规则;实例状态写流程的结论(已退回、未确认、等待核实写入结果),核实生效后不再挂失败原因;流程应用首页不派生最近封存运行的结果块,看板没数据时是安静的空态;样例⑩的金额带类型和下限、待办标题带金额,表单上下限前后端一起生效 - 看板与证据:定时任务模板加 ISO 周、上一 ISO 周、本月、上月;出处链穿过原样解析查询结果的整形节点,追不到原始数据的照实说停在哪里,样例⑨改用 cell();应用首页和版本历史都能做成应用;指标块单位不重复;版本列表带退役说明;定时任务页头跟着刷新;删视图要确认、新视图能起名;编辑器属性用中文名、术语带解释 - 指标出具(用户 2026-10-15 拍板):契约只写「指标来自」、上游没有报告撰写节点、成果里没有模型写的话时按指标出具——必需指标齐、指标输入追到原始数据、成果字段里的数回指得上才完整出具;受管级要求每个指标静态地追到原始数据(governed.metric_untraced);出具横幅和应用印章写明按指标 - 受管工作流降为已发布只给管理员(Q8 顺延,服务端同样拦);工作流接口带当前发布版的级别,画布上改过之后也认得出受管工作流
This commit is contained in:
@@ -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>
|
||||
|
||||
@@ -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>
|
||||
|
||||
@@ -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'
|
||||
|
||||
Reference in New Issue
Block a user