2026-11-09 18:58:47 +08:00
|
|
|
|
# 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/ 运行报告输出目录
|
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
|
|
## 三、运行
|
|
|
|
|
|
|
|
|
|
|
|
```bash
|
|
|
|
|
|
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`。
|
|
|
|
|
|
|
2026-11-10 23:42:50 +08:00
|
|
|
|
**前置条件**:MES 8888、WMS 8890、工位终端 8892 三个服务在监听;看板随 MES 8888 `/board` 同源提供,无独立端口;
|
2026-11-09 18:58:47 +08:00
|
|
|
|
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`) |
|
|
|
|
|
|
|
|
|
|
|
|
## 七、已知口径差异(如实记录,不掩饰)
|
|
|
|
|
|
|
|
|
|
|
|
1. **物料档案建档方式**:`案例.md:62` 写「模板下载 → Excel 导入」,本测试用同源单条建档接口
|
|
|
|
|
|
`POST /api/material/create`(WMS `routes.go:58`)逐条创建,落库表同样是 `materials`。
|
|
|
|
|
|
差异原因:Excel 导入需构造 multipart xlsx,且失败行逐行弹窗属 UI 交互,自动化不适合;后续可补 multipart 用例。
|
|
|
|
|
|
2. **案例主数据与库内现状不一致**:`案例.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` 组装工艺组合,由系统自己回答能否闭环。
|
|
|
|
|
|
3. **场景二/三**本轮只建结构占位,未执行真实调用;按授权范围仅场景一完整跑通。
|
|
|
|
|
|
|
|
|
|
|
|
## 八、编译/运行纪律
|
|
|
|
|
|
|
|
|
|
|
|
- 只编译本模块(`GOWORK=off go build ./...`),不编译、不重建四个子项目的产物。
|
|
|
|
|
|
- 本模块不 commit;服务起停由使用者控制,测试程序自身不启动/停止任何业务服务。
|