2026-08-28 15:06:01 +08:00
|
|
|
|
# bj_power_wms（项目 C）— WMS 仓库系统
|
|
|
|
|
|
|
2026-09-07 15:55:30 +08:00
|
|
|
|
> Go 后端 + 内嵌 Vue3 前端（`go:embed web/static`），一个服务（8890）同时提供页面与 API。
|
|
|
|
|
|
> 2026-09-07 起原库房客户端（bj_power_wms_client, 8891）已合并进本项目并退役：扫码枪为 USB 键盘口（HID）设备，浏览器页面直接读取，无需独立客户端程序。
|
2026-08-28 15:06:01 +08:00
|
|
|
|
|
|
|
|
|
|
## 技术栈
|
|
|
|
|
|
|
|
|
|
|
|
- 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 # 库房区域
|
2026-09-02 08:21:11 +08:00
|
|
|
|
│ ├── inventory.go # 统一库存表（结构件批次 + 精密件 SN，manage_mode 区分）
|
2026-08-28 15:06:01 +08:00
|
|
|
|
│ ├── 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 # 用户
|
2026-09-07 15:55:30 +08:00
|
|
|
|
├── frontend/ # Vue3 前端源码（npm run build → web/static）
|
|
|
|
|
|
├── web/static/ # 前端构建产物（go:embed 内嵌，勿手改）
|
2026-08-28 15:06:01 +08:00
|
|
|
|
├── 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] 出库扣减（含工单物料台账强约束：累计出库 ≤ BOM 需求）
|
|
|
|
|
|
- [x] 库存查询 / 锁定 / 解锁 / 校验
|
|
|
|
|
|
- [x] 检验（单条 + 批量翻转）
|
|
|
|
|
|
- [x] 半成品出入库 / 包装绑定
|
|
|
|
|
|
- [ ] 登录鉴权（JWT）
|
|
|
|
|
|
- [ ] Excel 批量导入
|
|
|
|
|
|
- [ ] 盘点
|
|
|
|
|
|
- [ ] 追溯查询
|
|
|
|
|
|
|
|
|
|
|
|
## 对外 API（B ↔ C 联动）
|
|
|
|
|
|
|
|
|
|
|
|
| 接口 | 说明 |
|
|
|
|
|
|
| --- | --- |
|
|
|
|
|
|
| `POST /api/stock/lock` | 工单锁定库存（批次/SN），带 order_no |
|
|
|
|
|
|
| `POST /api/stock/deduct` | 出库扣减，WMS 校验累计 ≤ BOM |
|
|
|
|
|
|
| `GET /api/stock/query` | 库存查询（MES 查料） |
|
|
|
|
|
|
| `POST /api/semi/inbound` / `outbound` | 半成品入库/出库 |
|
|
|
|
|
|
| `GET /api/order/query` | 工单查询（待 MES 提供） |
|
