AGV 调度: - 任务重构为 GO_LOAD/TRANSPORT/EMPTY_RETURN/FREE 三段链,到位即停(ARRIVED)需人工确认装卸 - 自由调度单点步进,每段强制弹"请确保路径畅通无杂物";托盘回收独立工作台 - 接驳台 PLC 传感器检测到托盘即自动卸货放行,传感器故障由人工按钮兜底(无轮询) - 车辆状态只读展示(海康3.1.7 queryAgvStatus),调度仍由 RCS 负责 物料闭环: - 补料管理(SHORTAGE):工位申请 + 主管审批调增叫料池额度,与借料/差异补发三轨并行 - 损耗台账(loss_ledger):退料实际 < 理论必填原因、后审核,工单不记损耗 - 退料强制指定左/右接驳台,WMS 库管可代工位退料 下班闭环: - 工位终端自检接驳台剩余物料后下班;库管收货 + 托盘拉走后事件驱动自动结班 - 退出登录未下班仅作安全提示(不强制拦截、不新增责任审批) 接驳台左右按操作员朝向建模(dock.side 字段),废除"奇左偶右"隐式约定; 看板标签 / seed / 迁移补丁 / 布局文档统一为中文左/右。 产线布局说明:C1 前线头 AGV 点、C15 后线尾 AGV 点、外部 O1/O2/O3 散点, 清理修订痕迹为最终态描述。
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 提供) |