优化
This commit is contained in:
@@ -42,9 +42,10 @@
|
||||
- SKU 数随机为 `1–4`，但不得超过本票总箱数。
|
||||
- 总箱数随机拆分到各 SKU，每个 SKU 至少 1 箱。
|
||||
- 毛重、净重、数量、申报价值和体积根据各 SKU 箱数计算。
|
||||
- 称重图片、托盘和占用库位数量必须与上述托数完全一致。
|
||||
- 称重图片数量与上述托数一致；每托只在既有 `TP-001`、`YW-TP-002` 中随机复用一个托盘编码，不创建新的托盘主档，因此同一票和不同票都允许重复使用这两个编码。
|
||||
- 库位由正式仓储预占/结算接口分配，不创建库位主档；普通库位不足时直接使用仓库公共位 `A0`。托盘复用不改变 `palletCount = ceil(totalPackageCount / 30)` 的业务托数。
|
||||
- 箱唛打印冻结真实总箱数；多 SKU 测量使用各 SKU 实际箱数和对应箱序号。
|
||||
- 通过正式文件、称重 OCR、托盘库位、测量提交和审核接口推进状态，不直接写数据库。
|
||||
- 通过正式文件、称重 OCR、托盘库位预占、测量提交和审核接口推进状态，不直接写数据库。
|
||||
|
||||
## 尽力执行语义
|
||||
|
||||
@@ -92,5 +93,6 @@ node scripts/it-test-wait-split-bulk.mjs `
|
||||
- 仅用于已明确授权的测试环境，禁止用于生产环境。
|
||||
- 账号、密码、Token 和环境地址只从本机环境配置加载，不进入源码或报告。
|
||||
- 不自动删除已成功或部分成功的数据。
|
||||
- 不新增托盘或库位主档；只能复用 `TP-001`、`YW-TP-002`，库位不足落公共位 `A0`。
|
||||
- 不重置数据库、不执行 SQL、不绕过正式状态机。
|
||||
- 清理测试数据或文件必须另行获得明确授权。
|
||||
|
||||
@@ -4,6 +4,8 @@
|
||||
|
||||
需要为人工联调批量准备同一客户、同一国内仓和同一渠道的 `WAIT_SPLIT` 数据时，使用[《批量待分柜数据生成指南》](批量待分柜数据生成指南.md)。该入口通过正式下单、入库、称重和测量接口生成数据，支持 FBA、海外仓、私人地址及一件代发等稳定随机组合；不得直接写库或用于生产环境。
|
||||
|
||||
固定“IT测试”客户与“义乌仓”、其余线路随机并尽力生成最多 8,000 票时，独立编排入口是 `../it-test-wait-split-bulk.mjs`。它仍复用本目录的 `orders.mjs` 与 `inbound-measurement.mjs`，但逐票保存日志且单票失败后继续。测量前置只随机复用既有 `TP-001`、`YW-TP-002`，不得调用托盘新增接口；库位由正式仓储接口分配，普通位不足时使用公共位 `A0`，不得调用库位新增接口。
|
||||
|
||||
订单造数中的 `GET /api/merchant/v1/partners/candidates?type=SHIPPER` 属于 Warehouse 正式客户候选能力。失败时订单脚本仍可使用 sender 快照继续收集后续链路证据，但 HTTP 503/`S0503` 必须保留为 deployment blocker，不能因订单、测量、分柜或装柜后续通过而降级为 coverage gap。
|
||||
|
||||
人工分柜采用两个可选模块，不进入默认全量入口：`manual-order-splitting-fixture.mjs` 基于本轮至少四票 `WAIT_SPLIT` 数据生成部分分配、整票拼柜和未分配对照清单；人工在 Admin 完成计划分配后，`manual-order-splitting-verify.mjs` 读取准备报告和 `loadingPlanId`，只读核对柜次范围、计划箱数及候选余量。完整命令见同一指南的“人工分柜验收”章节。
|
||||
|
||||
@@ -55,6 +55,7 @@
|
||||
- 固定渠道存在当前 `ACTIVE` 价格簿和进仓码前缀。
|
||||
- FBA/OVERSEAS 至少存在一个与固定渠道价格明细匹配的目的仓。
|
||||
- File、Order、Firstleg、Warehouse、IAM、Auth 等链路可用。
|
||||
- 测量托盘只复用仓库已有 `TP-001`、`YW-TP-002`；脚本不创建托盘主档。库位由正式仓储接口分配，普通位不足时使用公共位 `A0`，脚本不创建库位主档。
|
||||
|
||||
账号、密码、环境域名和 Token 不得写入本文、源码、提交记录或报告。建议由本地未提交环境文件或当前终端环境变量提供。
|
||||
|
||||
@@ -405,7 +406,7 @@ node scripts/admin-test-env-acceptance.mjs `
|
||||
|
||||
## 失败、重跑与批量拆分
|
||||
|
||||
- 批次遇到第一条失败即停止，已经成功创建的订单不会自动删除或回滚。
|
||||
- `admin-test-env-acceptance.mjs --wait-split-count` 的普通批次遇到第一条失败即停止；`it-test-wait-split-bulk.mjs` 会记录该票失败并继续尝试后续票。两种入口都不会自动删除或回滚已经成功创建的订单。
|
||||
- 先查看日志和 JSON 报告中最后一个成功 fixture、失败接口的 `code/requestId/traceId`，修复前置后再运行剩余数量。
|
||||
- 重跑会生成新业务单号和入仓码，不覆盖旧订单；不要假设跨多次运行的入仓码一定连续。
|
||||
- 每次运行的随机序列从 1 重新开始；分批执行时组合可能重复，但仍保持固定三项和真实契约。
|
||||
@@ -429,6 +430,7 @@ node scripts/admin-test-env-acceptance.mjs `
|
||||
|
||||
```powershell
|
||||
node --check scripts/admin-test-env-acceptance.mjs
|
||||
node --check scripts/it-test-wait-split-bulk.mjs
|
||||
node --check scripts/admin-test-env-modules/orders.mjs
|
||||
node --check scripts/admin-test-env-modules/manual-order-splitting-fixture.mjs
|
||||
node --check scripts/admin-test-env-modules/manual-order-splitting-verify.mjs
|
||||
@@ -440,7 +442,7 @@ node --check scripts/admin-test-env-modules/manual-pda-batch-fixture.mjs
|
||||
node --check scripts/admin-test-env-modules/manual-pda-batch-verify.mjs
|
||||
node --check scripts/admin-test-env-modules/manual-loading-complete-fixture.mjs
|
||||
node --check scripts/admin-test-env-modules/manual-loading-complete-verify.mjs
|
||||
node --test scripts/admin-test-env-modules/merchant-qualification-fixture-contract.test.mjs scripts/admin-test-env-modules/inbound-measurement-box-code-contract.test.mjs scripts/admin-test-env-modules/manual-order-splitting-contract.test.mjs scripts/admin-test-env-modules/manual-preload-push-contract.test.mjs scripts/admin-test-env-modules/manual-pda-ready-contract.test.mjs scripts/admin-test-env-modules/manual-pda-batch-contract.test.mjs scripts/admin-test-env-modules/manual-loading-complete-contract.test.mjs
|
||||
node --test scripts/script-documentation-contract.test.mjs scripts/admin-test-env-modules/it-test-wait-split-bulk-contract.test.mjs scripts/admin-test-env-modules/merchant-qualification-fixture-contract.test.mjs scripts/admin-test-env-modules/inbound-measurement-box-code-contract.test.mjs scripts/admin-test-env-modules/manual-order-splitting-contract.test.mjs scripts/admin-test-env-modules/manual-preload-push-contract.test.mjs scripts/admin-test-env-modules/manual-pda-ready-contract.test.mjs scripts/admin-test-env-modules/manual-pda-batch-contract.test.mjs scripts/admin-test-env-modules/manual-loading-complete-contract.test.mjs
|
||||
git diff --check
|
||||
```
|
||||
|
||||
|
||||
Reference in New Issue
Block a user