From 72127ac45eae94e399377076addc9ace2f5ea014 Mon Sep 17 00:00:00 2001 From: yin <3313488199@qq.com> Date: Fri, 2 Oct 2026 18:03:43 +0800 Subject: [PATCH] 1 --- src/api/stock.check/stock.check.ts | 792 ++++++++++++++++-- .../components/OperationCellRenderer.vue | 17 +- .../config/components/CheckItemsPanel.vue | 293 ++++++- .../config/components/CheckRecordsPanel.vue | 619 ++++++++++++-- .../config/components/CheckReportDialog.vue | 245 ++++++ .../config/components/RecordImages.vue | 110 +++ .../stockcheck/config/template-config.ts | 20 +- .../pages/CheckStockPickerDialog.vue | 459 ++++++++-- 8 files changed, 2269 insertions(+), 286 deletions(-) create mode 100644 src/views/storage/stockcheck/config/components/CheckReportDialog.vue create mode 100644 src/views/storage/stockcheck/config/components/RecordImages.vue diff --git a/src/api/stock.check/stock.check.ts b/src/api/stock.check/stock.check.ts index 84edc1df..7affcdd2 100644 --- a/src/api/stock.check/stock.check.ts +++ b/src/api/stock.check/stock.check.ts @@ -2,9 +2,35 @@ import request from '@/utils/request' const v = '1.0' +/** + * stock.check 模块的**统一响应封装**(2026-10-02 起后端全部 20 个接口统一为该结构) + * + * ⚠️ 业务数据**整体位于 `data` 内**(内部字段口径与改造前完全一致);失败时 `data = null`。 + * 调用侧取业务数据的写法:`const data = res.data ?? res`(`?? res` 仅为兼容旧扁平响应)。 + * + * 成功判定:`code === 1`(`utils/request.ts` 的 SUCCESS_CODES 已含 1,非成功码会直接 reject, + * 所以页面里的 `isCheckApiSuccess()` 只是兜底);`message` 成功为 `ok`、失败为具体错误文案。 + */ +export type StockCheckEnvelope = { + /** 请求结果标记:success=成功 / failure=失败 */ + flag: 'success' | 'failure' | string + /** 业务码:成功为 1;失败为具体业务错误码(如 400/500) */ + code: number + /** 提示信息:成功为 ok;失败为具体错误文案 */ + message: string + /** 业务数据对象;失败时为 null */ + data: T | null + /** 服务器时间戳(秒) */ + timestamp: number +} + /** * 库存盘点(module folder = stock.check)接口封装。 * + * 响应封装(2026-10-02 起全部 20 个接口统一): + * `{ flag, code, message, data, timestamp }` —— 业务数据**整体在 `data` 内**(见 StockCheckEnvelope)。 + * 调用侧统一 `const data = res.data ?? res`;`code=1` 为成功(request.ts 已含在 SUCCESS_CODES 内)。 + * * 状态机(主表 status): * created ──submit──> submitted ──audit(approve)──> approved ──report(首次)──> checking ──finish──> completed * │ │ (终态:completed / cancelled) @@ -15,11 +41,15 @@ const v = '1.0' * 仓库隔离:所有接口的 warehouse_id 均由服务端从登录上下文(ctx.user.store_id)注入,前端**禁止传入**。 * * 盘点作业记录(wms_stock_check_record): - * report 为**覆盖式**上报——同明细 + 同库位编码重复上报时更新已有记录(不新增), - * 由唯一索引 uk_detail_location(detail_id, location_code) 保证并发安全; - * 未传/为空的库位归入「无库位」分组(库中 location_code 存**空串** '',同分组同样覆盖更新), - * 而 recordList 返回时把空串归一为 **null**(对外口径); + * report 为**覆盖式**上报——查重维度(同维度重复上报=更新已有记录,不新增): + * 已知商品 detail_id + stock_id + location_code(唯一索引 uk_detail_stock_location 保证并发安全) + * 未知商品 detail_id + stock_id IS NULL + barcode + location_code(应用层查重兜底) + * 未传/为空的库位归入「无库位」分组(库中 location_code 存**空串** ''), + * 而 recordList / result 返回时把空串归一为 **null**(对外口径); + * **未知商品** = stock_id 未命中、按 barcode 也匹配不到系统商品 → 记录 stock_id=NULL + + * barcode + item_name(缺省为条码);无账面数量、实盘 >0 即盘盈,走 unknown_items 聚合; * 一个明细可以有多个库位的记录,明细行上的 checked_quantity/diff_quantity 均为记录聚合值; + * ⚠️ 明细**范围行**(stock.check.detail)不含任何作业聚合,聚合请看 stock.check.result; * recordList / recordDelete 用于查看与删除作业记录,删除不影响主表状态。 * 未盘明细 = 无作业记录的明细(finish 时按实盘 0 处理,计入盘亏与差异行数)。 */ @@ -121,12 +151,17 @@ export type StockCheckRecord = { warehouse_id?: number /** 盘点明细ID */ detail_id: number - /** 商品库存ID(wms_stock_warehouse.id) */ - stock_id: number + /** + * 商品库存ID(wms_stock_warehouse.id) + * + * **可为 null**:null = 未知商品(stock_id 未命中且按 barcode 也匹配不到系统商品), + * 此时看 barcode / item_name;已知商品 barcode / item_name 可能为空 + */ + stock_id: number | null location_id?: number | null /** - * 库位编码;「无库位」分组的记录:库中存**空串**,但 recordList/detail 返回时归一为 **null** - * (故前端按 falsy 判断即可,空串与 null 均表示无库位) + * 库位编码;「无库位」分组的记录:库中存**空串**,但 recordList / result / detail 返回时 + * 归一为 **null**(故前端按 falsy 判断即可,空串与 null 均表示无库位) */ location_code?: string | null /** 本库位实盘数量 */ @@ -135,6 +170,22 @@ export type StockCheckRecord = { checker_name?: string | null checked_at?: string | null remark?: string | null + /** 扫描条码(未知商品记录有值;已知商品可能为空/null) */ + barcode?: string | null + /** 商品名称快照(未知商品=上报名称或条码兜底;已知商品从明细商品快照补齐) */ + item_name?: string | null + /** + * **空库位标记记录**(`is_empty=1`):stock_id / barcode / item_name 均为 null、quantity=0 + * + * 库位明细「标记为空」后该明细下**只保留这条记录**(原商品记录被清除); + * 反之上报商品时会删除该明细下的空标记记录(两者互斥)。 + */ + is_empty?: boolean | number | null + /** + * 作业图片列表(FileReference business_type=stock_check_record,仿收货 receivingItem 口径); + * 每条为 `{ id: file_id, url }` + */ + images?: { id: number; url: string }[] created_at?: string updated_at?: string [key: string]: unknown @@ -169,6 +220,23 @@ export type StockCheckDetailStock = { [key: string]: unknown } +/** + * 未知商品聚合(stock.check.result 的 rows[].unknown_items,按条码升序) + * + * 作业记录 stock_id 为空(按 barcode 也匹配不到系统商品)的未知商品按条码归组; + * 无账面数量,差异 = 实盘 - 0(实盘 >0 即盘盈),已计入行级 + * checked_quantity / diff_quantity / is_diff;无未知商品时为空数组。 + */ +export type StockCheckUnknownItem = { + /** 扫描条码(归组键) */ + barcode: string + /** 商品名称快照(缺省为条码) */ + item_name?: string | null + /** 该条码实盘数量合计 */ + checked_quantity?: number | null + [key: string]: unknown +} + /** * 盘点**范围行**(stock.check.detail 的 rows 元素)—— 纯范围行,**不含任何盘点作业聚合** * @@ -202,6 +270,14 @@ export type StockCheckDetailRow = { batch_no?: string | null /** 账面数量快照(商品行为快照值,库位行为 0) */ system_quantity?: number | null + /** + * 商品行(scope_type=goods)另挂载的全局商品信息(来源 stockWarehouse.getStockDetails,带缓存): + * id / item_code / item_name / sku_property / quantity / locked_quantity / is_batch_mgmt / + * is_shelf_life_mgmt / image_url / is_images / need_recheck / store_id / packing_requirements / + * pick_requirements / recheck_requirements / merge_requirements / stock_unit / barcodes; + * 未命中(库存不存在或不属于本仓库)为 null;**库位行不挂载**(无该字段) + */ + stock?: Record | null remark?: string | null created_at?: string updated_at?: string @@ -228,6 +304,13 @@ export type StockCheckResultRow = StockCheckDetailRow & { is_diff?: boolean | number | null /** 盘点状态:checked=有作业记录 / unchecked=未盘 */ status?: 'checked' | 'unchecked' | string + /** + * 是否**空库位标记**(仅库位行:true 表示该库位已确认空) + * + * 空标记时 `stocks=[]`、`unknown_items=[]`、`checked_quantity=0`、`status=checked`(视为已盘); + * 库位账面有库存时 `diff_quantity` 为负数(盘亏 = 0 - 库位账面库存总量)、`is_diff=1` + */ + is_empty?: boolean | number | null /** 已盘库位编码数组(去重;无库位分组的编码为空串/null) */ location_codes?: string[] /** 盘点人数组(去重) */ @@ -240,6 +323,13 @@ export type StockCheckResultRow = StockCheckDetailRow & { locations?: StockCheckDetailLocation[] /** 库位行的商品聚合(商品行为 undefined;无记录时为空数组) */ stocks?: StockCheckDetailStock[] + /** + * 未知商品按条码聚合(商品行 / 库位行**都有**;无未知商品时为空数组) + * + * 口径:作业记录 stock_id 为空(按 barcode 也匹配不到系统商品)的记录按条码归组, + * 无账面、差异 = 实盘 - 0(盘盈),已计入行级 checked_quantity / diff_quantity / is_diff + */ + unknown_items?: StockCheckUnknownItem[] } // ============ stock.check.create ============ @@ -268,7 +358,7 @@ export type StockCheckCreateParams = { /** stock.check.create:创建盘点任务(空任务,status=created、detail_status=none_checked) */ export function stockCheckCreate( data: StockCheckCreateParams -): Promise }> { +): Promise> { return request({ url: '/system', method: 'post', @@ -321,13 +411,7 @@ export type StockCheckPatternListResponse = { * * 返回代码注册的 5 个内置定式,每条含 id/name/description/type;无入参。 */ -export function stockCheckPatternList(): Promise< - StockCheckPatternListResponse & { - code?: number - message?: string - data?: Partial | StockCheckPattern[] - } -> { +export function stockCheckPatternList(): Promise> { return request({ url: '/system', method: 'post', @@ -396,13 +480,7 @@ export type StockCheckPatternCreateResponse = { */ export function stockCheckPatternCreate( data: StockCheckPatternCreateParams -): Promise< - StockCheckPatternCreateResponse & { - code?: number - message?: string - data?: Partial - } -> { +): Promise> { return request({ url: '/system', method: 'post', @@ -484,7 +562,7 @@ export type StockCheckListResponse = { /** stock.check.list:盘点任务列表(按登录仓库限定数据范围,服务端分页) */ export function stockCheckList( data: StockCheckListParams = {} -): Promise }> { +): Promise> { return request({ url: '/system', method: 'post', @@ -500,22 +578,42 @@ export function stockCheckList( // ============ stock.check.addDetail ============ -/** stock.check.addDetail 请求参数(与任务 type 对齐:商品类传 stock_ids,库位类传 locations) */ +/** + * stock.check.addDetail 请求参数(与任务 type 对齐:商品类传 stock_ids,库位类传 locations / location_ids) + * + * 维度校验(传错维度后端报 400): + * - 按库位盘点(type=all/location)传 stock_ids → 「当前盘点类型按库位盘点,请传 locations 或 + * location_ids(如需按商品盘点请创建 type=goods 任务)」 + * - 按商品盘点(type=store/goods)传 locations → 「当前盘点类型按商品盘点,请传 stock_ids」 + * - 按商品盘点传 location_ids → 「当前盘点类型按商品盘点,不能添加库位明细」 + * + * 兼容:type=all 且已存在商品明细行(改造前创建的旧任务)时,继续按商品模式接受 stock_ids。 + * 幂等:已存在同盘点项(商品行 stock_id / 库位行 location_code)自动跳过(计入 skipped)。 + */ export type StockCheckAddDetailParams = { /** 盘点任务ID */ id: number /** * 商品库存ID列表(wms_stock_warehouse.id):type=store/goods 按商品盘点时使用, - * 与 locations 按任务类型二选一 + * 与 locations / location_ids 按任务类型二选一 */ stock_ids?: number[] /** * 库位编码列表(wms_location_space.space_code):type=all/location 按库位盘点时使用, - * 与 stock_ids 按任务类型二选一;**type=all 未传时由后端自动拉取全仓库启用库位生成盘点范围** + * 与 stock_ids 按任务类型二选一;**与 location_ids 同时传入时被忽略(location_ids 优先)**; + * **type=all 未传库位且未传 location_ids 时由后端自动拉取全仓库启用库位生成盘点范围** */ locations?: string[] /** 库位编码列表(兼容别名;locations 优先,两者都传时以 locations 为准) */ location_codes?: string[] + /** + * 库位ID列表(wms_location_space.id):type=all/location 按库位盘点时使用, + * 直接按 id + warehouse_id 查库校验(**不再按编码二次解析**),查不到的 ID 记入 + * `invalid_location_ids`(不报错);与 locations 同时传入时 **location_ids 优先、locations 忽略** + */ + location_ids?: number[] + /** 库位ID列表(驼峰别名,兼容写法;location_ids 优先) */ + locationIds?: number[] } /** stock.check.addDetail 响应 */ @@ -528,16 +626,16 @@ export type StockCheckAddDetailResponse = { invalid_stock_ids: number[] /** 无效库位编码列表(当前仓库不存在对应库位编码) */ invalid_locations: string[] + /** 无效库位ID列表(按 wms_location_space.id 直查当前仓库不存在) */ + invalid_location_ids: number[] /** 重算后的明细总行数 */ total_items: number } -/** stock.check.addDetail:添加盘点明细(仅 created/rejected 允许;同 stock_id 幂等跳过) */ +/** stock.check.addDetail:添加盘点明细(仅 created/rejected 允许;同盘点项幂等跳过) */ export function stockCheckAddDetail( data: StockCheckAddDetailParams -): Promise< - StockCheckAddDetailResponse & { code?: number; message?: string; data?: Partial } -> { +): Promise> { return request({ url: '/system', method: 'post', @@ -551,45 +649,107 @@ export function stockCheckAddDetail( } as any) } +// ============ stock.check.addLocationDetail ============ + +/** + * stock.check.addLocationDetail 请求参数(仅库位维度:**库位ID直查**,不解析编码) + * + * 服务端直接按 wms_location_space.id + warehouse_id 查库校验,不经过 space_code 二次解析; + * 转发前保留旧口径参数校验(任务ID不能为空、库位ID不能为空、单次上限 200), + * 任务存在性 / 状态 / 类型分派校验统一由 addDetail 处理。 + */ +export type StockCheckAddLocationDetailParams = { + /** 盘点任务ID */ + id: number + /** 库位ID列表(wms_location_space.id,单次上限 200) */ + location_ids: number[] + /** 库位ID列表(驼峰别名,兼容写法;location_ids 优先) */ + locationIds?: number[] +} + +/** + * stock.check.addLocationDetail 响应 + * + * 由 addDetail 返回结构**映射**而来:只保留 { added, skipped, invalid_location_ids, total_items }, + * 已过滤 invalid_locations / invalid_stock_ids(口径与原「批量添加库位明细」一致)。 + */ +export type StockCheckAddLocationDetailResponse = { + /** 本次新增明细数 */ + added: number + /** 已存在被跳过(幂等)的盘点项数 */ + skipped: number + /** 无效库位ID列表(按 wms_location_space.id 直查当前仓库不存在) */ + invalid_location_ids: number[] + /** 重算后的明细总行数 */ + total_items: number +} + +/** + * stock.check.addLocationDetail:**批量添加库位明细**(兼容入口,薄封装转调 addDetail 的库位ID直查路径) + * + * - 幂等添加 `scope_type=location` 明细行,已存在的同库位明细自动跳过 + * - 仅 created/rejected 状态允许(由 addDetail 校验) + * - 仅传库位ID,不传库位编码;单次上限 200 + */ +export function stockCheckAddLocationDetail( + data: StockCheckAddLocationDetailParams +): Promise> { + return request({ + url: '/system', + method: 'post', + params: { + method: 'stock.check.addLocationDetail', + v, + timestamp: new Date().getTime() + }, + data, + isSystemApi: true + } as any) +} + // ============ stock.check.detailDelete ============ -/** stock.check.detailDelete 请求参数 */ +/** stock.check.detailDelete 请求参数(**批量删除**,单次上限 200) */ export type StockCheckDetailDeleteParams = { /** 盘点任务ID */ id: number - /** 盘点明细ID(与 detailId 二选一,detail_id 优先) */ + /** + * 盘点明细ID数组(单次上限 200) + * + * 兼容写法:`detailIds`(驼峰)/ `detail_id`(旧版单值,自动转数组); + * 优先级 detail_ids > detailIds > detail_id + */ + detail_ids: number[] + /** 盘点明细ID数组(驼峰别名,兼容写法,单值自动转数组;detail_ids 优先) */ + detailIds?: number[] | number + /** 盘点明细ID(旧版单值写法,自动转数组;detail_ids / detailIds 优先) */ detail_id?: number - /** 盘点明细ID(驼峰别名,兼容写法) */ - detailId?: number } -/** stock.check.detailDelete 响应 */ +/** stock.check.detailDelete 响应(批量口径) */ export type StockCheckDetailDeleteResponse = { - /** 被删除的盘点明细ID */ - detail_id: number - /** 是否删除成功 */ - deleted: boolean + /** 实际删除的明细数量 */ + deleted_count: number + /** 实际删除的明细ID列表(保持入参顺序) */ + deleted_ids: number[] + /** 未命中被跳过的明细ID列表(明细不存在或不属于当前仓库,不报错;保持入参顺序) */ + skipped_ids: number[] /** 删除后重算的主表明细总行数 */ total_items: number } /** - * stock.check.detailDelete:删除盘点明细(从任务中移除某个商品) + * stock.check.detailDelete:**批量删除盘点明细**(从任务中移除若干商品 / 库位行) * * - 仅主表状态 created/rejected 允许删除 - * - 该明细若存在作业记录(wms_stock_check_record)会防御性一并删除 + * - 未命中的明细ID(不存在或不属于当前仓库)计入 `skipped_ids`,不报错 + * - 命中明细若存在作业记录(wms_stock_check_record)会防御性一并删除 * (正常流程 created/rejected 状态不应有记录) * - 删除后服务端重算主表 total_items */ export function stockCheckDetailDelete( data: StockCheckDetailDeleteParams -): Promise< - StockCheckDetailDeleteResponse & { - code?: number - message?: string - data?: Partial - } -> { +): Promise> { return request({ url: '/system', method: 'post', @@ -629,7 +789,7 @@ export type StockCheckDetailResponse = { */ export function stockCheckDetail( data: StockCheckDetailParams -): Promise }> { +): Promise> { return request({ url: '/system', method: 'post', @@ -670,7 +830,7 @@ export type StockCheckResultResponse = { */ export function stockCheckResult( data: StockCheckResultParams -): Promise }> { +): Promise> { return request({ url: '/system', method: 'post', @@ -684,9 +844,296 @@ export function stockCheckResult( } as any) } +// ============ stock.check.workData ============ + +/** + * workData 的**行结构**类型(三套) + * + * ⚠️ 这**不是入参**:`view` 入参已废弃(传了也被忽略)。实际返回哪种结构由 + * **任务范围类型 + `is_goods`** 解析: + * - 任务范围是库位(`type=location/all`)→ **一律 `location`**(库位结构) + * - 任务范围是商品(`type=goods/store`)→ 默认 **`space`**(聚合库位); + * 仅 `is_goods=true` → **`goods`**(商品结构) + */ +export type StockCheckWorkDataView = 'location' | 'goods' | 'space' + +/** workData 可拉取的盘点主表状态(仅这两种,其他状态后端返回 400) */ +export type StockCheckWorkDataStatus = 'approved' | 'checking' + +/** 作业数据里的图片项(FileReference business_type=stock_check_record) */ +export type StockCheckWorkImage = { id: number; url: string } + +/** + * location 视图行内的**商品记录**子项 + * + * ⚠️ 新口径:**已知商品与未知商品记录均并入本列表**(未知商品 `stock_id=null`、`item_code` 用条码兜底); + * 是否含未知商品看行上的 `has_unknown`;空库位标记记录**不在本列表**(看行上的 `is_empty`)。 + */ +export type StockCheckWorkLocationGoods = { + /** 作业记录ID(wms_stock_check_record.id) */ + record_id: number + /** 商品库存ID;**null = 未知商品**(此时 item_code 用 barcode 兜底) */ + stock_id: number | null + /** 商品编码(未知商品为扫描条码) */ + item_code?: string | null + item_name?: string | null + /** 商品条码 */ + barcode?: string | null + /** 该记录的作业图片 */ + images?: StockCheckWorkImage[] + store_id?: number | null + /** 货主名称(_resolveStoreNameMap 解析) */ + store_name?: string | null + /** 实盘数量 */ + quantity: number + checked_at?: string | null + checker_name?: string | null + [key: string]: unknown +} + +/** + * location 视图行内的**未知商品**子项(stock_id 为空,item_name 缺省为条码) + * + * ⚠️ 新口径下未知商品记录已并入 `goods`(`stock_id=null`),本字段**可能不再返回**; + * 保留仅为兼容旧响应(页面应以 `goods` + `has_unknown` 为准)。 + */ +export type StockCheckWorkLocationUnknown = { + record_id: number + barcode?: string | null + item_name?: string | null + images?: StockCheckWorkImage[] + /** 实盘数量(无账面,实盘 >0 即盘盈) */ + quantity: number + checked_at?: string | null + checker_name?: string | null + [key: string]: unknown +} + +/** location 视图行(一行一个库位范围行) */ +export type StockCheckWorkLocationRow = { + /** 盘点明细ID */ + detail_id: number + location_id?: number | null + /** 库位编码(优先明细快照,缺失回退库位表 space_code) */ + location_code?: string | null + /** 库位名称(custom_name 兜底 space_code) */ + location_name?: string | null + /** 盘点状态:checked=存在作业记录 / unchecked=无 */ + status: 'checked' | 'unchecked' | string + /** 是否含未知商品记录 */ + has_unknown?: boolean + /** + * 是否存在**空库位标记**记录(`is_empty=1`) + * + * 空标记记录**不计入 `goods`**;存在空标记后该行 `status=checked`(视为已盘点) + */ + is_empty?: boolean + /** 该库位最近上报时间(无记录为 null) */ + checked_at?: string | null + /** 盘点人(去重数组) */ + checkers?: string[] + /** 该库位的商品作业记录(**已知 + 未知商品均在内**,未知商品 stock_id=null) */ + goods?: StockCheckWorkLocationGoods[] + /** 该库位的未知商品作业记录(新口径已并入 goods,**可能不再返回**,仅兼容保留) */ + unknown?: StockCheckWorkLocationUnknown[] + [key: string]: unknown +} + +/** goods 视图行内按库位聚合的作业记录(明盘另含 quantity=该库位实盘合计) */ +export type StockCheckWorkGoodsLocation = { + /** 空库位归 location_code=null 组 */ + location_code?: string | null + checked_at?: string | null + checker_name?: string | null + quantity?: number | null + [key: string]: unknown +} + +/** + * goods 视图行(一行一个商品范围行) + * + * ⚠️ 盲盘(mode=blind)**不返回任何数量字段**:system_quantity / checked_quantity / + * diff_quantity / is_diff 均为 undefined,locations 各项也没有 quantity。 + */ +export type StockCheckWorkGoodsRow = { + detail_id: number + stock_id: number + item_code?: string | null + item_name?: string | null + spec?: string | null + store_id?: number | null + store_name?: string | null + barcode?: string | null + images?: StockCheckWorkImage[] + /** 按库位聚合的作业记录(按首条记录 id 升序) */ + locations?: StockCheckWorkGoodsLocation[] + /** 账面数量快照(仅明盘) */ + system_quantity?: number | null + /** 已盘合计(仅明盘) */ + checked_quantity?: number | null + /** 差异 = 已盘 - 账面(仅明盘) */ + diff_quantity?: number | null + /** 是否差异:0|1(仅明盘) */ + is_diff?: boolean | number | null + [key: string]: unknown +} + +/** space 视图行内的任务商品子项(明盘另含数量) */ +export type StockCheckWorkSpaceGoods = { + detail_id: number + stock_id: number + item_code?: string | null + item_name?: string | null + spec?: string | null + store_id?: number | null + store_name?: string | null + barcode?: string | null + images?: StockCheckWorkImage[] + /** 该商品在该库位是否已盘(存在 detail_id+location_code 的作业记录即 checked) */ + status: 'checked' | 'unchecked' | string + /** 该库位该商品的账面(wms_storage space+stock SUM(quantity);仅明盘) */ + system_quantity?: number | null + /** 该库位该商品的实盘合计(仅明盘) */ + checked_quantity?: number | null + [key: string]: unknown +} + +/** + * space 视图行(一行一个库位,按拣货路径排序) + * + * ⚠️ 库位字段对齐库位查询惯例(index.searchSpace),**不是** location_id / location_code: + * id = 库位ID(wms_location_space.id)/ space_code = 库位编码 / + * custom_name = 自定义名称(空为 null,**不兜底** space_code)/ custom_barcode = 自定义条码(空为 null) + * + * 库位集合 = **当前库存库位 ∪ 作业记录库位**: + * 盘点前库存已出空但已有盘点作业记录的库位也会返回, + * 该库位商品行账面 system_quantity 按 0、checked_quantity 按该库位实盘合计。 + */ +export type StockCheckWorkSpaceRow = { + /** 库位ID(wms_location_space.id) */ + id: number + /** 库位编码 */ + space_code?: string | null + /** 库位自定义条码(空为 null) */ + custom_barcode?: string | null + /** 库位自定义名称(空为 null,不兜底 space_code) */ + custom_name?: string | null + /** 该库位下的任务商品 */ + goods?: StockCheckWorkSpaceGoods[] + [key: string]: unknown +} + +/** workData 视图类型 → 行结构映射 */ +export type StockCheckWorkDataRowMap = { + location: StockCheckWorkLocationRow + goods: StockCheckWorkGoodsRow + space: StockCheckWorkSpaceRow +} + +/** + * workData 分页参数(可选;未传或非法时默认 page=1、pageSize=20,**pageSize 上限 200**) + * + * 分页口径与 `stock.check.list` 一致(**仅 `pagination`**,无蛇形 / 顶层别名写法)。 + */ +export type StockCheckWorkDataPagination = { + /** 页码(默认 1) */ + page?: number + /** 每页数量(默认 20,上限 200) */ + pageSize?: number +} + +/** workData 返回的行结构(union;按任务 type + is_goods 解析) */ +export type StockCheckWorkDataRow = + | StockCheckWorkLocationRow + | StockCheckWorkGoodsRow + | StockCheckWorkSpaceRow + +/** + * stock.check.workData 请求参数(id 必填;is_goods / pagination 可选) + * + * ⚠️ `view` 入参已废弃(传了也被忽略);分页只走 `pagination: { page, pageSize }` + * 一种写法,口径与 `stock.check.list` 一致。 + */ +export type StockCheckWorkDataParams = { + /** 盘点任务ID(wms_stock_check.id) */ + id: number + /** + * 商品任务是否按商品视图返回(**仅商品任务生效**): + * true → `goods`(商品结构);缺省 false → `space`(聚合库位,按拣货路径) + * 库位任务(type=location/all)**无视该参数**,一律返回 `location`(库位结构) + */ + is_goods?: boolean + /** 商品视图开关(驼峰别名,兼容写法;is_goods 优先) */ + isGoods?: boolean + /** 分页参数 { page, pageSize }(可选) */ + pagination?: StockCheckWorkDataPagination +} + +/** + * stock.check.workData 响应(**服务端分页**:rows 为当前页,total 为全量行数) + */ +export type StockCheckWorkDataResponse< + V extends StockCheckWorkDataView = StockCheckWorkDataView +> = { + /** 盘点主表信息(_formatCheckRow 口径) */ + check: StockCheckTask + /** + * **当前页**作业数据行(后端先构建全量行再按页切片);结构随**解析视图**变化 + * (任务范围 + is_goods);任务无对应范围行时为空数组 + */ + rows: StockCheckWorkDataRowMap[V][] + /** 全部行数(**未分页口径**;分页时 rows 只含当前页、total 保持全部行数) */ + total: number + /** 当前页码(未传或非法时默认 1) */ + page: number + /** 每页数量(默认 20,上限 200) */ + pageSize: number +} + +/** + * stock.check.workData:拉取盘点作业数据(**单接口三视图**,由**任务范围类型 + is_goods** 解析) + * + * 返回 `{ check, rows, total, page, pageSize }`(**服务端分页**:rows 为当前页,total 为全量行数); + * `rows` 结构随**解析视图**不同(见各视图行类型): + * - `location`:库位结构,行内 `goods`(已知商品)/ `unknown`(未知商品)子列表 + * - `goods` :商品结构,行内 `locations`(按库位聚合的作业记录);**盲盘不返回数量字段** + * - `space` :聚合库位列表(当前库存库位 ∪ 作业记录库位,按拣货路径排序), + * 行内 `goods` 为该库位的任务商品(库位列字段为 id/space_code/custom_name) + * + * ⚠️ **状态限制**:仅任务 `status=approved`(待盘点)/ `checking`(盘点中)可拉取, + * 其他状态(created/submitted/rejected/completed/cancelled)后端返回 400: + * 「当前状态(xx)不允许拉取盘点作业数据,仅审核完成(approved)或盘点作业中(checking)的任务可拉取」 + * → 前端应在非这两种状态时**不发请求**。 + * + * 与 detail / result 的区别:detail 只给范围行、result 按明细行聚合作业记录, + * workData 直接给「作业视角」的三套结构,前端无需再自行聚合。 + */ +export function stockCheckWorkData< + V extends StockCheckWorkDataView = StockCheckWorkDataView +>( + data: StockCheckWorkDataParams +): Promise>> { + return request({ + url: '/system', + method: 'post', + params: { + method: 'stock.check.workData', + v, + timestamp: new Date().getTime() + }, + data, + isSystemApi: true + } as any) +} + // ============ stock.check.report ============ -/** stock.check.report 请求参数(覆盖式:同明细 + 同商品 + 同库位重复上报为更新) */ +/** + * stock.check.report 请求参数(覆盖式) + * + * 查重维度:已知商品 detail_id + stock_id + location_code; + * 未知商品 detail_id + stock_id IS NULL + barcode + location_code。 + */ export type StockCheckReportParams = { /** 盘点任务ID */ id: number @@ -699,14 +1146,37 @@ export type StockCheckReportParams = { * 匹配 space_code 时回填 location_id */ location?: string - /** 实盘数量(不小于 0 的整数) */ + /** + * 实盘数量(不小于 0 的整数) + * + * `is_empty=true` 时**不参与校验**(后端恒按 0 处理) + */ quantity: number /** * 商品库存ID(wms_stock_warehouse.id): * - 商品行:可选(传入必须与明细商品一致,否则报错) - * - 库位行:**必填**,且商品必须属于本仓库 + * - 库位行:与 `barcode` **至少传一项**(商品必须属于本仓库);`is_empty=true` 时不传 */ stock_id?: number + /** + * 扫描到的条码/编码(可选):未传 stock_id 时按条码匹配系统商品 + * (wms_stock_barcodes 按 barcode + 本仓库匹配,关联 StockWarehouse 校验商品属于本仓库), + * 命中回填 stock_id 按已知商品处理;未命中记为**未知商品**(stock_id=NULL + barcode + item_name) + */ + barcode?: string + /** + * 未知商品名称快照(可选):**仅未知商品记录落库**,缺省为 barcode;已知商品忽略 + */ + item_name?: string + /** + * **空库位标记**(可选,**仅库位明细行 scope_type=location 支持**) + * + * true = 确认该库位为空:不要求商品/条码,`quantity` 恒为 0,写一条特殊作业记录 + * (stock_id=null、barcode=null、item_name=null、quantity=0、is_empty=1); + * 与商品记录**互斥**:标记空时删除该明细下所有商品记录(含未知商品),上报商品时删除空标记记录; + * 商品明细行传 true 报 400「仅库位盘点明细支持空库位标记」 + */ + is_empty?: boolean } /** stock.check.report 响应 */ @@ -726,12 +1196,19 @@ export type StockCheckReportResponse = { } /** - * stock.check.report:盘点作业**覆盖式**上报(同明细 + 同库位重复上报更新已有记录)。 - * 仅 approved/checking 允许;主表 approved 首次上报自动转 checking。 + * stock.check.report:盘点作业**覆盖式**上报(同明细 + 同商品 + 同库位重复上报更新已有记录)。 + * + * 仅 approved/checking 允许;主表 approved 首次上报自动转 checking; + * 主表 start_time 为空时以本次明细写入时间补写(= 盘点开始时间); + * 未知商品(stock_id 与 barcode 至少传一项):仅传 barcode 时先按条码匹配系统商品, + * 命中回填 stock_id 走已知商品逻辑,未命中记为未知商品(stock_id=NULL)。 + * + * 空库位标记(`is_empty=true`,仅库位行):确认该库位为空 —— 与商品记录互斥, + * 标记空时清除该明细的所有商品记录。 */ export function stockCheckReport( data: StockCheckReportParams -): Promise }> { +): Promise> { return request({ url: '/system', method: 'post', @@ -745,6 +1222,53 @@ export function stockCheckReport( } as any) } +// ============ stock.check.markEmpty ============ + +/** stock.check.markEmpty 请求参数(库位盘点专用:确认某库位为空) */ +export type StockCheckMarkEmptyParams = { + /** 盘点任务ID(正整数;非法报 400「盘点任务ID不能为空」) */ + id: number + /** + * 库位明细ID(正整数;非法报 400「盘点明细ID不能为空」) + * + * 明细必须属于本任务且为库位范围行(scope_type=location), + * 否则报 400「仅库位盘点明细支持空库位标记」 + */ + detail_id: number +} + +/** stock.check.markEmpty 响应 data(**与 report 口径一致**) */ +export type StockCheckMarkEmptyResponse = StockCheckReportResponse + +/** + * stock.check.markEmpty:**标记库位为空**(库位盘点模式专属,后端转调 report 的 `is_empty=true` 口径) + * + * - 仅**库位范围任务**(type=location/all)支持,否则 400「仅库位盘点任务支持空库位标记」 + * - 仅 `approved` / `checking` 状态允许 + * - 行为:写/更新空标记记录(stock_id/barcode/item_name 均为 null、quantity=0、is_empty=1)、 + * **清除该明细下所有商品记录**、主表 approved 首次标记自动转 checking、 + * 重算 checked_items / diff_items / detail_status(空标记计入已盘;库位账面有库存计盘亏差异) + * - warehouse_id 由服务端从登录上下文注入,前端不传 + * + * ⚠️ 与 `report({ is_empty: true })` 等价;已标记空的库位需再盘点商品时,直接 `report` 正常上报即可 + * (后端会自动删除该明细下的空标记记录)。 + */ +export function stockCheckMarkEmpty( + data: StockCheckMarkEmptyParams +): Promise> { + return request({ + url: '/system', + method: 'post', + params: { + method: 'stock.check.markEmpty', + v, + timestamp: new Date().getTime() + }, + data, + isSystemApi: true + } as any) +} + // ============ stock.check.recordList ============ /** stock.check.recordList 请求参数(id 与 detail_id 至少传一个) */ @@ -757,10 +1281,16 @@ export type StockCheckRecordListParams = { pagination?: { page?: number; pageSize?: number } } -/** stock.check.recordList 响应行:作业记录全字段 + 商品快照列 */ +/** + * stock.check.recordList 响应行:作业记录全字段 + 商品快照列 + images + * + * 商品快照口径:未知商品(stock_id 为空)item_code = 扫描条码(barcode,空则 null)、 + * item_name = 上报名称快照(item_name 或 barcode 兜底);已知商品从明细表 + * (wms_stock_check_detail)商品快照补齐。 + */ export type StockCheckRecordListRow = StockCheckRecord & { - item_code?: string - item_name?: string + /** 商品编码(未知商品=扫描条码;已知商品=明细商品快照) */ + item_code?: string | null } /** stock.check.recordList 响应 */ @@ -774,7 +1304,7 @@ export type StockCheckRecordListResponse = { /** stock.check.recordList:盘点作业记录列表(按记录 id 倒序,服务端分页) */ export function stockCheckRecordList( data: StockCheckRecordListParams = {} -): Promise }> { +): Promise> { return request({ url: '/system', method: 'post', @@ -790,32 +1320,60 @@ export function stockCheckRecordList( // ============ stock.check.recordDelete ============ -/** stock.check.recordDelete 请求参数(record_id 优先,recordId 为兼容别名) */ +/** + * stock.check.recordDelete 请求参数(**批量删除**,单次上限 200) + * + * 兼容旧版单值写法(传单值自动转数组),优先级: + * `record_ids` > `recordIds` > `recordId` > `record_id` + */ export type StockCheckRecordDeleteParams = { /** 盘点任务ID */ id: number - /** 作业记录ID(wms_stock_check_record.id) */ - record_id?: number - /** 作业记录ID(驼峰别名) */ + /** + * 作业记录ID数组(wms_stock_check_record.id;单次上限 200;传单值自动转数组) + */ + record_ids: number[] + /** 作业记录ID数组(驼峰别名,兼容写法;record_ids 优先) */ + recordIds?: number[] + /** 作业记录ID(单数驼峰,兼容旧版单值写法;record_ids/recordIds 优先,单值自动转数组) */ recordId?: number + /** 作业记录ID(旧版单值写法,兼容;record_ids/recordIds/recordId 优先,单值自动转数组) */ + record_id?: number } -/** stock.check.recordDelete 响应(删除后重算的进度;主表状态不回退) */ +/** + * stock.check.recordDelete 响应 data(**批量口径**,与 detailDelete 批量一致) + * + * 删除后重算进度(主表状态不回退);`deleted_ids` / `skipped_ids` 保持入参顺序。 + */ export type StockCheckRecordDeleteResponse = { - /** 被删除的作业记录ID */ - record_id: number - /** 是否删除成功 */ - deleted: boolean + /** 实际删除的记录数量 */ + deleted_count: number + /** 实际删除的记录ID列表(保持入参顺序) */ + deleted_ids: number[] + /** 未命中被跳过的记录ID列表(记录不存在或不属于该任务/当前仓库,不报错;保持入参顺序) */ + skipped_ids: number[] + /** 明细总行数 */ total_items: number + /** 重算后的已盘行数(存在作业记录的明细数) */ checked_items: number + /** 重算后的差异行数 */ diff_items: number + /** 重算后的明细盘点进度 */ detail_status: StockCheckDetailStatus } -/** stock.check.recordDelete:删除盘点作业记录(仅 approved/checking;记录删光后该明细回到未盘口径) */ +/** + * stock.check.recordDelete:**批量删除**盘点作业记录(由旧版单值删除升级而来) + * + * - 仅 `approved` / `checking` 允许;记录必须属于该任务与当前仓库 + * - 未命中的记录ID计入 `skipped_ids`(不报错) + * - 删除后清理该批记录的图片引用、重算 checked_items / diff_items / detail_status + * (明细记录删光后回到未盘口径),主表状态不回退 + */ export function stockCheckRecordDelete( data: StockCheckRecordDeleteParams -): Promise }> { +): Promise> { return request({ url: '/system', method: 'post', @@ -829,6 +1387,70 @@ export function stockCheckRecordDelete( } as any) } +// ============ stock.check.recheckClearLocation ============ + +/** stock.check.recheckClearLocation 请求参数(库位盘点专用:按库位清除盘点信息) */ +export type StockCheckRecheckClearLocationParams = { + /** 盘点任务ID */ + id: number + /** 库位ID(wms_location_space.id) */ + location_id: number + /** 库位ID(驼峰别名,兼容写法;location_id 优先) */ + locationId?: number +} + +/** + * stock.check.recheckClearLocation 响应 data + * + * ⚠️ 文档未逐字段列出(只说明「清除该库位全部作业记录并重算进度」); + * 参照同类批量删除接口(recordDelete / detailDelete)推断应含清除数量/IDs 与重算后的进度字段, + * 但**请以实际响应为准**,故此处用宽松类型(字段均为可选 + 索引签名兜底)。 + */ +export type StockCheckRecheckClearLocationResponse = { + /** 被清除的作业记录数量(推断字段) */ + deleted_count?: number + /** 被清除的作业记录ID列表(推断字段) */ + deleted_ids?: number[] + /** 被清除的库位ID(推断字段) */ + location_id?: number + /** 明细总行数(推断字段) */ + total_items?: number + /** 重算后的已盘行数(推断字段) */ + checked_items?: number + /** 重算后的差异行数(推断字段) */ + diff_items?: number + /** 重算后的明细盘点进度(推断字段) */ + detail_status?: StockCheckDetailStatus + [key: string]: unknown +} + +/** + * stock.check.recheckClearLocation:**重盘清除库位**(按库位清除盘点信息,库位盘点模式专属) + * + * - 传 `id` + `location_id`,清除该库位范围内明细(`scope_type=location`)的**全部作业记录 + * (含空库位标记)**,该库位回到未盘 + * - 仅任务范围为库位(`type=location/all`)且状态 `approved` / `checking` 允许 + * - 删除后清理被删记录的图片引用(失败仅告警)、重算 checked_items / diff_items / detail_status + * (主表状态不回退)、写 `STOCK_CHECK_CLEAR_LOCATION` 操作日志 + * - 与 `markEmpty` 的区别:本接口是**清空**该库位的盘点结果(回到未盘), + * `markEmpty` 是**写入**一条空标记(视为已盘) + */ +export function stockCheckRecheckClearLocation( + data: StockCheckRecheckClearLocationParams +): Promise> { + return request({ + url: '/system', + method: 'post', + params: { + method: 'stock.check.recheckClearLocation', + v, + timestamp: new Date().getTime() + }, + data, + isSystemApi: true + } as any) +} + // ============ stock.check.finish ============ /** stock.check.finish 请求参数 */ @@ -864,7 +1486,7 @@ export type StockCheckFinishResponse = { */ export function stockCheckFinish( data: StockCheckFinishParams -): Promise }> { +): Promise> { return request({ url: '/system', method: 'post', @@ -896,7 +1518,7 @@ export type StockCheckSubmitResponse = { /** stock.check.submit:提交审核(仅 created/rejected 允许;校验 total_items>0) */ export function stockCheckSubmit( data: StockCheckSubmitParams -): Promise }> { +): Promise> { return request({ url: '/system', method: 'post', @@ -928,7 +1550,7 @@ export type StockCheckCancelResponse = { /** stock.check.cancel:取消盘点任务(仅 created/submitted/rejected 允许) */ export function stockCheckCancel( data: StockCheckCancelParams -): Promise }> { +): Promise> { return request({ url: '/system', method: 'post', @@ -964,7 +1586,7 @@ export type StockCheckAuditResponse = { /** stock.check.audit:审核盘点任务(仅 submitted 允许) */ export function stockCheckAudit( data: StockCheckAuditParams -): Promise }> { +): Promise> { return request({ url: '/system', method: 'post', @@ -1022,7 +1644,7 @@ export type StockCheckExportResponse = { */ export function stockCheckExport( data: StockCheckExportParams = {} -): Promise }> { +): Promise> { return request({ url: '/system', method: 'post', @@ -1058,13 +1680,7 @@ export type StockCheckExportTaskProgressResponse = StockCheckExportResponse & { */ export function stockCheckExportTaskProgress( data: StockCheckExportTaskProgressParams -): Promise< - StockCheckExportTaskProgressResponse & { - code?: number - message?: string - data?: Partial - } -> { +): Promise> { return request({ url: '/system', method: 'post', @@ -1112,13 +1728,7 @@ export type StockCheckBatchDeleteResponse = { */ export function stockCheckBatchDelete( data: StockCheckBatchDeleteParams -): Promise< - StockCheckBatchDeleteResponse & { - code?: number - message?: string - data?: Partial - } -> { +): Promise> { return request({ url: '/system', method: 'post', diff --git a/src/views/storage/stockcheck/components/OperationCellRenderer.vue b/src/views/storage/stockcheck/components/OperationCellRenderer.vue index 46d4e41d..c456157f 100644 --- a/src/views/storage/stockcheck/components/OperationCellRenderer.vue +++ b/src/views/storage/stockcheck/components/OperationCellRenderer.vue @@ -31,7 +31,7 @@ :disabled="isDisabled(btn)" @click.stop="handleActionClick(btn)" > - {{ btn.label }} + {{ resolveLabel(btn) }} @@ -43,7 +43,7 @@ :disabled="isDisabled(btn)" @click.stop="openForm(btn)" > - {{ btn.label }} + {{ resolveLabel(btn) }} @@ -168,6 +168,19 @@ function isVisible(btn: OperationButtonConfig): boolean { } } +/** 按钮文案:labelWhen(row) 优先,返回空则回退静态 label */ +function resolveLabel(btn: OperationButtonConfig): string { + if (typeof btn.labelWhen === 'function') { + try { + const dynamic = btn.labelWhen(props.row) + if (dynamic) return dynamic + } catch { + /* 忽略,回退静态 label */ + } + } + return btn.label +} + function isDisabled(btn: OperationButtonConfig): boolean { if (btn.disabledOnField) { const val = props.row[btn.disabledOnField] diff --git a/src/views/storage/stockcheck/config/components/CheckItemsPanel.vue b/src/views/storage/stockcheck/config/components/CheckItemsPanel.vue index c4c1db5b..7e15edc9 100644 --- a/src/views/storage/stockcheck/config/components/CheckItemsPanel.vue +++ b/src/views/storage/stockcheck/config/components/CheckItemsPanel.vue @@ -8,18 +8,26 @@ - 尚未开始作业的阶段(created/rejected/submitted,必然无作业记录)→ **stock.check.detail** (纯范围行,不含聚合;此时作业类列不渲染,无需多发一次聚合查询) 明细行形态由任务 type 决定,表格统一「平铺」展示(不用展开行): - - 商品行(scope_type=goods,type=store/goods):一行一个库存商品(商品快照 + 已盘聚合) + - 商品行(scope_type=goods,type=store/goods):一行一个库存商品(商品快照 + 已盘聚合); + 行级聚合(checked_quantity/diff_quantity)**已含未知商品**,故不再平铺 unknown_items, + 改为在「商品名称」列提示「含未知商品 N 项」,避免合计重复展示 - 库位行(scope_type=location,type=all/location):一行一个库位 + 行内商品各一行 - (result 的 stocks[] 平铺;无商品时保留库位行本身、商品列为 —) - 上报需带 stock_id → 商品行直接上报;同明细的「明细类型 / 库位」单元格合并显示 - 2. 盘点作业:行内或批量上报(stock.check.report,**覆盖式**: - 商品行=同明细+同库位;库位行=同明细+同商品+同库位,均重复上报为更新) - 3. 完成盘点(stock.check.finish,允许部分未盘完成: + (result 的 stocks[] 平铺)+ **未知商品各一行**(unknown_items 平铺,带「未知」标记); + 行级合计不单独展示(只展示明细),所以平铺不会重复 + 2. 盘点作业:行内上报(stock.check.report,**覆盖式**:同明细+同商品+同库位重复上报为更新) + · 行内「上报」→ CheckReportDialog 弹窗(可填实盘数量与「未匹配条码」): + 填了条码 → 后端按条码匹配系统商品,命中=已知商品;未命中记**未知商品**(无账面,实盘>0 即盘盈) + · 批量上报(仅商品类,行内数量列):逐行串行提交,不走弹窗 + 2b. 标记库位为空(stock.check.markEmpty,仅库位类任务的**无商品库位行**): + 写空标记记录(quantity=0、is_empty=1)并清除该库位下商品记录;空标记计入已盘, + 库位账面有库存时计入盘亏;已标记空的行展示「空库位」 tag。 + 3. 完成盘点(stock.check.finish,允许部分未盘完成: 未盘商品明细按实盘 0 计入盘亏与差异行数,未盘库位明细不计差异) - 4. 「添加商品 / 添加库位」交给宿主 index.vue 打开 CheckStockPickerDialog(emit add-items) + 4. 「添加商品 / 添加库位」交给宿主 index.vue 打开 CheckStockPickerDialog(emit add-items) + 5. 作业图片列:result 的 records[].images(RecordImages 缩略图 + 点击放大) 状态约束(与后端一致): - - created/rejected → 可添加明细(addDetail) + - created/rejected → 可添加明细(商品类 addDetail / 库位类 addLocationDetail) - approved/checking → 可上报(report)、可完成(finish) - mode=blind 盲盘 → 账面数量/差异在前端不可见 - 明细 status:checked=有作业记录 / unchecked=未盘 @@ -86,7 +94,13 @@ - + @@ -107,7 +121,19 @@ {{ formatLocationCodes(row) }} - + + + + + @@ -149,19 +175,34 @@ - - + + + + + + @@ -184,6 +225,17 @@ @current-change="handlePageChange" /> + + + @@ -193,9 +245,12 @@ import { ElMessage, ElMessageBox } from 'element-plus' import { useResizeObserver } from '@vueuse/core' import { getStatusTextClass } from '@/views/order/orderManagement/config/order-common-config' import { formatTime, isCheckApiSuccess, isLocationScopeType, translate } from '../template-config' +import RecordImages from './RecordImages.vue' +import CheckReportDialog from './CheckReportDialog.vue' import { stockCheckDetail, stockCheckFinish, + stockCheckMarkEmpty, stockCheckReport, stockCheckResult, type StockCheckReportParams @@ -220,7 +275,11 @@ const emit = defineEmits<{ // ============================================================ const taskId = computed(() => Number(props.row?.id) || 0) const taskStatus = computed(() => String(props.row?.status ?? '')) -/** created/rejected:可添加明细(addDetail:商品类传 stock_ids / 库位类传 locations) */ +/** + * created/rejected:可添加明细 + * - 商品类:addDetail 传 stock_ids + * - 库位类:勾选库位走 addLocationDetail(location_ids)/ 手填编码走 addDetail(locations) + */ const canAddItems = computed(() => ['created', 'rejected'].includes(taskStatus.value)) /** approved/checking:可上报实盘、可完成 */ const canReport = computed(() => ['approved', 'checking'].includes(taskStatus.value)) @@ -275,6 +334,37 @@ function rowStocks(item: Record): Record[] { return Array.isArray(item?.stocks) ? item.stocks : [] } +/** + * 行内未知商品聚合(result 的 unknown_items:stock_id 为空、按条码归组) + * + * 口径:无账面数量,差异 = 实盘 - 0(实盘 >0 即盘盈),已计入行级 checked_quantity/diff_quantity。 + * 商品行与库位行都可能有。 + */ +function rowUnknowns(item: Record): Record[] { + return Array.isArray(item?.unknown_items) ? item.unknown_items : [] +} + +/** + * 平铺行对应的作业图片(result 的 records[].images) + * + * - 库位行的商品行:该明细下同 stock_id 的记录 + * - 未知商品行:同条码且 stock_id 为空的记录 + * - 商品行:该明细全部记录 + */ +function rowImages(row: Record): any[] { + const records: Record[] = Array.isArray(row?.item?.records) ? row.item.records : [] + let matched = records + if (row?.stock) { + matched = records.filter((r) => Number(r?.stock_id) === Number(row.stock?.stock_id)) + } else if (row?.unknown) { + const barcode = String(row.unknown?.barcode ?? '') + matched = records.filter( + (r) => (r?.stock_id === null || r?.stock_id === undefined) && String(r?.barcode ?? '') === barcode + ) + } + return matched.flatMap((r) => (Array.isArray(r?.images) ? r.images : [])) +} + /** * 平铺行(表格数据源) * @@ -282,35 +372,60 @@ function rowStocks(item: Record): Record[] { * - 库位行(scope_type=location):将行内商品(result 的 stocks[])平铺为多行, * 一行一个商品,商品快照/账面数量/已盘/差异取商品(stock)的值; * 无商品时保留库位行本身(商品列显示 —,不可上报) + * - 未知商品(result 的 unknown_items)**仅库位类任务平铺为独立行**: + * 该行级合计不单独展示(库位类只展示 stocks 明细),所以平铺不会重复; + * 商品类行级聚合(checked_quantity 等)已含未知商品,故不额外平铺, + * 改为在商品名称列提示「含未知商品 N 项」,避免合计重复展示 * 每行带 `flat_key`(行 key)与 `item`(明细行,上报/库位等仍以明细为准) */ const flatRows = computed[]>(() => { const list: Record[] = [] for (const item of items.value) { const detailId = Number(item.id) || 0 + const unknowns = rowUnknowns(item) if (!isLocationTask.value) { - list.push({ ...item, flat_key: `d${detailId}`, detail_id: detailId, item }) + list.push({ ...item, flat_key: `d${detailId}`, detail_id: detailId, item, unknown_count: unknowns.length }) continue } const stocks = rowStocks(item) if (!stocks.length) { list.push({ ...item, flat_key: `d${detailId}`, detail_id: detailId, item }) - continue + } else { + for (const stock of stocks) { + list.push({ + ...item, + flat_key: `d${detailId}:s${stock.stock_id}`, + detail_id: detailId, + item, + stock, + item_code: stock.item_code ?? null, + item_name: stock.item_name ?? null, + spec: stock.spec ?? null, + batch_no: stock.batch_no ?? null, + system_quantity: stock.system_quantity ?? null, + checked_quantity: stock.checked_quantity ?? null, + diff_quantity: stock.diff_quantity ?? null + }) + } } - for (const stock of stocks) { + // 未知商品行(无账面,差异 = 实盘 - 0 = 盘盈) + for (const unknown of unknowns) { + const quantity = unknown?.checked_quantity ?? null list.push({ ...item, - flat_key: `d${detailId}:s${stock.stock_id}`, + flat_key: `d${detailId}:u${unknown?.barcode ?? ''}`, detail_id: detailId, item, - stock, - item_code: stock.item_code ?? null, - item_name: stock.item_name ?? null, - spec: stock.spec ?? null, - batch_no: stock.batch_no ?? null, - system_quantity: stock.system_quantity ?? null, - checked_quantity: stock.checked_quantity ?? null, - diff_quantity: stock.diff_quantity ?? null + unknown, + is_unknown: true, + item_code: unknown?.barcode ?? null, + item_name: unknown?.item_name ?? unknown?.barcode ?? null, + spec: null, + batch_no: null, + system_quantity: 0, + checked_quantity: quantity, + diff_quantity: quantity, + status: 'checked' }) } } @@ -335,6 +450,8 @@ const emptyText = computed(() => const dirtyRows = computed(() => { const list: ReportTarget[] = [] for (const row of flatRows.value) { + // 未知商品行是「已产生的作业记录」,不作为上报目标 + if (row.is_unknown) continue if (row.stock) { if (hasQuantity(stockQuantityMap[stockKey(row.item.id, row.stock.stock_id)])) { list.push({ item: row.item, stock: row.stock }) @@ -394,9 +511,11 @@ function handlePageChange() { nextTick(() => tableRef.value?.setScrollTop?.(0)) } -/** 该行是否可填实盘数量并上报(库位行需有对应商品库存;商品行直接可填) */ +/** 该行是否可上报(库位行需有对应商品库存且非未知商品行;商品行直接可报) */ function isReportableRow(row: Record): boolean { if (!canReport.value) return false + // 未知商品行已是作业记录,不是盘点范围行 + if (row?.is_unknown) return false return isLocationTask.value ? Boolean(row?.stock) : true } @@ -586,27 +705,110 @@ async function doReport(target: ReportTarget, silent = false): Promise } } -/** 行内上报(商品行) */ -async function reportRow(item: Record) { - const ok = await doReport({ item }) - if (!ok) return - // 覆盖式上报可能更新已有记录,明细行上的聚合字段需重拉 +// ============================================================ +// 行内上报弹窗(stock.check.report,支持「未匹配条码」→ 未知商品) +// ============================================================ +const reportDialogVisible = ref(false) +/** 「标记为空」进行中的明细ID(按钮 loading) */ +const markingEmptyId = ref(null) +/** 弹窗目标快照(打开时定格,避免表格重渲染后引用漂移) */ +const reportTarget = ref<{ + item: Record + stock: Record | null + location: string + quantity: number | null +} | null>(null) + +/** + * 打开上报弹窗(行内「上报」) + * + * - 库位行:需带 stock_id + 明细库位,数量取该行已填值 + * - 商品行:按明细商品上报,库位取行内填写值 + * - 两者均可另填「未匹配条码」,由后端按条码解析(命中=已知商品 / 未命中=未知商品) + */ +function openReportDialog(row: Record) { + const item = row?.item + if (!item) return + const stock = row?.stock ?? null + const location = stock + ? (resolveLocationCodes(item)[0] ?? '') + : String(locationMap[String(item.id)] ?? '').trim() + const rawQuantity = stock + ? stockQuantityMap[stockKey(item.id, stock.stock_id)] + : quantityMap[String(item.id)] + const quantity = + rawQuantity === undefined || rawQuantity === null || (rawQuantity as any) === '' + ? null + : Number(rawQuantity) + reportTarget.value = { + item, + stock, + location, + quantity: Number.isFinite(Number(quantity)) ? Number(quantity) : null + } + reportDialogVisible.value = true +} + +/** 上报成功:覆盖式上报可能更新已有记录,明细聚合字段需重拉 */ +async function handleReportSuccess() { + // 不复位 reportTarget:弹窗关闭动画期间保留内容,下次打开会整体覆盖 await loadItems() emit('changed') } -/** 行内上报(库位行的某个商品;report 需要 stock_id) */ -async function reportStock(item: Record, stock: Record) { - const ok = await doReport({ item, stock }) - if (!ok) return - await loadItems() - emit('changed') +// ============================================================ +// 标记库位为空(stock.check.markEmpty,库位盘点专用) +// ============================================================ +/** + * 该行是否可「标记为空」 + * + * 仅库位类任务 + 可上报状态(approved/checking),且该行是**没有商品记录的库位明细行** + * (有商品/未知商品的行走「上报」);已标记为空的不重复提供。 + */ +function canMarkEmpty(row: Record): boolean { + if (!canReport.value || !isLocationTask.value) return false + if (row?.is_unknown || row?.stock) return false + if (row?.item?.is_empty) return false + const scope = row?.item?.scope_type + return scope === undefined || scope === null || scope === '' || scope === 'location' } -/** 平铺行上报:有商品按商品上报,商品行直接按明细上报 */ -async function reportFlatRow(row: Record) { - if (row?.stock) await reportStock(row.item, row.stock) - else await reportRow(row.item) +/** + * 标记库位为空(stock.check.markEmpty) + * + * 等价于 report(is_empty=true):写空标记记录(quantity=0、is_empty=1),并**清除该库位下的商品记录**; + * 空标记计入已盘;库位账面有库存时计入盘亏差异。 + */ +async function handleMarkEmpty(row: Record) { + const detailId = Number(row?.item?.id) + if (!taskId.value || !Number.isFinite(detailId) || detailId <= 0) return + const location = formatLocationCodes(row?.item ?? row) + try { + await ElMessageBox.confirm( + `确认库位「${location}」为空?\n标记后该库位下的商品记录将被清除;若库位账面还有库存,会按盘亏计入差异。`, + '标记库位为空', + { confirmButtonText: '确认标记', cancelButtonText: '取消', type: 'warning' } + ) + } catch { + return + } + + markingEmptyId.value = detailId + try { + const res: any = await stockCheckMarkEmpty({ id: taskId.value, detail_id: detailId }) + if (!isCheckApiSuccess(res)) { + throw new Error(res?.message || '标记库位为空失败') + } + ElMessage.success('已将库位标记为空') + // 主表进度/差异由后端重算 → 重拉明细 + 通知宿主刷新列表 + await loadItems() + emit('changed') + } catch (e: any) { + console.error('[stockcheck] 标记库位为空失败', e) + ElMessage.error(e?.message || '标记库位为空失败') + } finally { + markingEmptyId.value = null + } } /** 批量上报:逐行串行提交,避免并发写同一盘点单 */ @@ -761,6 +963,11 @@ watch( color: #c0c4cc; } +/* 未知商品标记(result 的 unknown_items:条码匹配不到系统商品) */ +.unknown-tag { + margin-right: 4px; +} + .table-host { flex: 1; min-height: 120px; diff --git a/src/views/storage/stockcheck/config/components/CheckRecordsPanel.vue b/src/views/storage/stockcheck/config/components/CheckRecordsPanel.vue index b31d9e04..86cf81ba 100644 --- a/src/views/storage/stockcheck/config/components/CheckRecordsPanel.vue +++ b/src/views/storage/stockcheck/config/components/CheckRecordsPanel.vue @@ -1,88 +1,314 @@