Files
bj_power/bj_power_wms
SunYF 1d1dc1bdd8 按模块说明
一、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 更新重新生成。
2026-11-05 19:18:18 +08:00
..
2026-11-05 19:18:18 +08:00
2026-11-05 19:18:18 +08:00
2026-11-05 19:18:18 +08:00
2026-11-05 19:18:18 +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 提供)