This commit is contained in:
yin 2026-09-29 18:15:06 +08:00
parent cf119f7ff3
commit 2cf3806edf
18 changed files with 5275 additions and 1 deletions

View File

@ -0,0 +1,745 @@
import request from '@/utils/request'
const v = '1.0'
/**
* 库存盘点(module folder = stock.check)接口封装。
*
* 状态机(主表 status):
* created ──submit──> submitted ──audit(approve)──> approved ──report(首次)──> checking ──finish──> completed
* │ │ (终态:completed / cancelled)
* │ └──audit(reject)──> rejected ──addDetail 可再改──┐
* └──cancel──> cancelled(终态) │
* ↑──────────────── submit 仅 created/rejected ──────────────────────────┘
*
* 仓库隔离:所有接口的 warehouse_id 均由服务端从登录上下文(ctx.user.store_id)注入,前端**禁止传入**。
*
* 盘点作业记录(wms_stock_check_record):
* report 为**覆盖式**上报——同明细 + 同库位编码重复上报时更新已有记录(不新增),
* 由唯一索引 uk_detail_location(detail_id, location_code) 保证并发安全;
* 未传/为空的库位归入「无库位」分组(库中 location_code 存**空串** '',同分组同样覆盖更新),
* 而 recordList 返回时把空串归一为 **null**(对外口径);
* 一个明细可以有多个库位的记录,明细行上的 checked_quantity/diff_quantity 均为记录聚合值;
* recordList / recordDelete 用于查看与删除作业记录,删除不影响主表状态。
* 未盘明细 = 无作业记录的明细(finish 时按实盘 0 处理,计入盘亏与差异行数)。
*/
/** 盘点主表状态 */
export type StockCheckStatus =
| 'created' // 新建(可加明细)
| 'submitted' // 已提交待审核
| 'rejected' // 审核驳回(可再改明细再提交)
| 'approved' // 审核通过,待盘点作业
| 'checking' // 盘点中
| 'completed' // 已完成(终态)
| 'cancelled' // 已取消(终态)
/** 明细盘点进度(主表 detail_status) */
export type StockCheckDetailStatus = 'none_checked' | 'partial_checked' | 'all_checked'
/** 盘点范围类型 */
export type StockCheckType =
| 'all' // 全盘(缺省)
| 'store' // 按货主
| 'goods' // 按商品
| 'location' // 按库位
/** 盘点方式 */
export type StockCheckMode =
| 'open' // 明盘(可见账面数量,缺省)
| 'blind' // 盲盘(不可见账面数量)
/** 审核动作 */
export type StockCheckAuditAction = 'approve' | 'reject'
/** 盘点主表行(create 响应 / list rows / detail.check 同构) */
export type StockCheckTask = {
id: number
/** 盘点单号(PD+YYYYMMDD+6 位序号,按仓库隔离) */
check_no: string
/** 盘点名称/主题 */
title: string
type: StockCheckType
mode: StockCheckMode
/** 货主ID(type=store 按货主盘点时有值) */
store_id?: number | null
status: StockCheckStatus
detail_status: StockCheckDetailStatus
/** 盘点日期 */
check_date?: string | null
/** 实际开始时间(开始盘点作业后回填) */
start_time?: string | null
/** 实际结束时间(完成盘点后回填) */
end_time?: string | null
creator_id: number
/** 创建人名称快照 */
creator_name: string
/** 明细行数 */
total_items: number
/** 已盘行数 */
checked_items: number
/** 差异行数 */
diff_items: number
remark: string
created_at?: string
updated_at?: string
[key: string]: unknown
}
/** 盘点作业记录(wms_stock_check_record):同一明细 + 同一库位一条,重复上报为覆盖更新 */
export type StockCheckRecord = {
id: number
check_id: number
warehouse_id?: number
/** 盘点明细ID */
detail_id: number
/** 商品库存ID(wms_stock_warehouse.id) */
stock_id: number
location_id?: number | null
/**
* 库位编码;「无库位」分组的记录:库中存**空串**,但 recordList/detail 返回时归一为 **null**
* (故前端按 falsy 判断即可,空串与 null 均表示无库位)
*/
location_code?: string | null
/** 本库位实盘数量 */
quantity: number
checker_id?: number | null
checker_name?: string | null
checked_at?: string | null
remark?: string | null
created_at?: string
updated_at?: string
[key: string]: unknown
}
/** 明细的库位聚合(stock.check.detail 的 rows[].locations) */
export type StockCheckDetailLocation = {
location_id?: number | null
/** 库位编码;「无库位」分组为空串或 null */
location_code?: string | null
/** 该库位下作业记录数量合计 */
quantity: number
}
/**
* 盘点明细行(stock.check.detail 返回):商品快照 + 已盘聚合字段 + 作业记录
*
* 注意:实盘数量/差异已不是单值,而是按作业记录聚合的 checked_quantity / diff_quantity;
* 库位为多个(location_codes 数组 + locations 按库位聚合;无库位分组的编码为空串/null)。
*/
export type StockCheckDetailRow = {
id: number
check_id: number
warehouse_id?: number
/** 商品库存ID(wms_stock_warehouse.id) */
stock_id: number
item_code?: string
item_name?: string
spec?: string
batch_no?: string
/** 账面数量(快照) */
system_quantity?: number
/** 已盘数量 = 该明细作业记录 quantity 合计(无作业记录时为 null) */
checked_quantity?: number | null
/** 差异数量 = 已盘数量 - 账面快照(无作业记录时为 null) */
diff_quantity?: number | null
/** 是否有差异:0|1(无作业记录时为 null) */
is_diff?: boolean | number | null
/** 明细状态:checked=有作业记录 / unchecked=未盘 */
status?: 'checked' | 'unchecked' | string
/** 已盘库位编码数组(去重;无库位分组的编码为空串/null) */
location_codes?: string[]
/** 盘点人数组(去重) */
checkers?: string[]
/** 最近上报时间 */
last_checked_at?: string | null
/** 该明细的全部作业记录(无记录时为空数组) */
records?: StockCheckRecord[]
/** 按库位聚合(无记录时为空数组) */
locations?: StockCheckDetailLocation[]
remark?: string | null
created_at?: string
updated_at?: string
[key: string]: unknown
}
// ============ stock.check.create ============
/** stock.check.create 请求参数(warehouse_id 服务端注入,禁止前端传;check_date 必填) */
export type StockCheckCreateParams = {
/** 盘点名称/主题 */
title?: string
/** 盘点范围类型,缺省 all */
type?: StockCheckType
/** 盘点方式,缺省 open;blind=盲盘(前端不可见账面数量) */
mode?: StockCheckMode
/** 货主ID(type=store 时必填) */
store_id?: number
/** 盘点日期(必填,须可被 Date 解析) */
check_date: string
remark?: string
}
/** stock.check.create:创建盘点任务(空任务,status=created、detail_status=none_checked) */
export function stockCheckCreate(
data: StockCheckCreateParams
): Promise<StockCheckTask & { code?: number; message?: string; data?: Partial<StockCheckTask> }> {
return request({
url: '/system',
method: 'post',
params: {
method: 'stock.check.create',
v,
timestamp: new Date().getTime()
},
data,
isSystemApi: true
} as any)
}
// ============ stock.check.list ============
/** stock.check.list 的 where 条件 */
export type StockCheckListWhere = {
/** 状态筛选(单值或数组):created/submitted/rejected/approved/checking/completed/cancelled */
status?: StockCheckStatus | StockCheckStatus[]
/** 货主筛选 */
store_id?: number
/** 关键字:对盘点单号/标题模糊匹配 */
keyword?: string
}
/** stock.check.list 请求参数 */
export type StockCheckListParams = {
/** 分页参数,默认 page=1、pageSize=20,pageSize 上限 200 */
pagination?: { page?: number; pageSize?: number }
where?: StockCheckListWhere
}
/** stock.check.list 响应 */
export type StockCheckListResponse = {
rows: StockCheckTask[]
total: number
page: number
pageSize: number
}
/** stock.check.list:盘点任务列表(按登录仓库限定数据范围,服务端分页) */
export function stockCheckList(
data: StockCheckListParams = {}
): Promise<StockCheckListResponse & { code?: number; message?: string; data?: Partial<StockCheckListResponse> }> {
return request({
url: '/system',
method: 'post',
params: {
method: 'stock.check.list',
v,
timestamp: new Date().getTime()
},
data,
isSystemApi: true
} as any)
}
// ============ stock.check.addDetail ============
/** stock.check.addDetail 请求参数 */
export type StockCheckAddDetailParams = {
/** 盘点任务ID */
id: number
/** 商品库存ID列表(wms_stock_warehouse.id) */
stock_ids: number[]
}
/** stock.check.addDetail 响应 */
export type StockCheckAddDetailResponse = {
/** 本次新增明细数 */
added: number
/** 已存在被跳过(幂等)的 stock_id 数 */
skipped: number
/** 无效商品库存ID列表(不存在或不属于当前仓库) */
invalid_stock_ids: number[]
/** 重算后的明细总行数 */
total_items: number
}
/** stock.check.addDetail:添加盘点明细(仅 created/rejected 允许;同 stock_id 幂等跳过) */
export function stockCheckAddDetail(
data: StockCheckAddDetailParams
): Promise<
StockCheckAddDetailResponse & { code?: number; message?: string; data?: Partial<StockCheckAddDetailResponse> }
> {
return request({
url: '/system',
method: 'post',
params: {
method: 'stock.check.addDetail',
v,
timestamp: new Date().getTime()
},
data,
isSystemApi: true
} as any)
}
// ============ stock.check.detailDelete ============
/** stock.check.detailDelete 请求参数 */
export type StockCheckDetailDeleteParams = {
/** 盘点任务ID */
id: number
/** 盘点明细ID(与 detailId 二选一,detail_id 优先) */
detail_id?: number
/** 盘点明细ID(驼峰别名,兼容写法) */
detailId?: number
}
/** stock.check.detailDelete 响应 */
export type StockCheckDetailDeleteResponse = {
/** 被删除的盘点明细ID */
detail_id: number
/** 是否删除成功 */
deleted: boolean
/** 删除后重算的主表明细总行数 */
total_items: number
}
/**
* stock.check.detailDelete:删除盘点明细(从任务中移除某个商品)
*
* - 仅主表状态 created/rejected 允许删除
* - 该明细若存在作业记录(wms_stock_check_record)会防御性一并删除
* (正常流程 created/rejected 状态不应有记录)
* - 删除后服务端重算主表 total_items
*/
export function stockCheckDetailDelete(
data: StockCheckDetailDeleteParams
): Promise<
StockCheckDetailDeleteResponse & {
code?: number
message?: string
data?: Partial<StockCheckDetailDeleteResponse>
}
> {
return request({
url: '/system',
method: 'post',
params: {
method: 'stock.check.detailDelete',
v,
timestamp: new Date().getTime()
},
data,
isSystemApi: true
} as any)
}
// ============ stock.check.detail ============
/** stock.check.detail 请求参数 */
export type StockCheckDetailParams = {
/** 盘点任务ID */
id: number
}
/** stock.check.detail 响应 */
export type StockCheckDetailResponse = {
/** 盘点主表信息 */
check: StockCheckTask
/** 全部明细行 */
rows: StockCheckDetailRow[]
/** 明细总条数 */
total: number
}
/** stock.check.detail:拉取盘点任务主表 + 全部明细行(不分页) */
export function stockCheckDetail(
data: StockCheckDetailParams
): Promise<StockCheckDetailResponse & { code?: number; message?: string; data?: Partial<StockCheckDetailResponse> }> {
return request({
url: '/system',
method: 'post',
params: {
method: 'stock.check.detail',
v,
timestamp: new Date().getTime()
},
data,
isSystemApi: true
} as any)
}
// ============ stock.check.report ============
/** stock.check.report 请求参数(覆盖式:同明细 + 同库位重复上报为更新) */
export type StockCheckReportParams = {
/** 盘点任务ID */
id: number
/** 盘点明细ID */
detail_id: number
/**
* 库位编码(可空):未传或为空串均写入「无库位」分组(库中 location_code 存空串);
* 匹配 space_code 时回填 location_id
*/
location?: string
/** 实盘数量(不小于 0 的整数) */
quantity: number
}
/** stock.check.report 响应 */
export type StockCheckReportResponse = {
/** 新增或更新的作业记录(wms_stock_check_record 行) */
record: StockCheckRecord
/** 盘点明细ID */
detail_id: number
/** 本次上报模式:created=首次上报新增记录 / updated=同明细+同库位覆盖更新 */
mode: 'created' | 'updated' | string
total_items: number
/** 已盘行数(存在作业记录的明细数) */
checked_items: number
/** 差异行数(实盘合计与账面快照不一致的明细数) */
diff_items: number
detail_status: StockCheckDetailStatus
}
/**
* stock.check.report:盘点作业**覆盖式**上报(同明细 + 同库位重复上报更新已有记录)。
* 仅 approved/checking 允许;主表 approved 首次上报自动转 checking。
*/
export function stockCheckReport(
data: StockCheckReportParams
): Promise<StockCheckReportResponse & { code?: number; message?: string; data?: Partial<StockCheckReportResponse> }> {
return request({
url: '/system',
method: 'post',
params: {
method: 'stock.check.report',
v,
timestamp: new Date().getTime()
},
data,
isSystemApi: true
} as any)
}
// ============ stock.check.recordList ============
/** stock.check.recordList 请求参数(id 与 detail_id 至少传一个) */
export type StockCheckRecordListParams = {
/** 盘点任务ID(可选) */
id?: number
/** 盘点明细ID(可选;传了只查该明细的作业记录) */
detail_id?: number
/** 分页参数,默认 page=1、pageSize=20,pageSize 上限 200 */
pagination?: { page?: number; pageSize?: number }
}
/** stock.check.recordList 响应行:作业记录全字段 + 商品快照列 */
export type StockCheckRecordListRow = StockCheckRecord & {
item_code?: string
item_name?: string
}
/** stock.check.recordList 响应 */
export type StockCheckRecordListResponse = {
rows: StockCheckRecordListRow[]
total: number
page: number
pageSize: number
}
/** stock.check.recordList:盘点作业记录列表(按记录 id 倒序,服务端分页) */
export function stockCheckRecordList(
data: StockCheckRecordListParams = {}
): Promise<StockCheckRecordListResponse & { code?: number; message?: string; data?: Partial<StockCheckRecordListResponse> }> {
return request({
url: '/system',
method: 'post',
params: {
method: 'stock.check.recordList',
v,
timestamp: new Date().getTime()
},
data,
isSystemApi: true
} as any)
}
// ============ stock.check.recordDelete ============
/** stock.check.recordDelete 请求参数(record_id 优先,recordId 为兼容别名) */
export type StockCheckRecordDeleteParams = {
/** 盘点任务ID */
id: number
/** 作业记录ID(wms_stock_check_record.id) */
record_id?: number
/** 作业记录ID(驼峰别名) */
recordId?: number
}
/** stock.check.recordDelete 响应(删除后重算的进度;主表状态不回退) */
export type StockCheckRecordDeleteResponse = {
/** 被删除的作业记录ID */
record_id: number
/** 是否删除成功 */
deleted: boolean
total_items: number
checked_items: number
diff_items: number
detail_status: StockCheckDetailStatus
}
/** stock.check.recordDelete:删除盘点作业记录(仅 approved/checking;记录删光后该明细回到未盘口径) */
export function stockCheckRecordDelete(
data: StockCheckRecordDeleteParams
): Promise<StockCheckRecordDeleteResponse & { code?: number; message?: string; data?: Partial<StockCheckRecordDeleteResponse> }> {
return request({
url: '/system',
method: 'post',
params: {
method: 'stock.check.recordDelete',
v,
timestamp: new Date().getTime()
},
data,
isSystemApi: true
} as any)
}
// ============ stock.check.finish ============
/** stock.check.finish 请求参数 */
export type StockCheckFinishParams = {
/** 盘点任务ID */
id: number
}
/** stock.check.finish 响应(含差异汇总与未盘明细数) */
export type StockCheckFinishResponse = {
id: number
/** 完成后的主表状态(completed) */
status: StockCheckStatus
total_items: number
/** 已盘行数(存在作业记录的明细数) */
checked_items: number
/** 未盘明细数(无作业记录的明细数,完成时按实盘 0 处理计为盘亏) */
unchecked_items: number
/** 差异行数(含未盘明细按实盘 0 计算的差异) */
diff_items: number
/** 盘盈合计(作业记录数量合计大于账面快照的差异合计) */
profit_total: number
/** 盘亏合计(实盘小于账面快照的差异绝对值合计,含未盘明细的账面快照数) */
loss_total: number
}
/**
* stock.check.finish:完成盘点作业(**允许部分未盘完成**)。
* 仅 approved/checking 允许;未盘明细按实盘 0 处理(差异 = -账面快照,计入盘亏与差异行数)。
*/
export function stockCheckFinish(
data: StockCheckFinishParams
): Promise<StockCheckFinishResponse & { code?: number; message?: string; data?: Partial<StockCheckFinishResponse> }> {
return request({
url: '/system',
method: 'post',
params: {
method: 'stock.check.finish',
v,
timestamp: new Date().getTime()
},
data,
isSystemApi: true
} as any)
}
// ============ stock.check.submit ============
/** stock.check.submit 请求参数 */
export type StockCheckSubmitParams = {
/** 盘点任务ID */
id: number
}
/** stock.check.submit 响应 */
export type StockCheckSubmitResponse = {
id: number
/** 提交后的主表状态(submitted) */
status: StockCheckStatus
}
/** stock.check.submit:提交审核(仅 created/rejected 允许;校验 total_items>0) */
export function stockCheckSubmit(
data: StockCheckSubmitParams
): Promise<StockCheckSubmitResponse & { code?: number; message?: string; data?: Partial<StockCheckSubmitResponse> }> {
return request({
url: '/system',
method: 'post',
params: {
method: 'stock.check.submit',
v,
timestamp: new Date().getTime()
},
data,
isSystemApi: true
} as any)
}
// ============ stock.check.cancel ============
/** stock.check.cancel 请求参数 */
export type StockCheckCancelParams = {
/** 盘点任务ID */
id: number
}
/** stock.check.cancel 响应 */
export type StockCheckCancelResponse = {
id: number
/** 取消后的主表状态(cancelled 终态) */
status: StockCheckStatus
}
/** stock.check.cancel:取消盘点任务(仅 created/submitted/rejected 允许) */
export function stockCheckCancel(
data: StockCheckCancelParams
): Promise<StockCheckCancelResponse & { code?: number; message?: string; data?: Partial<StockCheckCancelResponse> }> {
return request({
url: '/system',
method: 'post',
params: {
method: 'stock.check.cancel',
v,
timestamp: new Date().getTime()
},
data,
isSystemApi: true
} as any)
}
// ============ stock.check.audit ============
/** stock.check.audit 请求参数 */
export type StockCheckAuditParams = {
/** 盘点任务ID */
id: number
/** 审核动作:approve=通过 / reject=驳回 */
action: StockCheckAuditAction
/** 驳回原因(写入备注,可选;缺省保留原备注) */
reason?: string
}
/** stock.check.audit 响应 */
export type StockCheckAuditResponse = {
id: number
/** 审核后的主表状态:approved(通过)/ rejected(驳回) */
status: StockCheckStatus
}
/** stock.check.audit:审核盘点任务(仅 submitted 允许) */
export function stockCheckAudit(
data: StockCheckAuditParams
): Promise<StockCheckAuditResponse & { code?: number; message?: string; data?: Partial<StockCheckAuditResponse> }> {
return request({
url: '/system',
method: 'post',
params: {
method: 'stock.check.audit',
v,
timestamp: new Date().getTime()
},
data,
isSystemApi: true
} as any)
}
// ============ stock.check.export ============
/** stock.check.export 请求参数(ids 与 task_ids 二选一,ids 优先;单次最多 50 个盘点任务) */
export type StockCheckExportParams = {
/** 盘点任务ID数组(兼容单值) */
ids?: number[] | number
/** 盘点任务ID数组(ids 的别名) */
task_ids?: number[] | number
}
/** stock.check.export / exportTaskProgress 响应(提交与进度同构,进度额外含 download_url) */
export type StockCheckExportResponse = {
/** 导出任务ID(格式 stock_check_export_{warehouseId}_{时间戳}_{随机串}) */
task_id: string
/** 任务状态:submitted/running/success/failed/not_found */
status: string
/** 进度百分比(0-100) */
progress: number
/** 当前已处理明细数 */
current_count: number
/** 明细总行数 */
total_count: number
message: string
/** 任务成功时的结果对象(含 filename/fileKey/url/cdnUrl/cosUrl) */
result?: Record<string, unknown> | null
error: string
/** 最近一次状态更新时间戳(毫秒) */
update_time: number
}
/**
* stock.check.export:提交盘点任务导出任务(异步)。
* 每个盘点任务一个 Sheet(Sheet 名=盘点单号);单次最多 50 个盘点任务。
*/
export function stockCheckExport(
data: StockCheckExportParams = {}
): Promise<StockCheckExportResponse & { code?: number; message?: string; data?: Partial<StockCheckExportResponse> }> {
return request({
url: '/system',
method: 'post',
params: {
method: 'stock.check.export',
v,
timestamp: new Date().getTime()
},
data,
isSystemApi: true
} as any)
}
// ============ stock.check.exportTaskProgress ============
/** stock.check.exportTaskProgress 请求参数(task_id 与 taskId 二选一) */
export type StockCheckExportTaskProgressParams = {
/** 任务ID(下划线写法) */
task_id?: string
/** 任务ID(驼峰写法) */
taskId?: string
}
/** stock.check.exportTaskProgress 响应 */
export type StockCheckExportTaskProgressResponse = StockCheckExportResponse & {
/** 完成后可直接下载的文件地址(从 result 兜底提取);未完成或未找到时为空字符串 */
download_url: string
}
/**
* stock.check.exportTaskProgress:查询盘点导出进度。
* 任务不存在时**正常返回**(status=not_found),不视为错误;任务缓存 TTL 1800 秒。
*/
export function stockCheckExportTaskProgress(
data: StockCheckExportTaskProgressParams
): Promise<
StockCheckExportTaskProgressResponse & {
code?: number
message?: string
data?: Partial<StockCheckExportTaskProgressResponse>
}
> {
return request({
url: '/system',
method: 'post',
params: {
method: 'stock.check.exportTaskProgress',
v,
timestamp: new Date().getTime()
},
data,
isSystemApi: true
} as any)
}

