Files
bj_power/bj_power_wms/README.md
T
SunYF 1e92b2a596 feat: 核心业务实体扩充(混产模板/产品BOM/试制记录)、WMS 库存检验增强与前端通用能力
- MES 新增实体:混产模板、产品BOM、产品工艺物料、试制记录(schema + ent 生成码 + logic/handler/前端页)
- WMS 实体增强:检验记录、库存、半成品重构;新增序列号库存与短缺代报
- AGV 与产能:AGV 手动点位与链路、物料守卫、短缺预测、原因字典
- 前端通用能力:新增下一步引导组件 NextStepBar,统一帮助文档/布局/请求拦截与操作列
- 工位终端:界面与各 handler 调整(api/store/绑定/PLC/拧紧/上报等)
- 配置与文档:更新 mes-api.yaml、WMS README 及案例/产线API/问题记录/项目说明/流程说明
2026-11-15 12:17:39 +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 -tags entgenerate ./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 提供) |