SunYF/bj_power
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

feat: 完成区域管理、装箱功能优化与接口标准化

Browse Source 
- 新增区域状态字段与增删改查接口，支持区域启用/停用
- 重构实体字段JSON标签为camelCase格式统一接口规范
- 优化入库、盘点、装箱流程的交互与提示文案
- 新增装箱管理功能，支持合同号关联与装箱编辑
- 调整前端菜单与帮助文档适配业务场景变更
This commit is contained in:
SunYF
2026-09-01 13:49:44 +08:00
parent ea6d55b7e6
commit bb22148625
59 changed files with 2238 additions and 357 deletions
Download Patch File Download Diff File Expand all files Collapse all files
问题记录.md
+154 -18
View File
@@ -1,32 +1,168 @@
一、菜单：工单管理
1、新建工单， 产品类型 选择框，用户未选择时， 选择框显示“请选择”。所有选择框，都应如此。
2、工单，不能删除吗。 满足某些条件时，应该可以删除。请考虑一下
3、查询条件，多一些，比如：产品编码、产品名称 模糊查询
4、新建工单、工序组合，是不是应该是 工位 ？ 你看看，怎么更合适
wms
1、结构件入库--->提交入库。报错提示： 精密件入库 序列号(SN)必填
2、结构件入库--->区域 undefined 。并且 区域 ，应该是必填
3、精密件SN入库-->物料、区域，都应该是必填
4、基础数据，拆分一下。并且，保存方式，不要再用这种表格上面 。 行内新增 vs 弹窗新增 ？ wms和mes 等，都必须用 弹出新增修改。所有项目，大列表时，必须有分页
5、所有项目，浏览器tab标签页，小图标，不能显示 hardman标，显示一个系统相关图标
6、基础数据-->区域维护，列表显示有问题。区域编码、区域名称 都没显示出来。还是说，没有保存上呢？
7、wms左下角，还是有 问号帮助标识。去除，只保留右上角 帮助按钮即可
8、帮助按钮，如果没有数据，合理提示用户
9、包装绑定，当前也是 行内新增，写法。都去掉，看着难受。并且，新增修改，都添加一个合同号（选填）。 标题添加查询按钮，搜索条件多一些（操作人、时间、合同号、等等等）
10、包装绑定，名称取得，能不能更好听些，能代表实际现场业务，见名知意
11、半成品出库（重上线） ， 跟mes 能闭环不能，什么逻辑
12、库存查询 里面 叫：批次号、SN 序列号 ， 库存盘点 里面叫 目标编号 到底什么意思，对不上号。 要求1、统一 名称 ，结构件和精密件 应该有一个总名称：物料？货物？ 叫什么合适？ 2、结构件和精密件,主表结构要统一，精密件，仅仅比结构件多了一个子表 记录sn，其他是不是应该一样？ 都有批次、和数量
二、菜单： 工艺流程
1、名称起的有些不合适： 工艺流程、 流程名称叫 “工序1_默认” ，流程，和工序，是不一样的。不能叫工序。原设计，一个流程包含多个序
2、编辑工艺流程 ---> 工序编号 ? 应该是工位编码吧，固定 12个。认真审核，名字统一。
3、编辑工艺流程 ---> 步骤模板 ? 工序步骤吧。 你好好统一一下，现在非常容易混淆。 比如，去除 工艺 概念 ？ 去除 工序 概念。你好好考虑
三、菜单： PLC工序下发
这个全人工操作，挺好的。名称变一下，更符合业务场景，操作人员更容易理解。见名知意。
四、菜单： 日排产
工单号：WO1787966513636 ， 计划数量 总和，超出了 工单的 工件 数量。是个bug
五、菜单： 产品类型
帮助文档，说清楚，和工单、物料清单、备料单、如何分工，几对几关系，有没有强约束，等。 相关菜单，也要把这些关系写清楚。 如果有和wms关联的，更要说清楚。
所有项目帮助按钮说明：
DeepSeek，写的说明这么好，你为什么写的说明，如此差？？？ 你参考参考人家的（至结尾）
## 工单物料台账 —— 页面设计说明
### 一、这个页面是什么
**一个「实时看板」，展示某个工单的物料消耗进度，强制约束“不准超领”。**
把每个物料的三项数据列在一行：**总共要多少 → 已经出了多少 → 还剩多少缺口**。
### 二、数据链路
**MES 工单创建时 → 用 BOM 算出物料总需求 → 自动写入 WMS 工单物料台账 → 每次出库自动扣减累计出库 → 缺口实时更新。**
- 工单号：来自 MES 工单（手动输入查询）
- 需求总量：MES BOM 自动算（产品 × 单台用量）
- 累计已出库：出库单提交时自动累加（WMS 算）
- 剩余缺口：需求总量 - 累计已出库（系统算，只读）
**核心约束：累计出库 ≥ 需求总量时，该物料“领料完结”，禁止再出库。** 累计出库 **永远不能大于** 需求总量。达到即完结，禁止超额。
### 三、页面功能
1. **查询**：输入工单号 → 显示该工单的所有物料台账行
2. **列表展示**：每行一个物料，显示需求总量、累计已出库、剩余缺口
3. **状态标识**：剩余缺口 > 0 显示“待领料”/“部分领料”，= 0 显示“领料完结”/绿色对勾
4. **实时更新**：每次出库提交后，累计出库和剩余缺口自动刷新
### 四、字段说明
| 字段 | 来源 | 谁填 | 说明 |
|------|------|------|------|
| 工单号 | MES 工单 | 系统自动带入 | 查询条件，手动输入 |
| 物料编码 | MES BOM | 系统自动带入 | 工单创建时从 BOM 取 |
| 物料名称 | 调 WMS 物料档案 | 系统自动带入 | 按编码查 WMS |
| 规格 | 调 WMS 物料档案 | 系统自动带入 | 同上 |
| 单位 | 调 WMS 物料档案 | 系统自动带入 | 同上 |
| 需求总量 | MES BOM | 系统自动计算 | BOM 单台用量 × 工单计划产量 |
| 累计已出库 | 出库单 | 系统自动累加 | 每次出库提交后 + 出库数量 |
| 剩余缺口 | 系统计算 | 只读 | 需求总量 - 累计已出库 |
| 状态 | 系统判定 | 只读 | 缺口>0 显示“部分领料”，=0 显示“领料完结” |
### 五、界面示意
```
┌──────────────────────────────────────────────────────────────────────┐
│ 工单物料台账 │
│ ┌──────────────────────────────────────────────────────────────────┐ │
│ │ 工单号 [WO001___________] [查询] │ │
│ └──────────────────────────────────────────────────────────────────┘ │
┌──────┬────────┬──────┬──────┬──────────┬──────────┬──────────┬──────────┐
│ 物料 │ 物料 │ 规格 │ 单位 │ 需求总量 │ 累计已出 │ 剩余缺口 │ 状态 │
│ 编码 │ 名称 │ │ │ │ 库 │ │ │
├──────┼────────┼──────┼──────┼──────────┼──────────┼──────────┼──────────┤
│ SCR- │ 螺丝 │ M4× │ 颗 │ 800 │ 600 │ 200 │ 部分领料 │
│ M4-12 │ M4 │ 12 │ │ │ │ │ │
├──────┼────────┼──────┼──────┼──────────┼──────────┼──────────┼──────────┤
│ CHIP- │ 控制 │ │ 片 │ 100 │ 100 │ 0 │ ✅领料完结│
│ 001 │ 芯片 │ │ │ │ │ │ │
├──────┼────────┼──────┼──────┼──────────┼──────────┼──────────┼──────────┤
│ SHELL │ 外壳 │ │ 套 │ 100 │ 80 │ 20 │ 部分领料 │
│ -01 │ │ │ │ │ │ │ │
└──────┴────────┴──────┴──────┴──────────┴──────────┴──────────┴──────────┘
```
### 六、为什么做这个页面，有没有必要
**有必要，它不是报表，是WMS的核心约束机制，也是甲方唯一能查“这工单还剩多少料没领”的地方。**
1. **防止超发**：约束逻辑（累计出库≤需求总量）必须有一个可见的展示载体；光靠后端拦截，甲方会投诉“为什么出不了库，也看不到原因”。这个页面是约束逻辑的可视化出口。
2. **仓管操作依据**：仓管今天出多少，要看“累计已出库”和“剩余缺口”决定能不能出、出多少。没这个页面，仓管就无法判断。
3. **拉通MES和WMS**：工单创建后，MES BOM自动生成台账是“工单驱动”模式的关键；没台账，MES和WMS还是割裂的。
4. **订单完工判断**：“所有物料状态 = 领料完结”是完工的前置条件之一。页面一眼看出哪个料还没领完，不需要查多个页面。
整体建议：
菜单，能不能，分分类。包括 wms，先优化，后分类。 仅思考，判定是否合适，给方案。
## 包装绑定（箱号 ↔ SN）—— 页面设计说明
### 一、这个页面是什么
**把成品/精密件的序列号(SN)装进一个箱号里，形成可追溯的包装箱。** 用于发货、入库、整箱追溯。
### 二、数据链路
**拣选出待包装的SN → 扫码绑到同一个箱号下 → 一个箱号关联多个SN → 后续按箱号出库/发货/追溯。**
### 三、字段说明
| 字段 | 来源 | 谁填 | 说明 |
|------|------|------|------|
| 箱号 | 扫码枪/手动输入 | 操作人 | 包装箱上的条码或手贴码，唯一标识一个箱子 |
| 物料 | 下拉选择（可空） | 操作人 | 箱内物料的类型（限定同一箱只装一种物料） |
| 操作人 | 登录账号 | 自动 | 绑定的操作人 |
| SN清单 | 扫码枪连续扫码 | 操作人 | 扫入一个SN回车追加一个，实时展示在清单列表里 |
### 四、界面示意
```
┌──────────────────────────────────────────────────────────────────────┐
│ 包装绑定 │
│ ┌──────────────────────────────────────────────────────────────────┐ │
│ │ 箱号 [___________________________] [扫码] │ │
│ │ 物料 [下拉选择 ▼] (可空) │ │
│ │ 操作人 张三 (自动) │ │
│ │ │ │
│ │ SN录入 [扫入SN后回车_________] [追加] │ │
│ │ ✅ 已扫 8 件 │ │
│ │ ┌──────────────────────────────────────────────────────────────┐ │ │
│ │ │ 序号 │ SN码 │ 物料名称 │ 状态 │ 操作 │ │ │
│ │ │ 1 │ SN-HLX-001 │ 汇流箱 │ 已绑 │ 移除 │ │ │
│ │ │ 2 │ SN-HLX-002 │ 汇流箱 │ 已绑 │ 移除 │ │ │
│ │ │ ... │ │ │ │ │ │ │
│ │ └──────────────────────────────────────────────────────────────┘ │
│ │ │
│ │ [保存包装] [取消] │
│ └──────────────────────────────────────────────────────────────────┘ │
└──────────────────────────────────────────────────────────────────────┘
```
### 五、业务规则
1. **同一箱只能装同一物料**：选择物料后，SN录入只能扫该物料的SN。如果物料为空，不校验（允许混装，但以后不建议，因为出库时容易乱）
2. **SN不能重复装箱**：已绑定到其他箱号的SN，扫码时提示“SN已在箱号XXX中”，不允许重复绑定
3. **保存时校验**：箱号不能为空，至少扫入1个SN
4. **保存后**：箱号 ↔ SN 关系写入数据库，SN状态变为“已包装”，可追溯
### 六、为什么做这个页面
1. **发货/出库需要**：成品出库时按箱出库，而不是按SN逐个扫码。用箱号加速出库操作
2. **追溯链闭环**：当某个产品出问题时，通过箱号反查箱内所有SN，快速定位问题批次
3. **库存管理**：成品入库时按箱入库，WMS库存按箱号管理
4. **甲方实际业务**：产线做完的成品要打包入库/发货，需要箱号管理（录音原文：“一个包装箱里边，我给他规定好一共十个包装箱，每个包装箱里边十台”）