openxiangda 2.34.3 → 2.44.0

package/dist/browser/components/workflow/StandardWorkflowPages.js

@@ -1,6 +1,9 @@
 import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
 import { applicationCode } from '../../runtime-meta';
 import { readPendingWorkflowSubmission, writePendingWorkflowSubmission, clearPendingWorkflowSubmission, workflowSubmissionScope, submissionLocatorStorage, standardProcessWasRejected } from '../../workflow-submission-recovery';
+import { readPendingWorkflowTaskCommand, writePendingWorkflowTaskCommand, clearPendingWorkflowTaskCommand, workflowTaskCommandScope, workflowCommandTokenDigest, workflowTaskCommandWasRejected } from '../../workflow-task-command-recovery';
+import { WorkflowTaskForm, useWorkflowTaskForm } from './WorkflowTaskForm';
+import { WorkflowPendingCommandGuard, WorkflowTaskCommandReceipt } from './WorkflowTaskCommandReceipt';
 import { PresentationTime, usePresentationTimeZone } from '../../presentation-time';
 import { ArrowLeftOutlined, ClockCircleOutlined, EllipsisOutlined, ReloadOutlined, CloseOutlined, ExpandOutlined, CompressOutlined, ExportOutlined, } from '@ant-design/icons';
 import { Alert, App, Button, Card, Drawer, Empty, Form, Input, Modal, Result, Segmented, Select, Space, Spin, Table, Tabs, Tag, Tooltip, Typography, } from 'antd';