View File

@ -86,6 +86,7 @@ export default {
'afterSalelist':'AfterSale List',
'inbox_auto_reply':'Inbox Auto Reply',
'InboxAutoReply':'Inbox Auto Reply',
'StockCheck':'Stock Check',
},
"login": {
"title": "Login",

View File

@ -89,6 +89,7 @@ export default {
'afterSalelist':'售后列表',
'inbox_auto_reply':'回信规则配置',
'InboxAutoReply':'回信规则配置',
'StockCheck':'库存盘点',
},
"login": {
"title": "登录",

View File

@ -89,4 +89,5 @@ export const componentMap: Record<string, any> = {
'afterSale/afterSalelist': () => import('@/views/afterSale/list/index.vue'),
'afterSale/detail/index': () => import('@/views/afterSale/detail/index.vue'),
'afterSale/typelist/index': () => import('@/views/afterSale/typelist/index.vue'),
'storage/stockcheck/index': () => import('@/views/storage/stockcheck/index.vue'),
};

View File

@ -22,6 +22,15 @@
>
刷新
</el-button>
<!-- 「数量」数值默认遮挡,点此切换显示/隐藏(仅影响展示) -->
<el-button
type="primary"
plain
size="small"
@click="quantityVisible = !quantityVisible"
>
{{ quantityVisible ? '隐藏数量' : '显示数量' }}
</el-button>
</el-button-group>
<!-- 明细表格 -->
@ -62,7 +71,12 @@
prop="quantity"
label="数量"
width="80"
/>
>
<!-- 数量:默认遮挡具体数值,点上方「显示数量」可查看 -->
<template #default="{ row }">
<span>{{ quantityVisible ? (row.quantity ?? '-') : QUANTITY_MASK }}</span>
</template>
</el-table-column>
<el-table-column
prop="locked_quantity"
label="锁定数量"
@ -73,6 +87,12 @@
label="可用数量"
width="80"
/>
<el-table-column
label="实物数"
width="80"
>
<template #default="{ row }">{{ resolvePhysicalQuantity(row) }}</template>
</el-table-column>
<el-table-column
prop="production_date"
label="生产日期"
@ -138,6 +158,22 @@ const loading = ref(false)
const tableData = ref<any[]>([])
const stockItem = ref<any>(null)
/** 「数量」数值是否可见:默认隐藏(只遮挡数值,列仍在;不影响数据与分页/刷新) */
const quantityVisible = ref(false)
/** 隐藏时的占位符 */
const QUANTITY_MASK = '***'
/**
* 实物数 = 可用数量 + 锁定数量
* 可用数量缺失/为 0 时按「数量 - 锁定数量」兜底(与主列表「可用库存」列口径一致)
*/
function resolvePhysicalQuantity(row: any): number {
const quantity = Number(row?.quantity ?? 0) || 0
const locked = Number(row?.locked_quantity ?? 0) || 0
const available = Number(row?.available_quantity || Math.max(0, quantity - locked)) || 0
return available + locked
}
const pagination = reactive({
page: 1,
pageSize: 20,

View File

@ -66,6 +66,15 @@
</div>
<div class="right-actions">
<!-- 「总数量」数值默认遮挡,点此切换显示/隐藏(仅影响展示) -->
<el-button
size="small"
type="primary"
plain
@click="quantityVisible = !quantityVisible"
>
{{ quantityVisible ? '隐藏数量' : '显示数量' }}
</el-button>
<el-radio-group
v-if="!groupByBatch"
v-model="detailViewMode"
@ -230,6 +239,11 @@
</el-link>
<span v-else>{{ row[col.prop] || '--' }}</span>
</template>
<!-- 总数量:默认遮挡具体数值,点右上「显示数量」可查看 -->
<template v-else-if="col.prop === 'quantity'" #default="{ row }">
<span>{{ quantityVisible ? (row[col.prop] ?? '--') : QUANTITY_MASK }}</span>
</template>
</el-table-column>
<template #empty>
@ -340,6 +354,7 @@ const detailColumns = computed(() => {
if (isSpaceView.value) {
return [
{ prop: 'space_code', label: '库位', width: '160' },
{ prop: 'physical_quantity', label: '实物数', width: '100' },
{ prop: 'quantity', label: '总数量', width: '100' },
{ prop: 'available_quantity', label: '可用数量', width: '100' },
{ prop: 'locked_quantity', label: '锁定数量', width: '100' },
@ -363,6 +378,11 @@ const detailColumns = computed(() => {
]
})
/** 「总数量」数值是否可见:默认隐藏(只隐藏数值,列仍在;不影响数据与移库/维护日期逻辑) */
const quantityVisible = ref(false)
/** 隐藏时的占位符 */
const QUANTITY_MASK = '***'
const dialogTitle = computed(() => {
if (transferMode.value === 'location') return '按库存记录移库'
if (transferMode.value === 'product') return '按商品移库'
@ -814,6 +834,13 @@ async function confirmExpiry() {
}
}
/** 实物数 = 可用数量 + 锁定数量 */
function resolvePhysicalQuantity(row: any): number {
const available = Number(row?.available_quantity ?? 0)
const locked = Number(row?.locked_quantity ?? 0)
return (Number.isFinite(available) ? available : 0) + (Number.isFinite(locked) ? locked : 0)
}
/** 按库位汇总行归一化(无批次字段,含库位/数量/批次数/入库时间) */
function normalizeSpaceRow(item: any) {
const row = normalizeRow(item)
@ -823,6 +850,7 @@ function normalizeSpaceRow(item: any) {
row.quantity = item.quantity ?? 0
row.available_quantity = item.available_quantity ?? 0
row.locked_quantity = item.locked_quantity ?? 0
row.physical_quantity = resolvePhysicalQuantity(row)
row.batch_count = Number(item.batch_count || 0)
row.first_inbound_time = item.first_inbound_time || ''
row.last_inbound_time = item.last_inbound_time || ''

View File

@ -0,0 +1,74 @@
<!--
ColumnCellRenderer — 通用表格列渲染器
根据传入的 ColumnSlotConfig 决定如何渲染单元格:
- type='tag' → 状态文字颜色(ut-status-text,替代 el-tag;支持 tagResolver / tagType 颜色映射)
- type='text' → 纯文本(支持 datetime 格式化)
- type='default' → 默认插槽渲染
- type='operation' → 操作列(由 OperationCellRenderer 处理)
-->
<template>
<template v-if="!config || config.type === 'default'">
<slot />
</template>
<template v-else-if="config.type === 'tag'">
<span :class="getStatusTextClass(resolvedTagType)">
{{ displayValue }}
</span>
</template>
<template v-else>
<span>{{ displayValue }}</span>
</template>
</template>
<script setup lang="ts">
import { computed } from 'vue'
import type { ColumnSlotConfig } from '../config/template-config'
import { TAG_RESOLVERS, translate, formatTime, formatDate } from '../config/template-config'
import { getStatusTextClass } from '@/views/order/orderManagement/config/order-common-config'
defineOptions({ name: 'ColumnCellRenderer' })
const props = defineProps<{
/** 列插槽渲染配置 */
config: ColumnSlotConfig | undefined
/** 单元格值 */
value: any
}>()
/** 显示文本:translateField 翻译 > format 格式化 > 原始值 */
const displayValue = computed(() => {
const v = props.value
if (props.config?.translateField) {
return translate(props.config.translateField, v)
}
if (props.config?.format === 'datetime') {
return formatTime(v)
}
if (props.config?.format === 'date') {
return formatDate(v)
}
return v ?? '—'
})
const resolvedTagType = computed(() => {
if (!props.config || props.config.type !== 'tag') return ''
const { tagType, tagResolver } = props.config
// 优先使用 tagResolver(函数名映射)
if (tagResolver && TAG_RESOLVERS[tagResolver]) {
return TAG_RESOLVERS[tagResolver](props.value)
}
// 其次使用 tagType 映射表(用原始值查找)
if (tagType && typeof tagType === 'object') {
return tagType[String(props.value)] ?? 'info'
}
// 最后使用固定值
return (typeof tagType === 'string' ? tagType : 'info')
})
</script>
<style lang="scss" scoped>
/* ut-status-text 系列状态文字颜色类定义在 order-sub.scss 里(scoped 样式需要本组件自行引入) */
@use "../../../order/orderManagement/styles/order-sub.scss";
</style>

View File

@ -0,0 +1,189 @@
<!--
OperationCellRenderer — 表格操作列渲染组件
根据 operationButtons 配置渲染按钮列表。
支持的行为类型:
- actionType='action' → 触发 @operation-action 事件(可选配置 confirmMessage 弹确认框)
- actionType='form' → 打开 COMPONENT_REGISTRY 中注册的表单组件
显隐与禁用:
- visibleWhen(row) 返回 false 时不渲染该按钮(用于按 status 只显示可用动作)
- disabledOnField 对应行字段为空时置灰
使用方式:在 index.vue 中通过插槽 column-operation 引入:
<OperationCellRenderer
:buttons="currentTabConfig?.operationButtons"
:row="row"
@operation-action="handleOperationAction"
/>
-->
<template>
<div class="operation-cell">
<template v-for="btn in buttons" :key="btn.key">
<!-- action 按钮:支持确认弹窗 -->
<el-button
v-if="isVisible(btn) && btn.actionType === 'action'"
link
:type="btn.type || 'primary'"
size="small"
:loading="actionLoadingMap[btn.key]"
:disabled="isDisabled(btn)"
@click.stop="handleActionClick(btn)"
>
{{ btn.label }}
</el-button>
<!-- form 按钮:打开表单弹窗 -->
<template v-else-if="isVisible(btn) && btn.actionType === 'form'">
<el-button
link
:type="btn.type || 'primary'"
size="small"
:disabled="isDisabled(btn)"
@click.stop="openForm(btn)"
>
{{ btn.label }}
</el-button>
<!-- 表单弹窗 -->
<component
:is="resolvedFormComponents[btn.key]"
v-if="resolvedFormComponents[btn.key] && activeFormKey === btn.key"
v-model:visible="formVisibleMap[btn.key]"
v-bind="buildFormProps(btn)"
@success="handleFormSuccess(btn.key)"
/>
</template>
</template>
</div>
</template>
<script setup lang="ts">
import { ref, reactive, markRaw, type Component } from 'vue'
import { ElMessageBox } from 'element-plus'
import { COMPONENT_REGISTRY } from '../config/template-config'
import type { OperationButtonConfig } from '../config/template-config'
defineOptions({ name: 'OperationCellRenderer' })
const props = defineProps<{
/** 操作按钮配置列表(来自 TabPageConfig.operationButtons) */
buttons?: OperationButtonConfig[]
/** 当前行数据 */
row: Record<string, any>
}>()
const emit = defineEmits<{
/** action 按钮点击事件(key: 按钮标识, row: 行数据) */
(e: 'operation-action', key: string, row: Record<string, any>): void
}>()
// ===== form 弹窗管理 =====
const activeFormKey = ref('')
const formVisibleMap = reactive<Record<string, boolean>>({})
const resolvedFormComponents = ref<Record<string, Component>>({})
const actionLoadingMap = reactive<Record<string, boolean>>({})
// ============================================================
// action 按钮:支持确认弹窗
// ============================================================
async function handleActionClick(btn: OperationButtonConfig) {
if (btn.confirmMessage) {
try {
await ElMessageBox.confirm(
btn.confirmMessage,
btn.confirmTitle || '确认操作',
{
confirmButtonText: btn.confirmButtonText || '确定',
cancelButtonText: '取消',
type: (btn.confirmType || 'warning') as any
}
)
} catch {
return // 取消
}
}
actionLoadingMap[btn.key] = true
try {
emit('operation-action', btn.key, props.row)
} finally {
actionLoadingMap[btn.key] = false
}
}
// ============================================================
// form 按钮:打开表单弹窗
// ============================================================
function openForm(btn: OperationButtonConfig) {
if (!btn.formKey) return
const comp = COMPONENT_REGISTRY[btn.formKey]
if (!comp) {
console.warn(`[OperationCellRenderer] 未注册的表单组件: ${btn.formKey}`)
return
}
activeFormKey.value = btn.key
resolvedFormComponents.value[btn.key] = markRaw(comp)
formVisibleMap[btn.key] = true
}
function buildFormProps(btn: OperationButtonConfig): Record<string, any> {
const result: Record<string, any> = {}
// paramMap: { formProp: rowField } → 从行数据取值注入表单
if (btn.paramMap) {
for (const [formProp, rowField] of Object.entries(btn.paramMap)) {
result[formProp] = props.row[rowField]
}
}
// extraParams: 固定参数直接注入
if (btn.extraParams) {
Object.assign(result, btn.extraParams)
}
return result
}
function handleFormSuccess(key: string) {
emit('operation-action', key, props.row)
}
// ============================================================
// 按钮显隐 / 禁用判断
// ============================================================
/** 按行数据决定是否渲染(未配置 visibleWhen 则渲染) */
function isVisible(btn: OperationButtonConfig): boolean {
if (typeof btn.visibleWhen !== 'function') return true
try {
return btn.visibleWhen(props.row) !== false
} catch {
return true
}
}
function isDisabled(btn: OperationButtonConfig): boolean {
if (btn.disabledOnField) {
const val = props.row[btn.disabledOnField]
if (val === undefined || val === null || val === '' || val === false) {
return true
}
}
return false
}
</script>
<style lang="scss" scoped>
.operation-cell {
display: flex;
flex-wrap: wrap;
gap: 2px;
justify-content: center;
}
</style>

View File

@ -0,0 +1,132 @@
<template>
<div class="tab-area-wrapper">
<el-tabs
v-model="activeTab"
tab-position="top"
type="border-card"
class="tab-container"
@tab-click="handleTabClick"
>
<el-tab-pane
v-for="tab in tabs"
:key="tab.name"
:name="tab.name"
:lazy="false"
>
<template #label>
<span class="custom-tab-label">{{ tab.label }}</span>
</template>
</el-tab-pane>
</el-tabs>
</div>
</template>
<script setup lang="ts">
import { ref } from 'vue'
defineOptions({ name: 'TabArea' })
interface TabItem {
name: string
label: string
}
const props = withDefaults(
defineProps<{
tabs?: TabItem[]
defaultActive?: string
}>(),
{
tabs: () => [],
defaultActive: ''
}
)
const emit = defineEmits<{
(e: 'tab-change', tabName: string): void
}>()
const activeTab = ref(props.defaultActive || props.tabs[0]?.name || '')
const handleTabClick = (pane: any) => {
const name = pane?.name ?? pane?.props?.name ?? ''
if (name) {
activeTab.value = name
emit('tab-change', name)
}
}
</script>
<style lang="scss" scoped>
.tab-area-wrapper {
flex-shrink: 0;
}
.tab-container {
display: flex;
flex-direction: column;
:deep(.el-tabs__header) {
margin-bottom: 0;
flex-shrink: 0;
}
:deep(.el-tabs__header.is-top) {
padding: 4px 12px 0;
background: #f8fbff;
border-bottom: 1px solid #e8eef7;
margin: 0;
}
:deep(.el-tabs__nav-wrap::after) {
display: none;
}
:deep(.el-tabs__item.is-top) {
height: 38px;
line-height: 38px;
padding: 0 20px;
border-radius: 6px 6px 0 0;
color: #606266;
font-size: 14px;
font-weight: 500;
transition: all 0.3s cubic-bezier(0.645, 0.045, 0.355, 1);
border: 1px solid transparent;
border-bottom: none;
margin-right: 4px;
}
:deep(.el-tabs__item.is-top:hover) {
color: #409eff;
background-color: rgba(64, 158, 255, 0.05);
}
:deep(.el-tabs__item.is-top.is-active) {
color: #409eff;
font-weight: 600;
background: #ffffff;
border-color: #e8eef7;
border-bottom: 2px solid #ffffff;
margin-bottom: -1px;
position: relative;
z-index: 1;
}
:deep(.el-tabs__active-bar) {
height: 2px;
border-radius: 2px;
background-color: #409eff;
bottom: 0;
}
:deep(.el-tabs__content) {
display: none;
}
}
.custom-tab-label {
display: inline-flex;
align-items: center;
gap: 6px;
}
</style>

View File

@ -0,0 +1,595 @@
<!--
CheckItemsPanel — 盘点明细面板(库存盘点 stock.check)
职责:
1. 拉取 stock.check.detail,渲染盘点明细行(商品/批次/库位/账面/已盘合计/差异/状态)
2. 盘点作业:行内或批量上报(stock.check.report,**覆盖式**:同明细 + 同库位重复上报=更新记录)
—— 行上是「上报库位 + 本库位数量」输入,「已盘合计/库位/盘点人/最近上报」为后端按作业记录聚合的只读值
3. 完成盘点(stock.check.finish,允许部分未盘完成:未盘明细按实盘 0 计入盘亏)
4. 「添加商品」交给宿主 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')">
添加商品
</el-button>
<el-button
v-if="canReport"
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="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="pagedItems"
row-key="id"
border
stripe
size="small"
:height="tableHeight"
>
<el-table-column type="index" label="#" width="56" align="center" :index="indexMethod" />
<el-table-column prop="item_code" label="商品编码" min-width="130" show-overflow-tooltip />
<el-table-column prop="item_name" label="商品名称" min-width="160" show-overflow-tooltip />
<el-table-column prop="spec" label="规格" min-width="110" show-overflow-tooltip />
<el-table-column prop="batch_no" label="批次号" min-width="110" show-overflow-tooltip />
<el-table-column label="库位" min-width="130" show-overflow-tooltip>
<template #default="{ row }">
<el-input
v-if="canReport"
v-model="locationMap[row.id]"
size="small"
placeholder="库位编码(可留空=无库位)"
/>
<span v-else>{{ formatLocationCodes(row) }}</span>
</template>
</el-table-column>
<el-table-column label="账面数量" width="100" align="center">
<template #default="{ row }">{{ maskQuantity(row.system_quantity) }}</template>
</el-table-column>
<el-table-column label="本库位数量" width="130" align="center">
<template #default="{ row }">
<el-input-number
v-if="canReport"
v-model="quantityMap[row.id]"
size="small"
:min="0"
:step="1"
step-strictly
controls-position="right"
class="quantity-input"
/>
<span v-else class="hint-text">—</span>
</template>
</el-table-column>
<el-table-column label="已盘合计" width="100" align="center">
<template #default="{ row }">{{ row.checked_quantity ?? '—' }}</template>
</el-table-column>
<el-table-column 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 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 label="盘点人" width="110" show-overflow-tooltip>
<template #default="{ row }">{{ formatCheckers(row) }}</template>
</el-table-column>
<el-table-column label="最近上报" width="160">
<template #default="{ row }">{{ formatTime(row.last_checked_at) }}</template>
</el-table-column>
<el-table-column label="操作" width="80" align="center" fixed="right">
<template #default="{ row }">
<el-button
v-if="canReport"
link
type="primary"
size="small"
:loading="reportingId === row.id"
@click="reportRow(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="items.length > pageSize" class="pagination-container">
<el-pagination
v-model:current-page="page"
v-model:page-size="pageSize"
:page-sizes="[10, 20, 50, 100]"
:total="items.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, translate } from '../template-config'
import {
stockCheckDetail,
stockCheckFinish,
stockCheckReport
} 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) */
const canAddItems = computed(() => ['created', 'rejected'].includes(taskStatus.value))
/** approved/checking:可上报实盘、可完成 */
const canReport = computed(() => ['approved', 'checking'].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 → 库位编码) */
const locationMap = reactive<Record<string, string>>({})
const emptyText = computed(() =>
canAddItems.value ? '暂无盘点明细,可点击「添加商品」生成明细' : '暂无盘点明细'
)
/** 已填写实盘数量的行(可上报) */
const dirtyRows = computed(() =>
items.value.filter((item) => {
const qty = quantityMap[String(item.id)]
return qty !== undefined && qty !== null && Number.isFinite(Number(qty))
})
)
// ============================================================
// 表格高度 / 分页
// ============================================================
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 pagedItems = computed(() => {
const start = (page.value - 1) * pageSize.value
return items.value.slice(start, start + pageSize.value)
})
function indexMethod(index: number) {
return (page.value - 1) * pageSize.value + index + 1
}
function handlePageChange() {
nextTick(() => tableRef.value?.setScrollTop?.(0))
}
// ============================================================
// 加载明细
// ============================================================
async function loadItems() {
if (!taskId.value) {
items.value = []
return
}
loading.value = true
try {
const res: any = 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()
page.value = 1
} catch (e: any) {
console.error('[stockcheck] 加载盘点明细失败', e)
ElMessage.error(e?.message || '获取盘点明细失败')
items.value = []
} finally {
loading.value = false
}
}
/** 明细已盘库位编码(location_codes 优先,其次 locations 兜底;剔除「无库位」分组的空串/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)
: []
return [...new Set(
raw
.filter((code: unknown) => code !== null && code !== undefined && String(code).trim() !== '')
.map((code: any) => String(code))
)]
}
/** 是否存在「无库位」分组的记录(该分组库中存空串,接口返回归一为 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(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.report)
// ============================================================
/** 取该行待上报的数量;非法返回 null */
function resolveQuantity(item: Record<string, any>): number | null {
const raw = quantityMap[String(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(item: Record<string, any>, silent = false): Promise<boolean> {
const quantity = resolveQuantity(item)
if (quantity === null) {
if (!silent) ElMessage.warning('请输入不小于 0 的实盘数量')
return false
}
const key = String(item.id)
const location = String(locationMap[key] ?? '').trim()
reportingId.value = Number(item.id)
try {
const res: any = await stockCheckReport({
id: taskId.value,
detail_id: Number(item.id),
...(location ? { location } : {}),
quantity
})
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')
}
/** 批量上报:逐行串行提交,避免并发写同一盘点单 */
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 item of targets) {
const ok = await doReport(item, 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>

View File

@ -0,0 +1,327 @@
<!--
CheckRecordsPanel — 盘点作业记录面板(库存盘点 stock.check)
职责(使用本次新增的两个接口):
1. stock.check.recordList:按盘点任务拉取作业记录(服务端分页,记录 id 倒序)
—— rows 为 wms_stock_check_record 全字段 + 商品快照列(item_code/item_name)
2. stock.check.recordDelete:删除单条作业记录(**仅主表 approved/checking 允许**;
记录删光后该明细回到未盘口径;主表状态不回退)
说明:一个「明细 + 库位」一条记录;重复上报同库位是覆盖更新(不新增),
所以这里一条记录 = 某明细在某库位的一次实盘结果。
-->
<template>
<div class="check-records-panel">
<!-- 按钮行(间距 6px 对齐 toolbar) -->
<div class="header-actions">
<div class="left-actions">
<el-button size="small" type="primary" :loading="loading" @click="loadRecords">
刷新
</el-button>
</div>
<div class="right-actions">
<span v-if="!canDelete" class="hint-text">仅「待盘点 / 盘点中」可删除作业记录</span>
<span class="stat-text">
记录 {{ pagination.total }} 条 · 已盘 {{ stats.checked }} / 明细 {{ stats.total }}
</span>
</div>
</div>
<div ref="tableHostRef" class="table-host">
<el-table
ref="tableRef"
v-loading="loading"
:data="records"
row-key="id"
border
stripe
size="small"
:height="tableHeight"
>
<el-table-column prop="id" label="记录ID" width="90" align="center" />
<el-table-column prop="detail_id" label="明细ID" width="90" align="center" />
<el-table-column prop="item_code" label="商品编码" min-width="130" show-overflow-tooltip />
<el-table-column prop="item_name" label="商品名称" min-width="160" show-overflow-tooltip />
<el-table-column label="库位" min-width="120" show-overflow-tooltip>
<template #default="{ row }">
<!-- 「无库位」分组:库中存空串,recordList 返回时归一为 null,故按 falsy 判断 -->
<span v-if="row.location_code">{{ row.location_code }}</span>
<span v-else class="hint-text">无库位</span>
</template>
</el-table-column>
<el-table-column prop="quantity" label="数量" width="90" align="center" />
<el-table-column prop="checker_name" label="盘点人" width="110" show-overflow-tooltip />
<el-table-column label="上报时间" width="160">
<template #default="{ row }">{{ formatTime(row.checked_at) }}</template>
</el-table-column>
<el-table-column label="备注" min-width="140" show-overflow-tooltip>
<template #default="{ row }">
<span v-if="row.remark">{{ row.remark }}</span>
<span v-else class="hint-text">—</span>
</template>
</el-table-column>
<el-table-column label="操作" width="80" align="center" fixed="right">
<template #default="{ row }">
<el-button
v-if="canDelete"
link
type="danger"
size="small"
:loading="deletingId === row.id"
@click="handleDelete(row)"
>
删除
</el-button>
<span v-else class="hint-text">—</span>
</template>
</el-table-column>
<template #empty>
<div class="empty-tip">暂无盘点作业记录</div>
</template>
</el-table>
</div>
<div class="pagination-container">
<el-pagination
v-model:current-page="pagination.page"
v-model:page-size="pagination.pageSize"
:page-sizes="[10, 20, 50, 100, 200]"
:total="pagination.total"
layout="total, sizes, prev, pager, next, jumper"
background
size="small"
@current-change="handlePageChange"
@size-change="handlePageSizeChange"
/>
</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 { formatTime, isCheckApiSuccess } from '../template-config'
import {
stockCheckRecordDelete,
stockCheckRecordList
} from '@/api/stock.check/stock.check'
defineOptions({ name: 'CheckRecordsPanel' })
const props = defineProps<{
/** 当前选中的盘点单(列表行数据,含 id/status/checked_items/total_items) */
row: Record<string, any> | null
}>()
const emit = defineEmits<{
/** 记录被删除 → 宿主刷新列表与明细 */
(e: 'changed'): void
}>()
const taskId = computed(() => Number(props.row?.id) || 0)
const taskStatus = computed(() => String(props.row?.status ?? ''))
/** 文档:recordDelete 仅主表 approved/checking 允许 */
const canDelete = computed(() => ['approved', 'checking'].includes(taskStatus.value))
const records = ref<Record<string, any>[]>([])
const loading = ref(false)
const deletingId = ref<number | null>(null)
/** 头部分母/分子取自列表行(删除后由宿主刷新列表同步) */
const stats = reactive({ total: 0, checked: 0 })
const pagination = reactive({ page: 1, pageSize: 20, total: 0 })
const tableRef = ref<any>(null)
const tableHostRef = ref<HTMLElement | null>(null)
const tableHeight = ref(260)
useResizeObserver(tableHostRef, (entries) => {
const h = entries[0]?.contentRect.height ?? 0
if (h >= 120) tableHeight.value = Math.floor(h)
})
// ============================================================
// 拉取作业记录(stock.check.recordList)
// ============================================================
async function loadRecords() {
if (!taskId.value) {
records.value = []
pagination.total = 0
return
}
loading.value = true
try {
const res: any = await stockCheckRecordList({
id: taskId.value,
pagination: { page: pagination.page, pageSize: pagination.pageSize }
})
if (!isCheckApiSuccess(res)) {
throw new Error(res?.message || '获取作业记录失败')
}
const data = res.data ?? res
records.value = Array.isArray(data.rows) ? data.rows : []
const total = Number(data.total ?? records.value.length)
pagination.total = Number.isFinite(total) ? total : records.value.length
// 文档响应含 page/pageSize,> 0 才采纳,避免被回显 0 覆盖
if (Number(data.page) > 0) pagination.page = Number(data.page)
if (Number(data.pageSize) > 0) pagination.pageSize = Number(data.pageSize)
syncStats()
} catch (e: any) {
console.error('[stockcheck] 加载作业记录失败', e)
ElMessage.error(e?.message || '获取作业记录失败')
records.value = []
pagination.total = 0
} finally {
loading.value = false
}
}
/** 头部统计随列表重新拉取而更新 */
function syncStats() {
stats.total = Number(props.row?.total_items ?? 0) || 0
stats.checked = Number(props.row?.checked_items ?? 0) || 0
}
function handlePageChange() {
nextTick(() => tableRef.value?.setScrollTop?.(0))
void loadRecords()
}
function handlePageSizeChange() {
pagination.page = 1
nextTick(() => tableRef.value?.setScrollTop?.(0))
void loadRecords()
}
// ============================================================
// 删除作业记录(stock.check.recordDelete)
// ============================================================
async function handleDelete(record: Record<string, any>) {
const recordId = Number(record?.id)
if (!Number.isFinite(recordId) || recordId <= 0) return
const locationText = record?.location_code ? String(record.location_code) : '无库位'
try {
await ElMessageBox.confirm(
`确定删除该作业记录?\n库位:${locationText},数量:${record?.quantity ?? '—'}\n删除后该明细按剩余记录重新汇总,盘点单状态不变。`,
'删除作业记录',
{ confirmButtonText: '确定删除', cancelButtonText: '取消', type: 'warning' }
)
} catch {
return
}
deletingId.value = recordId
try {
const res: any = await stockCheckRecordDelete({ id: taskId.value, record_id: recordId })
if (!isCheckApiSuccess(res)) {
throw new Error(res?.message || '删除作业记录失败')
}
ElMessage.success('作业记录已删除')
// 删除当前页最后一条时回退页码,避免停留在空页
if (records.value.length === 1 && pagination.page > 1) pagination.page -= 1
await loadRecords()
emit('changed')
} catch (e: any) {
console.error('[stockcheck] 删除作业记录失败', e)
ElMessage.error(e?.message || '删除作业记录失败')
} finally {
deletingId.value = null
}
}
// ============================================================
// 联动:切换盘点单 / 主表状态变化时重新拉取
// ============================================================
watch(
() => [props.row?.id, props.row?.status],
() => {
pagination.page = 1
syncStats()
void loadRecords()
},
{ immediate: true }
)
</script>
<style lang="scss" scoped>
/* ut-status-text 系列状态文字颜色类定义在 order-sub.scss 里(scoped 样式需要本组件自行引入) */
@use "../../../../order/orderManagement/styles/order-sub.scss";
.check-records-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;
}
.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>

View File

@ -0,0 +1,193 @@
<!--
DetailPanel — 明细面板(通用)
根据 detailConfig 配置的 sections 渲染 el-descriptions 分区。
支持 text、tag、pre 三种渲染类型。
支持 translateField + tagResolver 集中式翻译。
支持 apiMethod 自动获取详情数据。
-->
<template>
<div class="detail-panel">
<div v-if="!row" class="empty-tip">请从上方列表中选择一项查看明细</div>
<template v-else>
<div v-for="(section, si) in detailConfig" :key="si" class="section">
<div class="section-title">{{ section.title }}</div>
<el-descriptions :column="section.columnCount" border size="small" class="detail-descriptions">
<el-descriptions-item
v-for="(field, fi) in section.fields"
:key="fi"
:label="field.label"
:span="field.span ?? 1"
>
<!-- 状态文字颜色(ut-status-text,替代 el-tag) -->
<template v-if="field.renderType === 'tag'">
<span :class="getStatusTextClass(resolveTagType(field, getRowData()?.[field.key]))">
{{ resolveDisplayValue(field, getRowData()?.[field.key]) }}
</span>
</template>
<!-- pre 渲染 -->
<template v-else-if="field.renderType === 'pre'">
<pre class="order-list-pre">{{ formatPre(getRowData()?.[field.key]) }}</pre>
</template>
<!-- 默认文本渲染 -->
<template v-else>
{{ resolveDisplayValue(field, getRowData()?.[field.key]) }}
</template>
</el-descriptions-item>
</el-descriptions>
</div>
</template>
</div>
</template>
<script setup lang="ts">
import { ref, watch } from 'vue'
import { FIELD_DICT, TAG_RESOLVERS, translate, formatTime, formatDate } from '../template-config'
import type { DetailSectionConfig, DetailFieldConfig } from '../template-config'
import { getStatusTextClass } from '@/views/order/orderManagement/config/order-common-config'
defineOptions({ name: 'DetailPanel' })
const props = defineProps<{
row: Record<string, any> | null
detailConfig: DetailSectionConfig[]
/** 可选的 detail API 方法,传入后自动调用获取完整明细数据 */
apiMethod?: (...args: any[]) => Promise<any>
}>()
/** 通过 API 获取的增强数据(与 row 合并) */
const enrichedData = ref<Record<string, any> | null>(null)
watch(() => props.row, async (newRow) => {
if (newRow && props.apiMethod) {
try {
const res = await props.apiMethod({
id: newRow.id,
code: newRow.code
})
if (res && (res.code === 1 || res.code === 200)) {
enrichedData.value = res.data ?? res
} else {
enrichedData.value = null
}
} catch {
enrichedData.value = null
}
} else {
enrichedData.value = null
}
}, { immediate: true })
/** 合并 row + API 增强数据 */
function getRowData(): Record<string, any> | null {
if (!props.row) return null
if (enrichedData.value) {
return { ...props.row, ...enrichedData.value }
}
return props.row
}
/** 解析显示值:format 格式化 > translateField 翻译 > 原始值 */
function resolveDisplayValue(field: DetailFieldConfig, value: any): string {
// 后端时间字段多为时间戳,需按配置格式化(created_at/start_time/end_time=datetime,check_date=date);
// 字段配置里没带 format 时回退读 FIELD_DICT,避免旧配置/自定义 detailConfig 导致时间戳直出
const format = field.format ?? FIELD_DICT[field.key]?.slot?.format
if (format === 'datetime') {
return formatTime(value)
}
if (format === 'date') {
return formatDate(value)
}
if (field.translateField) {
return translate(field.translateField, value)
}
return value ?? '—'
}
/** 格式化 pre 渲染值:数组/对象转 JSON 字符串 */
function formatPre(value: any): string {
if (value === undefined || value === null || value === '') return '—'
if (Array.isArray(value) && value.length === 0) return '—'
if (typeof value === 'object') {
try {
return JSON.stringify(value, null, 2)
} catch {
return String(value)
}
}
return String(value)
}
/** 解析 tag 颜色 */
function resolveTagType(field: DetailFieldConfig, value: any): string {
if (field.tagResolver) {
const resolver = TAG_RESOLVERS[field.tagResolver]
if (resolver) return resolver(value)
}
if (field.tagType) {
if (typeof field.tagType === 'object') {
return field.tagType[String(value)] ?? 'info'
}
return field.tagType
}
return 'info'
}
</script>
<style lang="scss" scoped>
/* ut-status-text 系列状态文字颜色类定义在 order-sub.scss 里(scoped 样式需要本组件自行引入) */
@use "../../../../order/orderManagement/styles/order-sub.scss";
/* 面板自带内边距 8px 0(左右由宿主 .detail-container 的 padding: 0 10px 提供),
合计内容缩进 10px,对齐 express/waybill 的 DetailPanel / stock/external_stock「基本信息」 */
.detail-panel {
flex: 1;
min-height: 0;
height: 100%;
padding: 8px 0;
box-sizing: border-box;
overflow: auto;
}
.empty-tip {
text-align: center;
font-size: 13px;
color: #909399;
padding: 40px 0;
}
.section {
margin-bottom: 12px;
&:last-child {
margin-bottom: 0;
}
.section-title {
font-size: 14px;
font-weight: 600;
color: #303133;
margin-bottom: 10px;
padding-left: 8px;
border-left: 3px solid #409eff;
line-height: 1.4;
}
}
.detail-descriptions {
:deep(.el-descriptions__label) {
width: 120px;
background: #fafbfc;
font-weight: 500;
}
}
.order-list-pre {
margin: 0;
font-family: inherit;
font-size: 13px;
line-height: 1.8;
white-space: pre-wrap;
color: #606266;
}
</style>

View File

@ -0,0 +1,273 @@
<!--
LogPanel — 操作日志面板(通用)
支持两种数据来源:
- apiMethod 传入 → 调用真实接口获取日志
- 无 apiMethod → 基于 row 生成模拟日志(开发调试用)
-->
<template>
<div class="log-panel">
<!-- 按钮行(间距 6px 对齐 toolbar),对齐 stock/external_stock 面板新样式 -->
<div class="header-actions">
<div class="left-actions">
<el-button
size="small"
type="primary"
:loading="apiLoading"
:disabled="!row || !apiMethod"
@click="loadLogs"
>
刷新
</el-button>
</div>
</div>
<div ref="tableHostRef" class="table-host">
<el-table
ref="tableRef"
:data="pagedLogs"
border
stripe
size="small"
:height="tableHeight"
v-loading="apiLoading"
class="log-table"
>
<el-table-column prop="time" label="时间" width="175" />
<el-table-column prop="operator" label="操作人" width="120" />
<el-table-column prop="action" label="操作类型" min-width="180" show-overflow-tooltip />
<el-table-column label="结果" width="90" align="center">
<template #default="{ row }">
<span :class="getStatusTextClass(resultTagType(row))">{{ row.result }}</span>
</template>
</el-table-column>
<el-table-column label="说明" min-width="220" show-overflow-tooltip>
<template #default="{ row }">{{ row.detail || '—' }}</template>
</el-table-column>
<template #empty>
<div class="empty-tip">暂无操作日志</div>
</template>
</el-table>
</div>
<div v-if="logs.length > pageSize" class="pagination-container">
<el-pagination
v-model:current-page="currentPage"
:page-size="pageSize"
:total="logs.length"
layout="total, prev, pager, next"
background
size="small"
/>
</div>
</div>
</template>
<script setup lang="ts">
import { computed, nextTick, ref, watch } from 'vue'
import { useResizeObserver } from '@vueuse/core'
import { getStatusTextClass } from '@/views/order/orderManagement/config/order-common-config'
defineOptions({ name: 'LogPanel' })
interface LogItem {
operator: string
action: string
result: string
detail?: string
time: string
level: 'success' | 'info' | 'warning' | 'error'
}
const props = defineProps<{
/** 当前选中行数据(用于生成关联日志) */
row: Record<string, any> | null
/** 可选的日志 API 方法,传入后自动调用获取真实日志 */
apiMethod?: (...args: any[]) => Promise<any>
}>()
/** 通过 API 获取的真实日志列表 */
const apiLogs = ref<LogItem[] | null>(null)
const apiLoading = ref(false)
/** 表格自适应高度:容器 ref + 测高(不要给 el-table 写 height="100%",EP parseHeight('100%') → NaN) */
const tableRef = ref<any>(null)
const tableHostRef = ref<HTMLElement | null>(null)
const tableHeight = ref(280)
useResizeObserver(tableHostRef, (entries) => {
const h = entries[0]?.contentRect.height ?? 0
if (h >= 100) {
tableHeight.value = Math.floor(h)
}
})
/** 切页后把表格滚动位置归零 */
function resetTableScroll() {
nextTick(() => {
tableRef.value?.setScrollTop?.(0)
})
}
/** 表格本地分页(对齐 storage/receiving「操作日志」体验) */
const currentPage = ref(1)
const pageSize = 10
const pagedLogs = computed<LogItem[]>(() => {
const start = (currentPage.value - 1) * pageSize
return logs.value.slice(start, start + pageSize)
})
watch(currentPage, resetTableScroll)
function resultTagType(row: LogItem): string {
if (row.result === '成功') return 'success'
if (row.result === '失败') return 'danger'
return 'info'
}
watch(() => props.row, () => {
void loadLogs()
}, { immediate: true })
/** 拉取日志(按钮「刷新」也走这个函数) */
async function loadLogs() {
const newRow = props.row
currentPage.value = 1
if (newRow && props.apiMethod) {
apiLoading.value = true
try {
const res = await props.apiMethod({
id: newRow.id,
code: newRow.code,
page: 1,
pageSize: 100
})
if (res && (res.code === 1 || res.code === 200)) {
const list = res.data?.list ?? res.data?.logs ?? res.list ?? res.logs ?? []
apiLogs.value = Array.isArray(list) ? list.map((item: any) => ({
operator: item.operator ?? item.creator ?? '—',
action: item.action ?? item.operation ?? '—',
result: item.result ?? item.status ?? '—',
detail: item.detail ?? item.description ?? '',
time: item.time ?? item.create_time ?? '—',
level: (item.result === '成功' || item.status === 'success') ? 'success'
: (item.result === '失败' || item.status === 'error') ? 'error'
: 'info'
})) : []
} else {
apiLogs.value = []
}
} catch {
apiLogs.value = []
} finally {
apiLoading.value = false
}
} else {
apiLogs.value = null
}
}
/** 基于 row 生成模拟日志(无 apiMethod 时使用) */
const mockLogs = computed<LogItem[]>(() => {
if (!props.row) return []
const rowName = props.row.name ?? props.row.code ?? '—'
const now = new Date()
const pad = (n: number) => String(n).padStart(2, '0')
const fmt = (d: Date) =>
`${d.getFullYear()}-${pad(d.getMonth() + 1)}-${pad(d.getDate())} ${pad(d.getHours())}:${pad(d.getMinutes())}:${pad(d.getSeconds())}`
return [
{
operator: '系统',
action: `创建了「${rowName}」`,
result: '成功',
time: fmt(new Date(now.getTime() - 3600000 * 3)),
level: 'success'
},
{
operator: props.row.creator ?? '管理员',
action: `更新了「${rowName}」`,
result: '成功',
detail: `修改了状态和相关配置`,
time: fmt(new Date(now.getTime() - 3600000)),
level: 'success'
}
]
})
/** 最终展示的日志:优先使用 API 日志,否则使用 mock 日志 */
const logs = computed<LogItem[]>(() => {
if (apiLogs.value !== null) {
return apiLogs.value
}
return mockLogs.value
})
/** 数据变化后页码超出范围时回退到最后一页(必须放在 logs 声明之后,否则 setup 阶段 TDZ 报错) */
watch(logs, (list) => {
const maxPage = Math.max(1, Math.ceil(list.length / pageSize))
if (currentPage.value > maxPage) currentPage.value = maxPage
})
</script>
<style lang="scss" scoped>
/* ut-status-text 系列状态文字颜色类定义在 order-sub.scss 里(scoped 样式需要本组件自行引入) */
@use "../../../../order/orderManagement/styles/order-sub.scss";
/* 日志面板:按钮行 + 自适应高度表格 + 右对齐分页(对齐 stock/external_stock 面板列表新样式) */
.log-panel {
flex: 1;
min-height: 0;
width: 100%;
height: 100%;
padding: 8px 0;
box-sizing: border-box;
display: flex;
flex-direction: column;
overflow: hidden;
}
.header-actions {
display: flex;
justify-content: space-between;
align-items: center;
margin-bottom: 6px;
flex-shrink: 0;
gap: 4px;
flex-wrap: wrap;
}
.left-actions {
display: flex;
align-items: center;
gap: 6px;
/* 清除 Element Plus 默认按钮左边距,统一由 gap 控制间距 */
:deep(.el-button) {
margin-left: 0;
margin-right: 0;
}
}
.table-host {
flex: 1;
min-height: 120px;
min-width: 0;
overflow: hidden;
}
.pagination-container {
flex-shrink: 0;
display: flex;
justify-content: flex-end;
align-items: center;
margin-top: 6px;
}
.empty-tip {
color: #909399;
font-size: 13px;
}
</style>

File diff suppressed because it is too large Load Diff

View File

@ -0,0 +1,912 @@
<!--
库存盘点(storage/stockcheck)— 配置驱动页面(views/mode 模板 v2)
接口:库存盘点模块 stock.check(详见 src/api/stock.check/stock.check.ts)
- 列表/详情/新建/加明细/上报/提交/审核/完成/取消/导出+导出进度(11 个接口全部接入)
页面结构:
┌──────────┬──────────────────────────────────────────────┐
│ 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"
@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">
<component
:is="activeDetailTabComponent"
:row="selectedDetail"
:detail-config="currentDetailConfig"
:api-method="currentDetailTabApiMethod"
@add-items="handlePanelAddItems"
@changed="handlePanelChanged"
/>
</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 ?? false"
: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" />
<CheckStockPickerDialog
v-model:visible="pickerVisible"
:task-id="pickerTaskId"
:task-title="pickerTaskLabel"
@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"
:update-time="exportTaskProgress.updateTime"
/>
</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.vue'
import ColumnCellRenderer from './components/ColumnCellRenderer.vue'
import OperationCellRenderer from './components/OperationCellRenderer.vue'
import OrderToolbarButtonGroup from '@/views/order/orderManagement/component/OrderToolbarButtonGroup.vue'
import type { ToolbarButtonConfig as OrderToolbarButtonConfig } from '@/views/order/orderManagement/config/order-common-config'
import {
PAGE_CONFIG,
tabPages,
resolveTabConfig,
getTabToolbarButtons,
isCheckApiSuccess,
loadStoreOptions,
type TabPageConfig,
type DetailTabConfig,
type ToolbarButtonConfig,
} from './config/template-config'
import CheckFormDialog from './pages/CheckFormDialog.vue'
import CheckStockPickerDialog from './pages/CheckStockPickerDialog.vue'
import {
stockCheckAudit,
stockCheckCancel,
stockCheckExport,
stockCheckExportTaskProgress,
stockCheckFinish,
stockCheckSubmit
} from '@/api/stock.check/stock.check'
// ============================================================
// 容器高度
// ============================================================
const settingsStore = useSettingsStore()
const shortcutExpanded = computed(() => settingsStore.shortcutExpanded)
const containerHeight = computed(() =>
shortcutExpanded.value ? 'calc(100vh - 150px)' : 'calc(100vh - 100px)'
)
// ============================================================
// 标签页
// ============================================================
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
}))
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 },
handleExport: () => { void doExport() }
}
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':
await runCheckAction(() => stockCheckAudit({ id, action: 'approve' }), '审核已通过')
break
case 'auditReject':
await handleAuditReject(row)
break
case 'finishCheck':
await runCheckAction(() => stockCheckFinish({ id }), '盘点已完成')
break
case 'cancelCheck':
await runCheckAction(() => stockCheckCancel({ id }), '盘点单已取消')
break
case 'exportCheck':
await doExport([id])
break
default:
console.warn('[stockcheck] 未处理的操作按钮:', key)
}
}
/** 审核驳回:弹输入框收驳回原因(文档:reason 可选,缺省保留原备注) */
async function handleAuditReject(row: Record<string, any>) {
const id = Number(row?.id)
let reason = ''
try {
const res = await ElMessageBox.prompt(
'驳回原因将写入盘点单备注(可留空,留空则保留原备注)',
`驳回盘点单 ${row?.check_no ?? ''}`,
{
confirmButtonText: '确定驳回',
cancelButtonText: '取消',
inputType: 'textarea',
inputPlaceholder: '可留空',
type: 'warning'
}
)
reason = String(res.value ?? '').trim()
} catch {
return // 用户取消
}
await runCheckAction(
() => stockCheckAudit({ id, action: 'reject', ...(reason ? { reason } : {}) }),
'已驳回'
)
}
/** 统一执行状态类操作:校验结果 → 提示 → 刷新列表并同步详情 */
async function runCheckAction(action: () => Promise<any>, successText: string) {
try {
const res: any = await action()
if (!isCheckApiSuccess(res)) {
throw new Error(res?.message || '操作失败')
}
ElMessage.success(successText)
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)
})
/**
* 提交导出任务
* @param ids 指定盘点单ID(操作列单行导出);不传则用表格勾选行
*/
async function doExport(ids?: number[]) {
let targetIds: number[] = Array.isArray(ids)
? ids.map(Number).filter((n) => Number.isFinite(n) && n > 0)
: []
if (!targetIds.length) {
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 })
}
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: 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 pickerVisible = ref(false)
const pickerTask = ref<Record<string, any> | null>(null)
const pickerTaskId = computed(() => Number(pickerTask.value?.id) || 0)
const pickerTaskLabel = computed(() => {
const task = pickerTask.value
if (!task) return ''
return [task.check_no, task.title].filter(Boolean).join(' ')
})
/** 打开「添加盘点商品」(仅 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 }) {
await reloadAndResyncDetail()
if (!task?.id) return
try {
await ElMessageBox.confirm(
`盘点单 ${task.check_no || task.id} 已创建(空盘点单),是否立即添加盘点商品?`,
'添加盘点商品',
{ confirmButtonText: '立即添加', cancelButtonText: '稍后再说', type: 'info' }
)
} catch {
return
}
openStockPicker({ id: task.id, check_no: task.check_no, title: task.title })
}
/** 添加明细成功:刷新列表(total_items 已变化) */
async function handleItemsAdded() {
await reloadAndResyncDetail()
}
// ============================================================
// 初始化
// ============================================================
onMounted(() => {
loadData()
// 货主下拉(ScanBox 筛选 / 新建盘点表单共用)
void loadStoreOptions()
// 恢复未完成的导出任务(刷新页面后可继续查看进度)
resumeExportTaskFromStorage()
})
</script>
<style lang="scss" scoped>
/* 布局样式对齐 order/orderManagement(order-sub.scss) */
@use "../../order/orderManagement/styles/order-sub.scss";
/* 详情区外壳与 stock/external_stock 一致:不留上/下间距,左右 10px,
由各详情面板自身 padding 控制上下留白 */
.order-sub-container .main-content .lower-level .detail-container {
padding: 0 10px;
}
/* ================================================================
整体布局
================================================================ */
.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;
}
/* 分栏区域:布局样式由 order/orderManagement/styles/order-sub.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;
}
</style>

View File

@ -0,0 +1,234 @@
<!--
CheckFormDialog — 新建盘点单(stock.check.create)
字段说明(接口文档):
- title 盘点名称,非必填
- type 盘点范围:all 全盘(缺省)/ store 按货主 / goods 按商品 / location 按库位
- mode 盘点方式:open 明盘(缺省,可见账面数量)/ blind 盲盘
- store_id 货主ID(type=store 时必填)
- check_date 盘点日期(必填,须可被 Date 解析)
- remark 备注
warehouse_id 由服务端注入,前端不传。
-->
<template>
<el-dialog
:model-value="visible"
title="新建盘点单"
width="min(560px, 94vw)"
align-center
destroy-on-close
:close-on-click-modal="false"
@update:model-value="handleVisibleChange"
@closed="handleClosed"
>
<el-form
ref="formRef"
:model="form"
:rules="rules"
label-width="90px"
size="small"
>
<el-form-item label="盘点名称" prop="title">
<el-input v-model="form.title" maxlength="50" show-word-limit placeholder="如:9月底全盘(可留空)" />
</el-form-item>
<el-form-item label="盘点范围" prop="type">
<el-radio-group v-model="form.type">
<el-radio value="all">全盘</el-radio>
<el-radio value="store">按货主</el-radio>
<el-radio value="goods">按商品</el-radio>
<el-radio value="location">按库位</el-radio>
</el-radio-group>
</el-form-item>
<el-form-item v-if="form.type === 'store'" label="货主" prop="store_id">
<el-select
v-model="form.store_id"
placeholder="请选择货主"
filterable
clearable
style="width: 100%"
>
<el-option
v-for="opt in storeOptions"
:key="opt.value"
:label="opt.label"
:value="opt.value"
/>
</el-select>
</el-form-item>
<el-form-item label="盘点方式" prop="mode">
<el-radio-group v-model="form.mode">
<el-radio value="open">明盘</el-radio>
<el-radio value="blind">盲盘</el-radio>
</el-radio-group>
<span v-if="form.mode === 'blind'" class="form-tip">盲盘:盘点作业时前端不显示账面数量</span>
</el-form-item>
<el-form-item label="盘点日期" prop="check_date">
<el-date-picker
v-model="form.check_date"
type="date"
value-format="YYYY-MM-DD"
placeholder="请选择盘点日期"
style="width: 100%"
/>
</el-form-item>
<el-form-item label="备注" prop="remark">
<el-input v-model="form.remark" type="textarea" :rows="3" maxlength="200" show-word-limit placeholder="可留空" />
</el-form-item>
<el-alert
type="info"
:closable="false"
show-icon
title="创建后为「空盘点单」,需再添加盘点商品并提交审核。"
/>
</el-form>
<template #footer>
<el-button size="small" @click="handleVisibleChange(false)">取消</el-button>
<el-button size="small" type="primary" :loading="submitting" @click="handleSubmit">
确认创建
</el-button>
</template>
</el-dialog>
</template>
<script setup lang="ts">
import { reactive, ref, watch } from 'vue'
import { ElMessage } from 'element-plus'
import type { FormInstance, FormRules } from 'element-plus'
import { isCheckApiSuccess, loadStoreOptions, storeOptions } from '../config/template-config'
import {
stockCheckCreate,
type StockCheckMode,
type StockCheckType
} from '@/api/stock.check/stock.check'
defineOptions({ name: 'CheckFormDialog' })
const props = defineProps<{ visible: boolean }>()
const emit = defineEmits<{
(e: 'update:visible', value: boolean): void
/** 创建成功(携创建出的盘点单关键信息) */
(e: 'success', task: { id: number; check_no: string; title: string }): void
}>()
const formRef = ref<FormInstance>()
const submitting = ref(false)
function todayString() {
const d = new Date()
const pad = (n: number) => String(n).padStart(2, '0')
return `${d.getFullYear()}-${pad(d.getMonth() + 1)}-${pad(d.getDate())}`
}
const form = reactive<{
title: string
type: StockCheckType
store_id: number | undefined
mode: StockCheckMode
check_date: string
remark: string
}>({
title: '',
type: 'all',
store_id: undefined,
mode: 'open',
check_date: todayString(),
remark: ''
})
const rules: FormRules = {
check_date: [{ required: true, message: '请选择盘点日期', trigger: 'change' }],
store_id: [
{
validator: (_rule, value, callback) => {
if (form.type === 'store' && !value) callback(new Error('按货主盘点时必须选择货主'))
else callback()
},
trigger: 'change'
}
]
}
function handleVisibleChange(value: boolean) {
emit('update:visible', value)
}
function handleClosed() {
formRef.value?.clearValidate()
submitting.value = false
}
function resetForm() {
form.title = ''
form.type = 'all'
form.store_id = undefined
form.mode = 'open'
form.check_date = todayString()
form.remark = ''
}
watch(
() => props.visible,
(visible) => {
if (!visible) return
resetForm()
formRef.value?.clearValidate()
// 货主下拉(按货主盘点 / 后续筛选共用)
void loadStoreOptions()
}
)
async function handleSubmit() {
if (!formRef.value) return
try {
await formRef.value.validate()
} catch {
return
}
submitting.value = true
try {
const res: any = await stockCheckCreate({
title: form.title.trim() || undefined,
type: form.type,
mode: form.mode,
store_id: form.type === 'store' ? form.store_id : undefined,
check_date: form.check_date,
remark: form.remark.trim() || undefined
})
if (!isCheckApiSuccess(res)) {
throw new Error(res?.message || '创建盘点单失败')
}
const payload: any =
res.data && (res.data.id || res.data.check_no) ? res.data : res
const task = {
id: Number(payload.id) || 0,
check_no: String(payload.check_no ?? ''),
title: String(payload.title ?? form.title ?? '')
}
ElMessage.success(task.check_no ? `盘点单 ${task.check_no} 创建成功` : '盘点单创建成功')
emit('update:visible', false)
emit('success', task)
} catch (e: any) {
console.error('[stockcheck] 创建盘点单失败', e)
ElMessage.error(e?.message || '创建盘点单失败')
} finally {
submitting.value = false
}
}
</script>
<style lang="scss" scoped>
.form-tip {
margin-left: 10px;
font-size: 12px;
color: #e6a23c;
}
</style>

View File

@ -0,0 +1,383 @@
<!--
CheckStockPickerDialog — 添加盘点商品(stock.check.addDetail)
数据来源:storage.inventory.list(库存明细,汇总模式 group_by_batch=false)
行上带 stock_id(= wms_stock_warehouse.id),即 addDetail 需要的 stock_ids。
同一商品在不同库位会有多行,提交前按 stock_id 去重(后端对已存在明细幂等跳过)。
仅 created(新建)/ rejected(驳回)状态可添加,后端会校验。
-->
<template>
<el-dialog
:model-value="visible"
:title="dialogTitle"
width="min(1080px, 95vw)"
align-center
:close-on-click-modal="false"
@update:model-value="handleVisibleChange"
@closed="handleClosed"
>
<div class="picker-body">
<!-- 筛选行 -->
<div class="picker-filters">
<el-input
v-model="filters.keyword"
size="small"
clearable
placeholder="商品编码 / 名称 / 条码"
class="filter-item filter-item--keyword"
@keyup.enter="handleSearch"
/>
<el-input
v-model="filters.batch_no"
size="small"
clearable
placeholder="批次号"
class="filter-item"
@keyup.enter="handleSearch"
/>
<el-button size="small" type="primary" :loading="loading" @click="handleSearch">
查询
</el-button>
<el-button size="small" @click="handleResetFilters">重置</el-button>
</div>
<!-- 库存列表 -->
<div ref="tableHostRef" class="table-host">
<el-table
ref="tableRef"
v-loading="loading"
:data="rows"
:row-key="(row: any) => row._key"
border
stripe
size="small"
:height="tableHeight"
@selection-change="handleSelectionChange"
>
<el-table-column type="selection" width="45" :reserve-selection="true" />
<el-table-column prop="item_code" label="商品编码" min-width="130" show-overflow-tooltip />
<el-table-column prop="item_name" label="商品名称" min-width="160" show-overflow-tooltip />
<el-table-column prop="spec" label="规格" min-width="110" show-overflow-tooltip />
<el-table-column prop="store_name" label="货主" min-width="110" show-overflow-tooltip />
<el-table-column prop="space_code" label="库位" min-width="120" show-overflow-tooltip />
<el-table-column prop="batch_no" label="批次号" min-width="110" show-overflow-tooltip />
<el-table-column prop="quantity" label="库存数量" width="100" align="center" />
<el-table-column prop="available_quantity" label="可用数量" width="100" align="center" />
<template #empty>
<div class="empty-tip">暂无库存数据</div>
</template>
</el-table>
</div>
<!-- 分页 -->
<div class="pagination-container">
<el-pagination
v-model:current-page="pagination.page"
v-model:page-size="pagination.pageSize"
:page-sizes="[10, 20, 50, 100]"
:total="pagination.total"
layout="total, sizes, prev, pager, next"
background
size="small"
@current-change="loadRows"
@size-change="handleSizeChange"
/>
</div>
</div>
<template #footer>
<div class="dialog-footer">
<span class="selected-tip">
已选 {{ selectedRows.length }} 行 · 去重后 {{ selectedStockIds.length }} 个商品
</span>
<div class="footer-buttons">
<el-button size="small" @click="handleVisibleChange(false)">取消</el-button>
<el-button
size="small"
type="primary"
:loading="submitting"
:disabled="!selectedStockIds.length"
@click="handleSubmit"
>
确认添加
</el-button>
</div>
</div>
</template>
</el-dialog>
</template>
<script setup lang="ts">
import { computed, nextTick, reactive, ref, watch } from 'vue'
import { ElMessage } from 'element-plus'
import { useResizeObserver } from '@vueuse/core'
import { getInventoryList } from '@/api/storage.inventory/inventory'
import { stockCheckAddDetail } from '@/api/stock.check/stock.check'
import { isCheckApiSuccess } from '../config/template-config'
defineOptions({ name: 'CheckStockPickerDialog' })
const props = defineProps<{
visible: boolean
/** 目标盘点单ID */
taskId?: number
/** 目标盘点单号(展示用) */
taskTitle?: string
}>()
const emit = defineEmits<{
(e: 'update:visible', value: boolean): void
/** 添加成功 */
(e: 'success', result: { added: number; skipped: number }): void
}>()
const dialogTitle = computed(() =>
props.taskTitle ? `添加盘点商品 — ${props.taskTitle}` : '添加盘点商品'
)
const filters = reactive({ keyword: '', batch_no: '' })
const rows = ref<Record<string, any>[]>([])
const loading = ref(false)
const submitting = ref(false)
const selectedRows = ref<Record<string, any>[]>([])
const pagination = reactive({ page: 1, pageSize: 20, total: 0 })
const tableRef = ref<any>(null)
const tableHostRef = ref<HTMLElement | null>(null)
const tableHeight = ref(360)
useResizeObserver(tableHostRef, (entries) => {
const h = entries[0]?.contentRect.height ?? 0
if (h >= 120) tableHeight.value = Math.floor(h)
})
/** 提交前按 stock_id 去重 */
const selectedStockIds = computed(() => {
const ids = selectedRows.value
.map((row) => Number(row.stock_id))
.filter((id) => Number.isFinite(id) && id > 0)
return [...new Set(ids)]
})
function handleVisibleChange(value: boolean) {
emit('update:visible', value)
}
function handleClosed() {
tableRef.value?.clearSelection?.()
selectedRows.value = []
rows.value = []
submitting.value = false
}
/** 对象/数组属性统一转文本 */
function toText(value: any): string {
if (value === undefined || value === null || value === '') return ''
if (typeof value === 'string') return value
if (Array.isArray(value)) return value.map((v) => toText(v)).filter(Boolean).join('/')
if (typeof value === 'object') {
const picked = value.name ?? value.value ?? value.label ?? value.sku_property
return picked ? toText(picked) : ''
}
return String(value)
}
function mapRow(item: any, index: number): Record<string, any> {
const stockId = Number(item?.stock_id)
const spaceId = item?.space_id ?? item?.space?.id ?? ''
const batchNo = toText(item?.batch_no)
return {
_key: `${stockId}-${spaceId}-${batchNo}-${index}`,
stock_id: stockId,
item_code: toText(item?.stock?.item_code),
item_name: toText(item?.stock?.item_name),
spec: toText(item?.stock?.sku_property),
store_name: toText(item?.store_name ?? item?.stock?.store_name),
space_code: toText(item?.space?.space_code),
batch_no: batchNo,
quantity: item?.quantity ?? '—',
available_quantity: item?.available_quantity ?? '—'
}
}
async function loadRows() {
loading.value = true
try {
const keyword = filters.keyword.trim()
const batchNo = filters.batch_no.trim()
const res: any = await getInventoryList({
where: {
// stock_query 为虚拟筛选字段:按商品编码/名称/条码/SKU ID 模糊匹配
...(keyword ? { stock_query: { operator: 'like', value: keyword } } : {}),
...(batchNo ? { batch_no: batchNo } : {})
},
pagination: { page: pagination.page, pageSize: pagination.pageSize },
group_by_batch: false
})
if (!isCheckApiSuccess(res)) {
throw new Error(res?.message || '查询库存失败')
}
const data = res.data ?? res
const rawList: any[] = Array.isArray(data.list) ? data.list : []
rows.value = rawList
.map((item, index) => mapRow(item, index))
.filter((row) => Number.isFinite(row.stock_id) && row.stock_id > 0)
pagination.total = Number(data.total ?? data.pagination?.total ?? rows.value.length) || 0
nextTick(() => tableRef.value?.setScrollTop?.(0))
} catch (e: any) {
console.error('[stockcheck] 查询库存失败', e)
ElMessage.error(e?.message || '查询库存失败')
rows.value = []
pagination.total = 0
} finally {
loading.value = false
}
}
function handleSearch() {
pagination.page = 1
loadRows()
}
function handleResetFilters() {
filters.keyword = ''
filters.batch_no = ''
pagination.page = 1
loadRows()
}
function handleSizeChange() {
pagination.page = 1
loadRows()
}
function handleSelectionChange(selection: Record<string, any>[]) {
selectedRows.value = selection
}
async function handleSubmit() {
const taskId = Number(props.taskId)
const stockIds = selectedStockIds.value
if (!Number.isFinite(taskId) || taskId <= 0) {
ElMessage.error('缺少盘点单ID,无法添加明细')
return
}
if (!stockIds.length) {
ElMessage.warning('请先勾选要盘点的商品')
return
}
submitting.value = true
try {
const res: any = await stockCheckAddDetail({ id: taskId, stock_ids: stockIds })
if (!isCheckApiSuccess(res)) {
throw new Error(res?.message || '添加盘点明细失败')
}
const data = res.data ?? res
const added = Number(data.added ?? 0)
const skipped = Number(data.skipped ?? 0)
const invalid: number[] = Array.isArray(data.invalid_stock_ids) ? data.invalid_stock_ids : []
const parts = [`新增 ${added} 行`]
if (skipped) parts.push(`跳过已存在 ${skipped} 行`)
if (invalid.length) parts.push(`无效商品 ${invalid.length} 个`)
if (invalid.length) ElMessage.warning(parts.join(','))
else ElMessage.success(parts.join(','))
emit('update:visible', false)
emit('success', { added, skipped })
} catch (e: any) {
console.error('[stockcheck] 添加盘点明细失败', e)
ElMessage.error(e?.message || '添加盘点明细失败')
} finally {
submitting.value = false
}
}
watch(
() => props.visible,
(visible) => {
if (!visible) return
filters.keyword = ''
filters.batch_no = ''
pagination.page = 1
pagination.total = 0
selectedRows.value = []
rows.value = []
nextTick(() => tableRef.value?.clearSelection?.())
void loadRows()
}
)
</script>
<style lang="scss" scoped>
.picker-body {
display: flex;
flex-direction: column;
gap: 8px;
}
/* 筛选行:不要套卡片,仅做对齐 + 单行 */
.picker-filters {
display: flex;
flex-wrap: wrap;
align-items: center;
gap: 8px;
flex-shrink: 0;
.filter-item {
width: 200px;
}
.filter-item--keyword {
width: 260px;
}
}
.table-host {
flex: 1;
min-height: 200px;
min-width: 0;
overflow: hidden;
}
.empty-tip {
font-size: 13px;
color: #909399;
}
/* 分页器:右对齐 + 「每页条数」下拉与 UpperTable 同宽 80px */
.pagination-container {
flex-shrink: 0;
display: flex;
justify-content: flex-end;
align-items: center;
:deep(.el-select--small) {
width: 80px;
}
:deep(.el-input__wrapper) {
padding: 0 4px;
}
}
.dialog-footer {
display: flex;
align-items: center;
justify-content: space-between;
gap: 12px;
.selected-tip {
font-size: 12px;
color: #909399;
}
.footer-buttons {
display: flex;
align-items: center;
gap: 8px;
}
}
</style>

View File

@ -0,0 +1,107 @@
<!--
ExampleFormDialog — 示例表单弹窗(模板)
功能按钮对应的表单组件放在 pages/ 目录下。
使用方式:
1. 在 template-config.ts 的 COMPONENT_REGISTRY 中注册
2. 在 template-config.ts 的 TOOLBAR_BUTTONS 中添加功能按钮,设置 formKey
3. index.vue 中通过工具栏按钮触发打开
-->
<template>
<el-dialog
:model-value="visible"
title="示例操作"
width="500px"
align-center
destroy-on-close
:close-on-click-modal="false"
@closed="handleClosed"
>
<div class="form-body">
<el-form ref="formRef" :model="form" label-width="100px" size="small">
<el-form-item label="名称" prop="name">
<el-input v-model="form.name" placeholder="请输入名称" />
</el-form-item>
<el-form-item label="描述" prop="description">
<el-input
v-model="form.description"
type="textarea"
:rows="3"
placeholder="请输入描述"
/>
</el-form-item>
</el-form>
</div>
<template #footer>
<el-button size="small" @click="handleClosed">取消</el-button>
<el-button size="small" type="primary" :loading="submitting" @click="handleSubmit">
确认
</el-button>
</template>
</el-dialog>
</template>
<script setup lang="ts">
import { reactive, ref, watch } from 'vue'
import { ElMessage } from 'element-plus'
defineOptions({ name: 'ExampleFormDialog' })
const props = defineProps<{
visible: boolean
/** 从行数据注入的初始值(由 OperationCellRenderer 的 paramMap 传递) */
id?: string | number
code?: string
name?: string
}>()
const emit = defineEmits<{
(e: 'update:visible', v: boolean): void
(e: 'success'): void
}>()
const formRef = ref<any>(null)
const submitting = ref(false)
const form = reactive({
name: '',
description: ''
})
// 重置表单
watch(() => props.visible, (v) => {
if (v) {
form.name = props.name ?? ''
form.description = ''
}
})
function handleClosed() {
emit('update:visible', false)
}
async function handleSubmit() {
submitting.value = true
try {
// ★ 替换为真实 API 调用
// const res = await yourApi.submit({ id: props.id, ...form })
await new Promise((r) => setTimeout(r, 500))
ElMessage.success('操作成功')
emit('update:visible', false)
emit('success')
} catch (e: any) {
ElMessage.error(e?.message || '操作失败')
} finally {
submitting.value = false
}
}
</script>
<style lang="scss" scoped>
.form-body {
padding: 12px 0;
}
</style>