diff --git a/.tmp-def-form.txt b/.tmp-def-form.txt new file mode 100644 index 00000000..402928de --- /dev/null +++ b/.tmp-def-form.txt @@ -0,0 +1,161 @@ + diff --git a/docs/进度条弹窗-使用清单.md b/docs/进度条弹窗-使用清单.md index 62622542..60e15a98 100644 --- a/docs/进度条弹窗-使用清单.md +++ b/docs/进度条弹窗-使用清单.md @@ -7,6 +7,7 @@ > `components/task-progress/UnifiedTaskProgressDialog.vue`(猎豹进度条)渲染, > 组件名与页面调用方式保持不变。 > 任务完成后弹窗保持打开并展示完成状态,由用户手动关闭(导出、抓取、波次批量任务同样)。 +> **例外**:波次策略快速扫描弹窗扫描成功后 **1.5 秒自动关闭**(失败保持打开,见下方第 4 项)。 > > 示例入口:`order/waveOrder?tab=sandanFallbackOrders` → 「不符合波次策略订单列表」→ 工具栏「快速扫描」→ 波次策略快速扫描进度弹窗。 @@ -75,6 +76,7 @@ - `views/order/waveOrder/GroupWaveBatchListPanel.vue` ← `tab=groupWave` 团购波次 - 触发:工具栏「快速扫描」(`wave-config.ts` 中 `label: '快速扫描'`) - 已改为基于 `UnifiedTaskProgressDialog` 渲染(猎豹进度条);扫描中可「后台运行」关闭弹窗,轮询继续,任务结束后刷新列表。 +- **扫描成功后 1.5 秒自动关闭弹窗**(`AUTO_CLOSE_DELAY = 1500`,与导出进度弹窗一致);失败(failed / not_found)不自动关闭,便于查看错误信息。 ### 5. `views/order/waveOrder/component/WaveFetchTaskProgressDialog.vue` - 标题:`抓取任务` diff --git a/src/api/stock.check/stock.check.ts b/src/api/stock.check/stock.check.ts index 1f12c9a4..41b2d68f 100644 --- a/src/api/stock.check/stock.check.ts +++ b/src/api/stock.check/stock.check.ts @@ -35,6 +35,12 @@ export type StockCheckEnvelope = { * is_static=1 的任务在 approved/checking 期间锁定其商品范围内的 stock_id, * 完成/取消后解除 —— 库存操作(移库 / 分配储位等)前置判断可调 stockCheckStaticLockList。 * + * 静态盘点拣货完成标记(2026-10-29 文档新增 `picking_completed`): + * 静态盘点任务(is_static=1)中,商品须「仓库内锁定数量为 0(拣货完成)」才允许上报, + * 否则 report 返回 400「商品尚未完成拣货,不满足静态盘点要求…」。 + * 前端可提前读取该标记给提示:workData 的 space 视图 `rows[].goods[].picking_completed`、 + * workDataDetail 商品钻取 `data.picking_completed`(另有顶层 `locked_quantity` 锁定量合计)。 + * * 作业数据(workData 家族,2026-10-07 文档更新): * · workData —— 三视图(location/goods/space),服务端分页,新增 keyword / only_abnormal 入参, * **不再返回 check**(任务信息请调 detail) @@ -1010,14 +1016,27 @@ export type StockCheckWorkLocationRow = { export type StockCheckWorkGoodsLocation = { /** 空库位归 location_code=null 组 */ location_code?: string | null + /** + * 该库位盘点明细ID(wms_stock_check_detail.id,无明细快照的库位为 null) + * + * 📌 文档 `workData` goods 视图 locations 显式列出(可直接回传 `stock.check.report`) + */ + detail_id?: number | null checked_at?: string | null checker_name?: string | null /** 该库位该商品全部作业记录 ID(按记录 id 升序,供编辑/移除单条记录) */ record_ids?: number[] /** 该库位该商品全部作业照片(扁平去重) */ images?: StockCheckWorkImage[] - /** 该库位账面数量(=可用+锁定;仅明盘) */ + /** + * 该库位账面数量(仅明盘) + * + * ⚠️ 口径 = **可用数量**(wms_storage `SUM(available_quantity)`), + * **不含锁定**;无库存记录的库位为 0。 + */ system_quantity?: number | null + /** 该库位账面**快照**(盘点开始时的账面;仅明盘) */ + snapshot_quantity?: number | null /** 该库位锁定数量(仅明盘) */ locked_quantity?: number | null /** 该库位实盘数量(未盘库位 0;仅明盘) */ @@ -1075,6 +1094,16 @@ export type StockCheckWorkSpaceGoods = { checked_quantity?: number | null /** 该库位该商品全部作业记录 ID(2026-10-07 文档新增) */ record_ids?: number[] + /** + * 该商品是否**已完成拣货**(📌 2026-10-29 文档新增;**仅静态盘点 `is_static=1` 返回**,明盘/盲盘均返回) + * + * 1=已完成 / 0=未完成;口径=仓库内该商品 `wms_storage SUM(locked_quantity)` 是否为 0, + * 按商品维度判定(同一商品各库位行取值一致)。 + * + * ⚠️ 为 0 时该商品**不可上报**:`stock.check.report` 会返回 400 + * 「商品尚未完成拣货,不满足静态盘点要求,请先等待该商品完全完成拣货」。 + */ + picking_completed?: 0 | 1 | number | boolean | null [key: string]: unknown } @@ -1098,6 +1127,13 @@ export type StockCheckWorkSpaceRow = { custom_barcode?: string | null /** 库位自定义名称(空为 null,不兜底 space_code) */ custom_name?: string | null + /** + * `id` 同义字段(库位ID wms_location_space.id) + * + * 📌 文档显式输出:便于与 location/goods 视图、recordList、result 统一命名, + * 并可直接回传 `stock.check.report`(其库位参数就叫 `space_id` / `location_id`) + */ + location_id?: number | null /** 该库位下的任务商品 */ goods?: StockCheckWorkSpaceGoods[] [key: string]: unknown @@ -1263,7 +1299,7 @@ export type StockCheckWorkDetailGoodsRow = { /** 作业记录照片 */ images?: StockCheckWorkImage[] /** - * 该库位**当前**账面(wms_storage 可用+锁定;仅明盘) + * 该库位**当前账面数量**(wms_storage 可用数量;仅明盘) * * ⚠️ 静态盘点(is_static=1)时**不参与差异计算**,参与计算的是 `snapshot_quantity`。 */ @@ -1306,6 +1342,9 @@ export type StockCheckWorkDetailGoodsSummary = { * · is_static=0(普通盘点)→ `system_quantity` 取**当前** wms_storage 账面 SUM(available_quantity+locked_quantity) * 两种口径都会额外输出 `storage_quantity`(当前 storage 账面)与 `snapshot_quantity`(明细快照)供对照, * `system_quantity` 始终是参与差异计算的那个账面;`book_source` 标识来源(snapshot|storage)。 + * + * 📌 2026-10-29 文档新增:静态盘点(is_static=1)时顶层另返回 + * `picking_completed`(1=已完成拣货 / 0=未完成)与 `locked_quantity`(该商品仓库内锁定量合计,仅明盘)。 */ export type StockCheckWorkDetailGoods = { /** 盘点任务ID */ @@ -1324,6 +1363,21 @@ export type StockCheckWorkDetailGoods = { is_static?: boolean | number | null /** 账面来源:snapshot=取明细快照 / storage=取当前 storage 账面 */ book_source?: 'snapshot' | 'storage' | string + /** + * 该商品是否**已完成拣货**(📌 2026-10-29 文档新增;**仅静态盘点 `is_static=1` 返回**) + * + * 1=已完成 / 0=未完成;口径=仓库内该商品 `wms_storage SUM(locked_quantity)` 是否为 0。 + * ⚠️ 为 0 时该商品**不可上报**(`stock.check.report` 返回 400「商品尚未完成拣货…」), + * 前端可在商品钻取视图据此给「拣货中」提示,避免直接提交被拒。 + */ + picking_completed?: 0 | 1 | number | boolean | null + /** + * 该商品**仓库内锁定量合计**(`wms_storage SUM(locked_quantity)`;**仅明盘**返回) + * + * 📌 2026-10-29 文档新增(静态盘点商品钻取顶层);> 0 即存在在途出库未拣完, + * 与 `picking_completed=0` 同源。 + */ + locked_quantity?: number | null /** 商品级汇总(**仅明盘**;盲盘不返回 summary 与任何数量字段) */ summary?: StockCheckWorkDetailGoodsSummary /** 按库位分行(顺序与 workData goods 视图 locations 一致) */ @@ -1388,6 +1442,8 @@ export type StockCheckWorkDataDetailParams = * · 库位明细(scope_type=location)→ 结构同 workData 的 location 视图单行 * · 商品钻取(id + stock_id,或 detail_id 指向商品范围行)→ `StockCheckWorkDetailGoods` * (商品级汇总 summary + 按库位分行 rows;账面口径随任务 is_static 区分,见该类型注释) + * - 静态盘点(is_static=1)商品钻取顶层另含 `picking_completed`(1=已完成拣货/0=未完成) + * 与 `locked_quantity`(商品仓库内锁定量合计,仅明盘)—— 2026-10-29 文档新增 * - 仅任务 `approved`(待盘点)/ `checking`(盘点中)可拉取(与 workData 同口径) */ export function stockCheckWorkDataDetail( diff --git a/src/utils/videoDiagnose.ts b/src/utils/videoDiagnose.ts new file mode 100644 index 00000000..5d4892c0 --- /dev/null +++ b/src/utils/videoDiagnose.ts @@ -0,0 +1,129 @@ +/** + * 录像播放失败原因诊断 + * + * `