- 同步失败台账:MES/WMS 双端新增台账与页面,跨系统通知失败落台账、人工重试或标记已处理,不自动重传;重试前先判对端终态;叫料、配送、出库回写失败提示指向台账;补幂等建表脚本与菜单权限。 - 拧紧枪:新增按工位配置页,展示控制器地址与三把枪通道号(仅供查看,不参与采集校验);「允许手填」由全局开关改为每工位开关,关闭时校验该工位已配控制器;终端启动/登录上报配置并按本工位拉取,扭矩手填框按本工位置灰;补全局值迁移到各工位的脚本。 - 工位体系:终端未配置工位号时登录页可选(含虚拟工位),固定工位模式保留;虚拟/线下位不叫料、不退料、不作转产目标,未采集绑定放行并说明原因;叫料期望接驳台改为选填。 - AGV与出库:补「出库单已送达」回写;空车回充、接驳台传感器失联、配送状态更新失败均落预警或留痕并提示人工核对;人工出库不引入送达状态;出库单支持目标工位/接驳台并扩展导出列。 - 基础设施:看板缓存由Redis改为MES进程内实现,文档与启动脚本同步去Redis;扫码监听支持多地址、端口被占自动降级;PLC对账与工位报警在MES不可达时降级放行并留日志。 - 文档与帮助:案例与部署手册按实测订正(工位绑定、菜单名称、补料由班组长代提、菜单覆盖对照、虚拟工位);迁移脚本改为本地即时执行并登记7个已执行脚本;三端页面帮助改为「业务/操作/影响范围/后果」四要素。 - 测试:新增独立Go模块,按三个业务场景做真实HTTP与真实写库的流水测试,含运行报告。
test/ —— 自动化流水测试(独立 Go 模块)
按 案例.md 三场景做实操流水测试:真实 HTTP 调四服务、真实写库、前一步产生的真实数据传给下一步,不用 mock、不删测试数据。
一、边界
- 独立模块
bj_power_test,不加入根go.work,不 import 任何业务包,不改四个子项目。 - 因为根目录已有
go.work,本模块所有 Go 命令必须加GOWORK=off,否则会被 workspace 模式拦下。 - 只发真实请求。服务没起时不编造数据,报告逐条标注「阻断」。
- 测试数据全部保留在库里,用运行批次前缀隔离唯一键,绝不 DELETE/回滚。
二、目录
test/
├── go.mod 独立模块
├── README.md
├── cmd/run/main.go 全量入口(-scenario/-seq/-report-dir/-probe-only)
├── internal/
│ ├── env/ 探活、三端登录、X-API-TOKEN、运行配置
│ ├── client/ 四服务 HTTP 客户端(统一响应 code/message/data)
│ ├── db/ pgx 直连 MES/WMS PostgreSQL、SQLite 直连工作站
│ ├── fixture/ 批次前缀、日期相对化、跨步骤真实数据 State
│ ├── assert/ L1~L4 四层断言 + 每步六字段结果
│ └── report/ Markdown + JSON 报告
├── cases/
│ ├── scenario1/ 场景一:完整 15 步流水 + 收口核对
│ ├── scenario2/ 场景二:9 步结构占位(后续补)
│ ├── scenario3/ 场景三:8 步结构占位(后续补)
│ └── common/ 跨场景七组口径只读核查
├── golden/ 期望值(库存数字、状态机、交付物)
└── reports/ 运行报告输出目录
三、运行
cd D:/hardman/bj_power/test
GOWORK=off go build ./... # 编译
GOWORK=off go run ./cmd/run -probe-only # 只探活/建连/登录
GOWORK=off go run ./cmd/run -scenario 1 -seq 1 # 场景一全量
GOWORK=off go run ./cmd/run -scenario all # 三场景 + 跨场景口径
可用环境变量覆盖:TEST_MES_URL / TEST_WMS_URL / TEST_WS_URL / TEST_BOARD_URL、
TEST_MES_DSN / TEST_WMS_DSN / TEST_SQLITE_PATH / TEST_USER / TEST_PASSWORD /
TEST_INTERNAL_TOKEN / TEST_REPORT_DIR。
前置条件:MES 8888、WMS 8890、工位终端 8892、看板 5173 四个服务在监听;
PostgreSQL 5432 的 bj_power_mes / bj_power_wms 已建表;工位终端 workstation.db 存在。
服务未起时程序仍会生成报告,但所有业务步骤标「阻断」,不写任何业务数据。
四、断言分层
| 层 | 判什么 | 手段 |
|---|---|---|
| L1 | 接口响应 | HTTP 状态码、业务码 code、提示文案 |
| L2 | 数据库落库 | 直连库查工单/叫料单/配送单/出库单/退料单/入库单/检验单/库存/事件日志 |
| L3 | 状态流转 | 查单据当前状态,比对状态机期望 |
| L4 | 交付物 | 流程卡、追溯时间线、绩效报表、看板、跨场景口径 |
每步报告固定六字段:步骤ID + 案例.md 行号 + 期望 + 实际 + 通过/失败/阻断 + 失败原因。
五、数据隔离与日期
- 批次前缀
RUN<YYYYMMDD>-<NN>(如RUN20261107-01),所有工单号、入库单号、SN、批次号、退料单号都带前缀。 - 日期相对化:
T=今天、T+1、T+2由Run.Date(0/1/2)现算,代码里无写死日期。 - 同一天重跑换
-seq,不会撞唯一键;历史数据保留供人工查看。
六、接口与库字段来源(取证 file:line)
| 项 | 来源 |
|---|---|
| MES 8888 / DB / JWT / X-API-TOKEN | bj_power_mes/etc/bj_power_mes-api.yaml:1-25 |
| WMS 8890 / DB / JWT / X-API-TOKEN | bj_power_wms/etc/bj_power_wms-api.yaml:1-24 |
| 工位终端 8892 / SQLite | bj_power_workstation/etc/bj_power_workstation.yaml:1-22,54-55 |
| 登录接口 | MES internal/handler/routes.go:15、WMS internal/handler/routes.go:15、终端 internal/handler/routes.go:17 |
| 路由注册 | MES internal/handler/routes.go:12 + routes_production.go:17;WMS routes.go:11;终端 routes.go:12 |
| 统一响应 | MES common/httpx/response.go:12-16、WMS internal/handler/response.go:13-17、终端 internal/handler/response.go:9-13 |
| 落库表名 | 实测 information_schema:MES 单数(work_order/material_request/workpiece/event_log/daily_plan),WMS 混合(inbound_orders/inventories/delivery_order/return_orders/event_log) |
七、已知口径差异(如实记录,不掩饰)
- 物料档案建档方式:
案例.md:62写「模板下载 → Excel 导入」,本测试用同源单条建档接口POST /api/material/create(WMSroutes.go:58)逐条创建,落库表同样是materials。 差异原因:Excel 导入需构造 multipart xlsx,且失败行逐行弹窗属 UI 交互,自动化不适合;后续可补 multipart 用例。 - 案例主数据与库内现状不一致:
案例.md:18,52-57的四件套(DX100-XT-001 等)与产品 DX-100 在开发库里并不存在;库内现有ChengPin001/GaiZhi001/XinPian001等,product_process仅 1 条 (product_code=ChengPin001),工位12的flow_id=2而案例把工位 12 归为「包装」。 测试会真实创建四件套主数据,并从station表现查flow_id组装工艺组合,由系统自己回答能否闭环。 - 场景二/三本轮只建结构占位,未执行真实调用;按授权范围仅场景一完整跑通。
八、编译/运行纪律
- 只编译本模块(
GOWORK=off go build ./...),不编译、不重建四个子项目的产物。 - 本模块不 commit;服务起停由使用者控制,测试程序自身不启动/停止任何业务服务。