Files
bj_power/bj_power_wms/frontend/src/pages/Stocktake.vue
T
SunYF 56d56648f9 feat: 全项目列表页操作列规范统一 + 问题.md 六条整改
- 操作列按6条标准统一(WMS 13页/MES 18页):fixed right、宽160超限折更多、一列一填充、危险操作link+二次确认置末、页面级新建移工具栏
- 修复MES物料档案启用报错:改走 POST /product-types/status 专用端点,不再被全字段必填校验拦截
- 附件归档清理由按年改为用户选月(精确到月,截止月最晚6个月前,默认当前月-6),前后端同步
- 序列号文案统一为「是=逐件录SN,否=按数量(不录SN)」,MES 下拉改单选框
- 入库货架/层/位置必填校验(InboundEntry 前端 + inbound.go 后端),杜绝有区域无货架的新脏数据
- 生产流程卡新增列表Tab(新接口 GET /process-card/list 分页),去掉筛选默认时间
- 清理遗留 assets_bak/public_bak 备份目录;更新 WMS/MES 前端构建产物(index.html)
2026-10-10 18:09:17 +08:00

523 lines
23 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.
<script setup>
defineOptions({ name: 'Stocktake' })
import { computed, nextTick, onMounted, reactive, ref } from 'vue'
import { ElMessage, ElMessageBox } from 'element-plus'
import request from '../utils/request'
import { fmtTime } from '../utils/format'
import { getRealName } from '../utils/auth'
import { exportXlsxFetch } from '../utils/export'
import { can } from '../utils/perm'
import PageHelp from '../components/PageHelp.vue'
import MaterialSelect from '../components/MaterialSelect.vue'
import { helpStocktake } from '../help'
/* ---------- 权限(问题12) ---------- */
const operator = getRealName()
const canStart = can('stocktake:start') // 发起 / 扫码 / 取消(仓管作业)
const canWriteback = can('stocktake:writeback') // 差异写回(主管以上)
/* ---------- 当前进行中盘点单(发起后自动关联,问题1/2/3/7/8) ---------- */
const starting = ref(false)
const active = reactive({ no: '', totalTargets: 0, counted: 0, status: '' })
const scopeVisible = ref(false)
const scope = reactive({
type: 'all', // all / zone / material
zones: [], // 区域多选
materialCodes: [], // 物料多选
manageMode: 0, // 0全部 / 1结构件 / 2电气件
qualityStatus: '' // 空=全部
})
// 进入页面自动拉取「进行中」盘点单,扫码区/完成按钮自动关联,无需手动粘贴单号(问题2/7/8)
async function loadActive() {
try {
const data = await request.get('/stocktake/active')
const a = data?.active
if (a && a.stocktakeNo) {
active.no = a.stocktakeNo
active.totalTargets = a.totalTargets || 0
active.counted = a.counted || 0
active.status = '进行中'
} else {
active.no = ''; active.totalTargets = 0; active.counted = 0; active.status = ''
}
} catch { /* 忽略 */ }
}
// 发起范围所需的字典(物料下拉由 MaterialSelect 组件按需远程搜索,最近 100 条)
const zonesDict = ref([])
async function loadScopeDicts() {
try {
const z = await request.get('/zone/picker')
const arr = Array.isArray(z) ? z : (z?.list || [])
// picker 每行是一个货位,同一区域会重复出现,去重后区域选项才不重复
zonesDict.value = [...new Set(arr.map(x => x.zoneCode || x.code).filter(Boolean))]
} catch { /* 忽略 */ }
}
function openScope() {
loadScopeDicts()
scopeVisible.value = true
}
async function startStocktake() {
starting.value = true
let zones, materialCodes
if (scope.type === 'zone') zones = scope.zones
if (scope.type === 'material') materialCodes = scope.materialCodes
try {
const data = await request.post('/stocktake/start', {
operator,
zones: zones?.length ? zones : undefined,
materialCodes: materialCodes?.length ? materialCodes : undefined,
manageMode: scope.manageMode || undefined,
qualityStatus: scope.qualityStatus || undefined
})
active.no = data?.stocktakeNo || ''
active.totalTargets = data?.totalTargets || 0
active.counted = 0
active.status = '进行中'
records.value = []
finishResult.value = null
scopeVisible.value = false
ElMessage.success(
`盘点已发起:${scopeLabel()},盘点单号 ${active.no},目标 ${active.totalTargets} 项,库存已冻结`
)
await loadHistory()
nextTick(() => idRef.value?.focus())
} finally {
starting.value = false
}
}
function scopeLabel() {
if (scope.type === 'zone') return `按区域【${scope.zones.join('、')}】`
if (scope.type === 'material') return `按物料【${scope.materialCodes.join('、')}】${scope.manageMode ? (scope.manageMode === 1 ? '(结构件)' : '(电气件)') : ''}`
return '全库'
}
/* ---------- 扫码快速盘点(问题6:SN 自动记 1,批次填数) ---------- */
const recordForm = reactive({ targetId: '', scanQty: 1 })
const recording = ref(false)
const idRef = ref()
const records = ref([])
// 货位四级串(U18):区域/货架/层/位置,跳过空段,用于盘点差异精确定位。
function locText(row) {
const parts = []
if (row?.zoneCode) parts.push(row.zoneCode)
if (row?.shelfNo) parts.push(row.shelfNo + '架')
if (row?.layerNo) parts.push(row.layerNo + '层')
if (row?.positionNo) parts.push(row.positionNo + '位')
return parts.length ? parts.join('/') : '-'
}
async function submitRecord() {
if (!active.no) {
ElMessage.warning('请先发起盘点(或等待进行中盘点单自动带入)')
return
}
const targetId = recordForm.targetId.trim()
if (!targetId) {
ElMessage.warning('请扫入批次号(序列号=否)或 SN 序列号(序列号=是)')
return
}
const qty = Number(recordForm.scanQty)
if (!Number.isInteger(qty) || qty < 0) {
ElMessage.warning('实盘数量需为非负整数')
return
}
recording.value = true
try {
const data = await request.post('/stocktake/record', {
stocktakeNo: active.no,
targetId,
scanQty: qty
})
const isSn = data?.targetType === 'SN'
const hit = records.value.findIndex(r => r.targetId === (data?.targetId ?? targetId))
const row = {
targetId: data?.targetId ?? targetId,
targetType: data?.targetType ?? (isSn ? 'SN' : 'BATCH'),
bookQty: data?.bookQty ?? '-',
scannedQty: data?.scannedQty ?? qty,
diffQty: data?.diffQty ?? qty - (data?.bookQty ?? 0),
zoneCode: data?.zoneCode ?? '',
shelfNo: data?.shelfNo ?? '',
layerNo: data?.layerNo ?? '',
positionNo: data?.positionNo ?? ''
}
if (hit >= 0) records.value.splice(hit, 1, row)
else { records.value.unshift(row); active.counted++ }
ElMessage.success(
`已记录 ${row.targetId}(${isSn ? 'SN 自动记 1' : '批次'}):账面 ${row.bookQty},实盘 ${row.scannedQty},差异 ${row.diffQty}`
)
recordForm.targetId = ''
recordForm.scanQty = 1
nextTick(() => idRef.value?.focus())
} finally {
recording.value = false
}
}
/* ---------- 完成盘点(二次确认弹窗,问题3/4/5/11) ---------- */
const finishDlg = reactive({ visible: false, submitting: false, adjust: true, uncountedMode: 'keep' })
const finishResult = ref(null)
const approxUncounted = computed(() => Math.max(0, (active.totalTargets || 0) - (active.counted || 0)))
function openFinish() {
if (!active.no) {
ElMessage.warning('请先发起盘点')
return
}
finishDlg.adjust = canWriteback // 有写回权限默认勾选写回;无权限则只能出结论
finishDlg.uncountedMode = 'keep'
finishDlg.visible = true
}
async function submitFinish() {
if (finishDlg.adjust && !canWriteback) {
ElMessage.warning('无差异写回权限(需主管以上)')
return
}
finishDlg.submitting = true
try {
const data = await request.post('/stocktake/finish', {
stocktakeNo: active.no,
adjust: finishDlg.adjust,
uncountedMode: finishDlg.uncountedMode
})
finishResult.value = data || {}
ElMessage.success(
`盘点完成:已盘 ${data?.counted ?? 0} 项,未盘 ${data?.uncounted ?? 0} 项,差异 ${data?.diffCount ?? 0} 项` +
(data?.adjusted ? `,已写回库存(调整单 ${data?.adjustNo || ''})` : ',仅出结论未改库存')
)
finishDlg.visible = false
records.value = []
active.no = ''; active.totalTargets = 0; active.counted = 0; active.status = ''
await loadHistory()
} finally {
finishDlg.submitting = false
}
}
/* ---------- 取消盘点(问题9) ---------- */
const cancelling = ref(false)
async function cancelStocktake() {
if (!active.no) {
ElMessage.warning('当前无进行中的盘点单')
return
}
let reason
try {
const res = await ElMessageBox.prompt(
`确认取消盘点单 ${active.no}?取消后将解冻库存,本次已扫记录作废。请填写取消原因:`,
'取消盘点', { type: 'warning', inputPlaceholder: '如:发起范围选错 / 扫码错误过多', inputValidator: v => (v && v.trim() ? true : '请填写取消原因') }
)
reason = res.value
} catch { return }
cancelling.value = true
try {
await request.post('/stocktake/cancel', { stocktakeNo: active.no, reason })
ElMessage.success('盘点已取消,库存已解冻')
finishResult.value = null
records.value = []
active.no = ''; active.totalTargets = 0; active.counted = 0; active.status = ''
await loadHistory()
} finally {
cancelling.value = false
}
}
/* ---------- 历史盘点单(问题13:补差异项数/是否写回/写回时间/取消原因 + 状态筛选;问题14:导出) ---------- */
const historyFilter = ref('')
const statusFilter = ref('')
const history = ref([])
const historyLoading = ref(false)
async function loadHistory() {
historyLoading.value = true
try {
const params = {}
if (historyFilter.value.trim()) params.stocktakeNo = historyFilter.value.trim()
if (statusFilter.value) params.status = statusFilter.value
const data = await request.get('/stocktake/query', { params })
history.value = data?.list || []
} finally {
historyLoading.value = false
}
}
function statusTagType(s) {
switch (s) {
case '进行中': return 'primary'
case '已写回': return 'success'
case '已完成': return 'info'
case '已取消': return 'danger'
default: return 'info'
}
}
async function exportDetail(row) {
try {
await exportXlsxFetch('/api/stocktake/export', { stocktakeNo: row.stocktakeNo }, `盘点明细_${row.stocktakeNo}.xlsx`,
{ count: row.totalTargets, name: '盘点明细' })
} catch (e) {
ElMessage.error('导出失败:' + (e?.message || e))
}
}
// 进入页面即加载进行中盘点单 + 历史,无需手动点击查询
onMounted(async () => { await loadActive(); await loadHistory() })
// 流程步骤引导:发起盘点(冻结库存) → 扫码/录入实盘 → 完成(未盘项+写回)
const flowSteps = [
{ title: '发起盘点', desc: '选范围,冻结库存并保存快照' },
{ title: '扫码实盘', desc: '扫批次号/SN,录入实盘数' },
{ title: '完成盘点', desc: '处理未盘项,二次确认写回' }
]
const currentStep = computed(() => {
if (!active.no) return 0 // 尚未发起 → 停在第 1 步
if (!finishResult.value) return 1 // 扫码中 → 第 2 步
return flowSteps.length // 已完成后全部置成功
})
</script>
<template>
<div>
<!-- 盘点流程引导 -->
<el-card shadow="never" class="mb12">
<el-steps :active="currentStep" finish-status="success" align-center>
<el-step v-for="(s, i) in flowSteps" :key="i" :title="s.title" :description="s.desc" />
</el-steps>
</el-card>
<el-row :gutter="12">
<el-col :span="10">
<el-card shadow="never" class="mb12" header="发起盘点">
<el-descriptions :column="1" border size="small">
<el-descriptions-item label="操作人">{{ operator || '-' }}</el-descriptions-item>
<el-descriptions-item label="盘点范围">
{{ active.no ? '(已发起)' : (scope.type === 'all' ? '全库' : scope.type === 'zone' ? `按区域【${scope.zones.join('、')}】` : `按物料【${scope.materialCodes.join('、')}】`) }}
</el-descriptions-item>
<el-descriptions-item label="盘点单号">
<template v-if="active.no">
{{ active.no }}
<el-tag :type="statusTagType(active.status || '进行中')" size="small" style="margin-left:6px">{{ active.status || '进行中' }}</el-tag>
</template>
<span v-else>未发起</span>
</el-descriptions-item>
<el-descriptions-item label="目标数量">{{ active.no ? `${active.totalTargets} 项` : '-' }}</el-descriptions-item>
<el-descriptions-item label="盘点进度">{{ active.no ? `已盘 ${active.counted} / ${active.totalTargets}` : '-' }}</el-descriptions-item>
</el-descriptions>
<el-alert v-if="active.no" type="warning" :closable="false" show-icon class="mt12"
title="盘点期间该范围库存已冻结,禁止出库/入库,直至完成或取消。" />
<div class="mt12">
<el-button type="primary" :loading="starting" :disabled="!canStart || (!!active.no)"
@click="openScope">
发起盘点(可选范围)
</el-button>
<el-button type="danger" plain :loading="cancelling" :disabled="!canStart || !active.no"
@click="cancelStocktake">
取消盘点
</el-button>
</div>
</el-card>
<!-- 选择盘点范围弹窗 -->
<el-dialog v-model="scopeVisible" title="选择盘点范围" width="460px">
<el-form label-width="90px">
<el-form-item label="范围">
<el-radio-group v-model="scope.type">
<el-radio value="all">全库</el-radio>
<el-radio value="zone">按区域</el-radio>
<el-radio value="material">按物料</el-radio>
</el-radio-group>
</el-form-item>
<el-form-item v-if="scope.type === 'zone'" label="区域">
<el-select v-model="scope.zones" multiple filterable clearable placeholder="选择盘点区域" style="width:100%">
<el-option v-for="z in zonesDict" :key="z" :value="z" :label="z" />
</el-select>
</el-form-item>
<template v-if="scope.type === 'material'">
<el-form-item label="物料">
<MaterialSelect v-model="scope.materialCodes" multiple
placeholder="选择盘点物料(可多选,输入可搜索)" />
</el-form-item>
<el-form-item label="类型">
<el-select v-model="scope.manageMode" clearable placeholder="全部类型" style="width:100%">
<el-option :value="1" label="结构件" />
<el-option :value="2" label="电气件" />
</el-select>
</el-form-item>
</template>
</el-form>
<template #footer>
<el-button @click="scopeVisible = false">取消</el-button>
<el-button type="primary" :loading="starting" @click="startStocktake">确认发起</el-button>
</template>
</el-dialog>
<el-card shadow="never" header="完成盘点">
<p class="tip" style="margin-left:0">
盘点单号:<b>{{ active.no || '未发起' }}</b>(自动关联当前进行中单)
</p>
<div class="mt12">
<el-button type="warning" :disabled="!active.no" @click="openFinish">完成并处理差异</el-button>
</div>
</el-card>
</el-col>
<el-col :span="14">
<el-card shadow="never" class="mb12" header="扫码快速盘点(回车即提交并清空)">
<el-form inline @submit.prevent="submitRecord">
<el-form-item label="批次号/SN">
<el-input ref="idRef" v-model="recordForm.targetId" clearable autofocus placeholder="批次号(结构件) / SN(电气件)"
style="width:220px" @keyup.enter="submitRecord" />
</el-form-item>
<el-form-item label="实盘数量">
<el-input-number v-model="recordForm.scanQty" :min="0" :step="1" step-strictly style="width:120px" />
</el-form-item>
<el-form-item>
<el-button type="primary" :loading="recording" :disabled="!active.no" @click="submitRecord">提交</el-button>
</el-form-item>
</el-form>
<p class="tip" style="margin-left:0">
扫 <b>SN(电气件)</b> 自动记实盘数 = 1,无需填写数量;扫 <b>批次号(结构件)</b> 才需填「实盘数量」。
</p>
<el-table :data="records" border size="small" max-height="300" empty-text="尚无扫码记录">
<el-table-column prop="targetId" label="批次号 / SN 序列号" min-width="170" />
<el-table-column label="类型" width="80" align="center">
<template #default="{ row }">{{ row.targetType === 'SN' ? 'SN' : '批次' }}</template>
</el-table-column>
<el-table-column label="货位" min-width="140">
<template #default="{ row }">{{ locText(row) }}</template>
</el-table-column>
<el-table-column prop="bookQty" label="账面数" width="80" align="center" />
<el-table-column prop="scannedQty" label="实盘数" width="80" align="center" />
<el-table-column label="差异" width="80" align="center">
<template #default="{ row }">
<span :class="{ bad: row.diffQty !== 0 }">{{ row.diffQty }}</span>
</template>
</el-table-column>
</el-table>
</el-card>
</el-col>
</el-row>
<!-- 完成盘点:二次确认弹窗(问题3/5/11) -->
<el-dialog v-model="finishDlg.visible" title="完成盘点 · 差异处理确认" width="520px">
<el-alert type="info" :closable="false" show-icon class="mb12"
:title="`盘点单 ${active.no}:目标 ${active.totalTargets} 项,已盘 ${active.counted} 项,约 ${approxUncounted} 项未盘。`" />
<el-form label-width="120px">
<el-form-item label="未盘项处理">
<el-radio-group v-model="finishDlg.uncountedMode">
<el-radio value="keep">按账面保留(不计差异)</el-radio>
<el-radio value="zero">盘亏为 0(实盘记 0)</el-radio>
</el-radio-group>
</el-form-item>
<el-form-item label="差异写回库存">
<el-checkbox v-model="finishDlg.adjust" :disabled="!canWriteback">
写回(生成盘点调整单,修正库存量)
</el-checkbox>
<span v-if="!canWriteback" class="tip">无写回权限(需主管以上),本次仅出结论</span>
</el-form-item>
</el-form>
<el-alert v-if="finishDlg.adjust" type="warning" :closable="false" show-icon
title="写回将按差异修正库存量,此操作不可逆。" />
<template #footer>
<el-button @click="finishDlg.visible = false">返回</el-button>
<el-button type="warning" :loading="finishDlg.submitting" @click="submitFinish">确认完成</el-button>
</template>
</el-dialog>
<el-card v-if="finishResult" shadow="never" class="mb12" header="差异明细(diffs)">
<el-alert type="info" :closable="false"
:title="`盘点单 ${finishResult.stocktakeNo}:已盘 ${finishResult.counted} 项 / 未盘 ${finishResult.uncounted} 项 / 差异 ${finishResult.diffCount} 项${finishResult.adjusted ? `,已写回库存(调整单 ${finishResult.adjustNo || ''})` : ',仅出结论未改库存'}`"
style="margin-bottom:10px" />
<el-table :data="finishResult.diffs || []" border size="small"
empty-text="无差异,账实相符">
<el-table-column prop="targetId" label="批次号 / SN 序列号" min-width="190" />
<el-table-column label="货位" min-width="150">
<template #default="{ row }">{{ locText(row) }}</template>
</el-table-column>
<el-table-column prop="type" label="类型" width="100" align="center">
<template #default="{ row }">{{ row.type === 'BATCH' ? '批次' : 'SN' }}</template>
</el-table-column>
<el-table-column prop="bookQty" label="账面数" width="100" align="center" />
<el-table-column prop="scannedQty" label="实盘数" width="100" align="center" />
<el-table-column prop="diffQty" label="差异" width="100" align="center">
<template #default="{ row }">
<el-tag :type="row.diffQty > 0 ? 'success' : 'danger'" size="small">{{ row.diffQty }}</el-tag>
</template>
</el-table-column>
</el-table>
</el-card>
<el-card shadow="never" header="历史盘点单查询">
<el-form inline @submit.prevent="loadHistory">
<el-form-item label="盘点单号">
<el-input v-model="historyFilter" placeholder="留空查最近全部" clearable style="width:220px"
@keyup.enter="loadHistory" />
</el-form-item>
<el-form-item label="状态">
<el-select v-model="statusFilter" clearable placeholder="全部状态" style="width:130px">
<el-option value="进行中" label="进行中" />
<el-option value="已完成" label="已完成" />
<el-option value="已写回" label="已写回" />
<el-option value="已取消" label="已取消" />
</el-select>
</el-form-item>
<el-form-item>
<el-button type="primary" :loading="historyLoading" @click="loadHistory">查询</el-button>
<el-button @click="historyFilter=''; statusFilter=''; loadHistory()">重置</el-button>
</el-form-item>
</el-form>
<el-table :data="history" border size="small" empty-text="暂无盘点记录">
<el-table-column prop="stocktakeNo" label="盘点单号" min-width="190" />
<el-table-column prop="operator" label="发起人" width="100" align="center">
<template #default="{ row }">{{ row.operator || '-' }}</template>
</el-table-column>
<el-table-column prop="totalTargets" label="目标数" width="80" align="center" />
<el-table-column prop="diffCount" label="差异项数" width="90" align="center">
<template #default="{ row }">
<span :class="{ bad: (row.diffCount || 0) > 0 }">{{ row.diffCount || 0 }}</span>
</template>
</el-table-column>
<el-table-column label="状态" width="100" align="center">
<template #default="{ row }">
<el-tag :type="statusTagType(row.status)" size="small">{{ row.status }}</el-tag>
</template>
</el-table-column>
<el-table-column label="是否写回" width="90" align="center">
<template #default="{ row }">
<el-tag :type="row.adjusted ? 'success' : 'info'" size="small">{{ row.adjusted ? '已写回' : '未写回' }}</el-tag>
</template>
</el-table-column>
<el-table-column label="写回时间" width="160" align="center">
<template #default="{ row }">{{ fmtTime(row.writtenAt) || '-' }}</template>
</el-table-column>
<el-table-column label="取消原因" min-width="120">
<template #default="{ row }">{{ row.cancelReason || '-' }}</template>
</el-table-column>
<el-table-column label="发起时间" width="160" align="center">
<template #default="{ row }">{{ fmtTime(row.createdAt) }}</template>
</el-table-column>
<el-table-column label="操作" width="90" align="center" fixed="right">
<template #default="{ row }">
<el-button type="primary" size="small" @click="exportDetail(row)">导出明细</el-button>
</template>
</el-table-column>
</el-table>
</el-card>
</div>
<PageHelp :data="helpStocktake" page="Stocktake" />
</template>
<style scoped>
.mb12 { margin-bottom: 12px; }
.mt12 { margin-top: 12px; }
.tip { margin-left: 10px; color: #909399; font-size: 12px; }
.bad { color: #f56c6c; font-weight: 700; }
</style>