Files
bj_power/test
SunYF 619fc8983d feat: 全端体验与稳定性整改(帮助文档清理/收集式报错/操作列统一/托盘与WS通知/物料同步重推)
- 移除 bj_power_dashboard 旧 React 大屏源码(迁移至 2D SVG 方案)
- MES/WMS/工位终端前端:清理 help.js 与 PageHelp 帮助文档,统一操作列与布局,接入请求拦截器
- 新增收集式校验错误弹窗(ErrorListDialog 统一拦截 3015,逐条列现象+建议)
- 新增托盘程序(tray)与 WebSocket(ws) 实时通知模块(三端共用)
- MES/WMS 物料档案新增同步状态字段,补齐双向失败重推与默认角色 seed
- 工单/产能/产品工艺/日排产逻辑调整;拧紧枪按工位配置
- 新增迁移 SQL:扭矩按工位、sysconfig 序列修复
- 更新 技术约束/案例/部署手册/项目说明 等文档
2026-11-10 23:42:50 +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/                  运行报告输出目录

三、运行

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 三个服务在监听;看板随 MES 8888 /board 同源提供,无独立端口; 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;服务起停由使用者控制,测试程序自身不启动/停止任何业务服务。