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

bj_power_wms(项目 C)— WMS 仓库系统

Go 后端 + 内嵌 Vue3 前端(go:embed web/static),一个服务(8890)同时提供页面与 API。 2026-09-07 起原库房客户端(bj_power_wms_client, 8891)已合并进本项目并退役:扫码枪为网络型扫码枪 + 中间件键盘注入(iData PAD / 新大陆手机,共用 7757),无需独立客户端程序。

技术栈

  • Go 1.25 + go-zero 1.8.3(REST 框架)
  • Ent ORM v0.14.5(自动建表/迁移)
  • PostgreSQL(独立库 bj_power_wms)

目录结构

bj_power_wms/
├── bj_power_wms.go          # 主入口
├── etc/bj_power_wms-api.yaml # 配置文件
├── schema/                  # Ent schema(业务表定义)
│   ├── material.go          # 物料档案(精密件 SN / 结构件批次)
│   ├── zone.go              # 库房区域
│   ├── inventory.go         # 统一库存表(结构件批次 + 精密件 SN,manage_mode 区分)
│   ├── inventory_lock.go    # 库存锁定(工单锁库存)
│   ├── inbound_order.go     # 入库单 + inbound_detail 明细
│   ├── outbound_order.go    # 出库单 + outbound_detail 明细
│   ├── inspection_record.go # 检验记录
│   ├── semi_finished.go     # 半成品库存
│   ├── package_box.go       # 包装箱 ↔ SN
│   ├── order_material_ledger.go # 工单物料台账(出库强约束)
│   └── user.go              # 用户
├── frontend/                # Vue3 前端源码(npm run build → web/static)
├── web/static/              # 前端构建产物(go:embed 内嵌,勿手改)
├── ent/                     # Ent 生成代码(勿手改)
├── internal/
│   ├── config/              # 配置结构
│   ├── db/                  # 数据库连接 + 自动迁移
│   ├── svc/                 # ServiceContext
│   └── handler/             # HTTP handler(API 层)
└── tools/                   # ent 代码生成工具

常用命令

# 生成 ent 代码(修改 schema 后执行)
go run tools/generate.go

# 启动服务
go run bj_power_wms.go -f etc/bj_power_wms-api.yaml

当前状态

  • 工程骨架(go-zero + Ent + PostgreSQL)
  • 15 张核心表 schema + 自动迁移
  • 物料 CRUD / 区域
  • 入库(结构件批次 + 精密件 SN)
  • 出库扣减(含工单物料台账强约束:累计出库 ≤ 物料清单 需求)
  • 库存查询 / 锁定 / 解锁 / 校验
  • 检验(单条 + 批量翻转)
  • 半成品出入库 / 包装绑定
  • 登录鉴权(JWT)
  • Excel 批量导入
  • 盘点
  • 追溯查询

对外 API(B ↔ C 联动)

接口 说明
POST /api/stock/lock 工单锁定库存(批次/SN),带 order_no
POST /api/stock/deduct 出库扣减,WMS 校验累计 ≤ 物料清单
GET /api/stock/query 库存查询(MES 查料)
POST /api/semi/inbound / outbound 半成品入库/出库
GET /api/order/query 工单查询(待 MES 提供)