liufumingren eb305306eb feat(库存盘点): 明细平铺/批量删除、库位级联选择器与 addDetail 新契约
- 明细面板:库位行内商品平铺成行、新增「明细类型」列、批量删除明细(stock.check.detailDelete,按明细ID去重,上限 200)

- 新增 LocationPicker(仓库→库区→货架→库位逐层下拉,v-model 为库位ID数组),「添加盘点库位」接入该组件

- addDetail 改走 location_ids(优先于 locations),补 invalid_location_ids 提示

- 删除调试用临时文件 temp_stockcheck_tail.txt
2026-10-02 03:22:21 +08:00

896 lines
33 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.

<!--
CheckItemsPanel — 盘点明细面板(库存盘点 stock.check)
职责:
1. 拉取盘点明细并渲染:
- 已有/可能有作业记录的阶段(approved/checking/completed/cancelled)→ **stock.check.result**
(范围行 + 已盘/差异/状态/作业记录聚合)
- 尚未开始作业的阶段(created/rejected/submitted,必然无作业记录)→ **stock.check.detail**
(纯范围行,不含聚合;此时作业类列不渲染,无需多发一次聚合查询)
明细行形态由任务 type 决定,表格统一「平铺」展示(不用展开行):
- 商品行(scope_type=goods,type=store/goods):一行一个库存商品(商品快照 + 已盘聚合)
- 库位行(scope_type=location,type=all/location):一行一个库位 + 行内商品各一行
(result 的 stocks[] 平铺;无商品时保留库位行本身、商品列为 —)
上报需带 stock_id → 商品行直接上报;同明细的「明细类型 / 库位」单元格合并显示
2. 盘点作业:行内或批量上报(stock.check.report,**覆盖式**:
商品行=同明细+同库位;库位行=同明细+同商品+同库位,均重复上报为更新)
3. 批量删除明细(stock.check.detailDelete,仅 created/rejected):勾选行按**明细ID**去重提交,
单次上限 200 条;未命中的明细ID由服务端计入 skipped_ids(不报错)
4. 完成盘点(stock.check.finish,允许部分未盘完成:
未盘商品明细按实盘 0 计入盘亏与差异行数,未盘库位明细不计差异)
5. 「添加商品 / 添加库位」交给宿主 index.vue 打开 CheckStockPickerDialog(emit add-items)
状态约束(与后端一致):
- created/rejected → 可添加明细(addDetail)
- approved/checking → 可上报(report)、可完成(finish)
- mode=blind 盲盘 → 账面数量/差异在前端不可见
- 明细 status:checked=有作业记录 / unchecked=未盘
-->
<template>
<div class="check-items-panel">
<!-- 按钮行(间距 6px 对齐 toolbar) -->
<div class="header-actions">
<div class="left-actions">
<el-button size="small" type="primary" :loading="loading" @click="loadItems">刷新</el-button>
<el-button v-if="canAddItems" size="small" type="primary" plain @click="emit('add-items')">
{{ isLocationTask ? '添加库位' : '添加商品' }}
</el-button>
<el-button
v-if="canAddItems"
size="small"
type="danger"
plain
:disabled="!selectedDetailIds.length"
:loading="deleting"
@click="deleteSelected"
>
批量删除明细{{ selectedDetailIds.length ? `(${selectedDetailIds.length})` : '' }}
</el-button>
<el-button
v-if="canReport && !isLocationTask"
size="small"
type="primary"
plain
:disabled="!dirtyRows.length"
:loading="reporting"
@click="reportDirty"
>
批量上报{{ dirtyRows.length ? `(${dirtyRows.length})` : '' }}
</el-button>
<el-button
v-if="canReport"
size="small"
type="primary"
plain
:loading="finishing"
@click="finishCheck"
>
完成盘点
</el-button>
</div>
<div class="right-actions">
<span v-if="!useResultSource" class="hint-text">未开始盘点:仅展示盘点范围</span>
<span v-if="isQuantityMasked" class="hint-text">盲盘:账面数量不可见</span>
<span class="stat-text">
明细 {{ stats.total }} · 已盘 {{ stats.checked }} · 差异 {{ stats.diff }}
</span>
</div>
</div>
<div ref="tableHostRef" class="table-host">
<el-table
ref="tableRef"
v-loading="loading"
:data="pagedRows"
row-key="flat_key"
border
stripe
size="small"
:height="tableHeight"
:span-method="spanMethod"
@selection-change="handleSelectionChange"
>
<!-- 批量删除:仅 created/rejected(可增删明细)时提供勾选,按明细ID去重提交 -->
<el-table-column v-if="canAddItems" type="selection" width="45" :reserve-selection="true" />
<el-table-column type="index" label="#" width="56" align="center" :index="indexMethod" />
<!-- 明细类型:商品行 / 库位行(同一单内由任务 type 决定,显式标注便于核对) -->
<el-table-column label="明细类型" width="90" align="center">
<template #default="{ row }">{{ itemScopeLabel(row) }}</template>
</el-table-column>
<!-- 商品列:仅商品类任务显示(库位类任务不展示商品快照,商品明细看「作业明细」) -->
<el-table-column v-if="!isLocationTask" label="商品编码" min-width="130" show-overflow-tooltip>
<template #default="{ row }">{{ row.item_code || '—' }}</template>
</el-table-column>
<el-table-column v-if="!isLocationTask" label="商品名称" min-width="160" show-overflow-tooltip>
<template #default="{ row }">{{ row.item_name || '—' }}</template>
</el-table-column>
<el-table-column v-if="!isLocationTask" label="规格" min-width="110" show-overflow-tooltip>
<template #default="{ row }">{{ row.spec || '—' }}</template>
</el-table-column>
<el-table-column v-if="!isLocationTask" label="批次号" min-width="110" show-overflow-tooltip>
<template #default="{ row }">{{ row.batch_no || '—' }}</template>
</el-table-column>
<el-table-column label="库位" min-width="130" show-overflow-tooltip>
<template #default="{ row }">
<!-- 库位行:库位以明细自身库位为准,只读(同明细的行合并单元格);商品行可填库位 -->
<span v-if="isLocationTask">{{ formatLocationCodes(row) }}</span>
<el-input
v-else-if="canReport"
v-model="locationMap[row.item.id]"
size="small"
placeholder="库位编码(可留空=无库位)"
/>
<span v-else>{{ formatLocationCodes(row) }}</span>
</template>
</el-table-column>
<!-- 账面/实盘输入列:仅商品类任务(库位类任务不在此面板上报) -->
<el-table-column v-if="!isLocationTask" label="账面数量" width="100" align="center">
<template #default="{ row }">{{ maskQuantity(row.system_quantity) }}</template>
</el-table-column>
<el-table-column v-if="!isLocationTask" label="本库位数量" width="140" align="center">
<template #default="{ row }">
<el-input-number
v-if="isReportableRow(row)"
:model-value="rowQuantity(row)"
size="small"
:min="0"
:step="1"
step-strictly
controls-position="right"
class="quantity-input"
@update:model-value="onRowQuantityChange(row, $event)"
/>
<span v-else class="hint-text">—</span>
</template>
</el-table-column>
<el-table-column v-if="useResultSource" label="已盘合计" width="100" align="center">
<template #default="{ row }">{{ row.checked_quantity ?? '—' }}</template>
</el-table-column>
<el-table-column v-if="useResultSource" label="差异" width="90" align="center">
<template #default="{ row }">
<span v-if="isQuantityMasked" class="hint-text">—</span>
<span v-else :class="diffClass(row.diff_quantity)">{{ formatDiff(row.diff_quantity) }}</span>
</template>
</el-table-column>
<el-table-column v-if="useResultSource" label="盘点状态" width="100" align="center">
<template #default="{ row }">
<span :class="getStatusTextClass(itemStatusTag(row.status))">
{{ translate('check_item_status', row.status) }}
</span>
</template>
</el-table-column>
<el-table-column v-if="useResultSource" label="盘点人" width="110" show-overflow-tooltip>
<template #default="{ row }">{{ formatCheckers(row) }}</template>
</el-table-column>
<el-table-column v-if="useResultSource" label="最近上报" width="160">
<template #default="{ row }">{{ formatTime(row.last_checked_at) }}</template>
</el-table-column>
<!-- 操作列:仅商品类任务(库位类任务的上报在「作业明细」侧处理) -->
<el-table-column v-if="!isLocationTask" label="操作" width="100" align="center" fixed="right">
<template #default="{ row }">
<el-button
v-if="isReportableRow(row)"
link
type="primary"
size="small"
:loading="reportingId === Number(row.item.id)"
@click="reportFlatRow(row)"
>
上报
</el-button>
<span v-else class="hint-text">—</span>
</template>
</el-table-column>
<template #empty>
<div class="empty-tip">{{ emptyText }}</div>
</template>
</el-table>
</div>
<div v-if="flatRows.length > pageSize" class="pagination-container">
<el-pagination
v-model:current-page="page"
v-model:page-size="pageSize"
:page-sizes="[10, 20, 50, 100]"
:total="flatRows.length"
layout="total, sizes, prev, pager, next"
background
size="small"
@current-change="handlePageChange"
/>
</div>
</div>
</template>
<script setup lang="ts">
import { computed, nextTick, reactive, ref, watch } from 'vue'
import { ElMessage, ElMessageBox } from 'element-plus'
import { useResizeObserver } from '@vueuse/core'
import { getStatusTextClass } from '@/views/order/orderManagement/config/order-common-config'
import { formatTime, isCheckApiSuccess, isLocationScopeType, translate } from '../template-config'
import {
stockCheckDetail,
stockCheckDetailDelete,
stockCheckFinish,
stockCheckReport,
stockCheckResult,
type StockCheckReportParams
} from '@/api/stock.check/stock.check'
defineOptions({ name: 'CheckItemsPanel' })
const props = defineProps<{
/** 当前选中的盘点单(列表行数据,含 id/status/mode 等) */
row: Record<string, any> | null
}>()
const emit = defineEmits<{
/** 点击「添加商品 / 添加库位」→ 宿主打开 CheckStockPickerDialog */
(e: 'add-items'): void
/** 明细发生变化(加商品 / 上报 / 完成)→ 宿主刷新列表 */
(e: 'changed'): void
}>()
// ============================================================
// 状态判定
// ============================================================
const taskId = computed(() => Number(props.row?.id) || 0)
const taskStatus = computed(() => String(props.row?.status ?? ''))
/** created/rejected:可添加明细(addDetail:商品类传 stock_ids / 库位类传 locations) */
const canAddItems = computed(() => ['created', 'rejected'].includes(taskStatus.value))
/** approved/checking:可上报实盘、可完成 */
const canReport = computed(() => ['approved', 'checking'].includes(taskStatus.value))
/** 库位类任务(type=all/location):明细为「库位行」,上报需带 stock_id → 在展开行里按商品上报 */
const isLocationTask = computed(() => isLocationScopeType(props.row?.type))
/**
* 是否已有/可能有作业记录 —— 决定明细取数接口:
* true → stock.check.result(范围行 + 作业聚合)
* false → stock.check.detail(纯范围行,不含聚合)
* created/rejected/submitted 阶段后端不会有作业记录,聚合字段必然为空,故只取范围行。
*/
const useResultSource = computed(
() => !['created', 'rejected', 'submitted'].includes(taskStatus.value)
)
/** 盲盘:账面数量前端不可见 */
const isBlind = computed(() => String(props.row?.mode ?? '') === 'blind')
const isQuantityMasked = computed(
() => isBlind.value && !['completed', 'cancelled'].includes(taskStatus.value)
)
// ============================================================
// 明细数据
// ============================================================
const items = ref<Record<string, any>[]>([])
const loading = ref(false)
const reporting = ref(false)
const reportingId = ref<number | null>(null)
const finishing = ref(false)
const stats = reactive({ total: 0, checked: 0, diff: 0 })
/** 商品行实盘数量输入(明细ID → 数量) */
const quantityMap = reactive<Record<string, number | undefined>>({})
/** 库位行实盘数量输入(`明细ID:stockID` → 数量) */
const stockQuantityMap = reactive<Record<string, number | undefined>>({})
/** 商品行库位输入(明细ID → 库位编码) */
const locationMap = reactive<Record<string, string>>({})
/** 明细类型文案(scope_type:goods=商品 / location=库位;接口未返回时按任务类型兜底) */
function itemScopeLabel(item: Record<string, any>): string {
const scope = item?.scope_type
if (scope !== undefined && scope !== null && scope !== '') return translate('scope_type', scope)
return isLocationTask.value ? '库位' : '商品'
}
/** 库位行内商品的数量输入 key */
function stockKey(detailId: unknown, stockId: unknown): string {
return `${detailId}:${stockId}`
}
/** 库位行内的商品聚合(无 stocks 时返回空数组) */
function rowStocks(item: Record<string, any>): Record<string, any>[] {
return Array.isArray(item?.stocks) ? item.stocks : []
}
/**
* 平铺行(表格数据源)
*
* - 商品行(scope_type=goods):一行一个明细,商品快照取自明细自身
* - 库位行(scope_type=location):将行内商品(result 的 stocks[])平铺为多行,
* 一行一个商品,商品快照/账面数量/已盘/差异取商品(stock)的值;
* 无商品时保留库位行本身(商品列显示 —,不可上报)
* 每行带 `flat_key`(行 key)与 `item`(明细行,上报/库位等仍以明细为准)
*/
const flatRows = computed<Record<string, any>[]>(() => {
const list: Record<string, any>[] = []
for (const item of items.value) {
const detailId = Number(item.id) || 0
if (!isLocationTask.value) {
list.push({ ...item, flat_key: `d${detailId}`, detail_id: detailId, item })
continue
}
const stocks = rowStocks(item)
if (!stocks.length) {
list.push({ ...item, flat_key: `d${detailId}`, detail_id: detailId, item })
continue
}
for (const stock of stocks) {
list.push({
...item,
flat_key: `d${detailId}:s${stock.stock_id}`,
detail_id: detailId,
item,
stock,
item_code: stock.item_code ?? null,
item_name: stock.item_name ?? null,
spec: stock.spec ?? null,
batch_no: stock.batch_no ?? null,
system_quantity: stock.system_quantity ?? null,
checked_quantity: stock.checked_quantity ?? null,
diff_quantity: stock.diff_quantity ?? null
})
}
}
return list
})
function hasQuantity(value: unknown): boolean {
if (value === undefined || value === null || (value as any) === '') return false
return Number.isFinite(Number(value))
}
/** 本次上报目标:商品行只带明细;库位行还需带 stock_id */
type ReportTarget = { item: Record<string, any>; stock?: Record<string, any> }
const emptyText = computed(() =>
canAddItems.value
? `暂无盘点明细,可点击「${isLocationTask.value ? '添加库位' : '添加商品'}」生成明细`
: '暂无盘点明细'
)
/** 已填写实盘数量的行(库位行按明细+商品 / 商品行按明细) */
const dirtyRows = computed<ReportTarget[]>(() => {
const list: ReportTarget[] = []
for (const row of flatRows.value) {
if (row.stock) {
if (hasQuantity(stockQuantityMap[stockKey(row.item.id, row.stock.stock_id)])) {
list.push({ item: row.item, stock: row.stock })
}
} else if (!isLocationTask.value && hasQuantity(quantityMap[String(row.item.id)])) {
list.push({ item: row.item })
}
}
return list
})
// ============================================================
// 表格高度 / 分页
// ============================================================
const tableRef = ref<any>(null)
const tableHostRef = ref<HTMLElement | null>(null)
const tableHeight = ref(260)
const page = ref(1)
const pageSize = ref(20)
useResizeObserver(tableHostRef, (entries) => {
const h = entries[0]?.contentRect.height ?? 0
if (h >= 120) tableHeight.value = Math.floor(h)
})
const pagedRows = computed(() => {
const start = (page.value - 1) * pageSize.value
return flatRows.value.slice(start, start + pageSize.value)
})
function indexMethod(index: number) {
return (page.value - 1) * pageSize.value + index + 1
}
/**
* 平铺后按明细合并「明细类型 / 库位」单元格(仅库位类任务、仅当前页内)
* 首个同明细行返回 [跨行数, 1],其余返回 [0, 0](不渲染)
*/
function spanMethod({ rowIndex, column }: any): number[] | undefined {
if (!isLocationTask.value) return undefined
const label = String(column?.label ?? '')
if (label !== '明细类型' && label !== '库位') return undefined
const rows = pagedRows.value
const row = rows[rowIndex]
if (!row) return undefined
const prev = rows[rowIndex - 1]
if (prev && prev.detail_id === row.detail_id) return [0, 0]
let count = 1
for (let i = rowIndex + 1; i < rows.length; i += 1) {
if (rows[i]?.detail_id === row.detail_id) count += 1
else break
}
return [count, 1]
}
function handlePageChange() {
nextTick(() => tableRef.value?.setScrollTop?.(0))
}
/** 该行是否可填实盘数量并上报(库位行需有对应商品库存;商品行直接可填) */
function isReportableRow(row: Record<string, any>): boolean {
if (!canReport.value) return false
return isLocationTask.value ? Boolean(row?.stock) : true
}
/** 该行当前的实盘输入值(库位行按明细+商品,商品行按明细) */
function rowQuantity(row: Record<string, any>): number | undefined {
return row?.stock
? stockQuantityMap[stockKey(row.item.id, row.stock.stock_id)]
: quantityMap[String(row.item.id)]
}
function setRowQuantity(row: Record<string, any>, value: number | undefined) {
if (row?.stock) stockQuantityMap[stockKey(row.item.id, row.stock.stock_id)] = value
else quantityMap[String(row.item.id)] = value
}
function onRowQuantityChange(row: Record<string, any>, value: number | undefined | null) {
setRowQuantity(row, value === null ? undefined : value)
}
// ============================================================
// 加载明细
// ============================================================
async function loadItems() {
if (!taskId.value) {
items.value = []
return
}
loading.value = true
try {
// 有作业记录阶段取「结果」(含已盘/差异/作业记录聚合);未开始作业阶段只取「范围行」
const res: any = useResultSource.value
? await stockCheckResult({ id: taskId.value })
: await stockCheckDetail({ id: taskId.value })
if (!isCheckApiSuccess(res)) {
throw new Error(res?.message || '获取盘点明细失败')
}
const data = res.data ?? res
items.value = Array.isArray(data.rows) ? data.rows : []
const check = data.check ?? {}
stats.total = Number(check.total_items ?? items.value.length) || 0
stats.checked = Number(check.checked_items ?? 0) || 0
stats.diff = Number(check.diff_items ?? 0) || 0
resetInputs()
selectedRows.value = []
nextTick(() => tableRef.value?.clearSelection?.())
page.value = 1
} catch (e: any) {
console.error('[stockcheck] 加载盘点明细失败', e)
ElMessage.error(e?.message || '获取盘点明细失败')
items.value = []
} finally {
loading.value = false
}
}
/** 明细自身的库位编码(库位行 rows[].location_code;商品行与「无库位」分组为空) */
function ownLocationCode(item: Record<string, any>): string {
const code = item?.location_code
return code === null || code === undefined || String(code).trim() === '' ? '' : String(code)
}
/**
* 明细库位编码集合
*
* - 结果行(stock.check.result):取 location_codes,其次 locations 兜底
* - 范围行(stock.check.detail,未开始作业阶段):无聚合字段,**库位行**(scope_type=location)
* 取自身 location_code(否则库位列显示「—」,detail 的库位行只带 location_code)
* 「无库位」分组的空串/null 一律剔除;商品行不掺入自身预设库位
*/
function resolveLocationCodes(item: Record<string, any>): string[] {
const raw = Array.isArray(item?.location_codes) && item.location_codes.length
? item.location_codes
: Array.isArray(item?.locations)
? item.locations.map((loc: any) => loc?.location_code)
: []
const codes = raw
.filter((code: unknown) => code !== null && code !== undefined && String(code).trim() !== '')
.map((code: any) => String(code))
const own = item?.scope_type === 'location' ? ownLocationCode(item) : ''
if (own && !codes.includes(own)) codes.push(own)
return [...new Set(codes)]
}
/** 是否存在「无库位」分组的记录(该分组库中存空串,接口返回归一为 null) */
function hasBlankLocationRecord(item: Record<string, any>): boolean {
const raw: any[] = Array.isArray(item?.location_codes) && item.location_codes.length
? item.location_codes
: Array.isArray(item?.locations)
? item.locations.map((loc: any) => loc?.location_code)
: []
return raw.some((code) => code === null || code === undefined || String(code).trim() === '')
}
/** 库位列(只读态):多库位用、拼接;含无库位分组的记录时同时标出「无库位」 */
function formatLocationCodes(item: Record<string, any>): string {
const parts = resolveLocationCodes(item)
if (hasBlankLocationRecord(item)) parts.push('无库位')
if (parts.length) return parts.join('、')
return item?.checked_quantity === null || item?.checked_quantity === undefined ? '—' : '无库位'
}
/** 盘点人(checkers 数组去重拼接) */
function formatCheckers(item: Record<string, any>): string {
const list: string[] = Array.isArray(item?.checkers)
? [...new Set(item.checkers.filter(Boolean).map((c: any) => String(c)))]
: []
return list.length ? list.join('、') : '—'
}
/**
* 上报输入回填:商品行库位仅有 1 个时回填(便于覆盖上报);数量不预填
* (行上的 checked_quantity 是该明细全部作业记录的合计,不等于本次上报值)
*/
function resetInputs() {
for (const key of Object.keys(quantityMap)) delete quantityMap[key]
for (const key of Object.keys(stockQuantityMap)) delete stockQuantityMap[key]
for (const key of Object.keys(locationMap)) delete locationMap[key]
for (const item of items.value) {
const codes = resolveLocationCodes(item)
locationMap[String(item.id)] = codes.length === 1 ? (codes[0] ?? '') : ''
}
}
// ============================================================
// 批量删除明细(stock.check.detailDelete,仅 created/rejected)
// ============================================================
const selectedRows = ref<Record<string, any>[]>([])
const deleting = ref(false)
/** 选中行对应的明细ID(按明细去重:库位行平铺后同一明细可能对应多行) */
const selectedDetailIds = computed<number[]>(() => {
const ids = selectedRows.value.map((row) =>
Number(row?.detail_id ?? row?.item?.id ?? row?.id)
)
return [...new Set(ids.filter((id) => Number.isFinite(id) && id > 0))]
})
function handleSelectionChange(rows: Record<string, any>[]) {
selectedRows.value = Array.isArray(rows) ? rows : []
}
/** 批量删除选中的盘点明细(单次上限 200,与后端一致) */
async function deleteSelected() {
const ids = selectedDetailIds.value
if (!ids.length) {
ElMessage.warning('请先勾选要删除的盘点明细')
return
}
if (ids.length > 200) {
ElMessage.warning(`单次最多删除 200 条明细(已选 ${ids.length} 条),请分批删除`)
return
}
try {
await ElMessageBox.confirm(
`确定删除选中的 ${ids.length} 个盘点明细?删除后需重新添加。`,
'批量删除盘点明细',
{ confirmButtonText: '确定删除', cancelButtonText: '取消', type: 'warning' }
)
} catch {
return
}
deleting.value = true
try {
const res: any = await stockCheckDetailDelete({ id: taskId.value, detail_ids: ids })
if (!isCheckApiSuccess(res)) {
throw new Error(res?.message || '删除盘点明细失败')
}
const data = res.data ?? res
const deletedCount = Number(data.deleted_count ?? 0)
const skippedIds: number[] = Array.isArray(data.skipped_ids) ? data.skipped_ids : []
if (skippedIds.length) {
ElMessage.warning(
`已删除 ${deletedCount} 条明细,跳过 ${skippedIds.length} 条(不存在或不属于当前仓库)`
)
} else {
ElMessage.success(`已删除 ${deletedCount} 条盘点明细`)
}
// loadItems 内部会重置页码与勾选
await loadItems()
emit('changed')
} catch (e: any) {
console.error('[stockcheck] 删除盘点明细失败', e)
ElMessage.error(e?.message || '删除盘点明细失败')
} finally {
deleting.value = false
}
}
// ============================================================
// 上报实盘(stock.check.report)
// ============================================================
/** 取本次待上报的数量;非法返回 null */
function resolveQuantity(target: ReportTarget): number | null {
const raw = target.stock
? stockQuantityMap[stockKey(target.item.id, target.stock.stock_id)]
: quantityMap[String(target.item.id)]
if (raw === undefined || raw === null || (raw as any) === '') return null
const qty = Number(raw)
if (!Number.isFinite(qty) || qty < 0) return null
return Math.trunc(qty)
}
/**
* 上报一行;silent=true 时不弹单行成功提示(批量上报用)
* @returns 是否成功
*/
async function doReport(target: ReportTarget, silent = false): Promise<boolean> {
const { item, stock } = target
const quantity = resolveQuantity(target)
if (quantity === null) {
if (!silent) ElMessage.warning('请输入不小于 0 的实盘数量')
return false
}
const payload: StockCheckReportParams = {
id: taskId.value,
detail_id: Number(item.id),
quantity
}
if (stock) {
// 库位行:stock_id 必填,库位以明细库位为准(传入必须一致)
payload.stock_id = Number(stock.stock_id)
const loc = resolveLocationCodes(item)[0]
if (loc) payload.location = loc
} else {
// 商品行:stock_id 可选(传入必须与明细商品一致)
const stockId = Number(item.stock_id)
if (Number.isFinite(stockId) && stockId > 0) payload.stock_id = stockId
const location = String(locationMap[String(item.id)] ?? '').trim()
if (location) payload.location = location
}
reportingId.value = Number(item.id)
try {
const res: any = await stockCheckReport(payload)
if (!isCheckApiSuccess(res)) {
throw new Error(res?.message || '上报失败')
}
const data = res.data ?? res
// 覆盖式上报:进度/差异以接口返回为准,明细聚合字段稍后重新拉取
if (data.total_items !== undefined) stats.total = Number(data.total_items) || 0
if (data.checked_items !== undefined) stats.checked = Number(data.checked_items) || 0
if (data.diff_items !== undefined) stats.diff = Number(data.diff_items) || 0
if (!silent) ElMessage.success(String(data.mode ?? '') === 'updated' ? '已覆盖上报' : '上报成功')
return true
} catch (e: any) {
console.error('[stockcheck] 上报实盘失败', e)
if (!silent) ElMessage.error(e?.message || '上报失败')
return false
} finally {
reportingId.value = null
}
}
/** 行内上报(商品行) */
async function reportRow(item: Record<string, any>) {
const ok = await doReport({ item })
if (!ok) return
// 覆盖式上报可能更新已有记录,明细行上的聚合字段需重拉
await loadItems()
emit('changed')
}
/** 行内上报(库位行的某个商品;report 需要 stock_id) */
async function reportStock(item: Record<string, any>, stock: Record<string, any>) {
const ok = await doReport({ item, stock })
if (!ok) return
await loadItems()
emit('changed')
}
/** 平铺行上报:有商品按商品上报,商品行直接按明细上报 */
async function reportFlatRow(row: Record<string, any>) {
if (row?.stock) await reportStock(row.item, row.stock)
else await reportRow(row.item)
}
/** 批量上报:逐行串行提交,避免并发写同一盘点单 */
async function reportDirty() {
const targets = [...dirtyRows.value]
if (!targets.length) {
ElMessage.warning('请先填写实盘数量')
return
}
reporting.value = true
let success = 0
let failed = 0
try {
for (const target of targets) {
const ok = await doReport(target, true)
if (ok) success += 1
else failed += 1
}
} finally {
reporting.value = false
}
if (failed === 0) {
ElMessage.success(`已上报 ${success} 项`)
} else {
ElMessage.warning(`上报完成:成功 ${success} 项,失败 ${failed} 项`)
}
// 重新拉取明细(聚合字段由后端按作业记录重算)
await loadItems()
emit('changed')
}
// ============================================================
// 完成盘点(stock.check.finish)
// ============================================================
async function finishCheck() {
try {
await ElMessageBox.confirm(
'完成后不再允许修改盘点记录;未盘商品明细将按实盘 0 处理(计入盘亏与差异行数),未盘库位明细不计差异。确定完成?',
'完成盘点',
{ confirmButtonText: '确定完成', cancelButtonText: '取消', type: 'warning' }
)
} catch {
return
}
finishing.value = true
try {
const res: any = await stockCheckFinish({ id: taskId.value })
if (!isCheckApiSuccess(res)) {
throw new Error(res?.message || '完成盘点失败')
}
const data = res.data ?? res
const profit = Number(data.profit_total ?? 0)
const loss = Number(data.loss_total ?? 0)
const unchecked = Number(data.unchecked_items ?? 0)
ElMessage.success(
`盘点已完成(盘盈 ${profit} / 盘亏 ${loss}${unchecked > 0 ? `;未盘 ${unchecked} 项按 0 处理` : ''})`
)
await loadItems()
emit('changed')
} catch (e: any) {
console.error('[stockcheck] 完成盘点失败', e)
ElMessage.error(e?.message || '完成盘点失败')
} finally {
finishing.value = false
}
}
// ============================================================
// 单元格渲染辅助
// ============================================================
function maskQuantity(value: any) {
if (isQuantityMasked.value) return '***'
return value === undefined || value === null || value === '' ? '—' : value
}
function formatDiff(value: any) {
if (value === undefined || value === null || value === '') return '—'
const n = Number(value)
if (!Number.isFinite(n)) return String(value)
return n > 0 ? `+${n}` : String(n)
}
function diffClass(value: any) {
const n = Number(value)
if (!Number.isFinite(n) || n === 0) return 'diff-text'
return n > 0 ? 'diff-text diff-text--profit' : 'diff-text diff-text--loss'
}
function itemStatusTag(status: any) {
return String(status ?? '') === 'checked' ? 'success' : 'info'
}
// ============================================================
// 联动:切换盘点单 / 主表状态变化时重新拉取
// ============================================================
watch(
() => [props.row?.id, props.row?.status],
() => {
void loadItems()
},
{ immediate: true }
)
</script>
<style lang="scss" scoped>
/* ut-status-text 系列状态文字颜色类定义在 order-sub.scss 里(scoped 样式需要本组件自行引入) */
@use "../../../../order/orderManagement/styles/order-sub.scss";
.check-items-panel {
width: 100%;
height: 100%;
padding: 6px 10px 8px;
box-sizing: border-box;
background: #fff;
display: flex;
flex-direction: column;
overflow: hidden;
}
/* 按钮行:Element Plus 默认 .el-button + .el-button 会与 gap 叠加,必须清零 */
.header-actions {
display: flex;
justify-content: space-between;
align-items: center;
flex-wrap: wrap;
gap: 6px;
margin-bottom: 5px;
flex-shrink: 0;
.left-actions,
.right-actions {
display: flex;
align-items: center;
gap: 6px;
}
.left-actions {
:deep(.el-button) {
margin-left: 0;
margin-right: 0;
}
}
}
.stat-text {
font-size: 12px;
color: #909399;
}
.hint-text {
font-size: 12px;
color: #c0c4cc;
}
.table-host {
flex: 1;
min-height: 120px;
min-width: 0;
overflow: hidden;
.quantity-input {
width: 110px;
}
}
/* 库位行内的商品已平铺到主表,无需展开区样式 */
.diff-text {
color: #606266;
&--profit {
color: #67c23a;
}
&--loss {
color: #f56c6c;
}
}
.empty-tip {
font-size: 13px;
color: #909399;
}
/* 分页器:右对齐 + 「每页条数」下拉与 UpperTable 同宽 80px */
.pagination-container {
flex-shrink: 0;
display: flex;
justify-content: flex-end;
align-items: center;
margin-top: 6px;
:deep(.el-select--small) {
width: 80px;
}
:deep(.el-input__wrapper) {
padding: 0 4px;
}
}
</style>