yin 6838d69788 perf(app): 详情面板统一迁移 UpperTable,路由按需加载并优化跨浏览器性能
- 新增 router/view-glob.ts,动态菜单兜底的全量 glob 表改为按需动态加载,
  入口 chunk 由 465KB 降至 393KB;Sidebar / TaskView 用 utils/path 的
  resolveRoutePath 替换 path-browserify 静态引用
- 新增 utils/perf-probe 轻量探针(?perf=1 或 localStorage 开启),输出导航耗时、
  资源分类统计、长任务与硬件信息;移除 text-rendering: optimizeLegibility,
  breadcrumb 过渡由 all 改为 opacity/transform,降低弱 CPU 与非 Chrome 内核开销
- Navbar 工单角标轮询在后台标签页跳过,通过 visibilitychange 回到前台补刷一次
- 库存详情、货位、条码、入库日志、出库日志与明细、收货日志、盘点记录等
  详情面板由 el-table 迁移到 UpperTable,统一展开行、分页、选择与列插槽
- 11 处模板配置及内嵌表格开启行选择;转储、转退货、批量复核弹窗改用
  SelectedTags 展示已选项并支持逐个移除,移除最后一个后自动关闭
- ImagesUpload 重构为「图库 + 上传区」面板,支持多选、最多 20 张、
  单张 10MB 校验与数量提示
- 新增《跨浏览器性能-分析与优化清单》文档
2026-11-11 18:00:42 +08:00

1511 lines
50 KiB
Vue
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

