/** * 待办卡(应用平台 X4):从 RunPanel 的 ApprovalCard 抽出,和画布状态解耦——onResolved 必填,内部调 /api/tasks/{id}/respond。 * * 用在待办箱、实例页、记录页、画布、问数据。审批卡原有的全部能力都在这里:报告核对概况、反方审稿、双盲复算、质询、 * 补充输入和改稿、工具审批的参数(探索运行里的「始终允许」)、代码审批。另加流程的几样: * - 会签进度:派给了谁、谁同意了、谁驳回了,按策略(任一 / 全体 / 至少 m 人)说清还差什么; * - 时限与升级:剩多久、超了多久、升级过几次;超时只会提醒、升级或驳回,不会自动批准; * - 动作确认的哈希卡:遮罩后的预览、内容哈希前 8 位、环境;确认时原样带回哈希,服务端发送前重算,对不上不发(P8); * - 核实待办:已生效(填外部单号)/ 未生效重新发送 / 未生效放弃,结果未知永远不会自动重发; * - 等外部系统(signal):说明由入站钩子完成,不在这里处理; * - 审核个人应用(review,docs/design/normal-user-apps.md N7):同意不在这里点,处理人取一份共享副本、在副本上试运行和 * 走发布单(发布单做完这条待办自动记为已发布);不发布就退回。 * - 口径召回(recall,docs/design/next-round/02-口径账本.md 做法 7):旧口径、新口径、两版之差和原答案当时的值都点得开, * 「按新版重新出具」「知道了」(run/RecallTask.tsx)。 * * 不碰画布的 store:恢复之后谁去重新接事件流、刷新哪张列表,由调用方在 onResolved 里决定。会签时一个人的回复记下了、 * 还没凑齐(resolved 为假),照样回调——调用方据此刷新卡片。 * * 回复的内容(TaskRespond.values):有表单(task.form)时是表单的值;没有表单的补充输入、改稿、双盲复算是 {value: …}, * 服务端照旧把 value 交给节点;「始终允许」是 {always: true}。 */ import { useMemo, useState } from 'react' import type { ReactNode } from 'react' import { Link, useNavigate } from 'react-router-dom' import { Ban, Check, CheckCheck, Clock, Code, Copy, ExternalLink, Hand, History, Keyboard, PenLine, Send, SearchCheck, TriangleAlert, UserCheck, Webhook, Wrench, } from 'lucide-react' import clsx from 'clsx' import { ApiError, api } from '../api/client' import { useCatalog } from '../store/catalog' import { principalName, useAtLeast, useLoginOn, usePrincipal } from '../store/auth' import { SchemaForm } from '../components/SchemaForm' import { Spinner, useTicker, useToast } from '../components/ui' import { useLocalActor } from '../lib/actor' import { formatDateTime, formatSpan, formatTime, parseServerTime } from '../lib/format' import { cleanValues, formErrorsOf, validateForm, withDefaults } from '../lib/schemaForm' import { ACTION_CONFIRM_TEXT, ACTION_ENV_LABEL, INQUIRY_TEXT, RECONCILE_TEXT, SIGNAL_TEXT, TASK_KIND_LABEL, TASK_STATUS_LABEL, TASK_TEXT, TOOL_TRUST_TEXT, TRIAL_TEXT, runName, } from '../lib/terms' import { REJECT_ROUTE_TEXT, REVIEW_TASK_TEXT, rejectRouteOf } from '../lib/termsApp' import { RECALL_TEXT } from '../lib/termsRecall' import { blueprintPath } from '../pages/blueprints/shared' import type { Approval, ApprovalReport } from '../types' import type { FormError, ReviewTaskPayload, Task, TaskAssignment, TaskKind, TaskMyResponse, TaskProgress, TaskRespond, } from '../typesApp' import { Markdown } from './Markdown' import { ApprovalReports, ApprovalRunClass } from './ApprovalReport' import { ChallengeSummary } from './ChallengeSummary' import { DualCheckApproval } from './DualCheckApproval' import { useInquiryBusy } from './Inquiry' import { RecallTask } from './RecallTask' export interface TaskCardProps { task: Task /** 回复成功之后(凑齐了、或这个人的那一票记下了)。调用方决定刷新列表还是跳转 */ onResolved: (result: { task: Task; resolved: boolean }) => void /** 列表里用:不画「批了会怎样」的说明、签批人那一行和底部的链接 */ compact?: boolean /** * 把回复发出去。默认 POST /api/tasks/{id}/respond;审批卡在老服务端(审批上没有 task_id)上改走老的审批接口, * 按这里的形状交回结果 */ send?: (body: TaskRespond) => Promise<{ task: Task; resolved: boolean }> /** 卡头写不写应用或工作流名。画布上工作流就是眼前这张,不用再说一遍 */ showOwner?: boolean /** 画不画会签进度。应用页上同一页另有会签组件时服务端说不画(signoffs_on_page),同一页上不写两遍 */ showSignoffs?: boolean /** * 试运行里的待办(docs/design/normal-user-apps.md N4):派给了试运行的人自己,按钮写「以试运行身份同意 / 驳回 / 提交」, * 别让人以为这是在批一张真单子 */ trial?: boolean } const KIND_ICON: Record = { approve: Hand, input: Keyboard, edit: PenLine, tool: Wrench, code: Code, dual_check: Hand, action_confirm: Send, reconcile: SearchCheck, signal: Webhook, review: UserCheck, recall: History, } /** 一天没人处理就用琥珀色写等了多久,同审批卡 */ const STALE_MS = 24 * 3_600_000 export function TaskCard({ task, onResolved, compact = false, send, showOwner = true, showSignoffs = true, trial = false }: TaskCardProps) { const toast = useToast() const payload: Record = task.payload ?? {} const kind = task.kind const pending = task.status === 'pending' const canAct = pending && task.can_respond const inquiring = useInquiryBusy(task.run_id) const [busy, setBusy] = useState(false) const [note, setNote] = useState('') const [errors, setErrors] = useState([]) const [values, setValues] = useState>(() => (task.form ? withDefaults(task.form, {}) : {})) const [text, setText] = useState(() => (payload.draft != null ? String(payload.draft) : '')) const post = (body: TaskRespond) => (send ? send(body) : api.tasks.respond(task.id, body)) // 运行类别服务端在待办上给(run_class);老服务端不给时:应用里的运行一律是固定版本的正式运行,别处的看中断内容 // 自己带的运行类别,都没有就不画那一行 const runClass: 'formal' | 'exploratory' | null = task.run_class ?? (task.app_id ? 'formal' : payload.run_class === 'formal' || payload.run_class === 'exploratory' ? payload.run_class : null) const binary = kind === 'approve' || kind === 'tool' || kind === 'code' // 驳回之后去哪(中断内容的 reject_route):带了的照实说转到哪一步、运行终止还是这一路到此为止;老待办没带的照原来的说法 const route = rejectRouteOf(payload) const stops = route ? 'ends' in route && route.ends === 'run' : !binary const trustKey: string | undefined = kind === 'tool' && runClass !== 'formal' ? (typeof payload.trust_key === 'string' && payload.trust_key) || undefined : undefined const reports: ApprovalReport[] = Array.isArray(payload.reports) ? payload.reports.filter((r: unknown): r is ApprovalReport => !!r && typeof r === 'object' && typeof (r as ApprovalReport).node_id === 'string') : [] /** 回复一次。422 带 {errors} 的挂到表单上;别的错误交给 toast */ const respond = async (body: TaskRespond, done: string) => { if (busy) return setBusy(true) try { const res = await post({ ...body, ...(note.trim() && !body.note ? { note: note.trim() } : {}) }) setErrors([]) void useCatalog.getState().refreshApprovals() toast(res.resolved ? done : TASK_TEXT.doneVote, 'ok') onResolved(res) } catch (e) { const fe = e instanceof ApiError && e.status === 422 ? formErrorsOf(e) : null if (fe) setErrors(fe) else toast.error(e) } finally { setBusy(false) } } /** 批准 / 提交:有表单的先按子集校验,不合规不发 */ const approve = () => { if (task.form) { const local = validateForm(task.form, values) if (local.length) { setErrors(local); return } void respond({ decision: binary ? 'approve' : 'submit', values: cleanValues(task.form, values) }, binary ? TASK_TEXT.doneApprove : TASK_TEXT.doneSubmit) return } if (binary) void respond({ decision: 'approve' }, TASK_TEXT.doneApprove) else void respond({ decision: 'submit', values: { value: text } }, TASK_TEXT.doneSubmit) } const reject = () => void respond({ decision: 'reject' }, route ? TASK_TEXT.doneRejectRoute(REJECT_ROUTE_TEXT.goes(route)) : binary ? TASK_TEXT.doneReject : TASK_TEXT.doneRejectStop) /** 「始终允许」:批准这一次,并让服务端把这个工具设成门控把关(工具页的信任档跟着变,目录重拉一次) */ const always = async () => { if (!trustKey) return await respond({ decision: 'approve', values: { always: true } }, TOOL_TRUST_TEXT.alwaysDone(trustKey)) void useCatalog.getState().reload('tools') } const Icon = KIND_ICON[kind] ?? Hand const showForm = !!task.form && (kind === 'approve' || kind === 'input' || kind === 'edit') return (
{task.title || TASK_TEXT.untitled}
{!pending && } {showSignoffs && (task.assignments.length > 1 || task.policy.kind !== 'any') && } {(kind === 'approve' || kind === 'input' || kind === 'edit') && payload.kind === 'human_node' && runClass && ( )} {payload.message && (
)} {kind === 'dual_check' && ( { const res = await post(ok ? { decision: 'submit', values: { value: reply }, note: reply.note } : { decision: 'reject', note: reply.note }) void useCatalog.getState().refreshApprovals() onResolved(res) }} /> )} {kind === 'tool' && payload.tool && (
{String(payload.tool)}
            {JSON.stringify(payload.args ?? {}, null, 2)}
          
)} {kind === 'code' && payload.code && (
          {String(payload.code)}
        
)} {kind === 'action_confirm' && ( void respond({ decision: 'approve', payload_hash: hash }, ACTION_CONFIRM_TEXT.done)} onReject={() => void respond({ decision: 'reject' }, route && 'to' in route ? ACTION_CONFIRM_TEXT.rejectedRoute(REJECT_ROUTE_TEXT.goes(route)) : ACTION_CONFIRM_TEXT.rejected)} /> )} {kind === 'reconcile' && ( void respond(body, RECONCILE_TEXT.done)} /> )} {kind === 'signal' && } {kind === 'review' && ( void respond({ decision: 'reject' }, REVIEW_TASK_TEXT.rejected)} /> )} {kind === 'recall' && ( void respond({ decision }, decision === 'reissue' ? RECALL_TEXT.task.doneReissue : RECALL_TEXT.task.doneAck)} /> )} {showForm && (
{ setValues(v); if (errors.length) setErrors([]) }} />
)} {!showForm && canAct && (kind === 'input' || kind === 'edit') && (