Files
bj_power/test/README.md
T
SunYF af554cea75 feat: 同步失败台账双向可重试 + 拧紧枪按工位配置 + 虚拟工位体系 + 去Redis与文档口径对齐
- 同步失败台账:MES/WMS 双端新增台账与页面,跨系统通知失败落台账、人工重试或标记已处理,不自动重传;重试前先判对端终态;叫料、配送、出库回写失败提示指向台账;补幂等建表脚本与菜单权限。
- 拧紧枪:新增按工位配置页,展示控制器地址与三把枪通道号(仅供查看,不参与采集校验);「允许手填」由全局开关改为每工位开关,关闭时校验该工位已配控制器;终端启动/登录上报配置并按本工位拉取,扭矩手填框按本工位置灰;补全局值迁移到各工位的脚本。
- 工位体系:终端未配置工位号时登录页可选(含虚拟工位),固定工位模式保留;虚拟/线下位不叫料、不退料、不作转产目标,未采集绑定放行并说明原因;叫料期望接驳台改为选填。
- AGV与出库:补「出库单已送达」回写;空车回充、接驳台传感器失联、配送状态更新失败均落预警或留痕并提示人工核对;人工出库不引入送达状态;出库单支持目标工位/接驳台并扩展导出列。
- 基础设施:看板缓存由Redis改为MES进程内实现,文档与启动脚本同步去Redis;扫码监听支持多地址、端口被占自动降级;PLC对账与工位报警在MES不可达时降级放行并留日志。
- 文档与帮助:案例与部署手册按实测订正(工位绑定、菜单名称、补料由班组长代提、菜单覆盖对照、虚拟工位);迁移脚本改为本地即时执行并登记7个已执行脚本;三端页面帮助改为「业务/操作/影响范围/后果」四要素。
- 测试:新增独立Go模块,按三个业务场景做真实HTTP与真实写库的流水测试,含运行报告。
2026-11-09 18:58:47 +08:00

97 lines
5.9 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 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`。
**前置条件**: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`) |
## 七、已知口径差异(如实记录,不掩饰)
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;服务起停由使用者控制,测试程序自身不启动/停止任何业务服务。