<!--
库存盘点(storage/stockcheck)— 配置驱动页面(views/mode 模板 v2)
接口:库存盘点模块 stock.check(详见 src/api/stock.check/stock.check.ts)
- 列表/详情/新建/快速创建(按盘点定式)/加明细/上报/提交/审核/完成/取消/批量删除/导出选中+导出进度
快速创建(工具栏「快速创建」→ pages/CheckPatternDialog.vue):
- stock.check.patternList 拉取 5 个内置定式(空库位/错发/临期/静态/预警),
选定式 + 输入盘点名称即可创建(无需填盘点日期,也无需手选盘点范围);
后端按定式自动收集盘点对象(goods 型→商品行 / location 型→库位行),
创建后主表直接为 submitted(待审核),故不再引导手动添加明细。
页面结构:
┌──────────┬──────────────────────────────────────────────┐
│ ScanBox │ OrderToolbarButtonGroup(刷新/新建盘点/快速创建/导出选中…) │
│(单号/状态│ ┌──────────────────────────────────────────┐│
│ /货主) │ │ UpperTable(盘点单列表 + 操作列) ││
│ │ ├──────────────────────────────────────────┤│
│ │ │ 盘点单信息(DetailPanel) ││
│ │ │ 盘点明细(CheckItemsPanel:上报/完成) ││
│ │ └──────────────────────────────────────────┘│
└──────────┴──────────────────────────────────────────────┘
-->
<template>
<div class="page-wrapper" :style="{ height: containerHeight }">
<!-- ===== 多标签模式:显示顶部标签栏 ===== -->
<template v-if="PAGE_CONFIG.showTabArea && !PAGE_CONFIG.singlePage">
<div class="tab-section">
<TabArea
:tabs="tabList"
:default-active="activeTabName"
page-key="storage.stockcheck"
@tab-change="handleTabChange"
/>
</div>
</template>
<!-- ===== 主内容区 ===== -->
<div class="main-container">
<div class="order-sub-container">
<!-- 左侧:ScanBox 筛选面板 -->
<ScanBox
ref="scanBoxRef"
:cache-key="currentScanBoxCacheKey"
width="220px"
:tree-props="{ children: 'children', label: 'label' }"
:auto-submit="false"
:preset-tree="presetTree"
:available-fields="currentScanBoxFields"
@condition-change="handleConditionChange"
@reset="handleConditionReset"
@condition-clear="handleConditionClear"
/>
<!-- 右侧:内容区 -->
<div class="main-content">
<transition name="tab-fade" mode="out-in">
<div :key="activeTabName" class="tab-content-inner">
<!-- 工具栏按钮组 -->
<div class="toolbar">
<div class="toolbar-left">
<OrderToolbarButtonGroup
:buttons="currentToolbarButtons"
:resolve-disabled="resolveButtonDisabled"
:resolve-loading="resolveButtonLoading"
:resolve-label="resolveButtonLabel"
:layout-key="toolbarLayoutKey"
@action="handleToolbarButtonClick"
/>
</div>
</div>
<!-- 上下分栏区域:详情面板启用时才显示分栏 + 详情 -->
<template v-if="PAGE_CONFIG.enableDetailPanel">
<div class="split-stack" ref="splitStackRef">
<!-- 上半:表格 -->
<div class="upper-wrapper" :style="detailVisible ? upperPaneStyle : upperPaneFullStyle">
<UpperTable
ref="upperTableRef"
:title="currentTabConfig?.upperTable.title ?? '列表'"
default-align="center"
:enable-column-config="currentTabConfig?.upperTable.enableColumnConfig ?? true"
:column-config-schema-version="1"
:table-id="`template-table-${activeTabName}`"
:data="listData"
:row-key="'id'"
:columns="currentColumns"
table-size="small"
:pagination="pagination"
:page-sizes="[10, 20, 50, 100, 200]"
:show-index="currentTabConfig?.upperTable.showIndex ?? true"
:show-selection="currentTabConfig?.upperTable.showSelection ?? true"
:loading="loading"
:query-time="queryTime"
@current-change="handleRowClick"
@row-click="handleRowClick"
@page-change="handlePageChange"
@page-size-change="handlePageSizeChange"
@refresh="loadData"
@sort-change="handleSortChange"
@selection-change="handleSelectionChange"
>
<!-- 动态列插槽:根据 columnSlots 配置自动渲染 -->
<template
v-for="(slotConfig, colProp) in currentColumnSlots"
:key="`columnSlots-${colProp}`"
#[`column-${colProp}`]="{ row }"
>
<!-- 操作列:渲染操作按钮 -->
<OperationCellRenderer
v-if="slotConfig.type === 'operation'"
:buttons="currentTabConfig?.operationButtons"
:row="row"
@operation-action="handleOperationAction"
/>
<!-- 其他列:标签/文本渲染 -->
<ColumnCellRenderer
v-else
:config="slotConfig"
:value="row[colProp]"
/>
</template>
<template #empty>
<div class="empty-tip">{{ currentTabConfig?.upperTable.emptyText ?? '暂无数据' }}</div>
</template>
</UpperTable>
</div>
<!-- 分隔条(可拖拽) -->
<template v-if="detailVisible">
<div
class="pane-resizer"
title="拖动调整列表与详情区域高度"
@mousedown="beginSplitDrag"
/>
<!-- 下半:明细面板 -->
<div v-if="selectedRow" class="lower-level" :style="lowerPaneStyle">
<div class="detail-header">
<el-tabs v-model="activeDetailTab" class="detail-tab">
<el-tab-pane
v-for="tab in currentDetailTabs"
:key="tab.name"
:label="tab.label"
:name="tab.name"
/>
</el-tabs>
</div>
<div class="detail-container">
<div v-if="activeDetailTab" class="detail-page order-detail-wrapper">
<component
:is="activeDetailTabComponent"
:row="selectedDetail"
:detail-config="currentDetailConfig"
:api-method="currentDetailTabApiMethod"
@add-items="handlePanelAddItems"
@export-detail="handlePanelExportDetail"
@changed="handlePanelChanged"
/>
</div>
</div>
</div>
<!-- 未选中行时的占位 -->
<div v-else class="no-selection" :style="lowerPaneStyle">
<div class="empty-tip">
<p>请从上方列表中选择一项查看详情</p>
</div>
</div>
</template>
</div>
</template>
<!-- 详情面板禁用:表格占满全高 -->
<template v-else>
<div class="upper-wrapper upper-wrapper--full">
<UpperTable
ref="upperTableRef"
:title="currentTabConfig?.upperTable.title ?? '列表'"
default-align="center"
:enable-column-config="currentTabConfig?.upperTable.enableColumnConfig ?? true"
:column-config-schema-version="1"
:table-id="`template-table-${activeTabName}`"
:data="listData"
:row-key="'id'"
:columns="currentColumns"
table-size="small"
:pagination="pagination"
:page-sizes="[10, 20, 50, 100, 200]"
:show-index="currentTabConfig?.upperTable.showIndex ?? true"
:show-selection="currentTabConfig?.upperTable.showSelection ?? true"
:loading="loading"
:query-time="queryTime"
@current-change="handleRowClick"
@row-click="handleRowClick"
@page-change="handlePageChange"
@page-size-change="handlePageSizeChange"
@refresh="loadData"
@sort-change="handleSortChange"
@selection-change="handleSelectionChange"
>
<template
v-for="(slotConfig, colProp) in currentColumnSlots"
:key="`columnSlots-${colProp}`"
#[`column-${colProp}`]="{ row }"
>
<OperationCellRenderer
v-if="slotConfig.type === 'operation'"
:buttons="currentTabConfig?.operationButtons"
:row="row"
@operation-action="handleOperationAction"
/>
<ColumnCellRenderer
v-else
:config="slotConfig"
:value="row[colProp]"
/>
</template>
<template #empty>
<div class="empty-tip">{{ currentTabConfig?.upperTable.emptyText ?? '暂无数据' }}</div>
</template>
</UpperTable>
</div>
</template>
</div>
</transition>
</div>
</div>
</div>
<!-- ===== 功能弹窗(pages/ 目录下的组件) ===== -->
<CheckFormDialog v-model:visible="createVisible" @success="handleCreateSuccess" />
<!-- 快速创建(stock.check.patternList + stock.check.patternCreate,免填盘点日期) -->
<CheckPatternDialog v-model:visible="patternVisible" @success="handlePatternCreateSuccess" />
<CheckStockPickerDialog
v-model:visible="pickerVisible"
:task-id="pickerTaskId"
:task-title="pickerTaskLabel"
:task-type="pickerTaskType"
:task-store-id="pickerTaskStoreId"
:task-store-name="pickerTaskStoreName"
@success="handleItemsAdded"
/>
<!-- ===== 导出进度(stock.check.export + exportTaskProgress) ===== -->
<AsyncExportProgressDialog
v-model:visible="exportDialogVisible"
title="导出盘点单"
:loading="exportLoading"
:progress-percent="exportProgressPercent"
:progress-status="exportProgressStatus"
:status-label="exportStatusLabel"
:task-id="exportTaskProgress.taskId"
:message="exportTaskProgress.message"
:error="exportTaskProgress.error"
:meta="exportTaskProgress"
:update-time="exportTaskProgress.updateTime"
/>
<!-- ===== 盘点明细导出进度(stock.check.exportDetail + exportTaskProgress) ===== -->
<AsyncExportProgressDialog
v-model:visible="detailExportDialogVisible"
title="导出盘点明细"
:loading="detailExportLoading"
:progress-percent="detailExportProgressPercent"
:progress-status="detailExportProgressStatus"
:status-label="detailExportStatusLabel"
:task-id="detailExportTaskProgress.taskId"
:message="detailExportTaskProgress.message"
:error="detailExportTaskProgress.error"
:meta="detailExportTaskProgress"
:update-time="detailExportTaskProgress.updateTime"
/>
<!-- ===== 驳回盘点单(对齐 storage/receiving「批量驳回收货单」) ===== -->
<el-dialog
v-model="rejectDialogVisible"
class="reject-stockcheck-dialog"
width="min(560px, 92vw)"
align-center
append-to-body
:show-close="false"
:close-on-click-modal="false"
>
<div class="task-panel">
<header class="task-panel__head">
<div class="task-panel__titles">
<h2>驳回盘点单</h2>
<p>驳回后盘点单退回可重新编辑状态</p>
</div>
<button
class="task-panel__close"
type="button"
aria-label="关闭"
@click="rejectDialogVisible = false"
>
<svg viewBox="0 0 12 12" fill="none">
<path d="M1 1L11 11M11 1L1 11" stroke="currentColor" stroke-width="1.4" stroke-linecap="round" />
</svg>
</button>
</header>
<div class="task-panel__body">
<div class="task-panel__form">
<div class="task-panel__field">
<span class="task-panel__field-label">盘点单号</span>
<strong class="task-panel__field-value">{{ rejectRow?.check_no || '—' }}</strong>
</div>
<div class="task-panel__field task-panel__field--input task-panel__field--textarea">
<span class="task-panel__field-label">驳回原因</span>
<el-input
v-model="rejectReason"
type="textarea"
:rows="3"
placeholder="可留空(留空则保留原备注)"
/>
</div>
</div>
<p class="task-panel__form-tip">
驳回原因将写入盘点单备注;留空则保留原备注。
</p>
</div>
<footer class="task-panel__foot">
<span class="task-panel__hint">提交前请确认盘点单状态</span>
<div class="task-panel__actions">
<el-button size="small" @click="rejectDialogVisible = false">取消</el-button>
<el-button size="small" type="warning" :loading="rejectLoading" @click="submitAuditReject">
确定驳回
</el-button>
</div>
</footer>
</div>
</el-dialog>
<!-- ===== 审核通过(面板结构对齐手工录入运单号) ===== -->
<el-dialog
v-model="auditDialogVisible"
class="audit-pass-dialog"
width="min(560px, 92vw)"
align-center
append-to-body
:show-close="false"
:close-on-click-modal="false"
@closed="resetAuditDialog"
>
<div class="task-panel">
<header class="task-panel__head">
<div class="task-panel__titles">
<h2>审核通过</h2>
<p>通过后即可开始盘点作业</p>
</div>
<button
class="task-panel__close"
type="button"
aria-label="关闭"
@click="auditDialogVisible = false"
>
<svg viewBox="0 0 12 12" fill="none">
<path d="M1 1L11 11M11 1L1 11" stroke="currentColor" stroke-width="1.4" stroke-linecap="round" />
</svg>
</button>
</header>
<div class="task-panel__body">
<div class="task-panel__form">
<div class="task-panel__field">
<span class="task-panel__field-label">盘点单号</span>
<strong class="task-panel__field-value">{{ auditRow?.check_no || '—' }}</strong>
</div>
<div class="task-panel__field">
<span class="task-panel__field-label">盘点名称</span>
<strong class="task-panel__field-value">{{ auditRow?.title || '—' }}</strong>
</div>
<div class="task-panel__field">
<span class="task-panel__field-label">盘点范围</span>
<strong class="task-panel__field-value">{{ translate('type', auditRow?.type) }}</strong>
</div>
<div v-if="auditStatic" class="task-panel__field">
<span class="task-panel__field-label">静态盘点</span>
<strong class="task-panel__field-value">开启</strong>
</div>
</div>
<!-- <p class="task-panel__form-tip">
审核通过后即可开始盘点作业
</p> -->
<p v-if="auditStatic" class="task-panel__form-tip task-panel__form-tip--warning">
已开启静态盘点:审核通过后将锁定移库 / 分配储位(拣货不受影响),需等盘点完成后自动解锁。
</p>
</div>
<footer class="task-panel__foot">
<span class="task-panel__hint">提交前请确认盘点单状态</span>
<div class="task-panel__actions">
<el-button size="small" @click="auditDialogVisible = false">取消</el-button>
<el-button size="small" type="primary" :loading="auditLoading" @click="submitAuditPass">
确定通过
</el-button>
</div>
</footer>
</div>
</el-dialog>
</div>
</template>
<script setup lang="ts">
// ============================================================
// 组件名
// ============================================================
defineOptions({ name: 'StockCheck' })
import { ref, computed, onMounted, reactive } from 'vue'
import { ElMessage, ElMessageBox } from 'element-plus'
import { useSettingsStore } from '@/stores/modules/settings'
import { useVerticalSplitPane } from '@/composables/useVerticalSplitPane'
import { useAsyncExportTask } from '@/composables/useAsyncExportTask'
import ScanBox from '@/components/ScanBox/index.vue'
import UpperTable from '@/components/UpperTable/index.vue'
import AsyncExportProgressDialog from '@/components/AsyncExportProgressDialog.vue'
import TabArea from '@/components/TabArea/index.vue'
import ColumnCellRenderer from './components/ColumnCellRenderer.vue'
import OperationCellRenderer from './components/OperationCellRenderer.vue'
import OrderToolbarButtonGroup from '@/components/ToolbarButtonGroup/index.vue'
import type { ToolbarButtonConfig as OrderToolbarButtonConfig } from '@/components/ToolbarButtonGroup/types'
import {
PAGE_CONFIG,
tabPages,
resolveTabConfig,
getTabToolbarButtons,
isCheckApiSuccess,
isLocationScopeType,
isStaticCheckRow,
translate,
loadStoreOptions,
storeOptions,
buildWhereConditions,
type TabPageConfig,
type DetailTabConfig,
type ToolbarButtonConfig,
} from './config/template-config'
import CheckFormDialog from './pages/CheckFormDialog.vue'
import CheckPatternDialog from './pages/CheckPatternDialog.vue'
import CheckStockPickerDialog from './pages/CheckStockPickerDialog.vue'
import {
stockCheckAudit,
stockCheckBatchDelete,
stockCheckCancel,
stockCheckExport,
stockCheckExportDetail,
stockCheckExportTaskProgress,
stockCheckFinish,
stockCheckSubmit
} from '@/api/stock.check/stock.check'
// ============================================================
// 容器高度
// ============================================================
const settingsStore = useSettingsStore()
const containerHeight = computed(() =>
'100%' /* 高度由布局层(.app-router-page 的 flex:1)提供,不再自己算 vh */
)
// ============================================================
// 标签页
// ============================================================
const tabList = computed(() =>
tabPages.map((t) => ({ name: t.name, label: t.label }))
)
const activeTabName = ref(tabPages[0]?.name ?? 'tab1')
/** 当前激活标签页的完整配置 */
const currentTabConfig = computed<TabPageConfig | undefined>(() => {
const raw = tabPages.find((t) => t.name === activeTabName.value)
if (!raw) return undefined
return resolveTabConfig(raw)
})
/** 当前 ScanBox 缓存 key */
const currentScanBoxCacheKey = computed(
() => currentTabConfig.value?.scanBoxCacheKey ?? 'template-default'
)
/** 当前 ScanBox 筛选字段 */
const currentScanBoxFields = computed(
() => currentTabConfig.value?.scanBoxFields ?? []
)
/** 当前表格列 */
const currentColumns = computed(
() => currentTabConfig.value?.upperTable.columns ?? []
)
/** 当前列插槽配置 */
const currentColumnSlots = computed(
() => currentTabConfig.value?.columnSlots ?? {}
)
/** 当前明细面板配置 */
const currentDetailConfig = computed(
() => currentTabConfig.value?.detailConfig ?? []
)
/** 当前明细标签页列表 */
const currentDetailTabs = computed<DetailTabConfig[]>(
() => currentTabConfig.value?.detailTabs ?? []
)
/** 当前激活的明细标签页组件 */
const activeDetailTabComponent = computed(() => {
const tab = currentDetailTabs.value.find(
(t) => t.name === activeDetailTab.value
)
return tab?.component ?? null
})
/** 当前激活明细标签页对应的 API 方法 */
const currentDetailTabApiMethod = computed(() => {
const cfg = currentTabConfig.value
if (!cfg?.api) return undefined
const tab = currentDetailTabs.value.find((t) => t.name === activeDetailTab.value)
if (!tab) return undefined
let componentCfg: unknown
switch (tab.componentKey) {
case 'DetailPanel':
componentCfg = cfg.api.detail
break
case 'LogPanel':
componentCfg = cfg.api.log
break
default:
return undefined
}
if (typeof componentCfg === 'function') {
return componentCfg
}
return undefined
})
// ============================================================
// 工具栏按钮系统
// ============================================================
/** 当前标签页的工具栏按钮列表 */
const currentToolbarButtons = computed<OrderToolbarButtonConfig[]>(() => {
const btns = getTabToolbarButtons(activeTabName.value)
return btns.map((btn: ToolbarButtonConfig) => ({
key: btn.key,
label: btn.label,
size: btn.size,
// 类型 / 样式直接透传配置(「导出」为下拉按钮)
type: btn.type,
plain: btn.plain,
loadingKey: btn.loadingKey,
disabledKey: btn.disabledKey,
action: btn.action,
dynamicLabelKey: btn.dynamicLabelKey,
buttonType: btn.buttonType,
dropdownOptions: btn.dropdownOptions
}))
})
const buttonDisabledMap = computed<Record<string, boolean>>(() => ({
noSelection: selectedRows.value.length === 0
}))
const buttonLoadingMap = computed<Record<string, boolean>>(() => ({
loading: loading.value,
exportLoading: exportLoading.value,
batchDeleteLoading: batchDeleteLoading.value
}))
const buttonLabelMap = computed<Record<string, string>>(() => ({
detailToggleLabel: detailVisible.value ? '隐藏详情' : '显示详情'
}))
const toolbarLayoutKey = computed(() =>
JSON.stringify({
loading: buttonLoadingMap.value,
disabled: buttonDisabledMap.value,
labels: buttonLabelMap.value
})
)
function resolveButtonLoading(loadingKey?: string) {
if (!loadingKey) return false
return Boolean(buttonLoadingMap.value[loadingKey])
}
function resolveButtonDisabled(disabledKey?: string) {
if (!disabledKey) return false
return Boolean(buttonDisabledMap.value[disabledKey])
}
function resolveButtonLabel(defaultLabel: string, dynamicLabelKey?: string) {
if (!dynamicLabelKey) return defaultLabel
return buttonLabelMap.value[dynamicLabelKey] || defaultLabel
}
// ============================================================
// 工具栏动作分发
// ============================================================
const toolbarActionMap: Record<string, () => void> = {
loadData: () => { void loadData() },
openColumnConfigPanel: () => { upperTableRef.value?.openColumnConfig?.() },
toggleDetailVisible: () => { detailVisible.value = !detailVisible.value },
openCreateCheck: () => { createVisible.value = true },
openPatternCreate: () => { patternVisible.value = true },
handleExport: () => { void doExport() },
handleBatchDelete: () => { void doBatchDelete() }
}
function handleToolbarButtonClick(action: string) {
const handler = toolbarActionMap[action]
if (handler) {
handler()
return
}
console.warn('[stockcheck] 未处理的工具栏动作:', action)
}
// ============================================================
// 操作列按钮事件处理
// ============================================================
async function handleOperationAction(key: string, row: Record<string, any>) {
const id = Number(row?.id)
switch (key) {
case 'viewDetail':
// 已经通过行点击处理
break
case 'addItems':
openStockPicker(row)
break
case 'submitCheck':
await runCheckAction(() => stockCheckSubmit({ id }), '已提交审核')
break
case 'auditPass': {
handleAuditPass(row)
break
}
case 'auditReject':
await handleAuditReject(row)
break
case 'finishCheck':
// 静态盘点(is_static=1)完成后后端会释放静态锁定,响应带 released_stock_ids
await runCheckAction(() => stockCheckFinish({ id }), '盘点已完成', (res) => {
const released = Number((res?.data ?? res)?.released_stock_ids?.length ?? 0)
return released > 0 ? `,已释放 ${released} 个静态锁定商品` : ''
})
break
case 'cancelCheck':
await runCheckAction(() => stockCheckCancel({ id }), '盘点单已取消')
break
case 'exportDetail':
await doExportDetail(row)
break
default:
console.warn('[stockcheck] 未处理的操作按钮:', key)
}
}
/** 审核驳回:面板弹窗收驳回原因(reason 可选,留空保留原备注) */
const rejectDialogVisible = ref(false)
const rejectLoading = ref(false)
const rejectReason = ref('')
const rejectRow = ref<Record<string, any> | null>(null)
/** 审核通过:面板弹窗二次确认(对齐「手工录入运单号」新表单设计) */
const auditDialogVisible = ref(false)
const auditLoading = ref(false)
const auditRow = ref<Record<string, any> | null>(null)
const auditStatic = computed(() => isStaticCheckRow(auditRow.value))
function handleAuditPass(row: Record<string, any>) {
const id = Number(row?.id)
if (!Number.isFinite(id) || id <= 0) {
ElMessage.warning('缺少有效的盘点单ID')
return
}
auditRow.value = row
auditDialogVisible.value = true
}
function resetAuditDialog() {
auditRow.value = null
auditLoading.value = false
}
/** 提交审核通过:调用 stock.check.audit(action=approve) */
async function submitAuditPass() {
const id = Number(auditRow.value?.id)
if (!Number.isFinite(id) || id <= 0) {
ElMessage.warning('缺少有效的盘点单ID')
return
}
const wasStatic = auditStatic.value
auditLoading.value = true
try {
const res: any = await stockCheckAudit({ id, action: 'approve' })
if (!isCheckApiSuccess(res)) {
throw new Error(res?.message || '审核通过失败')
}
ElMessage.success(wasStatic ? '审核已通过,已锁定移库/分配储位,盘点完成后自动解锁' : '审核已通过')
auditDialogVisible.value = false
await reloadAndResyncDetail()
} catch (e: any) {
console.error('[stockcheck] 审核通过失败', e)
ElMessage.error(e?.message || '审核通过失败')
} finally {
auditLoading.value = false
}
}
function handleAuditReject(row: Record<string, any>) {
const id = Number(row?.id)
if (!Number.isFinite(id) || id <= 0) {
ElMessage.warning('缺少有效的盘点单ID')
return
}
rejectRow.value = row
rejectReason.value = ''
rejectDialogVisible.value = true
}
/** 提交驳回:调用 stock.check.audit(action=reject) */
async function submitAuditReject() {
const id = Number(rejectRow.value?.id)
if (!Number.isFinite(id) || id <= 0) {
ElMessage.warning('缺少有效的盘点单ID')
return
}
const reason = String(rejectReason.value ?? '').trim()
rejectLoading.value = true
try {
const res: any = await stockCheckAudit({ id, action: 'reject', ...(reason ? { reason } : {}) })
if (!isCheckApiSuccess(res)) {
throw new Error(res?.message || '驳回失败')
}
ElMessage.success('已驳回')
rejectDialogVisible.value = false
await reloadAndResyncDetail()
} catch (e: any) {
console.error('[stockcheck] 驳回盘点单失败', e)
ElMessage.error(e?.message || '驳回失败')
} finally {
rejectLoading.value = false
}
}
/** 统一执行状态类操作:校验结果 → 提示 → 刷新列表并同步详情 */
async function runCheckAction(
action: () => Promise<any>,
successText: string,
buildSuffix?: (res: any) => string
) {
try {
const res: any = await action()
if (!isCheckApiSuccess(res)) {
throw new Error(res?.message || '操作失败')
}
ElMessage.success(`${successText}${buildSuffix?.(res) || ''}`)
await reloadAndResyncDetail()
} catch (e: any) {
console.error('[stockcheck] 盘点单操作失败', e)
ElMessage.error(e?.message || '操作失败')
}
}
// ============================================================
// 接入真实接口(stock.check.*)
// ============================================================
const listData = ref<Record<string, any>[]>([])
const loading = ref(false)
const queryTime = ref(0)
const pagination = reactive({
currentPage: 1,
pageSize: 20,
total: 0
})
const currentSort = reactive({ prop: '', order: '' })
// ============================================================
// 导出(stock.check.export 异步任务 + exportTaskProgress 轮询)
// ============================================================
const {
exportLoading,
exportDialogVisible,
exportTaskProgress,
exportProgressPercent,
exportProgressStatus,
exportStatusLabel,
submitExportTask,
resumeExportTaskFromStorage
} = useAsyncExportTask({
storageKey: 'stock-check-export-task',
submitExport: (payload) => stockCheckExport(payload as any),
queryProgress: (params) => stockCheckExportTaskProgress(params)
})
/**
* 提交导出任务(导出表格中勾选的盘点单)
*/
async function doExport() {
const targetIds = selectedRows.value
.map((row) => Number(row.id))
.filter((n) => Number.isFinite(n) && n > 0)
if (!targetIds.length) {
ElMessage.warning('请先勾选要导出的盘点单')
return
}
if (targetIds.length > 50) {
ElMessage.warning('单次最多导出 50 个盘点单,请减少勾选数量')
return
}
await submitExportTask({ ids: targetIds })
}
// ============================================================
// 导出盘点明细(stock.check.exportDetail 单任务异步导出,进度复用 exportTaskProgress)
// ============================================================
const {
exportLoading: detailExportLoading,
exportDialogVisible: detailExportDialogVisible,
exportTaskProgress: detailExportTaskProgress,
exportProgressPercent: detailExportProgressPercent,
exportProgressStatus: detailExportProgressStatus,
exportStatusLabel: detailExportStatusLabel,
submitExportTask: submitDetailExportTask,
resumeExportTaskFromStorage: resumeDetailExportTaskFromStorage
} = useAsyncExportTask({
storageKey: 'stock-check-export-detail-task',
submitExport: (payload) => stockCheckExportDetail(payload as any),
queryProgress: (params) => stockCheckExportTaskProgress(params)
})
/**
* 导出单个盘点单的盘点明细(仅「已完成」任务)
*
* 商品类任务默认按库位区分明细(不传 mode → 后端默认 location);
* 库位类任务后端忽略 mode,导出 Sheet「盘点明细」。
*/
async function doExportDetail(row: Record<string, any> | null | undefined) {
const id = Number(row?.id)
if (!Number.isFinite(id) || id <= 0) {
ElMessage.warning('未识别到有效的盘点任务ID')
return
}
if (String(row?.status ?? '') !== 'completed') {
ElMessage.warning('仅「已完成」的盘点任务可导出盘点明细')
return
}
if (detailExportLoading.value) {
ElMessage.warning('已有盘点明细导出任务提交中,请稍候')
return
}
await submitDetailExportTask({ id })
}
/** 明细面板「导出明细」按钮(目标为当前选中行) */
function handlePanelExportDetail() {
void doExportDetail(selectedRow.value)
}
// ============================================================
// 批量删除(stock.check.batchDelete:仅删除「已作废(cancelled)」任务)
// ============================================================
const batchDeleteLoading = ref(false)
/**
* 批量删除盘点任务
*
* 服务端口径:仅 status=cancelled 的任务会被级联删除(作业记录 → 明细 → 主表),
* 其余状态与查不到的 ID 全部跳过并计入 skipped_ids;单次上限 200。
*/
async function doBatchDelete() {
const rows = selectedRows.value
if (!rows.length) {
ElMessage.warning('请先勾选要删除的盘点任务')
return
}
const ids = [
...new Set(
rows.map((row) => Number(row?.id)).filter((n) => Number.isFinite(n) && n > 0)
)
]
if (!ids.length) {
ElMessage.warning('未识别到有效的盘点任务ID')
return
}
if (ids.length > 200) {
ElMessage.warning('单次最多删除 200 个盘点任务,请减少勾选数量')
return
}
const cancelledRows = rows.filter((row) => String(row?.status ?? '') === 'cancelled')
const confirmText = cancelledRows.length
? `已选 ${ids.length} 个盘点任务,其中「已作废」${cancelledRows.length} 个。\n确定删除吗?仅「已作废」任务会被删除(连同其明细与作业记录),其余状态自动跳过。`
: `已选 ${ids.length} 个盘点任务,其中没有「已作废」任务,提交后将被全部跳过(不会删除任何数据)。\n是否继续?`
try {
await ElMessageBox.confirm(confirmText, '批量删除盘点任务', {
confirmButtonText: '确定删除',
cancelButtonText: '取消',
type: 'warning',
buttonSize: 'small'
})
} catch {
return
}
batchDeleteLoading.value = true
try {
const res: any = await stockCheckBatchDelete({ ids })
if (!isCheckApiSuccess(res)) {
throw new Error(res?.message || '批量删除失败')
}
const data = res.data ?? res
const deletedCount = Number(data.deleted_count ?? 0)
const skippedCount = Number(data.skipped_count ?? 0)
if (deletedCount > 0) {
ElMessage.success(
`已删除 ${deletedCount} 个盘点任务${skippedCount ? `,跳过 ${skippedCount} 个(非已作废)` : ''}`
)
} else {
ElMessage.warning(`未删除任何任务:${skippedCount} 个任务因非「已作废」状态被跳过`)
}
selectedRows.value = []
// 当前选中行若被删除,清空详情区
const deletedIds: number[] = Array.isArray(data.deleted_ids)
? data.deleted_ids.map((id: any) => Number(id))
: []
const currentId = Number(selectedRow.value?.id)
if (currentId && deletedIds.includes(currentId)) {
selectedRow.value = null
selectedDetail.value = null
}
await loadData()
} catch (e: any) {
console.error('[stockcheck] 批量删除失败', e)
ElMessage.error(e?.message || '批量删除失败')
} finally {
batchDeleteLoading.value = false
}
}
const loadData = async () => {
const cfg = currentTabConfig.value
if (!cfg) return
loading.value = true
const startTime = performance.now()
try {
if (cfg.api) {
// 使用真实接口
const conditions = scanBoxRef.value?.getConditions?.() || {}
const params = cfg.api.buildListParams
? cfg.api.buildListParams({
pagination: { page: pagination.currentPage, pageSize: pagination.pageSize },
conditions,
sort: currentSort.prop ? { prop: currentSort.prop, order: currentSort.order } : undefined
})
: {
pagination: { page: pagination.currentPage, pageSize: pagination.pageSize },
// 兜底:同样需套用后端 where 协议 `{ operator, value, type }`
where: buildWhereConditions(conditions)
}
const res = await cfg.api.list(params)
if (isCheckApiSuccess(res)) {
const parsed = cfg.api.parseListResponse
? cfg.api.parseListResponse(res)
: { list: res.data?.list ?? res.list ?? [], total: res.data?.pagination?.total ?? res.total ?? 0 }
listData.value = parsed.list
pagination.total = parsed.total
} else {
throw new Error(res?.message || '接口返回异常')
}
} else {
// ★ 未配置 API 时使用模拟数据(替换为真实接口后删除)
console.log('[PageTemplate] 未配置 API,使用空数据。请在 tabPages 中配置 api 字段。')
listData.value = []
pagination.total = 0
}
} catch (e: any) {
console.error('[PageTemplate] 加载列表失败:', e)
ElMessage.error(e?.message || '获取列表数据失败')
listData.value = []
pagination.total = 0
} finally {
loading.value = false
queryTime.value = Math.round(performance.now() - startTime)
}
}
// ============================================================
// ScanBox 筛选事件
// ============================================================
const scanBoxRef = ref<any>(null)
const presetTree = ref<any[]>([])
const handleConditionChange = () => {
pagination.currentPage = 1
loadData()
}
const handleConditionReset = () => {
pagination.currentPage = 1
loadData()
}
const handleConditionClear = () => {
pagination.currentPage = 1
loadData()
}
// ============================================================
// UpperTable 事件
// ============================================================
const upperTableRef = ref<any>(null)
const selectedRows = ref<Record<string, any>[]>([])
const handleSortChange = ({ prop, order }: any) => {
currentSort.prop = prop
currentSort.order = order
pagination.currentPage = 1
loadData()
}
const handlePageChange = (page: number) => {
pagination.currentPage = page
loadData()
}
const handlePageSizeChange = (size: number) => {
// stock.check.list 文档:pageSize 上限 200(选项已限制,此处再兜一层)
pagination.pageSize = Math.min(Math.max(1, Number(size) || 20), 200)
pagination.currentPage = 1
loadData()
}
const handleSelectionChange = (rows: Record<string, any>[]) => {
selectedRows.value = rows
}
// ============================================================
// 明细面板
// ============================================================
const detailVisible = ref(PAGE_CONFIG.enableDetailPanel)
const selectedRow = ref<Record<string, any> | null>(null)
const selectedDetail = ref<Record<string, any> | null>(null)
const activeDetailTab = ref('detail')
const handleRowClick = async (row: Record<string, any>) => {
if (!PAGE_CONFIG.enableDetailPanel) return
const cfg = currentTabConfig.value
if (!cfg) return
selectedRow.value = row
// 根据 DetailPanel 的 api 配置决定数据来源
const detailCfg = cfg.api?.detail
if (typeof detailCfg === 'function') {
try {
const detailRes = await detailCfg({ id: row.id, code: row.code })
if (detailRes && (detailRes.code === 1 || detailRes.code === 200)) {
selectedDetail.value = detailRes.data ?? detailRes
} else {
selectedDetail.value = { ...row }
}
} catch {
selectedDetail.value = { ...row }
}
} else {
// source='list' 或未配置:直接用行数据
selectedDetail.value = { ...row }
}
}
/**
* 刷新列表并把选中行同步为最新数据
* - 选中行仍在当前结果集 → 换成新对象(触发明细面板 watch 重新拉取)
* - 已被页签状态筛选排除 → 清空选中
*/
async function reloadAndResyncDetail() {
const currentId = selectedRow.value?.id
await loadData()
if (currentId === undefined || currentId === null) return
const fresh = listData.value.find((row) => row.id === currentId)
if (fresh) {
selectedRow.value = fresh
selectedDetail.value = { ...fresh }
} else {
selectedRow.value = null
selectedDetail.value = null
}
}
// ============================================================
// 标签页切换
// ============================================================
const handleTabChange = (tabName: string) => {
if (activeTabName.value === tabName) return
activeTabName.value = tabName
pagination.currentPage = 1
currentSort.prop = ''
currentSort.order = ''
selectedRow.value = null
selectedDetail.value = null
selectedRows.value = []
activeDetailTab.value = 'detail'
loadData()
}
// ============================================================
// 分栏拖拽
// ============================================================
const { splitStackRef, beginSplitDrag, lowerPaneStyle, upperPaneStyle } =
useVerticalSplitPane({ defaultLowerPercent: 38 })
const upperPaneFullStyle = computed(() => ({
flex: '1 1 auto',
minHeight: '0',
overflow: 'hidden' as const
}))
// ============================================================
// 弹窗:新建盘点 / 添加盘点商品
// ============================================================
const createVisible = ref(false)
/** 快速创建(按盘点定式)弹窗 */
const patternVisible = ref(false)
const pickerVisible = ref(false)
const pickerTask = ref<Record<string, any> | null>(null)
const pickerTaskId = computed(() => Number(pickerTask.value?.id) || 0)
/** 任务范围类型:location=库位类(添加库位);store/goods=商品类(添加商品);all 已下线 */
const pickerTaskType = computed(() => String(pickerTask.value?.type ?? ''))
const pickerTaskLabel = computed(() => {
const task = pickerTask.value
if (!task) return ''
return [task.check_no, task.title].filter(Boolean).join(' ')
})
/** 任务货主ID(>0 时「添加盘点商品」弹窗只显示该货主的商品) */
const pickerTaskStoreId = computed(() => Number(pickerTask.value?.store_id) || 0)
/** 任务货主名称(弹窗提示文案;list 行带 store_name,新建后缺失则回查下拉选项) */
const pickerTaskStoreName = computed(() => {
const task = pickerTask.value
if (!task) return ''
const name = String(task.store_name ?? '').trim()
if (name) return name
const id = Number(task.store_id)
if (!id) return ''
return storeOptions.value.find((opt) => Number(opt.value) === id)?.label ?? ''
})
/** 打开「添加盘点商品」(仅 created/rejected 状态可用,后端会再校验) */
function openStockPicker(row: Record<string, any> | null | undefined) {
if (!row?.id) return
pickerTask.value = row
pickerVisible.value = true
}
/** 明细面板「添加商品」按钮 */
function handlePanelAddItems() {
openStockPicker(selectedRow.value)
}
/** 明细面板数据变化(加商品 / 上报 / 完成)→ 刷新列表与详情 */
function handlePanelChanged() {
void reloadAndResyncDetail()
}
/** 创建成功:刷新列表,并询问是否立即添加盘点商品 / 盘点库位 */
async function handleCreateSuccess(task: {
id: number
check_no: string
title: string
type?: string
store_id?: number
store_name?: string
}) {
await reloadAndResyncDetail()
if (!task?.id) return
const targetLabel = isLocationScopeType(task.type) ? '盘点库位' : '盘点商品'
try {
await ElMessageBox.confirm(
`盘点单 ${task.check_no || task.id} 已创建(空盘点单),是否立即添加${targetLabel}?`,
`添加${targetLabel}`,
{ confirmButtonText: '立即添加', cancelButtonText: '稍后再说', type: 'info', buttonSize: 'small' }
)
} catch {
return
}
openStockPicker({
id: task.id,
check_no: task.check_no,
title: task.title,
type: task.type,
store_id: task.store_id,
store_name: task.store_name
})
}
/**
* 快速创建成功:按定式创建的盘点单已自动收集盘点对象并直接进入「待审核」,
* 无需再引导添加明细,仅刷新列表与详情。
*/
async function handlePatternCreateSuccess() {
await reloadAndResyncDetail()
}
/** 添加明细成功:刷新列表(total_items 已变化) */
async function handleItemsAdded() {
await reloadAndResyncDetail()
}
// ============================================================
// 初始化
// ============================================================
onMounted(() => {
loadData()
// 货主下拉(ScanBox 筛选 / 新建盘点表单共用)
void loadStoreOptions()
// 恢复未完成的导出任务(刷新页面后可继续查看进度)
resumeExportTaskFromStorage()
// 盘点明细导出任务同样可恢复(独立 storageKey)
resumeDetailExportTaskFromStorage()
})
</script>
<style lang="scss" scoped>
/* 布局样式对齐 @/styles/list-page.scss */
@use "@/styles/list-page.scss";
/* 详情区外壳与 order/waveOrder「团购波次」一致:不留上/下间距(波次明细/盘点单信息面板
自带 padding: 6px 10px 8px),只留左右 10px,内容滚动交给详情面板 */
.order-sub-container .main-content .lower-level .detail-container {
padding: 0 10px;
overflow: auto;
}
.detail-page {
height: 100%;
overflow-x: hidden;
overflow-y: auto;
}
.order-detail-wrapper {
height: 100%;
}
/* ================================================================
整体布局
================================================================ */
.page-wrapper {
position: relative;
width: 100%;
display: flex;
flex-direction: column;
overflow: hidden;
}
/* ================================================================
1. 顶部多标签页
================================================================ */
.tab-section {
flex-shrink: 0;
background: #fff;
border: 1px solid #e8eef7;
border-bottom: none;
border-radius: 6px 6px 0 0;
box-shadow: 0 1px 4px rgba(0, 0, 0, 0.06);
overflow: hidden;
}
/* ================================================================
2. 主内容区
================================================================ */
.main-container {
flex: 1;
display: flex;
flex-direction: column;
min-height: 0;
background: #fff;
border: 1px solid #e8eef7;
border-radius: 0 0 6px 6px;
box-shadow: 0 1px 4px rgba(0, 0, 0, 0.06);
overflow: hidden;
}
.tab-content-inner {
flex: 1;
display: flex;
flex-direction: column;
min-height: 0;
}
/* 分栏区域:布局样式由 @/styles/list-page.scss 提供,此处仅补充模板特有规则 */
.split-stack {
:deep(.el-card__header) {
padding: 2px 12px;
font-size: 13px;
}
}
/* ================================================================
6. 过渡动画
================================================================ */
.tab-fade-enter-active,
.tab-fade-leave-active {
transition: opacity 0.2s ease;
opacity: 1;
}
.tab-fade-enter-from,
.tab-fade-leave-to {
opacity: 0;
}
/* ================================================================
7. 空状态
================================================================ */
.empty-tip {
font-size: 13px;
color: #909399;
}
/* ================================================================
8. 驳回盘点单面板(结构 / 尺寸对齐批量驳回收货单)
================================================================ */
.task-panel {
background: #fff;
color: #303133;
&__head {
display: flex;
align-items: flex-start;
gap: 12px;
padding: 16px;
}
&__titles {
flex: 1;
min-width: 0;
h2 {
margin: 0;
font-size: 18px;
line-height: 24px;
font-weight: 400;
color: #303133;
}
p {
margin: 4px 0 0;
font-size: 12px;
line-height: 18px;
color: #909399;
}
}
&__close {
width: 24px;
height: 24px;
flex: none;
display: inline-flex;
align-items: center;
justify-content: center;
border: none;
border-radius: 4px;
background: transparent;
color: #909399;
cursor: pointer;
transition: color 0.2s;
svg {
width: 12px;
height: 12px;
}
&:hover {
color: #409eff;
}
}
&__body {
padding: 12px 16px 0;
}
&__form {
display: flex;
flex-direction: column;
gap: 8px;
}
&__field {
display: flex;
align-items: center;
justify-content: space-between;
gap: 16px;
min-height: 40px;
padding: 8px 12px;
border: 1px solid #ebeef5;
border-radius: 4px;
background: #fafafa;
/* 驳回原因输入行:不需要灰色容器,与上方静态信息行拉开层次 */
&--input {
align-items: center;
min-height: 0;
padding: 4px 0 0 12px;
border: none;
border-radius: 0;
background: transparent;
.el-input,
.el-textarea {
flex: 1;
min-width: 0;
}
}
&--textarea {
align-items: flex-start;
.task-panel__field-label {
padding-top: 7px;
}
}
}
/* 标签列固定宽度(含必填星号占位):对齐「手工录入运单号」表单 */
&__field-label {
flex: none;
width: 88px;
padding-left: 10px;
box-sizing: border-box;
font-size: 12px;
line-height: 20px;
color: #606266;
text-align: left;
white-space: nowrap;
}
&__field-value {
font-size: 13px;
font-weight: 500;
color: #303133;
text-align: right;
word-break: break-all;
}
&__form-tip {
margin: 8px 0 0;
padding: 8px 12px;
border-radius: 4px;
background: #f4f4f5;
font-size: 12px;
line-height: 18px;
color: #909399;
&--warning {
background: #fdf6ec;
color: #e6a23c;
}
}
&__foot {
display: flex;
align-items: center;
justify-content: space-between;
gap: 12px;
padding: 16px;
}
&__hint {
font-size: 12px;
color: #909399;
}
&__actions {
display: flex;
align-items: center;
/* 与工具栏按钮组(OrderToolbarButtonGroup)保持一致:gap 6px */
gap: 6px;
:deep(.el-button) {
margin-left: 0;
margin-right: 0;
}
}
}
</style>
<style lang="scss">
/* el-dialog 会被 append 到 body:去掉默认头/内边距,统一交给面板(同批量驳回收货单) */
.el-dialog.reject-stockcheck-dialog,
.el-dialog.audit-pass-dialog {
padding: 0;
overflow: hidden;
.el-dialog__header {
display: none;
}
.el-dialog__body {
padding: 0;
}
}
</style>