一、MES — 叫料单扩展(schema + 逻辑) material_request 新增字段:packageNo(叫料包号,一次提交=一包)、callDate(叫料日,默认当天)、planBreakdown(jsonb,工单×排产日明细 []CallPlanBreakdown);targetDock 语义降级为"期望接驳台(可空,配送时 WMS 确定实际台)"。 新增 internal/logic/call_plan.go:实时计算「叫料需求明细(工单×排产日×物料)」,派生两类提示(当日剩余未叫 / 跨日量明细),不落库、不拦提交;接驳台空台校验 EnsureStationDocksEmpty、托盘回库 DispatchPalletReturnManual、人工清台 ClearDockLedger、配送单派车 DispatchDeliveryAgv、工位物料明细 StationMaterialDetail。 新增 internal/handler/production/call_pkg.go:8 个 MES 内部端点(X-API-TOKEN 网关),供 WMS 调用——叫料需求明细、按包查单、接驳台状态、托盘回库、人工清台、配送单派车、叫料池原始行、工位物料明细、WMS 代叫料。 internal/handler/production/call.go、internal/logic/call.go、agv.go、qty_report.go、routes_production.go、wmsclient/client.go、db.go 同步接入上述逻辑。 二、WMS — 配送单(新功能,叫料与送料彻底拆开) 新增 schema/delivery_order.go + delivery_order_item.go 及 ent 生成代码:delivery_order(PENDING→DISPATCHED→DONE / CANCELLED,一单=一次托盘配送)、delivery_order_item(配送物料明细快照:工单/工艺/排产日)。 新增 internal/handler/delivery.go + 路由 + DeliveryOrders.vue 页面(仓储作业 → 配送单)。 mesclient/client.go 扩展:MES 叫料单结构补 packageNo/callDate/workOrderNo/planBreakdown,新增 PoolRow/DockPalletState/DeliveryAgvItem/getJSON 等。 CallQueue.vue:按叫料包展示,新增「代叫料」「建配送单」按钮与对话框;出库单回写所属配送单号(outbound_order 加字段);AGV 派送改由配送单驱动。 三、工位终端 — 叫料体验升级 MaterialPanel.vue:新增「本工位物料明细」卡(工艺物料全集×工位账四数,量为 0 也显示);叫料改为「叫料包」模式(默认当天、可勾选分批、可选其他排产日、期望接驳台可空),新增叫料日选择器、两条提示横幅(当日剩余未叫 / 跨日量明细)、托盘回库按钮。 InspectPanel.vue/Main.vue/OnlinePanel.vue/OfflinePanel.vue/WorkPanel.vue/SyncQueueDialog.vue/api/index.js/internal/handler/line.go/routes.go 同步接入接驳台状态、托盘回库、下班双台空台校验等。 web/static/index.html 构建刷新。 四、文档 案例.md:重写第 5/6/8/9 节与新「配送单」流程,补「模拟模式跳过接驳台校验」说明,库管员菜单加「配送单」;并修正"本单箱体"等措辞歧义。 客户问题.md:同步本轮拍板口径。 五、构建产物 / 同步 多个 MES 前端页面(.vue)随本次改动统一重新构建刷新;ent 生成代码(MES material_request、WMS delivery_order/outbound_order 相关)随 schema 更新重新生成。
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 提供) |