密集库出库、移库与 WCS 下发验收报告

验收结论

本次实现已完成代码级回归、生产构建、数据库迁移幂等验证、真实只读接口验证和浏览器页面验证。后端共执行 235 个测试，失败、错误和跳过均为 0；后端打包和前端生产构建均成功。

运行期验证使用本地 FTC25009-WMS 数据库和重新打包启动的后端，仅执行查询、预览、登录和页面访问，没有提交出库或移库作业，避免影响现有库存。

验证环境

日期：2026-07-16
分支：codex/dense-outbound-relocation
Java：17
Maven：D:\BDevTools\maven\apache-maven-3.9.11\bin\mvn.cmd
后端：http://127.0.0.1:8080
前端：http://127.0.0.1
数据库：FTC25009-WMS

自动化测试与构建

后端全量测试

& 'D:\BDevTools\maven\apache-maven-3.9.11\bin\mvn.cmd' -pl ruoyi-admin -am test

结果：BUILD SUCCESS，Tests run: 235, Failures: 0, Errors: 0, Skipped: 0。

覆盖的核心测试包括：

OutboundDispatchServiceImplTest：初次失败、最多 5 次自动重试、人工下发、并发抢占、密集库阻塞和类型路由。
DenseLaneServiceImplTest、DenseLaneMapperSqlTest：端头顺序、遮挡集合、同层不同通道目标、显式字段映射。
RelocationJobServiceImplTest、RelocationJobMapperSqlTest：类型 23 作业、准确预览汇总、库存搬移、货位切换、归档与真实供应商字段。
OutStockoutServiceImplTest、LocationOutboundServiceImplTest：指定库存和指定货位遇到遮挡时的移库编排。
KpiDenseRelocationServiceTest：03 仓、同层目标、容量、预览与生成复核。
DenseLaneOutboundServiceImplTest：端头 N 托、完整库存明细、准确货位汇总、预览签名失效和出库口适配。
WcsClientTest、OutMydoJobDispatchControllerTest：独立 WCS 地址和人工下发接口。

后端打包

& 'D:\BDevTools\maven\apache-maven-3.9.11\bin\mvn.cmd' clean package -DskipTests

结果：BUILD SUCCESS。打包前停止了占用 JAR 的本地后端，完成后使用新 JAR 重新启动，并通过 /captchaImage 返回 HTTP 200 验证服务恢复。

前端生产构建

Set-Location ruoyi-ui
npm run build:prod

结果：构建成功并生成 dist。存在项目原有的包体积提示，没有编译错误。

数据库迁移

连续执行两次：

& '.\scripts\apply-sql-file.ps1' -SqlFile 'sql\20260716_dense_outbound_relocation_dispatch.sql'
& '.\scripts\apply-sql-file.ps1' -SqlFile 'sql\20260716_dense_outbound_relocation_dispatch.sql'

两次均成功。执行后计数如下：

对象	数量
`wcs_job_dispatch` 表	1
`IX_wcs_job_dispatch_retry` 索引	1
`IX_mydo_job_dense_dispatch` 索引	1
`bas_task_no` 类型 23	1
WCS 补偿 Quartz 任务	1
指定通道出库菜单权限	1
通道出库预览权限	1
通道出库生成权限	1
出库作业人工下发权限	1

真实接口验证

在新打包后端上登录并调用只读接口，得到以下结果：

项目	结果
03 仓指定通道列表	12 条
通道编码为空的记录	0 条
验证通道	`03010101`
端头预览	1 托
预览签名	存在
预览合计库存	1
库存明细合计	1
KPI 同层移库源通道	7 条
KPI 同层移库目标通道	44 条

预览合计与准确选中货位的库存明细合计一致，避免重复托盘码导致跨货位重复汇总。

页面验证

执行：

$env:WMS_TEST_USERNAME='admin'
$env:WMS_TEST_PASSWORD='admin123'
python scripts\verify_dense_outbound_ui.py

结果：退出码 0，浏览器控制台错误 0，请求失败 0。桌面视口宽度 1440px 和窄屏视口宽度 390px 的页面文档宽度均等于视口宽度，没有页面级横向溢出。

截图：

真实弹窗截图在预览加载遮罩消失且托盘行渲染完成后生成，能看到准确托盘、货位和库存数量。

六项需求映射

需求	实现与直接证据
WCS 失败补偿、最多 5 次自动重试、人工下发、最外侧校验	Outbox 状态机、Quartz 任务、统一下发服务；`OutboundDispatchServiceImplTest` 15 项通过，出库作业页面验证通过。
指定托盘被遮挡时自动生成类型 23 移库	出库分配调用遮挡移库编排；`OutStockoutServiceImplTest`、`RelocationJobServiceImplTest` 通过。
KPI 平面图指定同层移库	同仓同层、不同通道及容量复核；KPI 测试通过，真实选项为源 7、目标 44，页面正常。
入库、普通出库、指定货位/通道、移库分别使用 WCS 地址	按 `in_or_out` 路由到 putaway、retrieve、location-outbound、relocation；`WcsClientTest` 和 dispatch 路由测试通过。
指定货位出库被遮挡时先生成移库	`LocationOutboundServiceImpl` 接入统一遮挡编排；对应服务测试通过。
指定通道按端头 N 托整托出库	列表、库存明细、准确预览签名、出库口适配和生成流程已实现；真实预览 1 托且合计一致，桌面与窄屏页面验证通过。

边界说明

本轮没有在现有业务库提交真实出库、移库或 WCS 失败作业；状态流转、库存搬移和失败补偿由自动化测试验证。
真实 WCS 联调仍需在可控测试单据和 WCS 测试地址下执行，避免向生产设备下发任务。
前端生产构建只有现有项目的包体积警告，不影响本次功能验收。

6.2 KiB Raw Blame History Unescape Escape