From f4db2401638744bb2c1a5d132f23f0f470b76598 Mon Sep 17 00:00:00 2001 From: yin <3313488199@qq.com> Date: Mon, 14 Sep 2026 18:07:40 +0800 Subject: [PATCH] 1 --- docs/命名规范-大小写与TS1261修复指南.md | 291 ++++++++++ src/api/storage.entry/entry.ts | 17 +- src/api/storage.inventory/inventory.ts | 82 +++ src/api/storage.stockout/stockout.ts | 43 +- src/utils/barcode.ts | 99 ++++ .../shipperSigning/index.vue | 2 +- .../components/UnpackDetailTable.vue | 515 +++++++++++++++-- src/views/express/returnUnpack/index.vue | 124 ++-- .../returnUnpack/returnUnpack-config.ts | 2 +- src/views/express/returnUnpackwork/index.vue | 532 +++++++++++++++--- .../utils/stock-picker-helpers.ts | 5 +- src/views/order/orderreview/index.vue | 15 +- src/views/stock/stock/component/recycle.vue | 3 +- src/views/stock/stock/stock-config.ts | 3 +- src/views/storage/entry/index.vue | 42 +- .../inventory/component/SpaceStockDialog.vue | 302 ++++++++++ .../inventory/component/panelstockdetail.vue | 17 +- src/views/storage/inventory/index.vue | 39 ++ .../storage/inventory/inventory-config.ts | 60 +- .../log/component/TransactionDetail.vue | 6 +- src/views/storage/log/index.vue | 21 +- src/views/storage/log/log-config.ts | 39 +- src/views/storage/stockout/component/log.vue | 1 - src/views/storage/stockout/index.vue | 124 +++- src/views/storage/stockout/stockout-config.ts | 49 +- src/views/store/shipperSigning/index.vue | 2 +- 26 files changed, 2124 insertions(+), 311 deletions(-) create mode 100644 docs/命名规范-大小写与TS1261修复指南.md create mode 100644 src/utils/barcode.ts create mode 100644 src/views/storage/inventory/component/SpaceStockDialog.vue diff --git a/docs/命名规范-大小写与TS1261修复指南.md b/docs/命名规范-大小写与TS1261修复指南.md new file mode 100644 index 00000000..ac7bf158 --- /dev/null +++ b/docs/命名规范-大小写与TS1261修复指南.md @@ -0,0 +1,291 @@ +# 命名规范与 TS1261(文件名大小写)修复指南 + +> **给 AI 助手的执行说明** +> 本文档用于修复本仓库在 Windows 上因「目录/文件名大小写不一致」导致的 `TS1261 / TS1149` 类型检查失败。 +> 第 4 节是**执行步骤**,第 5 节是**可直接运行的审计脚本**,第 6 节是**验收标准**,第 7 节是**禁止事项(务必先读)**。 +> 所有命令均为 PowerShell(Windows)。执行前请先读完第 2、3 节理解原理,避免"反向修复"。 + +--- + +## 1. 项目命名规范(硬性约定) + +| 范围 | 规范 | 示例 | +| --- | --- | --- | +| `src/api/` 的**一级目录名** | **必须全小写**,与 API 模块文档的 `folder` 字段完全一致 | `storewarehouse.warehouse`、`storewarehouse.store`、`storage.inventory`、`order.wave` | +| `src/api/` 目录名 | 允许小写字母、数字、`.`、`_`;**禁止驼峰** | ✅ `order.deliveryorder` ❌ `order.deliveryOrder` | +| `src/api/` 下的文件名 | 可以用驼峰(这是正常的) | `storeWarehouse.ts`、`inventory.ts` | +| 其它目录(`src/views`、`src/components` …) | 以 **git 索引为准**,磁盘必须与索引完全一致(索引里有驼峰目录是正常的,如 `src/views/Externalwarehouse`) | — | +| 代码里的 `import` 路径 | **大小写必须与磁盘(= git 索引)完全一致,逐字符匹配** | ✅ `@/api/storewarehouse.warehouse/storeWarehouse` | +| Git 配置 | 仓库级 `core.ignorecase` 必须为 `false` | `git config core.ignorecase false` | + +**判断"谁是对的"的唯一依据 = git 索引**: + +```powershell +git ls-tree --name-only HEAD:src/api # 看提交树里的真实目录名(权威) +git ls-files src/api # 看索引里的路径 +``` + +不要用「我本机磁盘是这样的」来当依据 —— Windows 磁盘改名对 git 可能不可见(见第 2 节)。 + +--- + +## 2. 为什么会报 TS1261(原理) + +报错原文形如: + +``` +error TS1261: Already included file name 'D:/repo/src/api/storeWarehouse.warehouse/storeWarehouse.ts' +differs from file name 'D:/repo/src/api/storewarehouse.warehouse/storeWarehouse.ts' only in casing. + The file is in the program because: + Imported via '@/api/storeWarehouse.warehouse/storeWarehouse' from file '.../shipperSigning/index.vue' + Matched by include pattern 'src/**/*' in 'tsconfig.app.json' +``` + +三个条件叠加导致: + +1. **Windows 文件系统不区分大小写**,因此 `storewarehouse.warehouse` 和 `storeWarehouse.warehouse` 在磁盘上"看起来"是同一个目录,很容易被改名而没人发现。 +2. `tsconfig.app.json` 使用 `"include": ["env.d.ts", "src/**/*", "src/**/*.vue"]` —— glob 是按**磁盘上的真实大小写**把文件收进编译程序的。 +3. TypeScript 的 `forceConsistentCasingInFileNames`(TS 5 起默认 `true`)会把"同一个文件以两种大小写被收录"判定为错误 → **TS1261 / TS1149**。 + +**关键推论**: + +> 同一个文件,只要 **import 里的大小写** 与 **磁盘上的真实大小写** 不一致,就必然报 TS1261。 +> 磁盘与 git 索引不一致时,改 import 只能让「本机通过」,代价是其它所有机器失败。 + +### 2.1 为什么 git 没记录这次改名 + +仓库级配置 `core.ignorecase = true`(Windows 上 git 的默认值)。 + +* 它让 git 认为文件系统大小写不敏感,于是**只改大小写的改名对 git 完全不可见**(`git status`、`git mv`、`git add` 都不反映)。 +* 结果:某台机器把磁盘目录改成了驼峰,**只有它本机变了**;git 索引/提交树里仍然是原来的小写目录。 +* 于是出现"镜像互坑":谁把 import 改成自己磁盘的样子,就把对方弄挂。 + +| 磁盘目录名 | 小写 import | 驼峰 import | +| --- | --- | --- | +| `storewarehouse.warehouse`(git 索引真值 / 所有正常克隆) | ✅ 通过 | ❌ TS1261 | +| `storeWarehouse.warehouse`(被改过名的机器) | ❌ TS1261 | ✅ 通过 | + +--- + +## 3. 本次案例的事实核对(2026-09 实测,可直接采信) + +| 项目 | 结论 | +| --- | --- | +| git 索引中 `src/api` 一级目录名 | **全部小写,无任何大写字母**(共 60 个一级目录) | +| `src/api/storewarehouse.warehouse` | 该目录在 git 索引 / 提交树中**始终是全小写**(`7afc669`、`9532289`、`cc9c0f7` 三个提交树一致) | +| 提交 `cc9c0f7` | 把两个页面的 import 从 `@/api/storewarehouse.warehouse/…` 改成 `@/api/storeWarehouse.warehouse/…`;`git ls-tree cc9c0f7:src/api/storeWarehouse.warehouse` → `fatal: Not a valid object name`(该路径在仓库中**不存在**) | +| 隔离实测(临时 worktree 检出 `cc9c0f7` + 独立 `vue-tsc --build --force`) | ❌ ExitCode=2,报 TS1261 | +| 隔离实测(把 import 回退为小写,即 `9532289` 状态) | ✅ ExitCode=0 | + +**结论:真值是小写。`cc9c0f7` 是反向修复,需要用「磁盘改名」而不是「改 import」来修复。** + +涉及的两个文件(import 行): + +* `src/views/Externalwarehouse/shipperSigning/index.vue` +* `src/views/store/shipperSigning/index.vue` + +正确写法: + +```ts +import { storeWarehouseWarehouseList } from '@/api/storewarehouse.warehouse/storeWarehouse' +import { storeWarehouseUnbind, storeWarehouseRename, storeWarehouseConfirmSign } from '@/api/storewarehouse.store/storeWarehouse' +``` + +--- + +## 4. 修复步骤(在「命名有问题的设备」上执行) + +### Step 0 — 保护本地工作 + +先把未提交的本地改动提交到自己的分支,或者 `git stash`。 + +> ⚠️ **在磁盘改名完成之前,绝对不要执行 `git add -A` / `git add .` / 提交**。否则错误的大小写会被写进 git 索引并推到远端,问题会扩散给所有人。 + +```powershell +git status --short +``` + +### Step 1 — 定位所有不一致(先看清单,再动手) + +先执行第 5 节的**审计脚本**,得到"索引名 vs 磁盘真实名"的不一致清单。 + +快速检测(把 git 临时切换成大小写敏感模式,不一致会显示成**成对**的 ` D …` + `?? …`): + +```powershell +git -c core.ignorecase=false -c core.quotepath=false status --porcelain +``` + +* 输出为空 → 磁盘与索引一致,跳到 Step 5。 +* 有输出 → 继续 Step 2,逐个改名。 + +### Step 2 — 改磁盘目录名(Windows 只改大小写**必须两步**) + +Windows 上直接 `Rename-Item a b`(仅大小写不同)会认为"名字没变"而失败,必须借道一个临时名: + +```powershell +# 目标:把 src\api 下被改成驼峰的目录改回索引里的小写名 +Set-Location <仓库根目录>\src\api + +Rename-Item -LiteralPath storeWarehouse.warehouse -NewName storeWarehouse.warehouse.__casefix +Rename-Item -LiteralPath storeWarehouse.warehouse.__casefix -NewName storewarehouse.warehouse +``` + +* 新名字**必须逐字符等于 git 索引里的名字**(本仓库 = 全小写)。 +* 目录内文件不用动(文件名的所属层级不变)。 +* 因为索引里本来就是小写,所以**不需要也不应该** `git mv`,改完 git 不会有任何 diff(这是正常的、期望的结果)。 + +确认磁盘真实名(**必须用精确正则**): + +```powershell +cmd /c dir /b src\api | Select-String -CaseSensitive -Pattern "^storewarehouse|^storeWarehouse" +``` + +期望:只有 `storewarehouse.store` 和 `storewarehouse.warehouse`;`^storeWarehouse` 一行都没有。 + +### Step 3 — 让 git 以后能发现这类问题 + +```powershell +git config core.ignorecase false # 仓库级配置,每台设备都要各自执行一次 +``` + +### Step 4 — 复核 + +```powershell +git status --short # 期望:干净,或只剩你自己的业务改动;不应再出现成对的 删除+未跟踪 +``` + +如仍有成对条目,回到 Step 2 继续改名,直到干净。 + +### Step 5 — 拉取并验收 + +```powershell +git pull + +# 自检 1:不应存在任何 "@/" 开头的驼峰 api 目录引用(期望:无输出) +git grep -n -E "@/api/[A-Z]" -- "src/**" + +# 自检 2:确认 api 引用与磁盘一致(期望:输出的目录名都是全小写) +git grep -n -E "@/api/[a-zA-Z]" -- "src/**" | Select-Object -First 20 + +# 自检 3:类型检查 +npm run type-check # 期望:ExitCode=0,无 TS1261 +``` + +### Step 6 — 兜底方案(最省事,推荐在无本地独有改动时使用) + +如果该设备本地没有独有改动(改动已推送或已丢弃),**直接删除目录重新 clone** 最稳:磁盘布局会按 git 索引一次性还原成正确大小写,不需要逐个改名。 + +```powershell +git push <自己的分支> # 如有本地提交 +# 然后重命名/删除旧目录,重新 git clone,再 npm install +``` + +--- + +## 5. 审计脚本(只读,不修改任何文件) + +保存为 `audit-case.ps1`,在**仓库根目录**执行:`powershell -ExecutionPolicy Bypass -File .\audit-case.ps1` + +* 输出 `OK: disk names match git index exactly ...` 表示大小写完全一致。 +* 对本仓库实测输出:`OK: disk names match git index exactly (checked 624 ASCII paths, skipped 14 non-ASCII paths)`。 +* 脚本刻意只用 ASCII 输出(中文在 GBK 终端下会乱码),并跳过含中文的路径(`docs/*.md` 等永远不会被 import,与 TS1261 无关)。 + +```powershell +# ===== 大小写一致性审计:对比 git 索引路径 与 磁盘真实路径 ===== +# 只读操作,不修改任何文件。 +$root = (git rev-parse --show-toplevel).Trim() +Set-Location $root + +$listingCache = @{} +function Get-Listing([string]$dir) { + if (-not $listingCache.ContainsKey($dir)) { + $listingCache[$dir] = @(Get-ChildItem -LiteralPath $dir -Force -ErrorAction SilentlyContinue) + } + return $listingCache[$dir] +} + +# 必须加 core.quotepath=false,否则含中文的路径会被 git 转义成 "\350\..." +$files = @(git -c core.quotepath=false ls-files) +$bad = [System.Collections.Generic.List[string]]::new() +$skipped = 0 + +foreach ($f in $files) { + if ($f -notmatch '^[\x20-\x7E]+$') { $skipped++; continue } + $segs = $f -split '/' + $cur = $root + for ($i = 0; $i -lt $segs.Count; $i++) { + $name = $segs[$i] + $items = Get-Listing $cur + $exact = $items | Where-Object { $_.Name -ceq $name } | Select-Object -First 1 + if ($exact) { $cur = $exact.FullName; continue } + # 磁盘上找不到「逐字符相同」的名字,但可能存在「仅大小写不同」的名字 + $ci = $items | Where-Object { $_.Name -ieq $name } | Select-Object -First 1 + if ($ci) { + $bad.Add("index: " + (($segs[0..$i]) -join '/') + " disk: " + $ci.Name + " (parent: " + $cur + ")") + } else { + $bad.Add("in index but missing on disk: " + (($segs[0..$i]) -join '/')) + } + break + } +} + +$bad = $bad | Sort-Object -Unique +if ($bad.Count -eq 0) { + Write-Host ("OK: disk names match git index exactly (checked " + ($files.Count - $skipped) + " ASCII paths, skipped " + $skipped + " non-ASCII paths)") +} else { + Write-Host ("Found " + $bad.Count + " case mismatch(es), rename the disk entry to the index name:") + $bad | ForEach-Object { Write-Host (" " + $_) } +} +``` + +**成对改名的辅助写法**(对审计结果里每一条 `index: xxx disk: XXX`): + +```powershell +$parent = "<父目录,来自审计输出的 (parent: …)>" +$diskName = "<磁盘上的真实名,来自审计输出的 disk:XXX>" +$indexName = "<索引里的名字,来自审计输出的 index:xxx 最后一段>" + +Set-Location $parent +Rename-Item -LiteralPath $diskName -NewName ($diskName + ".__casefix") +Rename-Item -LiteralPath ($diskName + ".__casefix") -NewName $indexName +``` + +--- + +## 6. 验收标准(全部满足才算修复完成) + +1. `git -c core.ignorecase=false -c core.quotepath=false status --porcelain` 输出为空(或只剩自己的业务改动)。 +2. 第 5 节审计脚本输出以 `OK:` 开头(且 `Found` 计数为 0)。 +3. `git grep -n -E "@/api/[A-Z]" -- "src/**"` 无输出。 +4. `npm run type-check` → `ExitCode=0`,无 `TS1261` / `TS1149`。 +5. `git config --get core.ignorecase` → `false`。 + +--- + +## 7. 禁止事项与常见坑 + +| 禁止 / 注意 | 说明 | +| --- | --- | +| ❌ 用「改 import 大小写」去适配自己本机的磁盘 | 这是本次问题的根源(提交 `cc9c0f7`)。真值在 git 索引里,不要在本地反向同步 | +| ❌ 在磁盘改名完成前执行 `git add -A` | 会把错误大小写写进索引并推到远端 | +| ❌ 单步 `Rename-Item a b`(仅大小写差异) | Windows 上会失败/无效,必须借道 `.__casefix` 再改回来 | +| ❌ 用 `Select-String -Pattern "store"` 判断目录大小写 | `storeWarehouse` 里也含 `store`,区分不出来。必须用 `-CaseSensitive -Pattern "^storewarehouse"` / `"^storeWarehouse"` | +| ❌ 用 `findstr /i`、`grep -i` 判断大小写 | 同上,必须区分大小写 | +| ❌ PowerShell `Remove-Item -Recurse` | 5.1 下可能递归删除**链接目标**的内容;删 junction 请用 `cmd /c rmdir ""`(不带 `/s`) | +| ⚠️ 用 junction 把 `node_modules` 链接进临时 git worktree,再 `git worktree remove --force` | git 会递归进 junction,**删除主工作区 `node_modules` 里排序靠前的条目**(`.bin`、`.package-lock.json`、`.modules.yaml` 等)。正确清理顺序:先 `cmd /c rmdir "\node_modules"`,再 `Remove-Item -Recurse -Force`,最后 `git worktree prune`;万一已误删,主工作区 `npm install` 可恢复 | +| ⚠️ `core.ignorecase=false` 的执行时机 | 必须在磁盘改名**之后**再开启。若磁盘仍是驼峰就开启,`git status` 会立刻出现大量成对的「删除 + 未跟踪」,此时**不要** `git add` | +| ⚠️ `git grep` 与 `Select-String` 的默认行为 | `git grep` 默认区分大小写;PowerShell `Select-String` 默认**不区分**,需要 `-CaseSensitive` | + +--- + +## 8. 相关提交与文件索引 + +| 对象 | 说明 | +| --- | --- | +| `cc9c0f7` | ❌ 反向修复:把 2 处 import 改成驼峰 `@/api/storeWarehouse.warehouse/…`,在所有磁盘为小写的机器上复现 TS1261 | +| `9532289` | `cc9c0f7` 的父提交,import 为正确的小写 | +| `7afc669` | 更早的提交,同样是小写 | +| `src/views/Externalwarehouse/shipperSigning/index.vue` | import 行约 143 行 | +| `src/views/store/shipperSigning/index.vue` | import 行约 195 / 196 行 | +| `tsconfig.app.json` | `include: ["env.d.ts", "src/**/*", "src/**/*.vue"]`,TS1261 的触发条件之一 | +| `package.json` | `type-check` = `vue-tsc --build` | diff --git a/src/api/storage.entry/entry.ts b/src/api/storage.entry/entry.ts index 20e1af4b..d17f8a98 100644 --- a/src/api/storage.entry/entry.ts +++ b/src/api/storage.entry/entry.ts @@ -271,24 +271,39 @@ export function getEntryDetailStore(data: GetEntryDetailParams): Promise { return request({ url: '/system', diff --git a/src/api/storage.inventory/inventory.ts b/src/api/storage.inventory/inventory.ts index 0243f4f9..2812c9da 100644 --- a/src/api/storage.inventory/inventory.ts +++ b/src/api/storage.inventory/inventory.ts @@ -45,6 +45,88 @@ export function getInventoryListByStockId(data: { stock_id: number; group_by_spa } as any) } +/** storage.inventory.listBySpaceId 请求参数 */ +export type InventoryListBySpaceIdParams = { + /** 库位ID(wms_location_space.id,必填) */ + space_id: number +} + +/** storage.inventory.listBySpaceId 响应 data.space(库位信息) */ +export type InventorySpaceInfo = { + /** 库位ID */ + id?: number + /** 所属仓库ID */ + warehouse_id?: number + /** 库位编码 */ + space_code?: string + /** 自定义名称 */ + custom_name?: string + /** 库位状态 */ + space_status?: number | string + [key: string]: unknown +} + +/** storage.inventory.listBySpaceId 响应 data.list 列表项(按商品 stock_id 汇总为一条) */ +export type InventorySpaceStockItem = { + warehouse_id?: number + store_id?: number + space_id?: number + stock_id?: number + /** 汇总数量 */ + quantity?: number + /** 汇总锁定数量 */ + locked_quantity?: number + /** 汇总拦截锁定数量 */ + intercept_locked_quantity?: number + /** 汇总可用数量 */ + available_quantity?: number + /** 批次数 */ + batch_count?: number + /** 最早入库时间(空为 '') */ + first_inbound_time?: string + /** 最晚入库时间(空为 '') */ + last_inbound_time?: string + /** 库位编码 */ + space_code?: string + /** 库位名称(custom_name 优先,否则 space_code) */ + space_name?: string + /** 货主名称(当前仓库签约表 store_remask,未命中为 null) */ + store_name?: string | null + /** stock_warehouse 通用商品属性对象(未命中为 null):id/item_code/item_name/sku_property/quantity/locked_quantity/is_batch_mgmt/is_shelf_life_mgmt/is_images/need_recheck/store_id/packing_requirements/stock_unit/barcodes/image_url */ + stock?: Record | null + [key: string]: unknown +} + +/** storage.inventory.listBySpaceId 响应 */ +export type InventoryListBySpaceIdResponse = { + code?: number + message?: string + data?: { + space?: InventorySpaceInfo + list?: InventorySpaceStockItem[] + } +} + +/** + * 按库位查询库存商品列表 + * - 入参 space_id 必填;先校验该库位归属当前登录仓库(库位不存在返回 404,存在但不属于本仓库返回 400) + * - 返回该库位下有量库存(quantity > 0)的商品列表,按商品(stock_id)汇总为一条 + * - 该库位无有量库存时 list 为空数组 + */ +export function getInventoryListBySpaceId(data: InventoryListBySpaceIdParams): Promise { + return request({ + url: '/system', + method: 'post', + params: { + method: 'storage.inventory.listBySpaceId', + v, + timestamp: new Date().getTime() + }, + data, + isSystemApi: true + } as any) +} + export function quickPutaway(data: { receiving_id: number; id?: number }): Promise { const body: Record = { ...data } if (body.receiving_id === undefined && body.id != null) { diff --git a/src/api/storage.stockout/stockout.ts b/src/api/storage.stockout/stockout.ts index 44e00751..87a5af05 100644 --- a/src/api/storage.stockout/stockout.ts +++ b/src/api/storage.stockout/stockout.ts @@ -149,15 +149,26 @@ export type StockoutConfirmParams = { export type StockoutConfirmResponse = { id: number stockout_order_code: string + /** 确认后状态(COMPLETED) */ order_status: string + /** 物流公司名称(当前实现固定返回字符串 OTHER) */ logisticsName: string - /** 运单号(取自表中 express_code 字段) */ + /** 快递公司编码(取自 wms_order_stockout.express_code):**历史遗留命名,实际语义是快递公司编码而非运单号**(运单号见 waybill_codes) */ expressCode: string - /** 运单号列表(取自表中 express_codes 字段) */ - expressCodes?: string[] + /** 当前实现取自已废弃字段 wms_order_stockout.express_codes(通常为 null):**运单号请以 waybill_codes 为准**,本字段待代码侧收敛,不应作为展示/回写依据 */ + expressCodes?: string[] | null + /** 外部回传结果:success=通知成功,failure=通知失败(确认本身不受影响);字段名为历史遗留,API/WMS 来源同样复用该字段 */ + qimenSync: string + /** 外部回传失败时的错误信息 */ + qimenSyncMessage?: string } -/** 直出确认出库单:不改变内部库存,按出库单明细计划数量(plan_qty)直接确认,状态推进到 COMPLETED。要求 express_code 已填写 */ +/** + * 直出确认出库单:不改变内部库存,按出库单明细计划数量(plan_qty)直接确认,成功后状态推进到 COMPLETED 并释放创建时占用的库存锁定(QM_STOCKOUT) + * - 运单号以 `waybill_codes`(复数,支持一单多运单)为准;单数 `waybill_code` 已弃用,仅在复数缺失时对存量单兼容回退 + * - 出站回传按 source_type 分流:QM→奇门;API→OpenAPI 回调;WMS 等内部来源直接视为成功 + * - 回传结果见响应 `qimenSync`:failure 时确认仍成功(order_status=COMPLETED),仅 sync_status 标记 FAILED 可重试 + */ export const stockoutConfirm = (data: StockoutConfirmParams) => { return request({ url: `/system`, @@ -173,23 +184,37 @@ export const stockoutConfirm = (data: StockoutConfirmParams) => { // ── storage.stockout.updateExpress ── +/** storage.stockout.updateExpress 请求参数(未传入的字段不会更新;三个字段都未传时后端返回「没有需要更新的字段」) */ export type StockoutUpdateExpressParams = { /** 出库单ID(必填) */ id: number - /** 运单号 */ + /** 快递公司编码(**非运单号**,如 SF/STO/ZT):传入后后端自动解析 express_name,传空值则 express_code/express_name 置 NULL */ express_code?: string - /** 运单号列表(JSON 数组) */ - express_codes?: string[] + /** 运单号列表(JSON 数组或 null,支持一单多运单);回传与确认校验以此为准,传空数组或 null 表示清空;非数组返回 400 */ + waybill_codes?: string[] | null + /** 【已弃用】单数运单号:仅作 waybill_codes 首个的镜像,勿单独使用 */ + waybill_code?: string } +/** storage.stockout.updateExpress 响应 */ export type StockoutUpdateExpressResponse = { id: number stockout_order_code: string + /** 更新后的快递公司编码 */ express_code?: string - express_codes?: string[] + /** 由 express_code 解析出的快递公司名称(未匹配到为空串) */ + express_name?: string + /** 更新后的运单号列表(以此为准) */ + waybill_codes?: string[] + /** 【已弃用】单数列镜像值(等于 waybill_codes 首个) */ + waybill_code?: string } -/** 更新出库单的运单号字段(express_code / express_codes),用于在确认前填写运单信息 */ +/** + * 更新出库单的快递公司与运单号(确认前填写运单信息) + * - `express_code` 是**快递公司编码**,不是运单号 + * - 运单号统一走 `waybill_codes`(复数数组);`waybill_code` 已弃用,`express_codes` 已废弃(不在本接口读写范围内) + */ export const stockoutUpdateExpress = (data: StockoutUpdateExpressParams) => { return request({ url: `/system`, diff --git a/src/utils/barcode.ts b/src/utils/barcode.ts new file mode 100644 index 00000000..450978bd --- /dev/null +++ b/src/utils/barcode.ts @@ -0,0 +1,99 @@ +/** + * 条码/编码类字段的统一归一化工具。 + * + * 背景:后端同一语义字段在不同接口返回结构不一致,常见形态有: + * - `["abc", "def"]` 字符串数组 + * - `[{ id: 1, barcode: "abc" }]` 对象数组(如 `stock.barcodes`) + * - `'["abc","def"]'` JSON 字符串 + * - `"abc|def"` 分隔符拼接字符串 + * 若直接 `String(item)` 强转,对象会被渲染成 `[object Object]`,故统一由此处理。 + */ + +/** 对象型条码项中可能承载条码文本的字段(按优先级) */ +const BARCODE_TEXT_KEYS = ['barcode', 'barcode_no', 'bar_code', 'code', 'value', 'name', 'label'] as const + +/** 从单个条码项提取文本:兼容字符串/数字/对象,无法提取时返回空串 */ +export function pickBarcodeText(item: unknown): string { + if (item === null || item === undefined) return '' + if (typeof item === 'string' || typeof item === 'number') return String(item).trim() + if (typeof item === 'object') { + const record = item as Record + for (const key of BARCODE_TEXT_KEYS) { + const value = record[key] + if (value === null || value === undefined) continue + // 仅接受基础类型,避免嵌套对象再次产生 [object Object] + if (typeof value === 'object') continue + const text = String(value).trim() + if (text) return text + } + return '' + } + return '' +} + +export interface NormalizeBarcodeOptions { + /** 字符串形态是否按分隔符拆分(默认 true,如 "a|b" → ["a", "b"]) */ + splitText?: boolean + /** 字符串拆分使用的分隔符(默认 ['|', ',']) */ + separators?: string[] +} + +function normalizeBarcodeArray(list: unknown[]): string[] { + const result: string[] = [] + for (const item of list) { + if (Array.isArray(item)) { + result.push(...normalizeBarcodeArray(item)) + continue + } + const text = pickBarcodeText(item) + if (text) result.push(text) + } + return result +} + +/** + * 归一化条码列表并过滤空值;支持数组(字符串/对象/嵌套数组)、JSON 字符串数组、 + * 以及分隔符拼接的字符串。无法提取到条码的项会被丢弃(不会产生 `[object Object]`)。 + */ +export function normalizeBarcodeList(value: unknown, options: NormalizeBarcodeOptions = {}): string[] { + const { splitText = true, separators = ['|', ','] } = options + if (value === null || value === undefined) return [] + + if (Array.isArray(value)) return normalizeBarcodeArray(value) + + if (typeof value === 'object') { + const text = pickBarcodeText(value) + return text ? [text] : [] + } + + const raw = String(value).trim() + if (!raw || raw === '[]' || raw === '[""]' || raw === '[ ]') return [] + + // JSON 字符串形态:["a","b"] / [{"barcode":"a"}] + if (raw.startsWith('[') && raw.endsWith(']')) { + try { + const parsed = JSON.parse(raw) + if (Array.isArray(parsed)) return normalizeBarcodeArray(parsed) + } catch { + // 非合法 JSON,按普通文本继续处理 + } + } + + if (!splitText || !separators.length) return [raw] + + const parts = separators.reduce( + (acc, separator) => acc.flatMap((part) => (separator ? part.split(separator) : [part])), + [raw] + ) + return parts.map((part) => part.trim()).filter(Boolean) +} + +/** 条码展示文本:按分隔符连接,无有效条码时返回 fallback */ +export function formatBarcodeText( + value: unknown, + options: NormalizeBarcodeOptions & { separator?: string; fallback?: string } = {} +): string { + const { separator = '|', fallback = '--' } = options + const items = normalizeBarcodeList(value, options) + return items.length ? items.join(separator) : fallback +} diff --git a/src/views/Externalwarehouse/shipperSigning/index.vue b/src/views/Externalwarehouse/shipperSigning/index.vue index 20c96c9c..44bcb558 100644 --- a/src/views/Externalwarehouse/shipperSigning/index.vue +++ b/src/views/Externalwarehouse/shipperSigning/index.vue @@ -140,7 +140,7 @@ import { ref, reactive, onMounted } from 'vue' import { ElMessage } from 'element-plus' import { Search, Refresh } from '@element-plus/icons-vue' -import { storeWarehouseWarehouseList } from '@/api/storeWarehouse.warehouse/storeWarehouse' +import { storeWarehouseWarehouseList } from '@/api/storewarehouse.warehouse/storeWarehouse' import ScanBox from '@/components/ScanBox/index.vue' import UpperTable from '@/components/UpperTable/index.vue' diff --git a/src/views/express/returnUnpack/components/UnpackDetailTable.vue b/src/views/express/returnUnpack/components/UnpackDetailTable.vue index daae270c..1e903aa3 100644 --- a/src/views/express/returnUnpack/components/UnpackDetailTable.vue +++ b/src/views/express/returnUnpack/components/UnpackDetailTable.vue @@ -1,63 +1,342 @@ + + diff --git a/src/views/storage/inventory/component/panelstockdetail.vue b/src/views/storage/inventory/component/panelstockdetail.vue index c98ced12..5ccb36c4 100644 --- a/src/views/storage/inventory/component/panelstockdetail.vue +++ b/src/views/storage/inventory/component/panelstockdetail.vue @@ -9,6 +9,14 @@ > + 刷新 + + 按明细 按库位汇总 - - 刷新 - + {{ row.batch_count || 0 }} + + @@ -142,6 +154,12 @@ + + void> = { openColumnConfigPanel: () => openColumnConfigPanel(), toggleDetailVisible: () => toggleDetailVisible(), handleImport: () => handleImport(), + openSpaceStock: () => openSpaceStock(), confirmBatchCancel: () => { void confirmBatchCancel() } } @@ -587,6 +607,25 @@ function handleCreateEntry() { ElMessage.info('新建入库单') } +// ── 库位商品查询(storage.inventory.listBySpaceId)── +const spaceStockVisible = ref(false) +const spaceStockSpaceId = ref(null) +const spaceStockKeyword = ref('') + +/** 取行上的库位ID(汇总模式多库位时可能为空) */ +function getRowSpaceId(row: any): number | null { + const id = Number(row?.space_id) + return Number.isInteger(id) && id > 0 ? id : null +} + +/** 打开库位商品弹窗;不传行则由用户在弹窗内扫码/输入库位 */ +function openSpaceStock(row?: any) { + const id = row ? getRowSpaceId(row) : null + spaceStockSpaceId.value = id + spaceStockKeyword.value = id ? String(row?.space_code ?? '') : '' + spaceStockVisible.value = true +} + async function confirmBatchCancel() { if (!selectionRows.value.length) { diff --git a/src/views/storage/inventory/inventory-config.ts b/src/views/storage/inventory/inventory-config.ts index d49aa016..47bb8fd8 100644 --- a/src/views/storage/inventory/inventory-config.ts +++ b/src/views/storage/inventory/inventory-config.ts @@ -1,6 +1,7 @@ import { stockQueryScanField } from '@/views/order/orderManagement/config/order-common-config' import type { ToolbarButtonConfig } from '@/views/order/orderManagement/config/order-common-config' +import { normalizeBarcodeList } from '@/utils/barcode' /** 库存列表主工具栏按钮(action 与 inventory/index.vue 内 toolbarActionMap 键一致) * 排序与样式分类对齐 storage/receiving: @@ -37,6 +38,13 @@ export const inventoryToolbarButtons: ToolbarButtonConfig[] = [ size: 'small', action: 'handleImport' }, + { + key: 'spaceStock', + label: '库位商品', + category: 'action', + size: 'small', + action: 'openSpaceStock' + }, { key: 'batchCancel', label: '批量作废', @@ -105,39 +113,9 @@ export function formatInventorySpaceLabel(space?: Record | null, fa return name || fallback } -/** 解析商品条码并过滤空值 */ +/** 解析商品条码并过滤空值(兼容字符串数组与 `{ id, barcode }` 对象数组) */ export function normalizeInventoryBarcodesList(value: unknown): string[] { - if (value === null || value === undefined || value === '') return [] - - if (Array.isArray(value)) { - return value - .map((item) => String(item ?? '').trim()) - .filter(Boolean) - } - - if (typeof value === 'string') { - const text = value.trim() - if (!text || text === '[""]' || text === '[]') return [] - if (text.startsWith('[') && text.endsWith(']')) { - try { - const parsed = JSON.parse(text) - if (Array.isArray(parsed)) { - return parsed - .map((item) => String(item ?? '').trim()) - .filter(Boolean) - } - } catch { - // ignore invalid json - } - } - if (text.includes('|')) { - return text.split('|').map((item) => item.trim()).filter(Boolean) - } - return [text] - } - - const text = String(value).trim() - return text ? [text] : [] + return normalizeBarcodeList(value, { separators: ['|'] }) } /** 商品条码展示:数组用 | 连接,忽略空条码 */ @@ -226,6 +204,24 @@ export const productstockColums = [ { prop: 'last_inbound_time', label: '最后入库时间', width: '160' }, ] +/** 库位商品弹窗表格列(storage.inventory.listBySpaceId 响应 data.list,按 stock_id 汇总) */ +export const spaceStockColumns = [ + { prop: 'stock_id', label: '商品ID', width: '100' }, + { prop: 'item_code', label: '商品编码', width: '150' }, + { prop: 'item_name', label: '商品名称', width: '200' }, + { prop: 'barcodes', label: '商品条码', width: '150' }, + { prop: 'sku_property', label: '规格', width: '140' }, + { prop: 'stock_unit', label: '单位', width: '80' }, + { prop: 'store_name', label: '货主', width: '120' }, + { prop: 'quantity', label: '总数量', width: '100' }, + { prop: 'available_quantity', label: '可用数量', width: '100' }, + { prop: 'locked_quantity', label: '锁定数量', width: '100' }, + { prop: 'intercept_locked_quantity', label: '拦截锁定', width: '100' }, + { prop: 'batch_count', label: '批次数', width: '80' }, + { prop: 'first_inbound_time', label: '最早入库时间', width: '160' }, + { prop: 'last_inbound_time', label: '最晚入库时间', width: '160' } +] + export const productstockDetail = [ { prop: 'id', label: 'ID', width: '80' }, { prop: 'sku_code', label: '商品编码', width: '150' }, diff --git a/src/views/storage/log/component/TransactionDetail.vue b/src/views/storage/log/component/TransactionDetail.vue index e5984c7d..014b4eef 100644 --- a/src/views/storage/log/component/TransactionDetail.vue +++ b/src/views/storage/log/component/TransactionDetail.vue @@ -2,8 +2,8 @@
- - {{ row?.transaction_type === 'INBOUND' ? '入库' : '出库' }} + + {{ getTransactionTypeText(row?.transaction_type) }} {{ row?.stock_id ?? '—' }} @@ -22,7 +22,7 @@