@chenchaolong/plugin-trade-compliance-workbench 1.0.6 → 1.0.8

package/dist/lib/remote-ui/app-source.js

@@ -2,20 +2,24 @@ import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-run
 import React from 'react';
 import { createRoot } from 'react-dom/client';
 import { createRemoteBridge } from './bridge.js';
-import { createBlobUrlOwner, createLatestCommittedRequest, createLatestRequestGate, normalizeWorkbenchData, routeDataRequest, unwrapResponse } from './model.js';
+import { resolvePaginationPageSize } from './contracts.js';
+import { clampPageAfterSingleDeletion, createBlobUrlOwner, createKeyedLatestRequestGate, createLatestCommittedRequest, createLatestRequestGate, generatedFileHistoryKey, normalizeWorkbenchData, routeDataRequest, runKeyedLatestRequest, unwrapResponse } from './model.js';
 import { encodeViewFilters } from '../view-parameters.js';
 import { InfoNotice } from './components/data-grid.js';
-import { LoadingBlocker, Toast } from './components/forms.js';
+import { LoadingBlocker, ToastStack } from './components/forms.js';
+import { addToast, createToastId, createToastTimerRegistry, removeToast } from './toast-queue.js';
 import { buildBreadcrumbs, WorkbenchShell } from './components/layout.js';
-import { CatalogCommands, CatalogImportError, ControlledGoodsPage, findActiveCatalogImportTask, findLatestFailedCatalogImportTask, runCatalogImportOrchestration, SanctionedCompaniesPage } from './pages/catalogs.js';
+import { CatalogCommands, CatalogImportError, ControlledGoodsPage, findActiveCatalogImportTasks, findLatestFailedCatalogImportTask, runCatalogImportOrchestration, SanctionedCompaniesPage } from './pages/catalogs.js';
 import { HomePage } from './pages/home.js';
 import { ProcurementPage } from './pages/procurement.js';
 import { CustomerContractsPage, adaptCustomerContractReview } from './pages/contracts.js';
 import { SalesPage } from './pages/sales.js';
 import { SalesFilesPage } from './pages/files.js';
-import { AnalyticsPage } from './pages/analytics.js';
+import { AnalyticsPage, AnalyticsPrototypeBoard } from './pages/analytics.js';
 import { SettingsPage } from './pages/settings.js';