@@ -13,7 +16,7 @@ import { executeWorkflowOperation, executeWorkflowLaunchNamedOperation, loadWork
 import { useWorkflowDefinition, } from '../../workflow-definitions';
 import { useResourceDefinitions } from '../../resource-definitions';
 import { selectedSurfaceFields } from '../resource/resource-field-selection';
-import { useRuntime } from '../../runtime';
+import { useRuntime, useOptionalRuntime } from '../../runtime';
 import { SurfaceFieldValue, } from '../resource/SurfaceFields';
 import { workflowContextScalarValue, processStatusReadRetryDelay, buildWorkflowNamedOperationInput, parseWorkflowNamedOperationResult, workflowLaunchContractJsonEqual, } from '../../workflow-launch';
 import { normalizeFormValues, normalizeRecordForForm, } from '../platform-fields/field-form-codec';
@@ -39,13 +42,32 @@ export function shouldRefreshWorkflowSurface(kind, result) {
  */
 export async function completeWorkflowCommand(kind, result, options) {
     const refreshSurface = shouldRefreshWorkflowSurface(kind, result);
-    const nextSurface = refreshSurface ? await options.refresh() : null;
+    let nextSurface = null;
+    let refreshFailure;
+    try {
+        nextSurface = refreshSurface ? await options.refresh() : null;
+    }
+    catch (error) {
+        refreshFailure = error;
+    }
     await options.onCommandCompleted?.(result);
     if (nextSurface)
         await options.onCompleted?.(nextSurface, result);
+    if (refreshFailure)
+        throw refreshFailure;
     return nextSurface;
 }
 function errorMessage(error, fallback) {
+    const code = error?.code;
+    const taskPageMessages = {
+        WORKFLOW_TASK_FORM_REQUIRED: '请完成本页必填资料后再提交。',
+        WORKFLOW_TASK_FORM_REVISION_CONFLICT: '业务资料已被其他处理人更新。请刷新并核对，当前输入会保留。',
+        WORKFLOW_TASK_FORM_RECOMPUTATION_REQUIRED: '这些资料会影响已完成的计算，请退回到计算前的节点重新办理。',
+        WORKFLOW_TASK_FORM_FIELD_NOT_EDITABLE: '页面规则已变化，请刷新资料后重新确认。',
+        WORKFLOW_TASK_FORM_COMMAND_FORBIDDEN: '此操作不提交补填资料，请使用保存补填、同意或重新提交。',
+    };
+    if (code && taskPageMessages[code])
+        return taskPageMessages[code];
     return error instanceof Error ? error.message : fallback;
 }
 function randomId(prefix) {
@@ -299,7 +321,8 @@ export function WorkflowTimelineSection({ timeline, }) {
     return (_jsx(Card, { className: "oxa-workflow-timeline-card", title: "\u5BA1\u6279\u6D41\u7A0B", children: entries.length ? (_jsx("div", { className: "oxa-workflow-timeline", children: entries.map((item) => {
                 const operations = item.operations || [];
                 const visiblePeople = visibleWorkflowTimelinePeople(item, operations);
-                return (_jsxs("div", { className: timelineTone(item.status), children: [_jsx("span", { className: "oxa-workflow-timeline-dot", children: _jsx(WorkflowStatusIcon, { status: item.status }) }), _jsxs("div", { children: [_jsxs("div", { className: "oxa-workflow-timeline-title", children: [_jsx("strong", { children: item.title }), _jsx(StatusTag, { status: item.status })] }), visiblePeople.length > 0 && (_jsx("div", { className: "oxa-workflow-timeline-assignees", children: visiblePeople.map((person, index) => (_jsxs("div", { children: [_jsx(PlatformAvatar, { avatarUrl: person.avatarUrl, size: 20 }), _jsxs("span", { children: [_jsx(Typography.Text, { children: person.displayName }), person.departmentDisplayName && (_jsx("small", { children: person.departmentDisplayName }))] })] }, `${person.userId || person.displayName}:${index}`))) })), operations.length > 0 && (_jsx("div", { className: "oxa-workflow-timeline-operations", children: operations.map((operation) => (_jsxs("div", { children: [_jsx(PlatformAvatar, { avatarUrl: operation.actor.avatarUrl, size: 20 }), _jsxs("span", { className: "oxa-workflow-operation-content", children: [_jsxs("span", { children: [_jsx(Typography.Text, { children: operation.actor.displayName }), _jsx("strong", { children: operation.operationLabel })] }), operation.reason && (_jsxs("span", { className: "oxa-workflow-operation-opinion", children: [_jsx(Typography.Text, { type: "secondary", children: "\u610F\u89C1" }), _jsx(Typography.Text, { children: operation.reason })] }))] })] }, operation.id))) })), item.terminalReason && !operations.some(operation => operation.reason) && (_jsxs(Typography.Text, { type: "secondary", children: ["\u539F\u56E0\uFF1A", item.terminalReason] })), item.primaryDisplayTime && (_jsx("time", { className: "oxa-workflow-primary-time", children: formatTime(item.primaryDisplayTime) }))] })] }, item.key));
+                const businessStep = item.nodeKind === 'action' ? item.result.businessStep : undefined;
+                return (_jsxs("div", { className: timelineTone(item.status), children: [_jsx("span", { className: "oxa-workflow-timeline-dot", children: _jsx(WorkflowStatusIcon, { status: item.status }) }), _jsxs("div", { children: [_jsxs("div", { className: "oxa-workflow-timeline-title", children: [_jsx("strong", { children: item.title }), businessStep?.status === 'waiting' ? _jsx(Tag, { color: "processing", children: "\u7B49\u5F85\u4E1A\u52A1\u7ED3\u679C" }) : businessStep?.status === 'result_ready' ? _jsx(Tag, { color: "warning", children: "\u63A8\u8FDB\u53D7\u963B" }) : _jsx(StatusTag, { status: item.status })] }), businessStep?.status === 'result_ready' && _jsx(Typography.Text, { type: "secondary", children: "\u8BA1\u7B97\u7ED3\u679C\u5DF2\u6536\u5230\uFF0C\u540E\u7EED\u6D41\u8F6C\u7B49\u5F85\u4FEE\u590D\u3002" }), visiblePeople.length > 0 && (_jsx("div", { className: "oxa-workflow-timeline-assignees", children: visiblePeople.map((person, index) => (_jsxs("div", { children: [_jsx(PlatformAvatar, { avatarUrl: person.avatarUrl, size: 20 }), _jsxs("span", { children: [_jsx(Typography.Text, { children: person.displayName }), person.departmentDisplayName && (_jsx("small", { children: person.departmentDisplayName }))] })] }, `${person.userId || person.displayName}:${index}`))) })), operations.length > 0 && (_jsx("div", { className: "oxa-workflow-timeline-operations", children: operations.map((operation) => (_jsxs("div", { children: [_jsx(PlatformAvatar, { avatarUrl: operation.actor.avatarUrl, size: 20 }), _jsxs("span", { className: "oxa-workflow-operation-content", children: [_jsxs("span", { children: [_jsx(Typography.Text, { children: operation.actor.displayName }), _jsx("strong", { children: operation.operationLabel })] }), operation.reason && (_jsxs("span", { className: "oxa-workflow-operation-opinion", children: [_jsx(Typography.Text, { type: "secondary", children: "\u610F\u89C1" }), _jsx(Typography.Text, { children: operation.reason })] }))] })] }, operation.id))) })), item.terminalReason && !operations.some(operation => operation.reason) && (_jsxs(Typography.Text, { type: "secondary", children: ["\u539F\u56E0\uFF1A", item.terminalReason] })), item.primaryDisplayTime && (_jsx("time", { className: "oxa-workflow-primary-time", children: formatTime(item.primaryDisplayTime) }))] })] }, item.key));
             }) })) : (_jsx(Empty, { description: "\u6682\u65E0\u6D41\u7A0B\u8F68\u8FF9", image: Empty.PRESENTED_IMAGE_SIMPLE })) }));
 }
 function WorkflowMemberPicker({ id, placeholder, value, onChange, multiple = false, variant }) {
@@ -360,18 +383,36 @@ function OperationDialog({ error, operation, submitting, variant, onCancel, onSu
     if (!operation)
         return null;
     const ui = operation.uiSchema;
-    const formNode = (_jsxs(Form, { form: form, layout: "vertical", onFinish: onSubmit, children: [error && _jsx(Alert, { role: "alert", title: "\u5BA1\u6279\u5C1A\u672A\u5B8C\u6210", description: error, showIcon: true, type: "error" }), ui.confirmation?.description && (_jsx(Alert, { className: "oxa-workflow-operation-alert", description: ui.confirmation.description, showIcon: true, type: operation.emphasis === 'danger' ? 'warning' : 'info' })), _jsx(OperationFields, { operation: operation, variant: variant })] }));
+    const formNode = (_jsxs(Form, { form: form, layout: "vertical", onFinish: onSubmit, disabled: submitting, children: [error && _jsx(Alert, { role: "alert", title: "\u5BA1\u6279\u5C1A\u672A\u5B8C\u6210", description: error, showIcon: true, type: "error" }), ui.confirmation?.description && (_jsx(Alert, { className: "oxa-workflow-operation-alert", description: ui.confirmation.description, showIcon: true, type: operation.emphasis === 'danger' ? 'warning' : 'info' })), _jsx(OperationFields, { operation: operation, variant: variant })] }));
     if (variant === 'mobile') {
         return (_jsx(Drawer, { extra: _jsx(Button, { loading: submitting, onClick: () => form.submit(), type: "primary", children: ui.confirmText || `确认${operation.label}` }), rootClassName: "oxa-workflow-operation-drawer", styles: { body: { overflowY: 'auto', minHeight: 0 } }, keyboard: !submitting, mask: { closable: !submitting }, closable: !submitting, onClose: submitting ? undefined : onCancel, open: true, placement: "bottom", size: "min(640px, 92dvh)", title: operation.label, children: formNode }));
     }
-    return (_jsx(Modal, { cancelText: "\u53D6\u6D88", confirmLoading: submitting, okText: ui.confirmText || `确认${operation.label}`, onCancel: onCancel, onOk: () => form.submit(), open: true, title: operation.label, children: formNode }));
+    return (_jsx(Modal, { cancelText: "\u53D6\u6D88", confirmLoading: submitting, cancelButtonProps: { disabled: submitting }, okText: ui.confirmText || `确认${operation.label}`, onCancel: onCancel, onOk: () => form.submit(), open: true, title: operation.label, keyboard: !submitting, mask: { closable: !submitting }, closable: !submitting, children: formNode }));
 }
-function WorkflowOperations({ surface, variant, onRefresh, onCommandSuccess, }) {
+function WorkflowOperations({ surface, variant, onRefresh, onCommandSuccess, pendingLocator, persistLocator, clearLocator, onBusyChange, settlement, confirmedReadPending, renderLayout, }) {
     const { message } = App.useApp();
     const [selectedState, setSelectedState] = useState(null);
     const [moreOpen, setMoreOpen] = useState(false);
     const [operationError, setOperationError] = useState('');
     const [submitting, setSubmitting] = useState(false);
+    const [draftLocked, setDraftLocked] = useState(false);
+    const [fileLocked, setFileLocked] = useState(false);
+    const [refreshFailure, setRefreshFailure] = useState(null);
+    const [unknown, setUnknown] = useState(false);
+    const request = useRef(null);
+    const mounted = useRef(false);
+    const busyRef = useRef(false);
+    const taskForm = useWorkflowTaskForm(surface.taskForm);
+    useEffect(() => { mounted.current = true; return () => { mounted.current = false; }; }, []);
+    useEffect(() => {
+        if (!settlement || request.current?.key !== settlement.key)
+            return;
+        if (settlement.result)
+            taskForm.committed(request.current.input.form, Number(settlement.result.dataRevision) || undefined);
+        request.current = null;
+        setUnknown(false);
+        setSelectedState(null);
+    }, [settlement]);
     const operations = standardWorkflowOperations(surface);
     const selected = selectedState?.surface === surface
         ? operations.find((operation) => operation.key === selectedState.operation.key &&
@@ -379,9 +420,9 @@ function WorkflowOperations({ surface, variant, onRefresh, onCommandSuccess, })
                 selectedState.operationSignature) || null
         : null;
     useEffect(() => {
-        if (selectedState && !selected)
+        if (selectedState && !selected && !submitting && !unknown)
             setSelectedState(null);
-    }, [selected, selectedState]);
+    }, [selected, selectedState, submitting, unknown]);
     const selectOperation = (operation) => {
         setOperationError('');
         setSelectedState({
@@ -391,10 +432,12 @@ function WorkflowOperations({ surface, variant, onRefresh, onCommandSuccess, })
         });
     };
     const submit = async (values) => {
-        if (!selected || submitting)
+        if (!selected || busyRef.current || draftLocked || fileLocked || taskForm.draftNeedsSave || pendingLocator || unknown || refreshFailure || confirmedReadPending)
             return;
         setOperationError('');
         setSubmitting(true);
+        busyRef.current = true;
+        onBusyChange(true);
         try {
             if (selected.kind !== 'workflow_command') {
                 throw new Error('WORKFLOW_APP_ACTION_NOT_EXECUTABLE_IN_STANDARD_PANEL');
@@ -408,15 +451,22 @@ function WorkflowOperations({ surface, variant, onRefresh, onCommandSuccess, })
                 await onRefresh();
                 throw new Error('WORKFLOW_COMMAND_SURFACE_EXPIRED');
             }
-            const result = await executeWorkflowOperation(surface, selected, values, { idempotencyKey: randomId(`workflow:${selected.key}`) });
-            message.success(`${selected.label}已提交`);
-            setSelectedState(null);
-            await onCommandSuccess(result);
+            const input = { ...values };
+            if (surface.taskForm && ['save_form', 'approve', 'resubmit'].includes(selected.key)) {
+                if (taskForm.stale)
+                    throw new Error('业务资料已更新，请先核对最新资料');
+                input.form = await taskForm.build(selected.key !== 'save_form');
+            }
+            const key = randomId(`workflow:${selected.key}`);
+            if (surface.task?.id)
+                persistLocator({ taskId: String(surface.task.id), command: selected.key,
+                    idempotencyKey: key, requestedAt: new Date().toISOString(), tokenDigest: await workflowCommandTokenDigest(commandToken) });
+            request.current = { surface, operation: selected, input: JSON.parse(JSON.stringify(input)), key };
         }
         catch (error) {
             const hasFreshSurface = Boolean(error?.data?.freshSurface);
             if (hasFreshSurface) {
-                await onRefresh();
+                await onRefresh().catch(() => undefined);
                 setSelectedState(null);
                 message.warning('内容已更新，请刷新后重试');
             }
@@ -427,13 +477,112 @@ function WorkflowOperations({ surface, variant, onRefresh, onCommandSuccess, })
                 setOperationError(failure);
                 message.error(failure);
             }
+            setSubmitting(false);
+            busyRef.current = false;
+            onBusyChange(false);
+            return;
         }
-        finally {
+        await sendRequest(false);
+    };
+    const sendRequest = async (recovering) => {
+        const wire = request.current;
+        if (!wire || (recovering && busyRef.current))
+            return;
+        setSubmitting(true);
+        busyRef.current = true;
+        onBusyChange(true);
+        setOperationError('');
+        let result;
+        try {
+            // Replay uses the exact token, input and key captured before the first write.
+            result = await executeWorkflowOperation(wire.surface, wire.operation, wire.input, { idempotencyKey: wire.key });
+        }
+        catch (error) {
+            if (!mounted.current)
+                return;
+            const rejected = !recovering && workflowTaskCommandWasRejected(error);
+            if (rejected) {
+                clearLocator(wire.key);
+                request.current = null;
+                setSelectedState(null);
+            }
+            else {
+                setUnknown(true);
+                setSelectedState(null);
+            }
+            const failure = errorMessage(error, '任务操作尚未完成');
+            setOperationError(failure);
+            if (rejected) {
+                message.error(failure);
+                // A definitive refusal permits a read, never an automatic new write.
+                // Keep this controller mounted so dirty inputs survive the fresh CAS.
+                try {
+                    await onRefresh();
+                    if (mounted.current)
+                        setRefreshFailure(null);
+                }
+                catch (reason) {
+                    if (mounted.current)
+                        setRefreshFailure({ outcome: 'rejected', message: errorMessage(reason, '最新资料读取失败') });
+                }
+            }
             setSubmitting(false);
+            busyRef.current = false;
+            onBusyChange(false);
+            return;
+        }
+        if (!mounted.current)
+            return;
+        clearLocator(wire.key);
+        request.current = null;
+        setUnknown(false);
+        setSelectedState(null);
+        taskForm.committed(wire.input.form, Number(result.dataRevision) || undefined);
+        onBusyChange(false);
+        message.success(`${wire.operation.label}已提交`);
+        // The write has succeeded. A callback or read failure can only affect refresh.
+        try {
+            await onCommandSuccess(result);
+        }
+        catch (error) {
+            if (mounted.current)
+                setRefreshFailure({ outcome: 'succeeded', message: errorMessage(error, '页面刷新失败') });
+        }
+        finally {
+            if (mounted.current) {
+                setSubmitting(false);
+                busyRef.current = false;
+                onBusyChange(false);
+            }
         }
     };
-    if (!operations.length)
-        return null;
+    const refreshConfirmed = async () => {
+        if (busyRef.current)
+            return;
+        setSubmitting(true);
+        busyRef.current = true;
+        onBusyChange(true);
+        try {
+            await onRefresh();
+            if (mounted.current)
+                setRefreshFailure(null);
+        }
+        catch (error) {
+            if (mounted.current)
+                setRefreshFailure(current => ({ outcome: current?.outcome || 'rejected', message: errorMessage(error, '页面刷新失败') }));
+        }
+        finally {
+            if (mounted.current) {
+                setSubmitting(false);
+                busyRef.current = false;
+                onBusyChange(false);
+            }
+        }
+    };
+    const commandLocked = submitting || unknown || Boolean(pendingLocator) || Boolean(refreshFailure) || confirmedReadPending;
+    const locked = commandLocked || draftLocked || fileLocked;
+    if (!operations.length && !surface.taskForm && !unknown && !refreshFailure)
+        return renderLayout({ content: null, actions: null });
     const primary = operations
         .filter((operation) => operation.placement === 'primary')
         .sort((left, right) => {
@@ -443,10 +592,13 @@ function WorkflowOperations({ surface, variant, onRefresh, onCommandSuccess, })
         return (order[left.key] ?? 10) - (order[right.key] ?? 10);
     });
     const secondary = operations.filter((operation) => operation.placement !== 'primary');
-    return (_jsxs(_Fragment, { children: [_jsxs("div", { className: `oxa-workflow-actions oxa-workflow-actions-${variant}`, children: [primary.map((operation) => (_jsx(Button, { danger: operation.emphasis === 'danger', disabled: submitting || !operation.enabled, onClick: () => selectOperation(operation), title: operation.disabledReason, type: operation.emphasis === 'primary' ? 'primary' : 'default', children: operation.label }, operation.key))), secondary.length > 0 && (_jsx(Button, { className: "oxa-workflow-more-trigger", disabled: submitting, icon: _jsx(EllipsisOutlined, {}), onClick: () => setMoreOpen((value) => !value), children: "\u66F4\u591A\u64CD\u4F5C" })), secondary.length > 0 && moreOpen && (_jsx("div", { className: "oxa-workflow-more-actions", children: secondary.map((operation) => (_jsx(Button, { disabled: submitting || !operation.enabled, onClick: () => {
+    const content = surface.taskForm || ((submitting || unknown) && !pendingLocator) || unknown || refreshFailure ? (_jsxs(_Fragment, { children: [surface.taskForm && _jsx(WorkflowTaskForm, { controller: taskForm, disabled: locked, variant: variant, taskId: surface.task?.id ? String(surface.task.id) : undefined, draftDisabled: commandLocked, onRefresh: onRefresh, onDraftBusyChange: busy => { setDraftLocked(busy); onBusyChange(busy || fileLocked || busyRef.current); }, onFileBusyChange: busy => { setFileLocked(busy); onBusyChange(busy || draftLocked || busyRef.current); }, resourceCode: surface.presentation.businessDetail.resourceCode || undefined, recordId: surface.presentation.businessDetail.recordId || undefined }), (submitting || unknown) && !pendingLocator && _jsx(WorkflowPendingCommandGuard, {}), unknown && _jsx(Alert, { type: "warning", showIcon: true, title: "\u4FDD\u7559\u4E86\u539F\u63D0\u4EA4\u8BF7\u6C42", description: operationError || '提交结果待确认，请重试原请求或查询原结果。', action: _jsx(Button, { disabled: submitting, loading: submitting, onClick: () => void sendRequest(true), children: "\u91CD\u8BD5\u539F\u8BF7\u6C42" }) }), refreshFailure && _jsx(Alert, { type: "warning", showIcon: true, title: refreshFailure.outcome === 'succeeded'
+                    ? '任务操作已成功，但资料刷新失败' : '本次未提交，最新资料读取失败', description: refreshFailure.message, action: _jsx(Button, { disabled: submitting, onClick: () => void refreshConfirmed(), children: "\u5237\u65B0\u8D44\u6599" }) })] })) : null;
+    const actions = (_jsxs(_Fragment, { children: [_jsxs("div", { className: `oxa-workflow-actions oxa-workflow-actions-${variant}`, children: [primary.map((operation) => (_jsx(Button, { danger: operation.emphasis === 'danger', disabled: locked || taskForm.stale || taskForm.draftNeedsSave || !operation.enabled, onClick: () => selectOperation(operation), title: operation.disabledReason, type: operation.emphasis === 'primary' ? 'primary' : 'default', children: operation.label }, operation.key))), secondary.length > 0 && (_jsx(Button, { className: "oxa-workflow-more-trigger", disabled: locked || taskForm.stale || taskForm.draftNeedsSave, icon: _jsx(EllipsisOutlined, {}), onClick: () => setMoreOpen((value) => !value), children: "\u66F4\u591A\u64CD\u4F5C" })), secondary.length > 0 && moreOpen && (_jsx("div", { className: "oxa-workflow-more-actions", children: secondary.map((operation) => (_jsx(Button, { disabled: locked || taskForm.stale || taskForm.draftNeedsSave || !operation.enabled, onClick: () => {
                                 setMoreOpen(false);
                                 selectOperation(operation);
                             }, type: "text", title: operation.disabledReason, children: operation.label }, operation.key))) }))] }), _jsx(OperationDialog, { error: operationError, onCancel: () => setSelectedState(null), onSubmit: (values) => void submit(values), operation: selected, submitting: submitting, variant: variant })] }));
+    return renderLayout({ content, actions });
 }
 /**
  * Shared lifecycle for the embeddable task and instance operation panels.
@@ -456,13 +608,40 @@ function WorkflowOperations({ surface, variant, onRefresh, onCommandSuccess, })
  * idempotency, and state transitions; all operation controls continue to be
  * rendered by WorkflowOperations above.
  */
-function WorkflowOperationsPanel({ identifier, surfaceKind, variant, surface: suppliedSurface, onSurfaceChange, onCompleted, onCommandCompleted, loadSurface, matchesSurface, missingIdentifierMessage, surfaceMismatchMessage, loadingLabel, loadErrorFallback, }) {
+function WorkflowOperationsPanel({ identifier, surfaceKind, variant, surface: suppliedSurface, onSurfaceChange, onCompleted, onCommandCompleted, loadSurface, matchesSurface, missingIdentifierMessage, surfaceMismatchMessage, loadingLabel, loadErrorFallback, renderLayout, }) {
     const normalizedIdentifier = identifier.trim();
+    const runtime = useOptionalRuntime();
+    const { message } = App.useApp();
+    const locatorScope = surfaceKind === 'task' && runtime
+        ? workflowTaskCommandScope(applicationCode(), runtime.identity.environment.id, runtime.identity.userId, normalizedIdentifier) : '';
+    const [locatorState, setLocatorState] = useState(() => ({ scope: locatorScope, value: locatorScope ? readPendingWorkflowTaskCommand(submissionLocatorStorage(), locatorScope) : null }));
+    const [writing, setWriting] = useState(false);
+    const [settlement, setSettlement] = useState(null);
+    const [confirmedReadFailure, setConfirmedReadFailure] = useState(null);
+    const locator = locatorState.scope === locatorScope ? locatorState.value : null;
+    useEffect(() => {
+        setLocatorState({ scope: locatorScope, value: locatorScope ? readPendingWorkflowTaskCommand(submissionLocatorStorage(), locatorScope) : null });
+    }, [locatorScope]);
+    const persistLocator = (value) => {
+        if (!locatorScope)
+            return;
+        if (!writePendingWorkflowTaskCommand(submissionLocatorStorage(), locatorScope, value))
+            message.warning('原请求已保留在当前页面，请在此确认提交结果。');
+        setLocatorState({ scope: locatorScope, value });
+    };
+    const clearLocator = (key) => {
+        if (locatorScope)
+            clearPendingWorkflowTaskCommand(submissionLocatorStorage(), locatorScope, key);
+        setLocatorState(current => current.scope === locatorScope && current.value?.idempotencyKey === key
+            ? { scope: locatorScope, value: null } : current);
+    };
     const inputSurface = suppliedSurface || null;
     const suppliedSurfaceMatches = matchesSurface(inputSurface, normalizedIdentifier);
     const initialSurface = suppliedSurfaceMatches ? inputSurface : null;
     const [surface, setSurface] = useState(initialSurface);
     const [surfaceIdentifier, setSurfaceIdentifier] = useState(initialSurface ? normalizedIdentifier : null);
+    const displayedSurfaceRef = useRef(surface);
+    displayedSurfaceRef.current = surface;
     const [acceptedInputSurface, setAcceptedInputSurface] = useState(initialSurface ? inputSurface : null);
     const [loading, setLoading] = useState(!initialSurface);
     const [loadingIdentifier, setLoadingIdentifier] = useState(initialSurface ? null : normalizedIdentifier);
@@ -514,8 +693,10 @@ function WorkflowOperationsPanel({ identifier, surfaceKind, variant, surface: su
         }
         const requestInputSurface = currentInputSurfaceRef.current;
         setAcceptedInputSurface(requestInputSurface);
-        setSurface(null);
-        setSurfaceIdentifier(null);
+        if (!matchesSurface(displayedSurfaceRef.current, requestIdentifier)) {
+            setSurface(null);
+            setSurfaceIdentifier(null);
+        }
         setLoading(true);
         setLoadingIdentifier(requestIdentifier);
         setErrorState(null);
@@ -530,7 +711,7 @@ function WorkflowOperationsPanel({ identifier, surfaceKind, variant, surface: su
                     identifier: requestIdentifier,
                     message: surfaceMismatchMessage,
                 });
-                return null;
+                throw new Error(surfaceMismatchMessage);
             }
             setSurface(nextSurface);
             setSurfaceIdentifier(requestIdentifier);
@@ -546,7 +727,7 @@ function WorkflowOperationsPanel({ identifier, surfaceKind, variant, surface: su
                     message: errorMessage(reason, loadErrorFallback),
                 });
             }
-            return null;
+            throw reason;
         }
         finally {
             if (isCurrentRequest(sequence)) {
@@ -592,9 +773,11 @@ function WorkflowOperationsPanel({ identifier, surfaceKind, variant, surface: su
                 requestSequence.current += 1;
             };
         }
-        setSurface(null);
-        setSurfaceIdentifier(null);
-        void refresh();
+        if (!matchesSurface(displayedSurfaceRef.current, normalizedIdentifier)) {
+            setSurface(null);
+            setSurfaceIdentifier(null);
+        }
+        void refresh().catch(() => undefined);
         return () => {
             activeRef.current = false;
             requestSequence.current += 1;
@@ -633,32 +816,40 @@ function WorkflowOperationsPanel({ identifier, surfaceKind, variant, surface: su
             setLoading(false);
             setLoadingIdentifier(null);
         }
-        await completeWorkflowCommand(surfaceKind, result, {
-            refresh: async () => {
-                if (!isCurrentGeneration(identifierAtStart, generationAtStart)) {
-                    return null;
-                }
-                const nextSurface = await refresh();
-                return isCurrentGeneration(identifierAtStart, generationAtStart)
-                    ? nextSurface
-                    : null;
-            },
-            onCommandCompleted: async (commandResult) => {
-                if (!isCurrentGeneration(identifierAtStart, generationAtStart)) {
-                    return;
-                }
-                await onCommandCompletedRef.current?.(commandResult);
-            },
-            onCompleted: async (nextSurface, commandResult) => {
-                if (!isCurrentGeneration(identifierAtStart, generationAtStart)) {
-                    return;
-                }
-                const callback = onCompletedRef.current;
-                if (!callback)
-                    return;
-                await callback(nextSurface, commandResult);
-            },
-        });
+        try {
+            await completeWorkflowCommand(surfaceKind, result, {
+                refresh: async () => {
+                    if (!isCurrentGeneration(identifierAtStart, generationAtStart)) {
+                        return null;
+                    }
+                    const nextSurface = await refresh();
+                    return isCurrentGeneration(identifierAtStart, generationAtStart)
+                        ? nextSurface
+                        : null;
+                },
+                onCommandCompleted: async (commandResult) => {
+                    if (!isCurrentGeneration(identifierAtStart, generationAtStart)) {
+                        return;
+                    }
+                    await onCommandCompletedRef.current?.(commandResult);
+                },
+                onCompleted: async (nextSurface, commandResult) => {
+                    if (!isCurrentGeneration(identifierAtStart, generationAtStart)) {
+                        return;
+                    }
+                    const callback = onCompletedRef.current;
+                    if (!callback)
+                        return;
+                    await callback(nextSurface, commandResult);
+                },
+            });
+            if (isCurrentGeneration(identifierAtStart, generationAtStart))
+                setConfirmedReadFailure(null);
+        }
+        catch (error) {
+            if (isCurrentGeneration(identifierAtStart, generationAtStart))
+                setConfirmedReadFailure({ result, message: errorMessage(error, '页面刷新失败') });
+        }
     }, [
         isCurrentGeneration,
         normalizedIdentifier,
@@ -689,19 +880,36 @@ function WorkflowOperationsPanel({ identifier, surfaceKind, variant, surface: su
             loadingIdentifier === normalizedIdentifier ||
             surfaceIdentifier !== normalizedIdentifier ||
             !acceptedInput);
+    const receipt = locator && _jsx(WorkflowTaskCommandReceipt, { locator: locator, busy: writing, onSettled: async (result, text) => {
+            clearLocator(locator.idempotencyKey);
+            setSettlement({ key: locator.idempotencyKey, result });
+            message.info(text);
+            try {
+                if (result)
+                    await completed(result);
+                else
+                    await refreshCurrent();
+            }
+            catch (error) {
+                message.warning(result ? '原操作已成功，请刷新查看最新资料。' : errorMessage(error, '资料刷新失败'));
+            }
+        } }, locatorScope);
+    const confirmedWarning = confirmedReadFailure && _jsx(Alert, { showIcon: true, type: "warning", title: "\u4EFB\u52A1\u64CD\u4F5C\u5DF2\u6210\u529F\uFF0C\u4F46\u9875\u9762\u5237\u65B0\u5931\u8D25", description: confirmedReadFailure.message, action: _jsx(Button, { onClick: () => void completed(confirmedReadFailure.result), children: "\u5237\u65B0\u8D44\u6599" }) });
+    const layout = (parts) => renderLayout
+        ? renderLayout({ ...parts, surface: renderSurface || undefined }) : _jsxs(_Fragment, { children: [parts.content, parts.actions] });
     if (renderLoading) {
-        return (_jsx("div", { "aria-busy": "true", "aria-label": loadingLabel, className: `oxa-workflow-actions-loading oxa-workflow-actions-loading-${variant}`, children: _jsx(Spin, {}) }));
+        return layout({ actions: null, content: (_jsxs(_Fragment, { children: [receipt, confirmedWarning, _jsx("div", { "aria-busy": "true", "aria-label": loadingLabel, className: `oxa-workflow-actions-loading oxa-workflow-actions-loading-${variant}`, children: _jsx(Spin, {}) })] })) });
     }
     if (renderError && !renderSurface) {
-        return (_jsx(Alert, { action: _jsx(Button, { onClick: () => void refresh(), children: "\u91CD\u8BD5" }), description: renderError, showIcon: true, type: "error" }));
+        return layout({ actions: null, content: (_jsxs(_Fragment, { children: [receipt, confirmedWarning, _jsx(Alert, { action: _jsx(Button, { onClick: () => void refresh().catch(() => undefined), children: "\u91CD\u8BD5" }), description: renderError, showIcon: true, type: "error" })] })) });
     }
     if (!renderSurface)
-        return null;
-    return (_jsxs(_Fragment, { children: [renderError && (_jsx(Alert, { description: renderError, showIcon: true, type: "warning" })), _jsx(WorkflowOperations, { onCommandSuccess: completed, onRefresh: refreshCurrent, surface: renderSurface, variant: variant })] }));
+        return layout({ content: receipt || confirmedWarning ? _jsxs(_Fragment, { children: [receipt, confirmedWarning] }) : null, actions: null });
+    return (_jsx(WorkflowOperations, { onCommandSuccess: completed, onRefresh: refreshCurrent, surface: renderSurface, variant: variant, pendingLocator: locator, persistLocator: persistLocator, clearLocator: clearLocator, onBusyChange: setWriting, settlement: settlement, confirmedReadPending: Boolean(confirmedReadFailure), renderLayout: ({ content, actions }) => layout({ actions, content: receipt || confirmedWarning || renderError || content ? _jsxs(_Fragment, { children: [receipt, confirmedWarning, renderError && _jsx(Alert, { description: renderError, showIcon: true, type: "warning" }), content] }) : null }) }, `${normalizedIdentifier}:${locatorScope}:${runtime?.identityEpoch || 0}`));
 }
 /** Public, embeddable Workflow task operation surface. */
-export function WorkflowTaskOperationsPanel({ taskId, variant = 'desktop', surface, onSurfaceChange, onCompleted, onCommandCompleted, }) {
-    return (_jsx(WorkflowOperationsPanel, { identifier: taskId, onCommandCompleted: onCommandCompleted, loadErrorFallback: "\u5BA1\u6279\u4EFB\u52A1\u52A0\u8F7D\u5931\u8D25", loadSurface: loadWorkflowTaskSurface, matchesSurface: workflowSurfaceMatchesTask, missingIdentifierMessage: "WORKFLOW_TASK_ID_REQUIRED", onCompleted: onCompleted, onSurfaceChange: onSurfaceChange, surface: surface, surfaceMismatchMessage: "WORKFLOW_TASK_SURFACE_TASK_MISMATCH", surfaceKind: "task", variant: variant, loadingLabel: "\u6B63\u5728\u52A0\u8F7D\u5BA1\u6279\u64CD\u4F5C" }));
+export function WorkflowTaskOperationsPanel({ taskId, variant = 'desktop', surface, onSurfaceChange, onCompleted, onCommandCompleted, renderLayout, }) {
+    return (_jsx(WorkflowOperationsPanel, { identifier: taskId, onCommandCompleted: onCommandCompleted, renderLayout: renderLayout, loadErrorFallback: "\u5BA1\u6279\u4EFB\u52A1\u52A0\u8F7D\u5931\u8D25", loadSurface: loadWorkflowTaskSurface, matchesSurface: workflowSurfaceMatchesTask, missingIdentifierMessage: "WORKFLOW_TASK_ID_REQUIRED", onCompleted: onCompleted, onSurfaceChange: onSurfaceChange, surface: surface, surfaceMismatchMessage: "WORKFLOW_TASK_SURFACE_TASK_MISMATCH", surfaceKind: "task", variant: variant, loadingLabel: "\u6B63\u5728\u52A0\u8F7D\u5BA1\u6279\u64CD\u4F5C" }));
 }
 /** Public, embeddable Workflow instance operation surface. */
 export function WorkflowInstanceOperationsPanel({ instanceId, variant = 'desktop', surface, onSurfaceChange, onCompleted, onCommandCompleted, }) {
@@ -717,7 +925,7 @@ export function WorkflowSummarySection({ surface }) {
     };
     return (_jsxs("div", { className: "oxa-workflow-summary-metadata", children: [_jsxs("span", { children: [_jsx(Typography.Text, { type: "secondary", children: "\u7533\u8BF7\u4EBA" }), _jsxs("span", { className: "oxa-workflow-applicant", children: [_jsx(PlatformAvatar, { avatarUrl: initiator.avatarUrl, size: 32 }), _jsxs("span", { children: [_jsx("strong", { children: initiator.displayName }), initiator.departmentDisplayName && (_jsx("small", { children: initiator.departmentDisplayName }))] })] })] }), _jsxs("span", { children: [_jsx(Typography.Text, { type: "secondary", children: "\u63D0\u4EA4\u65F6\u95F4" }), formatTime(summary.submittedAt)] }), summary.businessNumber && (_jsxs("span", { children: [_jsx(Typography.Text, { type: "secondary", children: "\u4E1A\u52A1\u7F16\u53F7" }), summary.businessNumber] }))] }));
 }
-function StandardWorkflowDetailRenderer({ surface, timeline, warning, operations, variant, onClose, onEdit, drawer, drawerState, newPageHref, editing, busy, }) {
+function StandardWorkflowDetailRenderer({ surface, timeline, warning, operations, taskContent, variant, onClose, onEdit, drawer, drawerState, newPageHref, editing, busy, }) {
     const navigate = useNavigate();
     const timeZone = usePresentationTimeZone();
     const [tab, setTab] = useState('application');
@@ -735,13 +943,13 @@ function StandardWorkflowDetailRenderer({ surface, timeline, warning, operations
     const loadAudit = useCallback(() => loadWorkflowDataAudit(instance.id), [instance.id]);
     const back = onClose || (() => navigate(variant === 'mobile' ? '/m/work-center' : '/work-center'));
     return _jsxs(RecordDetailFrame, { variant: variant, title: "\u7533\u8BF7\u8BE6\u60C5", heading: title, status: _jsx(StatusTag, { status: instance.status }), metadata: [summary.initiator?.displayName || summary.initiatorDisplayName, summary.initiator?.departmentDisplayName || summary.departmentDisplayName,
-            summary.submittedAt ? `${detailTime(summary.submittedAt, timeZone)} 创建` : ''].filter(Boolean).join(' · '), updatedAt: business.record.updated_at || instance.completedAt || instance.startedAt, onClose: back, onEdit: edit, editing: editing, busy: busy, drawer: drawer, drawerState: drawerState, newPageHref: newPageHref, footer: hasActions || edit ? _jsxs(_Fragment, { children: [operations, edit && _jsx(Button, { onClick: edit, children: "\u7F16\u8F91" })] }) : null, children: [warning && _jsx(Alert, { description: warning, showIcon: true, type: "warning" }), !workflowHasEnded(instance) && activeNode && _jsxs("div", { className: `oxa-workflow-current-node is-${bannerTone}`, role: "status", children: [_jsxs("span", { children: [_jsx(ClockCircleOutlined, {}), "\u5F53\u524D\u8282\u70B9\uFF1A", activeNode.title] }), people && _jsxs("span", { children: ["\u7B49\u5F85", people, "\u5904\u7406"] })] }), _jsx(Tabs, { activeKey: tab, onChange: setTab, items: [
+            summary.submittedAt ? `${detailTime(summary.submittedAt, timeZone)} 创建` : ''].filter(Boolean).join(' · '), updatedAt: business.record.updated_at || instance.completedAt || instance.startedAt, onClose: back, onEdit: edit, editing: editing, busy: busy, drawer: drawer, drawerState: drawerState, newPageHref: newPageHref, footer: operations || hasActions || edit ? _jsxs(_Fragment, { children: [operations, edit && _jsx(Button, { onClick: edit, children: "\u7F16\u8F91" })] }) : null, children: [warning && _jsx(Alert, { description: warning, showIcon: true, type: "warning" }), !workflowHasEnded(instance) && activeNode && _jsxs("div", { className: `oxa-workflow-current-node is-${bannerTone}`, role: "status", children: [_jsxs("span", { children: [_jsx(ClockCircleOutlined, {}), "\u5F53\u524D\u8282\u70B9\uFF1A", activeNode.title] }), people && _jsxs("span", { children: ["\u7B49\u5F85", people, "\u5904\u7406"] })] }), _jsx(Tabs, { activeKey: tab, onChange: setTab, items: [
                     { key: 'application', label: '申请内容', children: _jsx(WorkflowBusinessDetailSections, { surface: surface, variant: variant }) },
                     { key: 'history', label: '审批历史', children: _jsx(WorkflowTimelineSection, { timeline: timeline }) },
                     { key: 'changes', label: '变更记录', children: tab === 'changes' && business.surface && business.resourceCode && business.recordId
                             ? _jsx(RecordChangeHistory, { resourceCode: business.resourceCode, recordId: business.recordId, surface: business.surface, readable: () => true, loadPage: loadAudit })
                             : _jsx(Empty, { description: "\u6682\u65E0\u53D8\u66F4\u8BB0\u5F55" }) },
-                ] })] });
+                ] }), taskContent && _jsx("div", { className: "oxa-workflow-task-content", children: taskContent })] });
 }
 export function DesktopWorkflowDetailRenderer(props) {
     return _jsx(StandardWorkflowDetailRenderer, { ...props, variant: "desktop" });
@@ -816,7 +1024,7 @@ export function useWorkflowDetail({ kind, id, resourceCode }) {
         refresh,
     };
 }
-function WorkflowDetailPage({ kind, variant, resourceCode, recordId, onDismiss, drawerState }) {
+function WorkflowDetailPage({ kind, variant, resourceCode, recordId, onDismiss, drawerState, returnPath }) {
     const params = useParams();
     const id = recordId || String(kind === 'task' ? params.taskId || '' : kind === 'record' ? params.id || '' : params.instanceId || '');
     const navigate = useNavigate();
@@ -829,11 +1037,7 @@ function WorkflowDetailPage({ kind, variant, resourceCode, recordId, onDismiss,
     const business = surface ? surfaceBusinessDetail(surface) : null;
     const detailPath = surface ? (variant === 'mobile' ? surface.detailNavigation.mobilePath : surface.detailNavigation.desktopPath) : '';
     const newPageHref = useHref(detailPath || '.');
-    const close = onDismiss || (() => navigate(detail ? variant === 'mobile' ? detail.navigationContext.mobileReturnPath : detail.navigationContext.desktopReturnPath : variant === 'mobile' ? '/m/work-center' : '/work-center'));
-    if (!surface || !detail || !instance)
-        return _jsx(RecordDetailFrame, { variant: variant, title: "\u7533\u8BF7\u8BE6\u60C5", drawer: Boolean(onDismiss), drawerState: drawerState, onClose: close, children: loading ? _jsx(Spin, {}) : _jsx(Result, { status: "error", title: "\u6D41\u7A0B\u8BE6\u60C5\u52A0\u8F7D\u5931\u8D25", subTitle: error || '流程不存在', extra: _jsx(Button, { onClick: () => void refresh(), children: "\u91CD\u8BD5" }) }) });
-    if (surface.detailNavigation.custom)
-        return _jsx(Navigate, { replace: true, to: detailPath });
+    const close = onDismiss || (() => navigate(returnPath || (detail ? variant === 'mobile' ? detail.navigationContext.mobileReturnPath : detail.navigationContext.desktopReturnPath : variant === 'mobile' ? '/m/work-center' : '/work-center')));
     const onCommandCompleted = async (result) => {
         if (kind === 'task' && result.advanced === true) {
             const nextId = String(result.instanceId || '').trim();
@@ -845,18 +1049,22 @@ function WorkflowDetailPage({ kind, variant, resourceCode, recordId, onDismiss,
         else
             await refresh();
     };
-    const operations = task
-        ? _jsx(WorkflowTaskOperationsPanel, { onCommandCompleted: onCommandCompleted, surface: surface, taskId: task.id, variant: variant }, task.id)
-        : _jsx(WorkflowInstanceOperationsPanel, { instanceId: instance.id, onCommandCompleted: onCommandCompleted, surface: surface, variant: variant });
-    return _jsx(StandardWorkflowDetailRenderer, { surface: surface, timeline: timeline, warning: error, operations: operations, variant: variant, drawer: Boolean(onDismiss), drawerState: drawerState, newPageHref: newPageHref, onClose: editing ? () => { if (!editBusy)
+    if (!surface || !detail || !instance)
+        return _jsxs(RecordDetailFrame, { variant: variant, title: "\u7533\u8BF7\u8BE6\u60C5", drawer: Boolean(onDismiss), drawerState: drawerState, onClose: close, children: [kind === 'task' && readPendingWorkflowTaskCommand(submissionLocatorStorage(), workflowTaskCommandScope(applicationCode(), identity.environment.id, identity.userId, id)) &&
+                    _jsx(WorkflowTaskOperationsPanel, { taskId: id, variant: variant, onCommandCompleted: onCommandCompleted }), loading ? _jsx(Spin, {}) : _jsx(Result, { status: "error", title: "\u6D41\u7A0B\u8BE6\u60C5\u52A0\u8F7D\u5931\u8D25", subTitle: error || '流程不存在', extra: _jsx(Button, { onClick: () => void refresh(), children: "\u91CD\u8BD5" }) })] });
+    if (surface.detailNavigation.custom)
+        return _jsx(Navigate, { replace: true, to: detailPath });
+    const renderDetail = (operations, taskContent, currentSurface = surface) => _jsx(StandardWorkflowDetailRenderer, { surface: currentSurface, timeline: timeline, warning: error, operations: operations, taskContent: taskContent, variant: variant, drawer: Boolean(onDismiss), drawerState: drawerState, newPageHref: newPageHref, onClose: editing ? () => { if (!editBusy)
             setEditing(false); } : close, busy: editBusy, editing: editing && business?.resourceCode && business.recordId ? _jsx(WorkflowRecordEditor, { resourceCode: business.resourceCode, recordId: business.recordId, variant: variant, presentation: "embedded", onBusyChange: setEditBusy, onDismiss: () => setEditing(false), onSaved: () => { setEditing(false); void refresh(); } }) : undefined, onEdit: workflowHasEnded(instance) && identity.isAppSuperAdmin && (business?.status === 'ready' || business?.status === 'stale') ? () => setEditing(true) : undefined });
+    return task ? _jsx(WorkflowTaskOperationsPanel, { onCommandCompleted: onCommandCompleted, surface: surface, taskId: task.id, variant: variant, renderLayout: ({ content, actions, surface: currentSurface }) => renderDetail(actions, content, currentSurface) }, task.id)
+        : renderDetail(_jsx(WorkflowInstanceOperationsPanel, { instanceId: instance.id, onCommandCompleted: onCommandCompleted, surface: surface, variant: variant }));
 }
 export function WorkflowRecordDetailPage({ variant = 'desktop', ...props }) { return _jsx(WorkflowDetailPage, { ...props, variant: variant, kind: "record" }); }
-export function WorkflowTaskPage({ variant = 'desktop', }) {
-    return _jsx(WorkflowDetailPage, { kind: "task", variant: variant });
+export function WorkflowTaskPage({ variant = 'desktop', returnPath, }) {
+    return _jsx(WorkflowDetailPage, { kind: "task", variant: variant, returnPath: returnPath });
 }
-export function WorkflowInstancePage({ variant = 'desktop', }) {
-    return _jsx(WorkflowDetailPage, { kind: "instance", variant: variant });
+export function WorkflowInstancePage({ variant = 'desktop', returnPath, }) {
+    return _jsx(WorkflowDetailPage, { kind: "instance", variant: variant, returnPath: returnPath });
 }
 const WORK_VIEWS = [
     { value: 'created', label: '我创建的' }, { value: 'pending', label: '待我审批' },