Files
bj_power/bj_power_wms/README.md
T
SunYF f65a52d9e1 feat: 多系统新增扫码中间件与 AGV 对接,优化拧紧与退库流程
新增扫码中间件支持网络型扫码枪键盘注入,AGV 对接从 WMS 迁至 MES 统一管理;新增拧紧不合格人工处置与 PLC 对账机制,优化退库单关联与工位终端功能,同时清理旧 AGV 任务表,完善数据库与配置项。
2026-10-14 17:24:59 +08:00

75 lines
3.1 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 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 代码生成工具
```
## 常用命令
```bash
# 生成 ent 代码(修改 schema 后执行)
go run tools/generate.go
# 启动服务
go run bj_power_wms.go -f etc/bj_power_wms-api.yaml
```
## 当前状态
- [x] 工程骨架(go-zero + Ent + PostgreSQL)
- [x] 15 张核心表 schema + 自动迁移
- [x] 物料 CRUD / 区域
- [x] 入库(结构件批次 + 精密件 SN)
- [x] 出库扣减(含工单物料台账强约束:累计出库 ≤ 物料清单 需求)
- [x] 库存查询 / 锁定 / 解锁 / 校验
- [x] 检验(单条 + 批量翻转)
- [x] 半成品出入库 / 包装绑定
- [ ] 登录鉴权(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 提供) |