-import { ContractImportError, findRecoverableContractImport, findResumableContractImport, runContractImportOrchestration, runCustomerContractReanalysis } from './contract-import.js';
+import { ContractImportError, findRecoverableContractImport, findResumableContractImports, runContractImportOrchestration, runCustomerContractReanalysis, taskTransition } from './contract-import.js';
+import { compareTaskBusinessOrder, createPendingResultQueue, createPollingTaskTracker, isAbortError, isPollingObservationTimeout, submitAndRefreshTaskState } from './polling.js';
+import { executeWorkbenchAction } from './action-execution.js';
 import './styles.css';
 const pageMeta = {
     home: { title: '首页', subtitle: '查看系统风险操作提示与外贸合规业务流程。' },
@@ -30,24 +34,50 @@ const pageMeta = {
 };
 const bridge = createRemoteBridge();
 const initialAnalyticsQuery = { mode: 'PURCHASE', dimension: 'SUPPLIER', filters: {}, page: 1, pageSize: 20 };
+function comparePendingReviewBusinessOrder(left, right) {
+    const leftTask = left.kind === 'CONTRACT_IMPORT' ? left.completion.task : left.result.run;
+    const rightTask = right.kind === 'CONTRACT_IMPORT' ? right.completion.task : right.result.run;
+    return compareTaskBusinessOrder(leftTask, rightTask);
+}
+class ActionResponseError extends Error {
+    constructor(message, code) {
+        super(message);
+        this.code = code;
+        this.name = 'ActionResponseError';
+    }
+}
 let excelEditorRuntimePromise = null;
 function App() {
     const [route, setRoute] = React.useState({ type: 'page', page: 'home' });
     const routeRef = React.useRef(route);
     const contextRef = React.useRef(null);
     const requestGateRef = React.useRef(createLatestRequestGate());
+    const taskStateRequestGateRef = React.useRef(createLatestRequestGate());
+    const taskRecoveryTimerRef = React.useRef(null);
     const routeRequestGateRef = React.useRef(createLatestRequestGate());
+    const settingsRatesRequestGateRef = React.useRef(createLatestRequestGate());
+    const generatedFilesRequestGateRef = React.useRef(createKeyedLatestRequestGate());
+    const activeGeneratedFilesKeyRef = React.useRef(null);
+    const settingsRatesQueryRef = React.useRef({ page: 1, pageSize: 20 });
     const analyticsRequestsRef = React.useRef(createLatestCommittedRequest(initialAnalyticsQuery));
     const [analyticsCommittedQuery, setAnalyticsCommittedQuery] = React.useState(initialAnalyticsQuery);
+    const analyticsPrototypeListenerCleanupRef = React.useRef(null);
+    const [analyticsPrototypeVisible, setAnalyticsPrototypeVisible] = React.useState(false);
     const [data, setData] = React.useState(() => normalizeWorkbenchData(null));
     const [busy, setBusy] = React.useState(false);
     const [actionBusy, setActionBusy] = React.useState(false);
     const [catalogCommand, setCatalogCommand] = React.useState(null);
-    const [importCompletion, setImportCompletion] = React.useState(null);
+    const [importCompletions, setImportCompletions] = React.useState({ CONTROLLED_CATALOG: null, SANCTION_CATALOG: null });
     const [importFailures, setImportFailures] = React.useState({ CONTROLLED_CATALOG: null, SANCTION_CATALOG: null });
-    const runningImportTaskRef = React.useRef(null);
-    const runningContractTasksRef = React.useRef(new Set());
-    const handledContractTasksRef = React.useRef({ PURCHASE_CONTRACT: null, CUSTOMER_CONTRACT: null });
+    const catalogTaskTrackerRef = React.useRef(createPollingTaskTracker());
+    const contractTaskTrackerRef = React.useRef(createPollingTaskTracker());
+    const reanalysisTaskTrackerRef = React.useRef(createPollingTaskTracker());
+    const handledContractTasksRef = React.useRef(new Set());
+    const handledReanalysisResultsRef = React.useRef(new Set());
+    const pendingReviewResultsRef = React.useRef(createPendingResultQueue(item => item.kind === 'CONTRACT_IMPORT' ? item.completion.task.id : item.result.run.id, comparePendingReviewBusinessOrder));
+    const activeReviewResultRef = React.useRef(null);
+    const presentNextReviewRef = React.useRef(() => undefined);
+    const reviewPresentationTimerRef = React.useRef(null);
     const blobUrlOwnerRef = React.useRef(createBlobUrlOwner());
     const changeRouteRef = React.useRef(() => undefined);
     const [procurementContext, setProcurementContext] = React.useState({ supplier: null, order: null, metrics: null });
@@ -57,15 +87,34 @@ function App() {
     const [customerReanalysisState, setCustomerReanalysisState] = React.useState({ status: 'IDLE' });
     const [activeSalesFileOrder, setActiveSalesFileOrder] = React.useState(null);
     const [editingSalesFile, setEditingSalesFile] = React.useState(null);
-    const [toast, setToast] = React.useState(null);
+    const [toasts, setToasts] = React.useState([]);
+    const [toastTimers] = React.useState(() => createToastTimerRegistry((id) => setToasts((items) => removeToast(items, id))));
     const [analyticsError, setAnalyticsError] = React.useState(null);
+    const setToast = React.useCallback((toast) => {
+        setToasts((items) => addToast(items, toast, createToastId));
+    }, []);
+    const closeToast = React.useCallback((id) => {
+        toastTimers.dismiss(id);
+        setToasts((items) => removeToast(items, id));
+    }, [toastTimers]);
+    const configureAnalyticsPrototypeCapability = React.useCallback((parameters) => {
+        analyticsPrototypeListenerCleanupRef.current?.();
+        analyticsPrototypeListenerCleanupRef.current = null;
+        setAnalyticsPrototypeVisible(false);
+        if (parameters.visualCheck !== true)
+            return;
+        const showPrototypeBoard = () => setAnalyticsPrototypeVisible(true);
+        window.addEventListener('analytics-prototype-board', showPrototypeBoard);
+        analyticsPrototypeListenerCleanupRef.current = () => window.removeEventListener('analytics-prototype-board', showPrototypeBoard);
+    }, []);
     const loadRoute = React.useCallback(async (targetRoute, page = 1, pageSize = 20, filters = {}) => {
-        const request = routeDataRequest(targetRoute, page, pageSize, filters);
+        const requestedPageSize = resolvePaginationPageSize(pageSize);
+        const request = routeDataRequest(targetRoute, page, requestedPageSize, filters);
         if (!request)
             return;
         const collection = String(asRecord(request.parameters).collection);
         const requests = collection === 'analytics' ? analyticsRequestsRef.current : routeRequestGateRef.current;
-        const analyticsCandidate = collection === 'analytics' ? analyticsQueryFromRoute(page, pageSize, filters) : null;
+        const analyticsCandidate = collection === 'analytics' ? analyticsQueryFromRoute(page, requestedPageSize, filters) : null;
         const requestId = analyticsCandidate ? analyticsRequestsRef.current.begin(analyticsCandidate) : routeRequestGateRef.current.begin();
         setBusy(true);
         try {
@@ -78,15 +127,18 @@ function App() {
                 setAnalyticsCommittedQuery(analyticsRequestsRef.current.committed());
                 setData(current => ({ ...current, analytics: normalizeWorkbenchData({ summary: { analytics: payload } }).analytics }));
             }
-            else if (collection === 'settings')
-                setData(current => ({ ...current, settings: normalizeWorkbenchData({ summary: { settings: payload } }).settings }));
+            else if (collection === 'settings') {
+                const settings = normalizeWorkbenchData({ summary: { settings: payload } }).settings;
+                settingsRatesQueryRef.current = { page: settings.rates.page, pageSize: settings.rates.pageSize };
+                setData(current => ({ ...current, settings }));
+            }
             else
                 setData(current => ({
                     ...current,
                     [collection]: {
                         ...payload,
                         items: Array.isArray(payload.items) ? payload.items : [],
-                        total: numberValue(payload.total, 0), page: numberValue(payload.page, page), pageSize: numberValue(payload.pageSize, pageSize)
+                        total: numberValue(payload.total, 0), page: numberValue(payload.page, page), pageSize: requestedPageSize
                     }
                 }));
             if (targetRoute.type === 'procurement')
@@ -116,7 +168,7 @@ function App() {
         const requestId = gate.begin();
         setBusy(true);
         try {
-            const response = await bridge.requestData({ page: 1, pageSize: 200, parameters: active.initialQuery?.parameters ?? {} });
+            const response = await bridge.requestData({ page: 1, pageSize: 100, parameters: active.initialQuery?.parameters ?? {} });
             if (gate.isLatest(requestId)) {
                 const normalized = normalizeWorkbenchData(response);
                 bridge.configure({ uploadPolicy: normalized.uploadPolicy });
@@ -133,9 +185,68 @@ function App() {
             setBusy(gate.activeCount() + routeRequestGateRef.current.activeCount() + analyticsRequestsRef.current.activeCount() > 0);
         }
     }, [loadRoute]);
+    const loadTaskState = React.useCallback(async () => {
+        const active = contextRef.current;
+        if (!active)
+            return false;
+        const gate = taskStateRequestGateRef.current;
+        const requestId = gate.begin();
+        try {
+            const response = await bridge.requestData({ page: 1, pageSize: 100, parameters: active.initialQuery?.parameters ?? {} });
+            if (!gate.commit(requestId))
+                return false;
+            const normalized = normalizeWorkbenchData(response);
+            setData(current => ({
+                ...current,
+                controlledGoods: normalized.controlledGoods,
+                controlledBatches: normalized.controlledBatches,
+                sanctionedCompanies: normalized.sanctionedCompanies,
+                sanctionBatches: normalized.sanctionBatches,
+                importTasks: normalized.importTasks,
+                customerContractAnalyses: normalized.customerContractAnalyses
+            }));
+            return true;
+        }
+        catch (error) {
+            if (gate.isLatest(requestId))
+                setToast({ message: error instanceof Error ? `任务状态刷新失败：${error.message}` : '任务状态刷新失败', tone: 'error' });
+            return false;
+        }
+        finally {
+            gate.finish(requestId);
+        }
+    }, []);
+    const scheduleTaskStateRecovery = React.useCallback(() => {
+        if (taskRecoveryTimerRef.current != null)
+            return;
+        taskRecoveryTimerRef.current = window.setInterval(() => {
+            void loadTaskState().then(refreshed => {
+                if (!refreshed || taskRecoveryTimerRef.current == null)
+                    return;
+                window.clearInterval(taskRecoveryTimerRef.current);
+                taskRecoveryTimerRef.current = null;
+            });
+        }, 2000);
+    }, [loadTaskState]);
+    React.useEffect(() => () => {
+        if (taskRecoveryTimerRef.current != null)
+            window.clearInterval(taskRecoveryTimerRef.current);
+        if (reviewPresentationTimerRef.current != null)
+            window.clearTimeout(reviewPresentationTimerRef.current);
+    }, []);
+    React.useEffect(() => {
+        return () => catalogTaskTrackerRef.current.abortAll();
+    }, []);
+    React.useEffect(() => {
+        return () => contractTaskTrackerRef.current.abortAll();
+    }, []);
+    React.useEffect(() => {
+        return () => reanalysisTaskTrackerRef.current.abortAll();
+    }, []);
     React.useEffect(() => {
         bridge.start({
             onInit(nextContext) {
+                configureAnalyticsPrototypeCapability(asRecord(nextContext.initialQuery?.parameters));
                 contextRef.current = nextContext;
                 const normalized = normalizeWorkbenchData(nextContext.payload);
                 bridge.configure({ uploadPolicy: normalized.uploadPolicy });
@@ -146,86 +257,94 @@ function App() {
                 void load();
             }
         });
-        return () => { blobUrlOwnerRef.current.dispose(); bridge.destroy(); };
-    }, [load]);
+        return () => {
+            analyticsPrototypeListenerCleanupRef.current?.();
+            analyticsPrototypeListenerCleanupRef.current = null;
+            blobUrlOwnerRef.current.dispose();
+            bridge.destroy();
+        };
+    }, [configureAnalyticsPrototypeCapability, load]);
+    React.useEffect(() => () => toastTimers.dispose(), [toastTimers]);
     React.useEffect(() => {
         const timer = window.setTimeout(() => bridge.reportResize(), 0);
         return () => window.clearTimeout(timer);
     }, [route, data, busy]);
     React.useEffect(() => {
-        if (!toast)
-            return;
-        const timer = window.setTimeout(() => setToast(null), 4200);
-        return () => window.clearTimeout(timer);
-    }, [toast]);
+        toastTimers.sync(toasts);
+    }, [toastTimers, toasts]);
     const executeAction = React.useCallback(async (actionKey, input) => {
         setActionBusy(true);
         try {
-            const result = asActionResult(unwrapResponse(await bridge.executeAction(actionKey, input)));
-            if (result.success === false)
-                throw new Error(resolveActionMessage(result) || '操作失败');
-            if (actionKey === 'download_import_issues')
-                downloadActionFile(result.data);
-            if (result.refresh && shouldRefreshAfterAction(actionKey))
-                await load();
-            setToast({ message: resolveActionMessage(result) || '操作成功', tone: 'success' });
-            return result;
-        }
-        catch (error) {
-            setToast({ message: error instanceof Error ? error.message : '操作失败', tone: 'error' });
-            throw error;
+            return await executeWorkbenchAction({
+                actionKey,
+                mutate: async () => asActionResult(unwrapResponse(await bridge.executeAction(actionKey, input))),
+                refresh: load,
+                notify: setToast,
+                resolveMessage: resolveActionMessage,
+                onResult: result => { if (actionKey === 'download_import_issues' || actionKey === 'download_sales_file')
+                    downloadActionFile(result.data); }
+            });
         }
         finally {
             setActionBusy(false);
         }
     }, [load]);
     const executeSalesFileAction = React.useCallback((actionKey, input) => executeAction(actionKey, input), [executeAction]);
-    const orchestrateImport = React.useCallback(async (start) => {
+    const schedulePendingReviewPresentation = React.useCallback(() => {
+        if (reviewPresentationTimerRef.current != null)
+            return;
+        reviewPresentationTimerRef.current = window.setTimeout(() => {
+            reviewPresentationTimerRef.current = null;
+            presentNextReviewRef.current();
+        }, 0);
+    }, []);
+    const enqueuePendingReview = React.useCallback((result) => {
+        pendingReviewResultsRef.current.enqueue(result);
+        schedulePendingReviewPresentation();
+    }, [schedulePendingReviewPresentation]);
+    const orchestrateImport = React.useCallback(async (start, signal) => {
         const taskId = start.data?.task.id;
         if (!taskId)
             throw new Error('解析响应缺少任务标识');
-        if (runningImportTaskRef.current === taskId)
-            throw new Error('该目录任务正在解析中');
-        runningImportTaskRef.current = taskId;
-        setActionBusy(true);
         const documentType = start.data?.task.documentType;
         if (documentType)
             setImportFailures((current) => ({ ...current, [documentType]: null }));
         try {
             const completion = await runCatalogImportOrchestration({
                 start,
-                invokeClientCommand: (commandKey, payload) => bridge.invokeClientCommand(commandKey, payload),
-                markCommandDispatched: async (taskId) => {
-                    const result = asActionResult(unwrapResponse(await bridge.executeAction('mark_import_command_dispatched', { taskId })));
-                    if (result.success === false)
-                        throw new Error(resolveActionMessage(result) || '记录解析命令状态失败');
-                },
                 pollTask: async (taskId) => asImportCompletion(unwrapResponse(await bridge.requestData({ parameters: { collection: 'importTask', taskId } }))),
-                refresh: load
+                refresh: loadTaskState,
+                signal,
+                onTransition: (previous, next) => {
+                    const notice = taskTransition(previous, next);
+                    if (notice)
+                        setToast(notice);
+                },
+                onPollError: error => setToast({ message: `任务状态查询失败：${error.message}`, tone: 'error' })
             });
-            setImportCompletion(completion);
-            setToast({ message: '目录导入完成', tone: 'success' });
+            setImportCompletions(current => ({ ...current, [completion.task.documentType]: completion }));
             return completion;
         }
         catch (error) {
-            if (error instanceof CatalogImportError)
+            if (isAbortError(error))
+                throw error;
+            if (isPollingObservationTimeout(error)) {
+                setToast({ message: '任务仍在后台处理中，将继续跟踪', tone: 'info' });
+                scheduleTaskStateRecovery();
+                throw error;
+            }
+            if (error instanceof CatalogImportError) {
                 setImportFailures((current) => ({ ...current, [error.task.documentType]: error.task }));
-            setToast({ message: error instanceof Error ? error.message : '目录解析失败', tone: 'error' });
+            }
+            else
+                setToast({ message: error instanceof Error ? error.message : '目录解析失败', tone: 'error' });
             throw error;
         }
-        finally {
-            runningImportTaskRef.current = null;
-            setActionBusy(false);
-        }
-    }, [load]);
-    const orchestrateContractImport = React.useCallback(async (start) => {
+    }, [loadTaskState, scheduleTaskStateRecovery]);
+    const orchestrateContractImport = React.useCallback(async (start, signal) => {
         const task = start.data?.task;
         if (!task)
             throw new Error('解析响应缺少合同任务标识');
-        if (runningContractTasksRef.current.has(task.id))
-            throw new Error('该合同任务正在解析中');
-        runningContractTasksRef.current.add(task.id);
-        setActionBusy(true);
         if (task.documentType === 'PURCHASE_CONTRACT') {
             blobUrlOwnerRef.current.clear('purchase');
             setPurchaseImportTask(task);
@@ -238,29 +357,28 @@ function App() {
         try {
             const completion = await runContractImportOrchestration({
                 start,
-                invokeClientCommand: (commandKey, payload) => bridge.invokeClientCommand(commandKey, payload),
-                markCommandDispatched: async (taskId) => {
-                    const result = asActionResult(unwrapResponse(await bridge.executeAction('mark_import_command_dispatched', { taskId })));
-                    if (result.success === false)
-                        throw new Error(resolveActionMessage(result) || '记录解析命令状态失败');
+                signal,
+                pollTask: async (taskId) => asContractCompletion(unwrapResponse(await bridge.requestData({ parameters: { collection: 'importTask', taskId } }))),
+                onTransition: (previous, next) => {
+                    const notice = taskTransition(previous, next);
+                    if (notice)
+                        setToast(notice);
                 },
-                pollTask: async (taskId) => asContractCompletion(unwrapResponse(await bridge.requestData({ parameters: { collection: 'importTask', taskId } })))
+                onPollError: error => setToast({ message: `任务状态查询失败：${error.message}`, tone: 'error' })
             });
-            handledContractTasksRef.current[task.documentType] = task.id;
             if (completion.task.status === 'AWAITING_REVIEW') {
-                if (completion.task.documentType === 'PURCHASE_CONTRACT') {
-                    const draft = adaptPurchaseReview(completion.task);
-                    setPurchaseImportTask(completion.task);
-                    setPurchaseReviewDraft(await attachPurchaseSource(draft, completion.task, blobUrlOwnerRef.current));
-                }
-                else {
-                    const review = adaptCustomerContractReview(completion.task.resultPayload, { reviewSource: 'IMPORT_DRAFT', importTaskId: completion.task.id, sourceFileId: completion.task.sourceFileId ?? '', sourceFileName: completion.task.sourceFileName ?? '' });
-                    setCustomerImportState({ status: 'AWAITING_REVIEW', importTaskId: completion.task.id, review: await attachCustomerSource(review, blobUrlOwnerRef.current) });
-                }
+                enqueuePendingReview({ kind: 'CONTRACT_IMPORT', completion });
             }
             return completion;
         }
         catch (error) {
+            if (isAbortError(error))
+                throw error;
+            if (isPollingObservationTimeout(error)) {
+                setToast({ message: '任务仍在后台处理中，将继续跟踪', tone: 'info' });
+                scheduleTaskStateRecovery();
+                throw error;
+            }
             const failed = error instanceof ContractImportError ? error.task : task;
             if (task.documentType === 'PURCHASE_CONTRACT') {
                 setPurchaseImportTask({ ...failed, status: failed.status === 'TIMED_OUT' ? 'TIMED_OUT' : 'FAILED', errorMessage: error instanceof Error ? error.message : '采购合同解析失败' });
@@ -268,62 +386,58 @@ function App() {
             }
             else
                 setCustomerImportState({ status: 'FAILED', importTaskId: failed.id, message: error instanceof Error ? error.message : '客户合同解析失败' });
-            setToast({ message: error instanceof Error ? error.message : '合同解析失败', tone: 'error' });
+            if (!(error instanceof ContractImportError))
+                setToast({ message: error instanceof Error ? error.message : '合同解析失败', tone: 'error' });
             throw error;
         }
-        finally {
-            runningContractTasksRef.current.delete(task.id);
-            setActionBusy(false);
-        }
-    }, []);
-    const executeFileAction = React.useCallback(async (actionKey, file, input) => {
+    }, [enqueuePendingReview, scheduleTaskStateRecovery]);
+    const executeFileAction = React.useCallback(async (actionKey, file, input, notifyError = true) => {
         try {
-            const start = asActionResult(unwrapResponse(await bridge.executeFileAction(actionKey, file, input)));
+            const raw = await submitAndRefreshTaskState(() => bridge.executeFileAction(actionKey, file, input), loadTaskState);
+            const start = asActionResult(unwrapResponse(raw));
             if (start.success === false)
-                throw new Error(resolveActionMessage(start) || '上传失败');
-            if (actionKey === 'upload_purchase_contract' || actionKey === 'upload_customer_contract') {
-                const completion = await orchestrateContractImport(start);
-                return { success: true, data: completion, message: '合同解析完成，等待审核', refresh: false };
-            }
-            const completion = await orchestrateImport(start);
-            return { success: true, data: completion, message: '目录导入完成', refresh: true };
+                throw actionResponseError(start, '上传失败');
+            setToast({ message: resolveActionMessage(start) || '解析任务已提交', tone: 'info' });
+            return start;
         }
         catch (error) {
-            if (!(error instanceof CatalogImportError))
+            if (notifyError && !(error instanceof CatalogImportError))
                 setToast({ message: error instanceof Error ? error.message : '上传失败', tone: 'error' });
             throw error;
         }
-    }, [orchestrateContractImport, orchestrateImport]);
+    }, [loadTaskState]);
+    const executeCatalogFileAction = React.useCallback((actionKey, file, input) => executeFileAction(actionKey, file, input, false), [executeFileAction]);
     React.useEffect(() => {
         const tasks = data.importTasks.items;
         setImportFailures({
             CONTROLLED_CATALOG: findLatestFailedCatalogImportTask(tasks, 'CONTROLLED_CATALOG'),
             SANCTION_CATALOG: findLatestFailedCatalogImportTask(tasks, 'SANCTION_CATALOG')
         });
-        const active = findActiveCatalogImportTask(tasks);
-        if (active && runningImportTaskRef.current !== active.id && active.executionCommand) {
-            void orchestrateImport({ success: true, data: { task: active, commands: [active.executionCommand], polling: { intervalMs: 2000, timeoutMs: 1200000 } } }).catch(() => undefined);
-            return;
+        for (const active of findActiveCatalogImportTasks(tasks)) {
+            const running = catalogTaskTrackerRef.current.run(active.id, signal => orchestrateImport({ success: true, data: { task: active } }, signal));
+            if (running)
+                void running.catch(() => undefined);
         }
     }, [data.importTasks.items, orchestrateImport]);
     React.useEffect(() => {
         const tasks = data.importTasks.items;
+        for (const resumable of findResumableContractImports(tasks)) {
+            if (handledContractTasksRef.current.has(resumable.id))
+                continue;
+            const running = contractTaskTrackerRef.current.run(resumable.id, signal => orchestrateContractImport({ success: true, data: { task: resumable } }, signal));
+            if (running)
+                void running.catch(() => undefined);
+        }
         for (const documentType of ['PURCHASE_CONTRACT', 'CUSTOMER_CONTRACT']) {
-            const resumable = findResumableContractImport(tasks, documentType);
             const failed = findRecoverableContractImport(tasks, documentType);
-            if (resumable && handledContractTasksRef.current[documentType] !== resumable.id && !runningContractTasksRef.current.has(resumable.id)) {
-                if (resumable.status === 'AWAITING_REVIEW' || resumable.executionCommand) {
-                    void orchestrateContractImport({ success: true, data: { task: resumable, commands: resumable.executionCommand ? [resumable.executionCommand] : [], polling: { intervalMs: 2000, timeoutMs: 1200000 } } }).catch(() => undefined);
-                }
-                continue;
-            }
-            if (!resumable && failed) {
+            const hasResumable = tasks.some(task => task.documentType === documentType && (task.status === 'AWAITING_REVIEW' || ['QUEUED', 'EXTRACTING', 'AI_PARSING', 'VALIDATING', 'PERSISTING'].includes(task.status)));
+            if (!hasResumable && failed) {
                 if (documentType === 'PURCHASE_CONTRACT')
                     setPurchaseImportTask(failed);
                 else
                     setCustomerImportState({ status: 'FAILED', importTaskId: failed.id, message: failed.errorMessage || '客户合同解析失败，请重新解析' });
             }
-            if (!resumable && !failed && tasks.some(item => item.documentType === documentType && item.status === 'SUCCEEDED')) {
+            if (!hasResumable && !failed && tasks.some(item => item.documentType === documentType && item.status === 'SUCCEEDED')) {
                 if (documentType === 'PURCHASE_CONTRACT') {
                     setPurchaseImportTask(null);
                     setPurchaseReviewDraft(null);
@@ -335,65 +449,173 @@ function App() {
     }, [data.importTasks.items, orchestrateContractImport]);
     const retryImport = React.useCallback(async (taskId) => {
         try {
-            const start = asActionResult(unwrapResponse(await bridge.executeAction('retry_import_task', { taskId })));
+            const raw = await submitAndRefreshTaskState(() => bridge.executeAction('retry_import_task', { taskId }), loadTaskState);
+            const start = asActionResult(unwrapResponse(raw));
             if (start.success === false)
-                throw new Error(resolveActionMessage(start) || '重新解析失败');
-            await orchestrateImport(start);
+                throw actionResponseError(start, '重新解析失败');
+            setToast({ message: resolveActionMessage(start) || '重新解析任务已提交', tone: 'info' });
         }
         catch (error) {
             if (!(error instanceof CatalogImportError))
                 setToast({ message: error instanceof Error ? error.message : '重新解析失败', tone: 'error' });
             throw error;
         }
-    }, [orchestrateImport]);
+    }, [loadTaskState]);
     const retryContractImport = React.useCallback(async (taskId) => {
-        const start = asActionResult(unwrapResponse(await bridge.executeAction('retry_import_task', { taskId })));
-        if (start.success === false)
-            throw new Error(resolveActionMessage(start) || '重新解析失败');
-        const documentType = start.data?.task.documentType;
-        if (documentType === 'PURCHASE_CONTRACT' || documentType === 'CUSTOMER_CONTRACT')
-            handledContractTasksRef.current[documentType] = null;
-        await orchestrateContractImport(start);
-    }, [orchestrateContractImport]);
+        try {
+            const raw = await submitAndRefreshTaskState(() => bridge.executeAction('retry_import_task', { taskId }), loadTaskState);
+            const start = asActionResult(unwrapResponse(raw));
+            if (start.success === false)
+                throw actionResponseError(start, '重新解析失败');
+            setToast({ message: resolveActionMessage(start) || '重新解析任务已提交', tone: 'info' });
+        }
+        catch (error) {
+            setToast({ message: error instanceof Error ? error.message : '重新解析失败', tone: 'error' });
+            throw error;
+        }
+    }, [loadTaskState]);
+    const applyCustomerContractReanalysisResult = React.useCallback(async (result) => {
+        let review;
+        if (result.review) {
+            review = adaptCustomerContractReview(result.review, { reviewSource: 'EXISTING_CONTRACT' });
+        }
+        else if (result.task) {
+            review = adaptCustomerContractReview(result.task.resultPayload, { reviewSource: 'IMPORT_DRAFT', importTaskId: result.task.id, sourceFileId: result.task.sourceFileId ?? '', sourceFileName: result.task.sourceFileName ?? '' });
+        }
+        else {
+            throw new Error('重新分析结果缺少合同审核数据');
+        }
+        const attached = await attachCustomerSource(review, blobUrlOwnerRef.current);
+        setCustomerImportState({ status: 'AWAITING_REVIEW', importTaskId: result.task?.id ?? result.run.importTaskId ?? '', review: attached });
+        changeRouteRef.current({ type: 'page', page: 'customer-contract-review' });
+        return attached;
+    }, []);
+    const consumeCustomerContractReanalysisResult = React.useCallback(async (runId) => {
+        const consumed = asActionResult(unwrapResponse(await bridge.executeAction('consume_customer_contract_reanalysis_result', { runId })));
+        if (consumed.success === false)
+            throw new Error(resolveActionMessage(consumed) || '确认重新分析结果失败');
+    }, []);
     const reanalyzeCustomerContract = React.useCallback(async (input) => {
         setCustomerReanalysisState({ status: 'RUNNING', message: 'AI 重新分析中' });
         try {
-            const response = asActionResult(unwrapResponse(await bridge.executeAction('reanalyze_customer_contract', { reviewSource: input.reviewSource, ...(input.customerContractId ? { id: input.customerContractId } : {}), ...(input.importTaskId ? { importTaskId: input.importTaskId } : {}) })));
+            const raw = await submitAndRefreshTaskState(() => bridge.executeAction('reanalyze_customer_contract', { reviewSource: input.reviewSource, ...(input.customerContractId ? { id: input.customerContractId } : {}), ...(input.importTaskId ? { importTaskId: input.importTaskId } : {}) }), loadTaskState);
+            const response = asActionResult(unwrapResponse(raw));
             if (response.success === false || !response.data)
-                throw new Error(resolveActionMessage(response) || 'AI 重新分析启动失败');
-            const result = await runCustomerContractReanalysis({
+                throw actionResponseError(response, 'AI 重新分析启动失败');
+            setToast({ message: resolveActionMessage(response) || 'AI 重新分析任务已提交', tone: 'info' });
+            const running = reanalysisTaskTrackerRef.current.run(response.data.run.id, signal => runCustomerContractReanalysis({
                 start: response.data,
-                invokeClientCommand: (commandKey, payload) => bridge.invokeClientCommand(commandKey, payload),
-                markCommandDispatched: async (runId) => {
-                    const marked = asActionResult(unwrapResponse(await bridge.executeAction('mark_customer_contract_reanalysis_dispatched', { runId })));
-                    if (marked.success === false)
-                        throw new Error(resolveActionMessage(marked) || '记录重新分析命令状态失败');
-                },
-                markFailed: async (runId, failure) => {
-                    const marked = asActionResult(unwrapResponse(await bridge.executeAction('mark_customer_contract_reanalysis_failed', { runId, ...failure })));
-                    if (marked.success === false)
-                        throw new Error(resolveActionMessage(marked) || '记录重新分析失败状态失败');
-                },
-                poll: async (runId) => asCustomerContractReanalysisResult(unwrapResponse(await bridge.requestData({ parameters: { collection: 'customerContractAnalysis', runId } })))
-            });
-            let review;
-            if (result.review) {
-                review = adaptCustomerContractReview(result.review, { reviewSource: 'EXISTING_CONTRACT' });
-            }
-            else if (result.task) {
-                review = adaptCustomerContractReview(result.task.resultPayload, { reviewSource: 'IMPORT_DRAFT', importTaskId: result.task.id, sourceFileId: result.task.sourceFileId ?? '', sourceFileName: result.task.sourceFileName ?? '' });
-            }
-            else {
-                throw new Error('重新分析结果缺少合同审核数据');
-            }
+                signal,
+                poll: async (runId) => asCustomerContractReanalysisResult(unwrapResponse(await bridge.requestData({ parameters: { collection: 'customerContractAnalysis', runId } }))),
+                onPollError: error => setToast({ message: `任务状态查询失败：${error.message}`, tone: 'error' })
+            }));
+            if (!running)
+                throw new Error('该 AI 重新分析任务正在跟踪中');
+            const result = await running;
+            const review = await applyCustomerContractReanalysisResult(result);
+            await consumeCustomerContractReanalysisResult(result.run.id);
+            handledReanalysisResultsRef.current.add(result.run.id);
             setCustomerReanalysisState({ status: 'IDLE' });
+            setToast({ message: 'AI 重新分析完成', tone: 'success' });
+            await loadTaskState();
             return review;
         }
         catch (error) {
+            if (isAbortError(error))
+                throw error;
+            if (error instanceof ActionResponseError && error.code === 'IMPORT_QUEUE_UNAVAILABLE') {
+                setCustomerReanalysisState({ status: 'RUNNING', message: '任务已保存，等待队列服务恢复' });
+                setToast({ message: error.message, tone: 'info' });
+                scheduleTaskStateRecovery();
+                throw error;
+            }
+            if (isPollingObservationTimeout(error)) {
+                setCustomerReanalysisState({ status: 'RUNNING', message: 'AI 重新分析仍在后台处理中' });
+                setToast({ message: '任务仍在后台处理中，将继续跟踪', tone: 'info' });
+                scheduleTaskStateRecovery();
+                throw error;
+            }
             setCustomerReanalysisState({ status: 'FAILED', message: error instanceof Error ? error.message : 'AI 重新分析失败' });
+            setToast({ message: error instanceof Error ? error.message : 'AI 重新分析失败', tone: 'error' });
             throw error;
         }
-    }, []);
+    }, [applyCustomerContractReanalysisResult, consumeCustomerContractReanalysisResult, loadTaskState, scheduleTaskStateRecovery]);
+    React.useEffect(() => {
+        for (const recovery of data.customerContractAnalyses.items) {
+            const recoverable = recovery.recoveryType === 'ACTIVE_POLL' || recovery.recoveryType === 'SUCCEEDED_RESULT';
+            if (!recoverable)
+                continue;
+            if (handledReanalysisResultsRef.current.has(recovery.run.id))
+                continue;
+            const running = reanalysisTaskTrackerRef.current.run(recovery.run.id, signal => runCustomerContractReanalysis({
+                start: { run: recovery.run },
+                signal,
+                poll: async (runId) => asCustomerContractReanalysisResult(unwrapResponse(await bridge.requestData({ parameters: { collection: 'customerContractAnalysis', runId } }))),
+                onPollError: error => setToast({ message: `任务状态查询失败：${error.message}`, tone: 'error' })
+            }));
+            if (!running)
+                continue;
+            setCustomerReanalysisState({ status: 'RUNNING', message: 'AI 重新分析中' });
+            setToast({ message: '已恢复 AI 重新分析任务', tone: 'info' });
+            void running.then(result => {
+                enqueuePendingReview({ kind: 'REANALYSIS', result });
+            }).catch(error => {
+                if (isAbortError(error))
+                    return;
+                if (isPollingObservationTimeout(error)) {
+                    setCustomerReanalysisState({ status: 'RUNNING', message: 'AI 重新分析仍在后台处理中' });
+                    setToast({ message: '任务仍在后台处理中，将继续跟踪', tone: 'info' });
+                    scheduleTaskStateRecovery();
+                    return;
+                }
+                setCustomerReanalysisState({ status: 'FAILED', message: error instanceof Error ? error.message : 'AI 重新分析失败' });
+                setToast({ message: error instanceof Error ? error.message : 'AI 重新分析失败', tone: 'error' });
+            });
+        }
+    }, [data.customerContractAnalyses.items, enqueuePendingReview, scheduleTaskStateRecovery]);
+    const presentNextPendingReview = React.useCallback(async () => {
+        if (activeReviewResultRef.current)
+            return;
+        const pending = pendingReviewResultsRef.current.peek();
+        if (!pending)
+            return;
+        const resultId = pending.kind === 'CONTRACT_IMPORT' ? pending.completion.task.id : pending.result.run.id;
+        activeReviewResultRef.current = resultId;
+        try {
+            if (pending.kind === 'CONTRACT_IMPORT') {
+                const task = pending.completion.task;
+                if (task.documentType === 'PURCHASE_CONTRACT') {
+                    blobUrlOwnerRef.current.clear('purchase');
+                    const draft = adaptPurchaseReview(task);
+                    setPurchaseImportTask(task);
+                    setPurchaseReviewDraft(await attachPurchaseSource(draft, task, blobUrlOwnerRef.current));
+                    changeRouteRef.current({ type: 'procurement', level: 'suppliers' });
+                }
+                else {
+                    blobUrlOwnerRef.current.clear('customer');
+                    const review = adaptCustomerContractReview(task.resultPayload, { reviewSource: 'IMPORT_DRAFT', importTaskId: task.id, sourceFileId: task.sourceFileId ?? '', sourceFileName: task.sourceFileName ?? '' });
+                    setCustomerImportState({ status: 'AWAITING_REVIEW', importTaskId: task.id, review: await attachCustomerSource(review, blobUrlOwnerRef.current) });
+                    changeRouteRef.current({ type: 'page', page: 'customer-contract-review' });
+                }
+                pendingReviewResultsRef.current.ack(resultId);
+                handledContractTasksRef.current.add(resultId);
+                return;
+            }
+            await applyCustomerContractReanalysisResult(pending.result);
+            await consumeCustomerContractReanalysisResult(pending.result.run.id);
+            pendingReviewResultsRef.current.ack(resultId);
+            handledReanalysisResultsRef.current.add(pending.result.run.id);
+            setCustomerReanalysisState({ status: 'IDLE' });
+            setToast({ message: 'AI 重新分析完成', tone: 'success' });
+            await loadTaskState();
+        }
+        catch (error) {
+            activeReviewResultRef.current = null;
+            setToast({ message: error instanceof Error ? error.message : '审核结果恢复失败', tone: 'error' });
+            scheduleTaskStateRecovery();
+        }
+    }, [applyCustomerContractReanalysisResult, consumeCustomerContractReanalysisResult, loadTaskState, scheduleTaskStateRecovery]);
+    presentNextReviewRef.current = () => { void presentNextPendingReview(); };
     const loadCustomerContractReview = React.useCallback(async (customerContractId) => {
         const result = asActionResult(unwrapResponse(await bridge.executeAction('get_customer_contract_review', { id: customerContractId })));
         if (result.success === false || !result.data)
@@ -405,21 +627,27 @@ function App() {
     const closePurchaseReview = React.useCallback(() => {
         blobUrlOwnerRef.current.clear('purchase');
         setPurchaseReviewDraft(null);
-    }, []);
+        activeReviewResultRef.current = null;
+        schedulePendingReviewPresentation();
+    }, [schedulePendingReviewPresentation]);
     const closeCustomerReview = React.useCallback(() => {
         blobUrlOwnerRef.current.clear('customer');
         setCustomerImportState({ status: 'IDLE' });
-    }, []);
+        activeReviewResultRef.current = null;
+        schedulePendingReviewPresentation();
+    }, [schedulePendingReviewPresentation]);
     const queryImportIssues = React.useCallback(async (query) => {
-        const payload = asRecord(unwrapResponse(await bridge.requestData({ page: query.page, pageSize: query.pageSize, parameters: { collection: 'importIssues', documentType: query.documentType, batchId: query.batchId, issueType: query.issueType } })));
-        return { items: Array.isArray(payload.items) ? payload.items : [], total: numberValue(payload.total, 0), page: numberValue(payload.page, query.page), pageSize: numberValue(payload.pageSize, query.pageSize) };
+        const requestedPageSize = resolvePaginationPageSize(query.pageSize);
+        const payload = asRecord(unwrapResponse(await bridge.requestData({ page: query.page, pageSize: requestedPageSize, parameters: { collection: 'importIssues', documentType: query.documentType, batchId: query.batchId, issueType: query.issueType } })));
+        return { items: Array.isArray(payload.items) ? payload.items : [], total: numberValue(payload.total, 0), page: numberValue(payload.page, query.page), pageSize: requestedPageSize };
     }, []);
     const queryCatalog = React.useCallback(async (collection, query) => {
+        const requestedPageSize = resolvePaginationPageSize(query.pageSize);
         const gate = requestGateRef.current;
         const requestId = gate.begin();
         setBusy(true);
         try {
-            const payload = asRecord(unwrapResponse(await bridge.requestData({ page: query.page, pageSize: query.pageSize, parameters: { collection, filters: encodeViewFilters(query.filters) } })));
+            const payload = asRecord(unwrapResponse(await bridge.requestData({ page: query.page, pageSize: requestedPageSize, parameters: { collection, filters: encodeViewFilters(query.filters) } })));
             if (!gate.isLatest(requestId))
                 return;
             setData((current) => ({
@@ -429,7 +657,7 @@ function App() {
                     items: Array.isArray(payload.items) ? payload.items : [],
                     total: numberValue(payload.total, 0),
                     page: numberValue(payload.page, query.page),
-                    pageSize: numberValue(payload.pageSize, query.pageSize)
+                    pageSize: requestedPageSize
                 }
             }));
         }
@@ -442,6 +670,27 @@ function App() {
             setBusy(gate.activeCount() > 0);
         }
     }, []);
+    const queryMonthlyRates = React.useCallback(async (query) => {
+        const requestedPageSize = resolvePaginationPageSize(query.pageSize);
+        const gate = settingsRatesRequestGateRef.current;
+        const requestId = gate.begin();
+        setBusy(true);
+        try {
+            const payload = asRecord(unwrapResponse(await bridge.requestData({ page: query.page, pageSize: requestedPageSize, parameters: { collection: 'monthlyRates' } })));
+            if (!gate.commit(requestId))
+                return;
+            settingsRatesQueryRef.current = { page: numberValue(payload.page, query.page), pageSize: requestedPageSize };
+            setData(current => ({ ...current, settings: normalizeWorkbenchData({ summary: { settings: { ...current.settings, rates: { ...payload, pageSize: requestedPageSize } } } }).settings }));
+        }
+        catch (error) {
+            if (gate.isLatest(requestId))
+                setToast({ message: error instanceof Error ? `月度汇率加载失败：${error.message}` : '月度汇率加载失败', tone: 'error' });
+        }
+        finally {
+            gate.finish(requestId);
+            setBusy(gate.activeCount() + requestGateRef.current.activeCount() + routeRequestGateRef.current.activeCount() > 0);
+        }
+    }, []);
     const queryProcurement = React.useCallback(async (_collection, query) => {
         await loadRoute(routeRef.current, query.page, query.pageSize, query.filters);
     }, [loadRoute]);
@@ -452,20 +701,36 @@ function App() {
         await loadRoute(routeRef.current, query.page, query.pageSize, query.filters);
     }, [loadRoute]);
     const querySalesFiles = React.useCallback(async (collection, query) => {
+        const requestedPageSize = resolvePaginationPageSize(query.pageSize);
         if (collection === 'salesFileOrders') {
-            await loadRoute({ type: 'page', page: 'sales-files' }, query.page, query.pageSize, query.filters);
+            await loadRoute({ type: 'page', page: 'sales-files' }, query.page, requestedPageSize, query.filters);
             return;
         }
-        const payload = asRecord(unwrapResponse(await bridge.requestData({ page: query.page, pageSize: query.pageSize, parameters: { collection, ...query.parameters, filters: encodeViewFilters(query.filters) } })));
-        setData(current => ({ ...current, generatedFiles: { ...payload, items: Array.isArray(payload.items) ? payload.items : [], total: numberValue(payload.total, 0), page: numberValue(payload.page, query.page), pageSize: numberValue(payload.pageSize, query.pageSize) } }));
+        const key = generatedFileHistoryKey(query.parameters);
+        if (!key) {
+            setToast({ message: '历史生成文件查询缺少合同或采购订单标识', tone: 'error' });
+            return;
+        }
+        activeGeneratedFilesKeyRef.current = key;
+        await runKeyedLatestRequest({
+            gate: generatedFilesRequestGateRef.current,
+            key,
+            request: async () => asRecord(unwrapResponse(await bridge.requestData({ page: query.page, pageSize: requestedPageSize, parameters: { collection, ...query.parameters, filters: encodeViewFilters(query.filters) } }))),
+            isCurrent: () => activeGeneratedFilesKeyRef.current === key,
+            commit: payload => setData(current => ({ ...current, generatedFiles: { ...payload, items: Array.isArray(payload.items) ? payload.items : [], total: numberValue(payload.total, 0), page: numberValue(payload.page, query.page), pageSize: requestedPageSize } })),
+            onError: error => setToast({ message: error instanceof Error ? `历史生成文件加载失败：${error.message}` : '历史生成文件加载失败', tone: 'error' }),
+            onStart: () => setBusy(true),
+            onFinish: () => setBusy(generatedFilesRequestGateRef.current.activeCount() + requestGateRef.current.activeCount() + routeRequestGateRef.current.activeCount() + analyticsRequestsRef.current.activeCount() > 0)
+        });
     }, [loadRoute]);
     const queryAnalytics = React.useCallback(async (query) => {
+        const requestedQuery = { ...query, pageSize: resolvePaginationPageSize(query.pageSize) };
         const requests = analyticsRequestsRef.current;
-        const requestId = requests.begin(query);
+        const requestId = requests.begin(requestedQuery);
         setBusy(true);
         setAnalyticsError(null);
         try {
-            const payload = asRecord(unwrapResponse(await bridge.requestData({ page: query.page, pageSize: query.pageSize, parameters: { collection: 'analytics', mode: query.mode, dimension: query.dimension, filters: encodeViewFilters(query.filters) } })));
+            const payload = asRecord(unwrapResponse(await bridge.requestData({ page: requestedQuery.page, pageSize: requestedQuery.pageSize, parameters: { collection: 'analytics', mode: requestedQuery.mode, dimension: requestedQuery.dimension, filters: encodeViewFilters(requestedQuery.filters) } })));
             if (!requests.commit(requestId))
                 return;
             setAnalyticsCommittedQuery(requests.committed());
@@ -509,25 +774,26 @@ function App() {
         const result = asActionResult(unwrapResponse(await bridge.executeAction('save_settings', request)));
         if (result.success === false)
             throw new Error(resolveActionMessage(result) || '设置保存失败');
-        await loadRoute({ type: 'page', page: 'settings' });
+        await loadRoute({ type: 'page', page: 'settings' }, settingsRatesQueryRef.current.page, settingsRatesQueryRef.current.pageSize);
     }, [loadRoute]);
     const restoreSettings = React.useCallback(async (request) => {
         const result = asActionResult(unwrapResponse(await bridge.executeAction('restore_settings_default', request)));
         if (result.success === false)
             throw new Error(resolveActionMessage(result) || '恢复系统默认失败');
-        await loadRoute({ type: 'page', page: 'settings' });
+        await loadRoute({ type: 'page', page: 'settings' }, settingsRatesQueryRef.current.page, settingsRatesQueryRef.current.pageSize);
     }, [loadRoute]);
     const deleteSettingsRate = React.useCallback(async (request) => {
         const result = asActionResult(unwrapResponse(await bridge.executeAction('delete_settings_rate', request)));
         if (result.success === false)
             throw new Error(resolveActionMessage(result) || '月度汇率删除失败');
-        await loadRoute({ type: 'page', page: 'settings' });
-    }, [loadRoute]);
+        const { page, pageSize } = settingsRatesQueryRef.current;
+        const clampedPage = clampPageAfterSingleDeletion(page, pageSize, data.settings.rates.total);
+        await loadRoute({ type: 'page', page: 'settings' }, clampedPage, pageSize);
+    }, [data.settings.rates.total, loadRoute]);
     const uploadCompanyLogo = React.useCallback(async (file) => {
         const result = asActionResult(unwrapResponse(await bridge.executeFileAction('upload_company_logo', file, {})));
         if (result.success === false || !result.data?.logoFileId)
             throw new Error(resolveActionMessage(result) || '公司 Logo 上传失败');
-        setToast({ message: '公司 Logo 上传成功', tone: 'success' });
         return result.data.logoFileId;
     }, []);
     const discardCompanyLogo = React.useCallback(async (logoFileId) => {
@@ -537,8 +803,22 @@ function App() {
     }, []);
     const openSalesFiles = React.useCallback((order) => {
         setActiveSalesFileOrder(order);
-        if (order)
-            changeRouteRef.current({ type: 'page', page: 'sales-files' });
+        if (!order)
+            return;
+        changeRouteRef.current({ type: 'page', page: 'sales-files' });
+        void querySalesFiles('generatedFiles', {
+            page: 1,
+            pageSize: 20,
+            filters: {},
+            parameters: { customerContractId: order.customerContractId, purchaseOrderId: order.purchaseOrderId }
+        });
+    }, [querySalesFiles]);
+    const selectSalesFileOrder = React.useCallback((order) => {
+        const previousKey = activeGeneratedFilesKeyRef.current;
+        if (previousKey)
+            generatedFilesRequestGateRef.current.invalidate(previousKey);
+        activeGeneratedFilesKeyRef.current = order ? generatedFileHistoryKey(order) : null;
+        setActiveSalesFileOrder(order);
     }, []);
     const changeRoute = React.useCallback((nextRoute) => {
         routeRef.current = nextRoute;
@@ -548,12 +828,16 @@ function App() {
     changeRouteRef.current = changeRoute;
     const page = routePage(route);
     const meta = pageMeta[page];
-    const contractCommands = page === 'procurement'
-        ? _jsx(ContractUploadCommand, { label: "\u4E0A\u4F20\u91C7\u8D2D\u5408\u540C", busy: busy || actionBusy, onFile: file => executeFileAction('upload_purchase_contract', file, { documentType: 'PURCHASE_CONTRACT' }) })
+    const contractCommands = page === 'procurement' && route.type === 'procurement'
+        ? route.level === 'orders'
+            ? _jsxs("button", { type: "button", className: "tcw-button tcw-button--primary", disabled: busy || actionBusy, onClick: () => changeRoute({ type: 'procurement', level: 'suppliers' }), children: [_jsx("i", { className: "ri-add-line", "aria-hidden": "true" }), "\u65B0\u5EFA\u91C7\u8D2D\u8BA2\u5355"] })
+            : _jsx(ContractUploadCommand, { label: "\u4E0A\u4F20\u91C7\u8D2D\u5408\u540C", busy: busy || actionBusy, onFile: file => executeFileAction('upload_purchase_contract', file, { documentType: 'PURCHASE_CONTRACT' }) })
         : page === 'customer-contract-review'
             ? _jsx(ContractUploadCommand, { label: "\u4E0A\u4F20\u5BA2\u6237\u5408\u540C", busy: busy || actionBusy, onFile: file => executeFileAction('upload_customer_contract', file, { documentType: 'CUSTOMER_CONTRACT' }) })
             : undefined;
-    return (_jsxs(_Fragment, { children: [_jsxs(WorkbenchShell, { route: route, breadcrumbs: buildBreadcrumbs(route), title: meta.title, subtitle: meta.subtitle, commands: (page === 'controlled-goods' || page === 'sanctioned-companies') ? _jsx(CatalogCommands, { busy: busy || actionBusy, onUpload: () => setCatalogCommand('upload'), onCreate: () => setCatalogCommand('create') }) : contractCommands, busy: busy || actionBusy, onRouteChange: changeRoute, onRefresh: () => void load(), children: [page === 'home' && _jsx(HomePage, {}), page === 'controlled-goods' && _jsx(ControlledGoodsPage, { collection: data.controlledGoods, batches: data.controlledBatches.items, busy: busy || actionBusy, onAction: executeAction, onFileAction: executeFileAction, onRefresh: load, onQuery: (query) => queryCatalog('controlledGoods', query), onIssueQuery: queryImportIssues, importCompletion: importCompletion, importFailure: importFailures.CONTROLLED_CATALOG, onRetryImport: retryImport, command: catalogCommand, onCommandHandled: () => setCatalogCommand(null) }), page === 'sanctioned-companies' && _jsx(SanctionedCompaniesPage, { collection: data.sanctionedCompanies, batches: data.sanctionBatches.items, busy: busy || actionBusy, onAction: executeAction, onFileAction: executeFileAction, onRefresh: load, onQuery: (query) => queryCatalog('sanctionedCompanies', query), onIssueQuery: queryImportIssues, importCompletion: importCompletion, importFailure: importFailures.SANCTION_CATALOG, onRetryImport: retryImport, command: catalogCommand, onCommandHandled: () => setCatalogCommand(null) }), page === 'procurement' && route.type === 'procurement' && _jsx(ProcurementPage, { route: route, suppliers: data.suppliers, purchaseOrders: data.purchaseOrders, purchaseLines: data.purchaseLines, supplier: procurementContext.supplier, order: procurementContext.order, metrics: procurementContext.metrics, importTask: purchaseImportTask, reviewDraft: purchaseReviewDraft, busy: busy || actionBusy, onQuery: queryProcurement, onAction: executeAction, onFileAction: executeFileAction, onRouteChange: changeRoute, onRetryImport: retryContractImport, onReviewClose: closePurchaseReview }), page === 'customer-contract-review' && _jsx(CustomerContractsPage, { collection: data.customerContracts, busy: busy || actionBusy, importReviewState: customerImportState, onQuery: queryCustomerContracts, onAction: executeAction, onFileAction: executeFileAction, onReanalyze: reanalyzeCustomerContract, onLoadReview: loadCustomerContractReview, onReviewClose: closeCustomerReview, reanalysisState: customerReanalysisState, onRetryImport: retryContractImport }), page === 'sales' && route.type === 'sales' && _jsx(SalesPage, { route: route, customers: data.salesCustomers, orders: data.salesOrders, lines: data.salesLines, busy: busy || actionBusy, onQuery: querySales, onAction: executeAction, onRouteChange: changeRoute, onOpenFiles: openSalesFiles }), page === 'sales-files' && _jsx(SalesFilesPage, { orders: data.salesFileOrders, history: data.generatedFiles, activeOrder: activeSalesFileOrder, banks: data.settings.banks, busy: busy || actionBusy, onQuery: querySalesFiles, onAction: executeSalesFileAction, onOpenSalesOrder: setActiveSalesFileOrder, onDownload: async (file) => { const result = await executeAction('download_sales_file', { id: file.id }); downloadActionFile(result.data); }, onEdit: async (file) => setEditingSalesFile(file) }), page === 'analytics' && _jsx(AnalyticsPage, { data: data.analytics, committedQuery: analyticsCommittedQuery, busy: busy || actionBusy, error: analyticsError, onQuery: queryAnalytics, onExportXlsx: exportAnalytics }), page === 'settings' && _jsx(SettingsPage, { data: data.settings, busy: busy || actionBusy, onSave: saveSettings, onRestoreDefault: restoreSettings, onDeleteRate: deleteSettingsRate, onUploadLogo: uploadCompanyLogo, onDiscardLogo: discardCompanyLogo }), !['home', 'controlled-goods', 'sanctioned-companies', 'procurement', 'customer-contract-review', 'sales', 'sales-files', 'analytics', 'settings'].includes(page) && _jsxs("section", { className: "tcw-page-placeholder", "data-page": page, children: [_jsx(InfoNotice, { children: "\u9875\u9762\u57FA\u7840\u7ED3\u6784\u5DF2\u5C31\u7EEA\uFF0C\u4E1A\u52A1\u5185\u5BB9\u5C06\u5728\u5BF9\u5E94\u9875\u9762\u6A21\u5757\u4E2D\u52A0\u8F7D\u3002" }), _jsx("div", { className: "tcw-placeholder-body", "aria-label": `${meta.title}页面内容` })] })] }), _jsx(LoadingBlocker, { visible: busy || actionBusy, label: actionBusy ? '操作处理中' : '数据加载中' }), toast && _jsx(Toast, { message: toast.message, tone: toast.tone, onClose: () => setToast(null) }), editingSalesFile && _jsx(SalesFileEditor, { file: editingSalesFile, onClose: () => setEditingSalesFile(null), onSaved: () => { setEditingSalesFile(null); if (activeSalesFileOrder)
+    if (analyticsPrototypeVisible)
+        return (_jsx(WorkbenchShell, { route: route, breadcrumbs: buildBreadcrumbs(route), title: meta.title, onRouteChange: changeRoute, onRefresh: () => void load(), children: _jsx(AnalyticsPrototypeBoard, { onClose: () => setAnalyticsPrototypeVisible(false) }) }));
+    return (_jsxs(_Fragment, { children: [_jsxs(WorkbenchShell, { route: route, breadcrumbs: buildBreadcrumbs(route), title: meta.title, subtitle: page === 'home' ? undefined : meta.subtitle, commands: (page === 'controlled-goods' || page === 'sanctioned-companies') ? _jsx(CatalogCommands, { busy: busy || actionBusy, onUpload: () => setCatalogCommand('upload'), onCreate: () => setCatalogCommand('create') }) : contractCommands, busy: busy || actionBusy, onRouteChange: changeRoute, onRefresh: () => void load(), children: [page === 'home' && _jsx(HomePage, {}), page === 'controlled-goods' && _jsx(ControlledGoodsPage, { collection: data.controlledGoods, batches: data.controlledBatches.items, busy: busy || actionBusy, onAction: executeAction, onFileAction: executeCatalogFileAction, onRefresh: load, onQuery: (query) => queryCatalog('controlledGoods', query), onIssueQuery: queryImportIssues, importCompletion: importCompletions.CONTROLLED_CATALOG, importFailure: importFailures.CONTROLLED_CATALOG, onRetryImport: retryImport, command: catalogCommand, onCommandHandled: () => setCatalogCommand(null), onNotify: setToast }), page === 'sanctioned-companies' && _jsx(SanctionedCompaniesPage, { collection: data.sanctionedCompanies, batches: data.sanctionBatches.items, busy: busy || actionBusy, onAction: executeAction, onFileAction: executeCatalogFileAction, onRefresh: load, onQuery: (query) => queryCatalog('sanctionedCompanies', query), onIssueQuery: queryImportIssues, importCompletion: importCompletions.SANCTION_CATALOG, importFailure: importFailures.SANCTION_CATALOG, onRetryImport: retryImport, command: catalogCommand, onCommandHandled: () => setCatalogCommand(null), onNotify: setToast }), page === 'procurement' && route.type === 'procurement' && _jsx(ProcurementPage, { route: route, suppliers: data.suppliers, purchaseOrders: data.purchaseOrders, purchaseLines: data.purchaseLines, supplier: procurementContext.supplier, order: procurementContext.order, metrics: procurementContext.metrics, importTask: purchaseImportTask, reviewDraft: purchaseReviewDraft, busy: busy || actionBusy, onQuery: queryProcurement, onAction: executeAction, onFileAction: executeFileAction, onRouteChange: changeRoute, onRetryImport: retryContractImport, onReviewClose: closePurchaseReview, onNotify: setToast }), page === 'customer-contract-review' && _jsx(CustomerContractsPage, { collection: data.customerContracts, busy: busy || actionBusy, importReviewState: customerImportState, onQuery: queryCustomerContracts, onAction: executeAction, onFileAction: executeFileAction, onReanalyze: reanalyzeCustomerContract, onLoadReview: loadCustomerContractReview, onReviewClose: closeCustomerReview, reanalysisState: customerReanalysisState, onRetryImport: retryContractImport, onNotify: setToast }), page === 'sales' && route.type === 'sales' && _jsx(SalesPage, { route: route, customers: data.salesCustomers, orders: data.salesOrders, lines: data.salesLines, busy: busy || actionBusy, onQuery: querySales, onAction: executeAction, onRouteChange: changeRoute, onOpenFiles: openSalesFiles, onNotify: setToast }), page === 'sales-files' && _jsx(SalesFilesPage, { orders: data.salesFileOrders, history: data.generatedFiles, activeOrder: activeSalesFileOrder, banks: data.settings.banks, busy: busy || actionBusy, onQuery: querySalesFiles, onAction: executeSalesFileAction, onOpenSalesOrder: selectSalesFileOrder, onDownload: file => executeAction('download_sales_file', { id: file.id }).then(() => undefined), onEdit: async (file) => setEditingSalesFile(file), onNotify: setToast }), page === 'analytics' && _jsx(AnalyticsPage, { data: data.analytics, committedQuery: analyticsCommittedQuery, busy: busy || actionBusy, error: analyticsError, onQuery: queryAnalytics, onExportXlsx: exportAnalytics }), page === 'settings' && _jsx(SettingsPage, { data: data.settings, busy: busy || actionBusy, onSave: saveSettings, onRestoreDefault: restoreSettings, onDeleteRate: deleteSettingsRate, onRateQuery: queryMonthlyRates, onUploadLogo: uploadCompanyLogo, onDiscardLogo: discardCompanyLogo, onNotify: setToast }), !['home', 'controlled-goods', 'sanctioned-companies', 'procurement', 'customer-contract-review', 'sales', 'sales-files', 'analytics', 'settings'].includes(page) && _jsxs("section", { className: "tcw-page-placeholder", "data-page": page, children: [_jsx(InfoNotice, { children: "\u9875\u9762\u57FA\u7840\u7ED3\u6784\u5DF2\u5C31\u7EEA\uFF0C\u4E1A\u52A1\u5185\u5BB9\u5C06\u5728\u5BF9\u5E94\u9875\u9762\u6A21\u5757\u4E2D\u52A0\u8F7D\u3002" }), _jsx("div", { className: "tcw-placeholder-body", "aria-label": `${meta.title}页面内容` })] })] }), _jsx(LoadingBlocker, { visible: busy || actionBusy, label: actionBusy ? '操作处理中' : '数据加载中' }), _jsx(ToastStack, { items: toasts, onClose: closeToast }), editingSalesFile && _jsx(SalesFileEditor, { file: editingSalesFile, onNotify: setToast, onClose: () => setEditingSalesFile(null), onSaved: () => { setEditingSalesFile(null); if (activeSalesFileOrder)
                     void querySalesFiles('generatedFiles', { page: 1, pageSize: 20, filters: {}, parameters: { customerContractId: activeSalesFileOrder.customerContractId, purchaseOrderId: activeSalesFileOrder.purchaseOrderId } }); } })] }));
 }
 function routePage(route) {
@@ -564,6 +848,7 @@ function routePage(route) {
     return route.page;
 }
 function analyticsQueryFromRoute(page, pageSize, values) {
+    const requestedPageSize = resolvePaginationPageSize(pageSize);
     const dateValue = values.orderDate;
     const date = dateValue && typeof dateValue === 'object' && !Array.isArray(dateValue) ? dateValue : null;
     const orderDate = date ? { from: optionalText(date.from), to: optionalText(date.to) } : undefined;
@@ -574,11 +859,11 @@ function analyticsQueryFromRoute(page, pageSize, values) {
     };
     if (values.mode === 'SALES')
         return {
-            mode: 'SALES', dimension: values.dimension === 'PRODUCT' ? 'PRODUCT' : 'CUSTOMER', page, pageSize,
+            mode: 'SALES', dimension: values.dimension === 'PRODUCT' ? 'PRODUCT' : 'CUSTOMER', page, pageSize: requestedPageSize,
             filters: { ...common, ...(optionalText(values.customer) ? { customer: optionalText(values.customer) } : {}), ...(enabled(values.unreceivedOnly) ? { unreceivedOnly: true } : {}) }
         };
     return {
-        mode: 'PURCHASE', dimension: values.dimension === 'PRODUCT' ? 'PRODUCT' : 'SUPPLIER', page, pageSize,
+        mode: 'PURCHASE', dimension: values.dimension === 'PRODUCT' ? 'PRODUCT' : 'SUPPLIER', page, pageSize: requestedPageSize,
         filters: { ...common, ...(optionalText(values.supplier) ? { supplier: optionalText(values.supplier) } : {}), ...(enabled(values.unpaidOnly) ? { unpaidOnly: true } : {}), ...(enabled(values.unrefundedOnly) ? { unrefundedOnly: true } : {}) }
     };
 }
@@ -596,6 +881,9 @@ function resolveActionMessage(result) {
     }
     return '';
 }
+function actionResponseError(result, fallback) {
+    return new ActionResponseError(resolveActionMessage(result) || fallback, result.error?.code);
+}
 function asRecord(value) {
     return value && typeof value === 'object' && !Array.isArray(value) ? value : {};
 }
@@ -694,9 +982,6 @@ function asCustomerContractReanalysisResult(value) {
         throw new Error('轮询响应缺少重新分析任务');
     return payload;
 }
-function shouldRefreshAfterAction(actionKey) {
-    return new Set(['save_controlled_goods', 'update_controlled_goods', 'save_sanctioned_company', 'update_sanctioned_company', 'save_purchase_review', 'save_customer_contract_review', 'update_supplier', 'update_purchase_order', 'add_purchase_line', 'update_purchase_line', 'update_customer_contract_review', 'delete_entity']).has(actionKey);
-}
 async function ensureExcelEditorRuntime() {
     const runtimeWindow = window;
     if (runtimeWindow.TradeComplianceExcelEditor?.open)
@@ -737,7 +1022,7 @@ async function ensureExcelEditorRuntime() {
     });
     return excelEditorRuntimePromise;
 }
-function SalesFileEditor({ file, onClose, onSaved }) {
+function SalesFileEditor({ file, onClose, onSaved, onNotify }) {
     const containerRef = React.useRef(null);
     const editorRef = React.useRef(null);
     const [error, setError] = React.useState('');
@@ -778,12 +1063,13 @@ function SalesFileEditor({ file, onClose, onSaved }) {
         return () => { cancelled = true; editorRef.current?.dispose(); editorRef.current = null; };
     }, [file.id]);
     const save = async () => { if (!editorRef.current)
-        return; setSaving(true); setError(''); try {
+        return; setSaving(true); try {
         await editorRef.current.save();
+        onNotify({ message: '工作簿保存成功', tone: 'success' });
         onSaved();
     }
     catch (cause) {
-        setError(cause instanceof Error ? cause.message : '工作簿保存失败');
+        onNotify({ message: cause instanceof Error ? cause.message : '工作簿保存失败', tone: 'error' });
     }
     finally {
         setSaving(false);