docs: 新增甲方问题清单及整改方案文档

This commit is contained in:
weixiao_world@163.com
2026-09-27 21:07:21 +08:00
parent e6e3ccc3b1
commit f5f0e65c57
2 changed files with 533 additions and 0 deletions
+50
View File
@@ -0,0 +1,50 @@
软件问题汇总:
1、编号名称问题:删除工程编号。合同号/科技项目编号为一级编号,正常工程项目使用合同号,科技项目使用科技项目编号,二者只能选择其中一种使用。工单号改为产品工号为二级编号,对应一类产品。产品编号改为产品序号,为三级编号,对应每台产品。
2、库房管理物料档案页面增加货架区域、货架号、第一层(存放位置);其中图号改为材料编码;
3、工艺页面损耗率解释一下怎么考虑?
4、出库管理内“箱号”解释一下?
5、解释一下自动排产原则是什么?(根据什么进行排产)
产线软件问题清单
问号为不明确待回复项,句号为修改项。
WMS系统:
1、把过程检验和完工检验放到仓储作业里,是不是不合适?过程检验指的是什么,工序间检验吗;完工应该是指生产过程中的完工检验吧,建议都放入MES系统中。
2、入库中的归属信息是下拉列表,具体的信息是在哪里录入?
3、来料检的信息不能为空。
4、来料检如果是批次,那需要录入第多少批,共多少件。
4、来料检里的从库存选批次号是什么作用?
5、入库记录增加一个按归属查询。
6、现在入库的料是否都需要建档,那能否在添加物料入库的时候,自动匹配,新的材料自动建档?
7、解释一下,原料类(SN/结构件/其它)如果刚开始判定合格入库,实际使用过程中不合格,转为退货或换修,系统如何修改和调整?
8、库存查询增加一个按归属查询。
9、现在来料检验中,是否保函两条路,一条是输入物料待检,报检后从已选清单完成检验结果录入;另外一条是在来料检验栏中手动输入信息,提交检验记录?
10、锁定量是说已列至排产计划的?
11、产成品入库在哪里?如果跟半成品写到一起,那改名为“半成品/成品管理”。
12、需要在AGV穿越到相邻厂房,接收半成品到库房。能否设置虚拟接驳台?
MES系统:
1、拧紧查询是否有必要单独成一条目,建议放到工件追溯中。
2、mes里的物料档案,是不是没有关于产品和物料的信息,应保存的都是产线设备和其他生产物料工具,改名为设备管理
3、工位绑定中如果一个工位只能绑定一个工艺,那更换生产产品的话,需要重新绑定?
4、工艺列表中,是不是应该生产的某项产品规定为工艺,芯片安装、喷漆这种规定为工艺步骤,然后物料清单链接工艺步骤?整体上提一级,工艺步骤不再罗列比如第一遍红漆、第二遍绿漆这种再下一级的工作内容。
5、工艺步骤中的采集方式是什么意思?工艺步骤只能上传pdf附件。考核标准是怎么输进去?
6、工件追溯需要显示出现有内容外,还需要查看工件的过程检验情况、操作工位、操作人员、操作时间,试验数据。
7、生产流程卡主要是用于对单个工件依据标准,使用原材料情况、生产情况、检验情况的记录和追溯,跟工件追溯功能类似。
8、巡检终端部分功能可能需要在后期调试时继续完善。
9、固定日产是用于生产天数小于工程要求天数?实际情况多为前期因为不熟练生产速度满,中后期逐渐加快,所以排产应该也是保持前松,中紧,后松的状态进行排产,是否可以实现?
10、日排产栏中按时间从前到后排序修改,现在为从后到前。
11、可生产套数的公式是不是错了,应该是最小库存量/单台用量。
12、多个工单同时生产的话,日排产栏中使用多栏表格或其他方式将不同工单号的进行区分,不要重叠放到一起。
13、多个工单同时生产时,下发工单操作的逻辑是不是还没有理顺?
14、备料单中的表格内,操作栏显示已接料是什么意思,已发出为0,为什么就显示已接料?
15、质量检验栏中的过程检和完工检,这两项不应该是巡检终端录入的吗,为什么会在这里可以录入?
工位终端:
1、当前工位的步骤完成后,应该先申请报检(需要考虑如何将检验的工作与工位的工作汇总到一起,最终体现到施工单上),报检通过后,报工(上传工作量)并流转至下一步骤对应工位。
2、有些工艺步骤是不需要录入信息的,是否会卡到这一步无法继续处理?
3、工位上对需要组装的电气件进行扫码,这一工作在哪个页面完成,是装配物料绑定页面吗?
4、移料的作用解释一下。
+483
View File
@@ -0,0 +1,483 @@
# 《问题.md》甲方问题清单 —— 整改方案(待决策)
> 依据:根目录《问题.md》(甲方问题清单,共 **37 条**实质问题)+ 《技术约束.md》+ 源码核实(commit `d9d4155`,本机已同步到最新、双库已最干净重建但未灌种子)。
> 本文**仅出方案,未改动任何代码/数据库/配置文件**,等待决策后实施。
> 判定符号:🔧修改 / 💬解释 / ❓需澄清 / 🚫暂不做。
---
## 零、一句话结论(findings-first)
- 37 条中:**解释类 9 条**(向客户说明现有设计与业务口径即可,零/极低代码成本)、**修改类 23 条**、**需澄清 5 条**、**暂不做 1 条**。
- **6 大高风险/高冲突点需先决策再动手**(否则会改错方向或推翻既有裁决;已与另一模型交叉审计,详见文末第八节):
1. **S1 编号体系重构**(删工程编号、一级改合同号/科技项目编号二选一)——`work_order` 核心表 schema 变更,牵一发动全身(工单/BOM/工艺/工件追溯/排产/出库归属全链路),且 MES 持 `work_order`、WMS 持 `contractNo` 双库需一致。
2. **S2「图号→材料编码」与历史裁决 L18 直接冲突**(L18 已裁决图号=物料编码合并、界面叫图号)。**必须先定口径**,否则自相矛盾。
3. **M4 工艺模型「上提一级」**(产品→工艺→工艺步骤→BOM 链接步骤)——工艺 schema 结构性重构,影响排产、工件追溯、BOM。
4. **T1 工位终端「报检→报工→流转」流程**——工位终端 + MES 工位逻辑的流程级改动。
5. **W12 虚拟接驳台**与技术约束「接驳台只读不可新增」冲突,需决策是否放开。
6. **M9 排产算法「前松中紧后松」**:影响排产/备料/出库全链路,属学习曲线模型,客户未给量化规则,必须单独评审 + 客户拍板比例后再动手。
- **检验归属(W1 / M15 / T1)是跨系统口径问题**:客户反复质疑「过程检/完工检在哪录入」。建议统一为——**来料检归 WMS(入库环节)、过程检/完工检归 MES/巡检终端**,需先与客户确认边界再落地,避免 WMS/MES 各改一通后对不上。
- 建议**分三批**推进:批次①先回复所有「解释类」(零代码、快速闭环客户疑问);批次②低风险字段/显示/查询修改;批次③高风险 schema/流程/架构变更(需评审 + 单独排期)。
---
## 一、清单全景统计
| 系统 | 总条 | 🔧修改 | 💬解释 | ❓澄清 | 🚫暂不做 |
|---|---|---|---|---|---|
| 软件问题汇总 | 5 | 2(S1,S2) | 2(S3,S4) | 1(S5排产规则) | 0 |
| WMS 系统 | 13 | 10 | 2(W4',W10) | 1(W9) | 0 |
| MES 系统 | 15 | 10 | 2(M11,M14) | 3(M3,M9,M13) | 1(M8) |
| 工位终端 | 4 | 1(T1) | 3(T2,T3,T4) | 0 | 0 |
| **合计** | **37** | **23** | **9** | **5** | **1** |
> 注:软件问题汇总实为 **5 条**(S1–S5,原文无第 6 条),前文误写 6;WMS 原文编号在「4」处重复(来料检批次录入 + 从库存选批次号),故实质 **13 条**(W1–W12 + W4'),逐条表如实列 13 行;MES 第 8 条巡检终端明确「后期完善」,标 🚫暂不做。分类为粗略口径,与逐条表判定以逐条表为准。
---
## 二、逐条判定表(核心)
> 列:序号(对应问题.md) | 客户诉求 | 判定 | 业务影响 | 方案要点 | 复杂度
### 软件问题汇总(S1–S5)
| 序号 | 诉求 | 判定 | 业务影响 | 方案要点 | 复杂度 |
|---|---|---|---|---|---|
| S1 | 删工程编号;一级=合同号/科技项目编号(二选一);二级=产品工号(=工单号);三级=产品序号(=产品编号,每台) | 🔧修改 | **高**:`work_order` 核心表字段重构,影响工单/BOM/工艺/工件追溯/排产/出库归属;双库一致 | 见§三.1 | **高** |
| S2 | 物料档案增「货架区域/货架号/第一层」;图号改材料编码 | 🔧修改 | **中**:物料主数据扩展 + 显示口径反转(与 L18 冲突);库位定位为「默认推荐」非写死 | 见§三.2 | **中** |
| S3 | 工艺页损耗率怎么考虑 | 💬解释 | 无 | 损耗率用于物料需求:`reqQty=分产量×单台用量×(1+损耗率)`(material.go:27)。向客户说明 | 低 |
| S4 | 出库「箱号」解释 | 💬解释 | 无 | 箱号=装箱号(电气件/结构件出库装箱标识,`outbound.boxNo`)。说明用途 | 低 |
| S5 | 自动排产原则 | 💬解释+❓澄清 | 中(涉及排产算法预期) | 排产由「工单+工艺组合+单台用量+库存可生产套数」驱动(producible.go);具体「前松中紧后松」规则需客户给口径(见 M9) | 低(解释)/高(落地) |
### WMS 系统(W1–W12)
| 序号 | 诉求 | 判定 | 业务影响 | 方案要点 | 复杂度 |
|---|---|---|---|---|---|
| W1 | 过程检/完工检放仓储作业是否合适?建议都放 MES | 🔧修改(架构) | **中高**:检验数据归属重划 | 统一口径:来料检留 WMS,过程检/完工检移 MES/巡检终端(关联 M15、T1) | 中高 |
| W2 | 入库归属下拉信息在哪录入 | 💬解释/小🔧 | 低 | 说明归属(工单号/科技项目号/其他)录入入口;若缺失则补录入页 | 低 |
| W3 | 来料检信息不能为空 | 🔧修改(校验) | 低 | 来料检必填校验(inspection 入库环节) | 低 |
| W4 | 来料检批次需录「第几批/共几件」 | 🔧修改(字段) | 中 | 来料检增加批次序号/总件数字段 + 表单/导出 | 中 |
| W4' | 来料检「从库存选批次号」作用 | 💬解释 | 无 | 说明:入库时从已存批次选择,避免重复录入 | 低 |
| W5 | 入库记录增加按归属查询 | 🔧修改(查询) | 中 | 入库查询加归属筛选(出库归属筛选已实现 outbound.go:316,入库需补齐) | 中 |
| W6 | 入库料是否都需建档;能否自动匹配建档 | 🔧修改(增强) | 中 | 入库时图号未建档则自动建档(需决策默认值:名称/规格缺失如何处理) | 中 |
| W7 | 原料不合格转退货/换修,系统如何调整 | 🔧修改(业务流) | 中 | 不合格→退货/换修的状态流转 + 库存红冲/冲正逻辑 | 中 |
| W8 | 库存查询增加按归属查询 | 🔧修改(查询) | 中 | stock 查询加归属筛选(stock.go 已支持区域/货架/层/位置,加归属) | 中 |
| W9 | 来料检是否两条路(待检清单录入 / 手动录入) | 💬解释/❓澄清 | 低 | 确认两条路是否都保留,或合并为一 | 低 |
| W10 | 锁定量=已列排产计划? | 💬解释(**纠正客户误解**) | **中** | 锁定量≠排产:排产仅为计划不锁库存;锁定量是**备料/出库预留**已占用、未实际消耗的量(inventory_lock 表,关联工单号,status=ACTIVE/RELEASED/CONSUMED),恒 ≤ 可用库存。向客户明确此口径,避免「排产即锁库存」误解 | 低 |
| W11 | 产成品入库改名「半成品/成品管理」 | 🔧修改(显示) | 低 | 菜单/页面改名(semi_finished 相关页面) | 低 |
| W12 | AGV 跨厂房接收半成品,能否设虚拟接驳台 | 🔧修改(架构) | **中高**:与技术约束「接驳台只读」冲突 | 见§三.5 | 中高 |
### MES 系统(M1–M15)
| 序号 | 诉求 | 判定 | 业务影响 | 方案要点 | 复杂度 |
|---|---|---|---|---|---|
| M1 | 拧紧查询单独成条目?建议放工件追溯 | 🔧修改(菜单聚合) | 低 | 拧紧查询并入工件追溯页面 | 低 |
| M2 | MES 物料档案改名「设备管理」 | ❓澄清+🔧(命名) | 中 | **源码核实(product.go:8-11)**:MES「物料档案」实为**产品型号/成品档案**(编码主数据单一来源=WMS materials item_type=3,MES 纯代理、本地无缓存表),页面存的就是产品信息,**并非设备**——客户困惑源于菜单命名误导。方案:菜单改「成品档案」消除歧义+向客户澄清;设备/工具档案现系统无实体,若确需属新增模块 | 中 |
| M3 | 工位绑一个工艺,换产品需重绑? | 💬解释/❓澄清 | 低 | 确认业务是否接受「换产品重绑」或改为「工位-工艺多对多」 | 低 |
| M4 | 工艺上提一级:产品→工艺→工艺步骤→BOM链接步骤 | 🔧修改(schema) | **高**:工艺模型重构 | 见§三.3 | **高** |
| M5 | 工艺步骤「采集方式」什么意思?只能传 pdf?考核标准怎么输 | 🔧修改(功能) | 中 | 工艺步骤增「采集方式」字段 + 考核标准输入 + 多附件类型(非仅 pdf) | 中 |
| M6 | 工件追溯需显示过程检/操作工位人员时间/试验数据 | 🔧修改(查询扩展) | 中 | 工件追溯关联 inspection/event_log/workpiece_bind 扩展字段 | 中 |
| M7 | 生产流程卡类似工件追溯 | 💬解释(不合并) | 低 | **源码核实:系统有两种流程卡**——SN 级(processcard.go,按单件打印实绩)+ 型号级全景流程卡(processcard_model.go,按型号聚合标准模板)。与工件追溯(实例交互查询)**不合并**:追溯=页面查询实例、SN 卡=实例打印交付物(数据同源、用途不同)、全景卡=型号模板标准 | 低 |
| M8 | 巡检终端后期完善 | 🚫暂不做 | 无 | 列入后期调试清单 | 低 |
| M9 | 固定日产用于天数<要求?前松中紧后松排产? | 🔧修改(算法)+❓澄清 | **高**:排产算法 | 需客户提供「前松中紧后松」明确规则后再落地 | 高 |
| M10 | 日排产按时间从前到后(现在从后到前) | 🔧修改(排序) | 低 | 颠倒日排产排序(前后端均可,建议后端 order) | 低 |
| M11 | 可生产套数公式=最小库存量/单台用量 | 💬解释(已正确) | 低 | 代码已实现 `min(各物料可用量÷单台含损耗用量)`(producible.go:100),与客户直觉一致;确认是否保留损耗率 | 低 |
| M12 | 多工单同时生产,日排产多栏区分不重叠 | 🔧修改(前端布局) | 低 | 多工单日排产改为多栏表格分组 | 低 |
| M13 | 多工单同时生产,下发工单逻辑未理顺 | 🔧修改(逻辑)+❓澄清 | 中 | 厘清多工单下发逻辑(待代码核实后定稿) | 中 |
| M14 | 备料单「已接料」含义,已发0却显示已接料 | 💬解释/可能bug | 中 | 核实「已接料」判定逻辑(疑似状态显示 bug,待决策后查备料单代码) | 中 |
| M15 | 质量检验栏过程检/完工检为何这里可录入(应是巡检终端录入) | 🔧修改(权限/归属) | 中 | 与 W1/T1 统一:过程检/完工检录入收口到 MES/巡检终端,WMS 质量检验栏移除或只读 | 中 |
### 工位终端(T1–T4)
| 序号 | 诉求 | 判定 | 业务影响 | 方案要点 | 复杂度 |
|---|---|---|---|---|---|
| T1 | 工位步骤完成先申请报检→通过→报工→流转下一步 | 🔧修改(流程) | **高**:工位终端 + MES 工位逻辑流程级改动 | 见§三.4 | **高** |
| T2 | 不需录入信息的工艺步骤是否卡住无法继续 | 💬解释/🔧 | 低 | 确认是否有跳过机制;若无则加「跳过/无信息采集」状态 | 低 |
| T3 | 电气件扫码在哪个页面(装配物料绑定页?) | 💬解释 | 无 | 说明在装配物料绑定页完成电气件扫码 | 低 |
| T4 | 移料作用解释 | 💬解释 | 无 | 说明移料=工位间/暂存-库房间物料转移 | 低 |
---
## 三、重点问题深度方案
### 1. S1 编号体系重构(高风险 · 需评审)
**现状核实**:
- `bj_power_mes/schema/work_order.go:33-36`:`projectNo`(工程编号)、`productSerial`(产品序号) 已存在;`work_order` 是 MES 核心表,关联 BOM、工艺、工件追溯、排产、出库归属。
- WMS 出库侧已有 `ContractNo`(合同号,`outbound.go:427`),归属体系已含合同号/科技项目号。
**客户新口径**:
- 一级:合同号 **或** 科技项目编号(二选一,互斥)
- 二级:产品工号(= 现工单号,对应一类产品)
- 三级:产品序号(= 现产品编号,对应每台产品)
- **删除「工程编号」(projectNo)**
**方案**:
1. `work_order` schema:标记 `projectNo` 弃用(迁移脚本置空/保留历史列但前台不展示,避免破坏既有外键与历史数据);新增 `scienceProjectNo`(科技项目编号) 与现有 `contractNo` 构成「一级二选一」互斥校验。
2. 显示层:`workOrderNo` 文案改「产品工号」,`productSerial` 文案改「产品序号」(前端统一替换,注意导出表头)。
3. 历史数据:已有 `projectNo` 值需决定映射(建议保留为备注或并入合同号),迁移脚本处理。
4. **双库一致性**:WMS 的 `contractNo` 与 MES `work_order.contractNo` 需通过内部 API 对齐;科技项目编号若 WMS 侧也要展示,需扩展 WMS 出库归属字段。
**业务影响**:全链路编号展示/查询/导出变更;工件追溯、排产、BOM 关联键若依赖 `projectNo` 需改;历史报表口径变化。
**风险**:🔴 高。建议单独排期 + 评审 + 迁移脚本 + 回归测试。
**⚠️ 需先澄清的语义分歧(DeepSeek 交叉审计指出,已采纳)**:客户将「工单号改为产品工号,对应一类产品」,这与现有"工单=一次生产任务(做 N 台)"的定义不同。须先与客户确认——
- 选项 A:「产品工号」= 现有 `workOrderNo` 仅改显示文案(低风险,工单模型不变);
- 选项 B:「产品工号」= 新的**产品型号级编号**(工单降为其下属生产任务),则工单-排产-备料模型需重构(高风险)。
**此分歧直接决定 S1 是"改名"还是"语义重构",必须先拍板再动手。**
**选项 B 的真实代价(须让客户知情后再选)**:产品工号升为**产品型号级编号维度**,工单降为其下属生产任务实例(一个产品工号对多张工单)——现有「工单=一次生产任务(N 台)」模型被**推翻**,BOM、排产、备料、工件追溯的关联键全部要改,历史工单数据需迁移映射。这不是"改个名字",而是一次核心业务模型重构,工作量与风险对标 M4 工艺重构。
### 2. S2 物料档案「图号→材料编码」+ 货架三字段(中风险 · 口径冲突)
**现状核实**:
- `bj_power_wms/schema/material.go:48-49`:**历史裁决 L18 已把图号与物料编码合并**,字段 `code` 即图号,界面统一显示「图号」,无独立 drawing_no。
- `bj_power_wms/zone/zone.go` 已有 `shelf_no`(货架号);`stock.go:773` 导出已含「区域/货架/层/位置」——**库存分布侧已支持货架定位**。
- 但**物料主数据(material)没有「默认存放位置」字段**。
**关键冲突**:客户现要求「图号改为材料编码」= **推翻 L18 裁决**。必须先定口径:
- 选项 A:仅改**显示文案**「图号」→「材料编码」(字段 `code` 不变,语义仍是物料编码)。✅ 推荐,零 schema 改动。
- 选项 B:字段语义重构(若客户认为图号≠物料编码需拆回两字段)——工作量大,且与 L18 相悖,需客户明确。
**方案**:
- 「图号改材料编码」→ 采用 **选项 A**:全局替换前端/导出「图号」文案为「材料编码」(`material.go` 导出 `headers`、导入模板 `codeCol`、inbound/stock/outbound 表头等多处)。
- 货架三字段:在 `material` schema 新增 `shelfArea`(货架区域)/`shelfNo`(货架号)/`shelfLayer`(第一层) 三个字段。
- **定位纠偏(DeepSeek 交叉审计指出,已采纳)**:物料档案是「物料字典」,库位是**库存属性**(同一物料可放多库位、不同批次不同位)。因此这三字段**仅作「默认推荐库位」,绝不代表唯一存放位**;入库时自动带出、允许手动覆盖,实际分布仍以 `zone` 表的区域/货架/层/位置为准。向客户说明此设计取舍:满足"在档案页能看到建议存放位"的诉求,同时不破坏"一物多库位"的库存事实。
**业务影响**:物料主数据扩展;导入/导出模板变更;显示口径统一。
**风险**:🟡 中。核心风险是**口径反转**,务必先与客户确认选项 A/B 再动手。
### 3. M4 工艺模型「上提一级」(高风险 · schema 重构)
**客户诉求**:产品规定为「工艺」,芯片安装/喷漆等规定为「工艺步骤」,物料清单链接到工艺步骤;整体上提一级,不再罗列"第一遍红漆/第二遍绿漆"这种下一级。
**源码核实(commit d9d4155)**:现有 MES 工艺模型为
- `ProcessFlow`(表 process_flow):注释即「工艺流程图(菜谱):描述『这个工位怎么干』,承载工艺图纸 PDF + 工序步骤模板」,当前**只绑工位**(`station.flow_id`),**无产品归属**,name 如"3号工位装配流程"。
- `ProcessStep`(表 process_step):注释即「工序步骤模板:一份工艺流程包含多个采集/考核步骤」,字段 `flowId`(所属流程图)、`collectType`(AUTO/MANUAL/NONE)、`needCheck`(报工前须检验通过)、`attachment`(多附件)。
- 另有 `step_criterion`(考核标准)、`step_data`(步骤数据)。
> 即:现有「工艺/步骤」命名**已与客户用词基本对应**,所谓"名字全变"不实(见第八节驳回项)。
**方案(明确三级:产品 → 工艺 → 工艺步骤)**:
1. **补「产品级归属」是核心改动**:`ProcessFlow` 增加 `productId`(或归属 work_order 的产品) 字段,使其从"工位通用模板"升级为"某产品的专属工艺";原工位绑定关系保留为"工艺下某步骤绑工位"。
2. `ProcessStep` 保持为「工艺步骤」(芯片安装/喷漆),挂 `collectType`/`needCheck`/考核标准/多附件/BOM 链接(M5 扩展采集方式与考核标准)。
3. **移除"子步骤"层级**:红漆/绿漆等合并为步骤的工艺参数/工序说明,不再独立建模。
4. 联动:排产(BOM 用量)、工件追溯、工位绑定(M3)同步适配。
**业务影响**:工艺、BOM、排产、工件追溯、工位绑定全链路受影响。
**风险**:🔴 高。建议与 M3/M5/M6 一并规划,单独大版本迭代。
### 4. T1 工位终端「报检→报工→流转」(高风险 · 流程级)
**客户诉求**:工位步骤完成后,先申请报检(检验工作与工位工作汇总到施工单)→ 报检通过 → 报工(上传工作量) → 流转至下一步骤对应工位。
**方案**:
1. 工位终端 workflow 增加「申请报检」状态节点:步骤完成 → 申请报检(待检) → 检验通过/驳回 → 通过后才允许报工 → 流转。
2. MES 工位逻辑增加报检-报工状态机;与 W1/M15 检验归属统一(过程检归 MES/巡检终端)。
3. 「施工单」汇总:报检与工位工作量体现在施工单(生产流程卡/工件追溯关联)。
**业务影响**:工位终端核心作业流变更;与 MES 工位状态、巡检终端打通。
**风险**:🔴 高。需明确报检由谁(巡检终端/工位终端)操作、驳回后处理路径。
**与现有「检测确认」(needCheck)的关系(源码核实 process_step.go:31、workpiece.go:256-358)**:
- `needCheck` 是**标记**:工艺步骤配置时勾选"是否需要检测确认",决定该步骤报工前须检验。
- 现有实现是**工人自检**:报工时对 needCheck 步骤逐条带 `checked=true`,服务端强校验(`validateNeedCheck`),缺失即拒绝报工。
- T1 的「报检」是**动作/流程节点**:把"工人勾选自检"升级为"正式报检申请 → 检验员通过/驳回 → 通过后才许报工"。
- 两者是**配合关系而非重复**:needCheck 决定哪些步骤触发报检;报检流程上线后,needCheck 步骤的通过依据从"勾选"变为"报检单通过",服务端校验点相应从 checked 字段改为报检状态。
### 5. W12 虚拟接驳台(中高风险 · 架构冲突)
**现状核实**:技术约束第49行——「接驳台是 WMS 侧**只读主数据**(不可新增/修改,仅查看,与实际接驳台一一对应)」;PLC 仅反馈到位信号。现有 dock 主数据(DOCK01~20 产线 / DOCK21 库房)。
**冲突**:客户要「跨厂房接收半成品的虚拟接驳台」= 新增接驳点,违反「只读不可新增」。
**方案(需决策)**:
- 选项 A:放开 dock 主数据的新增能力,新增「虚拟接驳台」类型(标记 `virtual=true`,不参与 PLC 到位信号校验),用于跨厂房接驳。需修改 WMS dock 管理页(当前只读→可维护虚拟台)。
- 选项 B:沿用现有 DOCK 体系,把跨厂房接驳点映射为已有 DOCK 编号,不新增(若实际物理点位已涵盖)。
- 选项 C:暂不做,待现场 AGV/海康 RCS 对接时一并设计。
**业务影响**:WMS dock 主数据可维护性变更;AGV 配送路径可能扩展。
**风险**:🟡 中高。建议结合《AGV海康.md》对接方案再定。
---
## 四、实施分期建议
| 批次 | 范围 | 代码量 | 风险 | 建议时机 |
|---|---|---|---|---|
| **批次① 解释闭环** | 全部 💬解释类(S3/S4/S5部分/W2/W4'/W9/W10/T2/T3/T4/M7/M11 等 11 条) | 零/极低 | 低 | **立即**:整理成给客户的文字说明(纯文字+表格,不出现代码),先回应客户疑问,建立信任 |
| **批次② 低风险修改** | 显示改名(W11/M1)、查询扩展(W5/W8)、校验(W3)、排序(M10/M12)、小字段(W4) | 中 | 低-中 | 第二批:纯前端/查询/handler 层,不碰核心 schema |
| **批次③ 高风险变更** | S1 编号体系、S2 货架+口径、M4 工艺重构、T1 报检流程、W1/M15 检验归属、W12 虚拟接驳台、W6/W7 业务流、M9 排产算法、M5/M6 工艺步骤扩展 | 大 | **高** | 第三批:每项单独评审 + 迁移脚本 + 回归;建议 S1/M4/T1/W1 四大项先出专项方案 |
---
## 五、需客户/产品澄清清单(❓)
1. **S5/M9 排产规则**:「前松中紧后松」的具体量化规则(前期/中期/后期比例或斜率)?固定日产的天数判定阈值?
2. **S2 图号口径**:确认「图号改材料编码」是仅改显示文案(选项A)还是字段语义重构(选项B)?—— **阻断 S2 实施**。
3. **W1/M15/T1 检验边界**:来料检(留WMS)、过程检/完工检(归MES/巡检终端) 的划分客户是否认可?报检由谁操作?
4. **W6 自动建档默认值**:入库图号未建档时,名称/规格/单位缺失如何默认值?是否允许半成品自动建档?
5. **M4 工艺模型**:确认「产品→工艺→工艺步骤→BOM链接步骤」两级结构即客户预期,子步骤(红漆/绿漆)合并为步骤参数。
6. **W12 虚拟接驳台**:跨厂房实际物理点位是否已纳入现有 DOCK?还是必须新增虚拟台(选项A/B/C)?
7. **M2 MES「物料档案」定位**:源码核实该页实为**产品型号/成品档案**(WMS 代理),并非设备。需与客户确认:菜单改名「成品档案」消除误导即可,还是客户确实需要**新增设备/工具档案模块**(现系统无此实体,属新增功能单独评估)?
---
## 六、风险与依赖
- **双库隔离**:MES(`bj_power_mes`) 与 WMS(`bj_power_wms`) 独立库,跨系统字段(合同号/归属/物料编码)需通过内部 API(`X-API-TOKEN=Hardman_2026`)对齐,S1/W12 尤甚。
- **历史裁决冲突**:S2 与 L18、W12 与技术约束「接驳台只读」均冲突,**先定口径再改**,避免反复。
- **schema 迁移**:S1/M4 涉及 ent schema 变更,需用 migrateonce/Atlas 迁移(本机已重建空库,迁移后需重新灌种子数据才能登录)。
- **种子数据**:当前双库为空(本次已最干净重建),任何功能验证前需先灌管理员/角色/基础主数据种子。
- **回归面大**:编号体系(S1)、工艺模型(M4)、工位流程(T1) 是三大牵一发动全身的改造,建议各自独立专项方案 + 评审,不要混在普通迭代里。
---
## 七、给客户的「解释类」回复草拟(批次①用,纯文字,不出现代码)
> 以下为口径草案,待你确认后正式发出:
> - **损耗率**:用于计算物料需求,公式为「需求量 = 分产量 × 单台用量 ×(1+损耗率)」,损耗率体现生产损耗预留。
> - **箱号**:指物料出库装箱时的装箱编号,用于电气件/结构件按箱出库与追溯。
> - **自动排产原则**:系统依据「生产工单 + 工艺组合 + 单台用量 + 当前库存可生产套数」自动推算排产;具体排产松紧节奏待与贵方确认规则后落地。
> - **来料检「从库存选批次号」**:入库时若物料已在库,可直接选取已有批次,避免重复录入批次信息。
> - **锁定量**:指**备料/出库预留时已实际占用、尚未消耗**的库存量(如某工单锁定 50 件防超卖),**不是排产计划量**——排产只是计划、不锁库存,且排产量可大于库存;锁定量恒 ≤ 可用库存,不参与可用量计算。
> - **电气件扫码**:在「装配物料绑定」页面完成电气件 SN 扫码绑定。
> - **移料**:指物料在工位间或暂存-库房间的转移操作。
> - **可生产套数公式**:当前已实现「各物料可用量 ÷ 单台用量(含损耗)取最小值」,与贵方理解一致;损耗率是否剔除待确认。
---
## 八、DeepSeek 交叉审计后的独立核实与修正
> 本文档已交另一模型(DeepSeek)交叉审计。以下为本人**对照源码 d9d4155 独立核实后**的采纳/驳回结论,不盲从。
### 一、采纳并修正(4 处)
1. **W10 锁定量 ≠ 排产**:核实 `inventory_lock.go`——锁是工单占用(备料/出库预留),关联 `order_no`,`status=ACTIVE/RELEASED/CONSUMED`;排产 `daily_plan` 不产生锁。已改 W10 判定与草拟回复,明确「锁定量恒≤可用、非排产」。
2. **S2 物料档案库位定位为「默认推荐」而非写死唯一库位**:物料档案=字典,库位是库存属性。已强化方案:三字段作默认推荐位,入库带出可改,并向客户说明取舍。
3. **M4 明确三级(产品→工艺→工艺步骤)**:采纳「三级」结构(原文档写两级)。但其映射判断错误,已纠正,见下。
4. **M9 排产算法列入高风险**:影响排产/备料/出库全链路,客户未给量化规则,须单独评审。已加入 6 大高风险清单。
### 二、驳回 / 纠正(DeepSeek 的代码臆测)
- **M4 映射错误**:DeepSeek 称「客户说的工艺=现在系统的产品,工艺步骤=现在的工艺,名字全变」。源码核实:`ProcessFlow` 注释本就是"工艺流程图"、`ProcessStep` 本就是"步骤"——**命名与客户用词基本对应,名字没变**。真正缺口是 `ProcessFlow` 当前只绑工位(`station.flow_id`)、**无产品归属**。重构核心是**给工艺补「产品级归属」(productId)**,而非把 ProcessFlow 当成"产品"重命名。若按其错误映射重构会改错方向。
- **M11 公式**:DeepSeek 假设"若当前是总库存÷总用量就是错的,应改 min()"。源码核实 `producible.go:100` 已实现 `min(各物料可用量÷单台含损耗用量)`,**与客户直觉一致,无需改公式**,仅确认是否保留损耗率。本文档原判定正确,未改。
### 三、统计修正
- 软件问题汇总实为 **5 条**(S1–S5,原文无第 6 条),前文误写 6;WMS 实质 **13 条**(编号「4」重复)。合计仍 37。已修正全景统计表与逐条表口径。
### 四、结论
DeepSeek 的框架性判断(风险分级、批次推进、检验归属统一、L18 冲突、W12 冲突、M11 已正确)总体成立;其 4 处修正中 3 处实质成立、1 处(M4 映射)方向对但具体映射错,已纠正。**本文档现为修订版,可直接用于与客户对齐。**
---
## 九、逐条对照表:原问题 · 对应方案 · 影响范围
> 本章将《问题.md》37 条原文与本文方案/影响一一对应,便于决策时逐条核对。判定符号:🔧修改 / 💬解释 / ❓需澄清 / 🚫暂不做。标注「详见§三.x」者方案深度分析见第三节,标注「第五/八节」者为待澄清决策点。
### 9.1 软件问题汇总(S1–S5)
#### S1 编号体系重构
- **原问题**:删除工程编号。一级=合同号/科技项目编号(二选一,互斥);二级=产品工号(=工单号,对应一类产品);三级=产品序号(=产品编号,对应每台产品)。
- **对应方案**(🔧修改,详见§三.1):① `work_order.projectNo` 标记弃用(迁移脚本置空/保留历史列但前台不展示,避免破坏外键);② 新增 `scienceProjectNo` 与现有 `contractNo` 构成「一级二选一」互斥校验;③ 显示层 `workOrderNo`→产品工号、`productSerial`→产品序号(前端+导出表头统一替换);④ 历史 `projectNo` 值决定映射(建议并入合同号或留备注);⑤ MES 与 WMS 双库通过内部 API 对齐合同号/科技项目号。**⚠️需先拍板语义分歧**:「产品工号」=现有 `workOrderNo` 仅改名(选项A,低风险)还是新产品型号级编号(选项B)。**选项 B = 推翻现有「工单=一次生产任务」模型**——产品工号升为型号级维度、工单降为其下属实例(一对多),BOM/排产/备料/追溯关联键全改 + 历史数据迁移,不只是改名(详见§三.1)。
- **影响范围**:🔴 高。`work_order` 核心表字段重构,牵一发动全身——工单/BOM/工艺/工件追溯/排产/出库归属全链路;MES 持 `work_order`、WMS 持 `contractNo` 双库需一致;历史报表口径变化。
#### S2 物料档案货架三字段 + 图号改材料编码
- **原问题**:库房管理物料档案页面增加货架区域、货架号、第一层(存放位置);其中图号改为材料编码。
- **对应方案**(🔧修改,详见§三.2):图号→材料编码采用**选项 A(仅改显示文案)**:`material.code` 字段不变,全局替换前端/导出「图号」文案为「材料编码」(material 导出 headers、导入模板、inbound/stock/outbound 表头等多处)。货架三字段在 `material` 新增 `shelfArea/shelfNo/shelfLayer`,**定位为「默认推荐库位」**(物料字典≠库存属性,同一物料可多库位),入库自动带出、允许手动覆盖,实际分布仍以 zone 表为准。
- **影响范围**:🟡 中。物料主数据扩展、导入/导出模板变更、显示口径统一;**与 L18 历史裁决(图号=物料编码已合并、界面叫图号)直接冲突,须先定口径(选项A/B)再动手**。
#### S3 损耗率解释
- **原问题**:工艺页面损耗率解释一下怎么考虑?
- **对应方案**(💬解释):向客户说明 `reqQty = 分产量 × 单台用量 × (1+损耗率)`(material.go:27),损耗率为生产预留,实际消耗按单台用量反冲、多备退库。
- **影响范围**:无(零代码,解释类)。
#### S4 箱号解释
- **原问题**:出库管理内"箱号"解释一下?
- **对应方案**(💬解释):箱号=物料出库装箱编号(电气件/结构件按箱出库与追溯,`outbound.boxNo`),用于整箱发货场景扫箱带出箱内所有 SN;若无需整箱可说明是否保留。
- **影响范围**:无(解释类)。
#### S5 自动排产原则
- **原问题**:解释一下自动排产原则是什么?(根据什么进行排产)
- **对应方案**(💬解释+❓澄清):排产由「生产工单 + 工艺组合 + 单台用量 + 当前库存可生产套数」驱动(producible.go);具体松紧节奏("前松中紧后松")规则需客户给量化口径(见 M9)。
- **影响范围**:中(解释低,但落地为算法改造高风险,见 M9)。
### 9.2 WMS 系统(W1–W12 + W4')
#### W1 过程检/完工检归属
- **原问题**:把过程检验和完工检验放到仓储作业里,是不是不合适?过程检验指工序间检验吗;完工指生产过程中的完工检验吧,建议都放入 MES。
- **对应方案**(🔧修改·架构):统一检验归属口径——**来料检留 WMS(入库环节),过程检/完工检移 MES/巡检终端**(与 M15、T1 联动),WMS 质量检验栏相应移除或只读。
- **影响范围**:🟡 中高。检验数据归属重划,WMS/MES/巡检终端三端需对齐,避免各自改一通后对不上。
#### W2 入库归属录入入口
- **原问题**:入库中的归属信息是下拉列表,具体的信息是在哪里录入?
- **对应方案**(💬解释/小🔧):说明归属(工单号/科技项目号/其他)的录入入口;若系统确实缺失录入页则补录入功能。
- **影响范围**:低。
#### W3 来料检必填
- **原问题**:来料检的信息不能为空。
- **对应方案**(🔧修改·校验):来料检字段必填校验(inspection 入库环节),空值禁止提交。
- **影响范围**:低(handler 层校验)。
#### W4 来料检批次序号/总件数
- **原问题**:来料检如果是批次,那需要录入第多少批,共多少件。
- **对应方案**(🔧修改·字段):来料检增加「批次序号/总件数」字段 + 表单/导出。
- **影响范围**:中(schema 扩展 + 表单/导出)。
#### W4' 从库存选批次号作用
- **原问题**:来料检里的从库存选批次号是什么作用?
- **对应方案**(💬解释):入库时若物料已在库,可直接选取已有批次,避免重复录入批次信息(相当于"从待检库存里选")。
- **影响范围**:无(解释类)。
#### W5 入库记录按归属查询
- **原问题**:入库记录增加一个按归属查询。
- **对应方案**(🔧修改·查询):入库查询加归属筛选(出库归属筛选已实现 outbound.go:316,入库侧补齐)。
- **影响范围**:中(查询扩展)。
#### W6 入库自动建档
- **原问题**:现在入库的料是否都需要建档,那能否在添加物料入库的时候,自动匹配,新的材料自动建档?
- **对应方案**(🔧修改·增强):入库时图号未建档则自动建档;**需决策默认值**(名称/规格/单位缺失如何处理、是否允许半成品自动建档)。
- **影响范围**:中(建档逻辑 + 默认值策略)。
#### W7 不合格转退货/换修
- **原问题**:原料类如果刚开始判定合格入库,实际使用过程中不合格,转为退货或换修,系统如何修改和调整?
- **对应方案**(🔧修改·业务流):不合格→退货/换修的状态流转 + 库存红冲/冲正逻辑 + 隔离区管理。
- **影响范围**:中(库存质量状态翻转 + 单据生成)。
#### W8 库存查询按归属
- **原问题**:库存查询增加一个按归属查询。
- **对应方案**(🔧修改·查询):stock 查询加归属筛选(stock.go 已支持区域/货架/层/位置,补归属维度)。
- **影响范围**:中(查询扩展)。
#### W9 来料检两条路
- **原问题**:现在来料检验中,是否保函两条路,一条是输入物料待检报检后从已选清单完成检验结果录入;另外一条是在来料检验栏中手动输入信息提交检验记录?
- **对应方案**(💬解释/❓澄清):确认两条路是否都保留(待检清单勾选带入 / 手动录入急件)或合并为一。
- **影响范围**:低(解释/口径确认)。
#### W10 锁定量定义(纠正客户误解)
- **原问题**:锁定量是说已列至排产计划的?
- **对应方案**(💬解释·纠正):**锁定量 ≠ 排产计划**。排产仅为计划、不锁库存(排产量可大于库存);锁定量是**备料/出库预留时已从可用库存划走、防超卖的量**(inventory_lock 表,关联工单号,status=ACTIVE/RELEASED/CONSUMED),恒 ≤ 可用库存,不参与可用量计算。
- **影响范围**:🟡 中。属口径澄清,但影响客户对备料/出库的理解,须明确以免后续口径混乱。
#### W11 产成品入库改名
- **原问题**:产成品入库在哪里?如果跟半成品写到一起,那改名为"半成品/成品管理"。
- **对应方案**(🔧修改·显示):菜单/页面改名(semi_finished 相关页面 → "半成品/成品管理")。
- **影响范围**:低(显示文案)。
#### W12 虚拟接驳台
- **原问题**:需要在 AGV 穿越到相邻厂房,接收半成品到库房。能否设置虚拟接驳台?
- **对应方案**(🔧修改·架构,详见§三.5):**与技术约束「接驳台只读不可新增」冲突,需决策**——选项 A 放开 dock 新增「虚拟接驳台」(virtual=true,不参与 PLC 到位校验);选项 B 映射现有 DOCK 编号不新增;选项 C 暂不做(待 AGV/海康 RCS 对接时设计)。
- **影响范围**:🟡 中高。WMS dock 主数据可维护性变更;AGV 配送路径可能扩展;需结合《AGV海康.md》。
### 9.3 MES 系统(M1–M15)
#### M1 拧紧查询并入工件追溯
- **原问题**:拧紧查询是否有必要单独成一条目,建议放到工件追溯中。
- **对应方案**(🔧修改·菜单聚合):拧紧查询并入工件追溯页面(查工件即看拧紧记录)。
- **影响范围**:低(菜单整合)。
#### M2 MES「物料档案」改名设备管理
- **原问题**:mes 里的物料档案,是不是没有关于产品和物料的信息,应保存的都是产线设备和其他生产物料工具,改名为设备管理。
- **对应方案**(❓澄清+🔧·命名,**源码核实后改判**):MES「物料档案」(produce.product → /product-type)实为**产品型号/成品档案**——编码主数据单一来源 = WMS(materials item_type=3),MES 纯代理、无本地表(product.go:8-11),页面存的就是产品信息,**并非设备**。客户困惑的根源是**菜单命名误导**(叫"物料档案"却只显示成品)。方案:① 菜单/页面改名「成品档案」消除歧义(UI);② 向客户澄清该页实际数据就是产品档案(产品);③ 若客户确需「设备/工具管理」,现系统无设备实体(station 仅为工位状态),属新增模块、单独评估,**不并入本次改名**。
- **影响范围**:中(菜单命名 + 客户口径澄清;若新增设备模块则另立专项)。
#### M3 工位换产品重绑
- **原问题**:工位绑定中如果一个工位只能绑定一个工艺,那更换生产产品的话,需要重新绑定?
- **对应方案**(💬解释/❓澄清):确认业务是否接受「换产品重绑」,或改造为「工位-工艺多对多」快速切换。
- **影响范围**:低(解释/口径)。
#### M4 工艺上提一级(三级结构)
- **原问题**:工艺列表中,是不是应该生产的某项产品规定为工艺,芯片安装、喷漆这种规定为工艺步骤,然后物料清单链接工艺步骤?整体上提一级,工艺步骤不再罗列比如第一遍红漆、第二遍绿漆这种再下一级的工作内容。
- **对应方案**(🔧修改·schema,详见§三.3):明确**三级(产品→工艺→工艺步骤)**。核心是给 `ProcessFlow` 补 `productId` 产品级归属(当前只绑工位 `station.flow_id`、无产品);`ProcessStep` 保持为「工艺步骤」(芯片安装/喷漆),挂 `collectType`/`needCheck`/考核标准/多附件/BOM 链接;移除"子步骤"层级(红漆/绿漆合并为步骤参数)。
- **影响范围**:🔴 高。工艺、BOM、排产、工件追溯、工位绑定(M3)全链路受影响,需与 M3/M5/M6 一并规划、单独大版本迭代。
#### M5 工艺步骤采集方式/考核标准/多附件
- **原问题**:工艺步骤中的采集方式是什么意思?工艺步骤只能上传 pdf 附件。考核标准是怎么输进去?
- **对应方案**(🔧修改·功能):工艺步骤增「采集方式」字段(手动/扫码/设备自动)+ 考核标准输入 + 多附件类型(非仅 pdf)。
- **影响范围**:中(工艺步骤模型扩展 + 表单)。
#### M6 工件追溯扩展字段
- **原问题**:工件追溯需要显示出现有内容外,还需要查看工件的过程检验情况、操作工位、操作人员、操作时间,试验数据。
- **对应方案**(🔧修改·查询扩展):工件追溯关联 inspection/event_log/workpiece_bind 扩展展示字段。
- **影响范围**:中(追溯查询扩展)。
#### M7 生产流程卡类似工件追溯
- **原问题**:生产流程卡主要是用于对单个工件依据标准,使用原材料情况、生产情况、检验情况的记录和追溯,跟工件追溯功能类似。
- **对应方案**(💬解释·**明确不合并**,源码核实):系统实有**三种定位**——① 工件追溯=按 SN **交互查询**单件全生命周期(页面);② SN 级流程卡(processcard.go)=按单件**打印实绩**交付物(数据与追溯同源,用途是纸质/现场流转);③ 型号级全景流程卡(processcard_model.go)=按产品型号聚合的**标准模板**(工位组合→工艺步骤→物料清单→检验卡项)。**三者不合并**:追溯与 SN 卡是"查询 vs 打印"同源双出口,全景卡是模板。向客户说明差异即可,无需代码改动。
- **影响范围**:低(解释,无代码改动)。
#### M8 巡检终端后期完善
- **原问题**:巡检终端部分功能可能需要在后期调试时继续完善。
- **对应方案**(🚫暂不做):列入后期调试完善清单,本期不实现。
- **影响范围**:无。
#### M9 前松中紧后松排产
- **原问题**:固定日产是用于生产天数小于工程要求天数?实际情况多为前期不熟练生产慢,中后期加快,所以排产应保持前松、中紧、后松状态,是否可实现?
- **对应方案**(🔧修改·算法+❓澄清,列入6大高风险):当前自动排产仅支持平均分摊/固定日产,**不支持前松中紧后松**;该需求属学习曲线模型。需客户先给出量化规则(前期/中期/后期比例或斜率)再落地,建议先做固定比例、动态调整二期。
- **影响范围**:🔴 高。排产算法重写,直接影响生产计划、备料、出库全链路;客户未给量化比例,须单独评审 + 拍板。
#### M10 日排产时间排序
- **原问题**:日排产栏中按时间从前到后排序修改,现在为从后到前。
- **对应方案**(🔧修改·排序):颠倒日排产排序(建议后端 order by 排产日期 asc)。
- **影响范围**:低(排序调整)。
#### M11 可生产套数公式
- **原问题**:可生产套数的公式是不是错了,应该是最小库存量/单台用量。
- **对应方案**(💬解释·已正确):代码已实现 `min(各物料可用量 ÷ 单台含损耗用量)`(producible.go:100),与客户直觉一致,**无需改公式**;仅确认是否保留损耗率。
- **影响范围**:低(解释,无代码改动)。
#### M12 多工单日排产区分
- **原问题**:多个工单同时生产的话,日排产栏中使用多栏表格或其他方式将不同工单号的进行区分,不要重叠放到一起。
- **对应方案**(🔧修改·前端布局):多工单日排产改为多栏表格分组展示(按工单号分栏)。
- **影响范围**:低(前端布局)。
#### M13 多工单下发逻辑
- **原问题**:多个工单同时生产时,下发工单操作的逻辑是不是还没有理顺?
- **对应方案**(🔧修改·逻辑+❓澄清):厘清多工单同时下发逻辑(待代码核实后定稿是否需要扩展并发下发)。
- **影响范围**:中(下发逻辑)。
#### M14 备料单已接料显示
- **原问题**:备料单中的表格内,操作栏显示已接料是什么意思,已发出为0,为什么就显示已接料?
- **对应方案**(💬解释/可能 bug):核实「已接料」状态判定逻辑(疑似状态显示 bug:已发出=0 不应显示已接料),决策后查备料单代码修复。
- **影响范围**:中(可能状态逻辑修正)。
#### M15 过程检/完工检录入归属
- **原问题**:质量检验栏中的过程检和完工检,这两项不应该是巡检终端录入的吗,为什么会在这里可以录入?
- **对应方案**(🔧修改·权限/归属):与 W1/T1 统一——过程检/完工检录入收口到 MES/巡检终端,WMS 质量检验栏移除或只读。
- **影响范围**:中(录入归属收口 + 权限)。
### 9.4 工位终端(T1–T4)
#### T1 报检→报工→流转流程
- **原问题**:当前工位的步骤完成后,应该先申请报检(将检验工作与工位工作汇总到施工单),报检通过后,报工(上传工作量)并流转至下一步骤对应工位。
- **对应方案**(🔧修改·流程,详见§三.4):工位终端 workflow 增加「申请报检」节点(步骤完成→申请报检待检→检验通过/驳回→通过后才允许报工→流转);MES 工位逻辑加报检-报工状态机;与 W1/M15 检验归属统一。**与现有「检测确认」(needCheck)为配合关系而非重复**:needCheck=步骤级标记(哪些步骤须检,现实现为工人报工时勾选+服务端强校验 validateNeedCheck);「报检」=动作节点(检验员通过/驳回),上线后 needCheck 步骤的通过依据由"勾选"升级为"报检单通过"(详见§三.4)。
- **影响范围**:🔴 高。工位终端核心作业流 + MES 工位状态机 + 巡检终端打通,流程级改动。
#### T2 无信息步骤是否卡住
- **原问题**:有些工艺步骤是不需要录入信息的,是否会卡到这一步无法继续处理?
- **对应方案**(💬解释/🔧):确认是否有跳过机制;若无则加「跳过/无信息采集」状态,允许直接完成。
- **影响范围**:低。
#### T3 电气件扫码页面
- **原问题**:工位上对需要组装的电气件进行扫码,这一工作在哪个页面完成,是装配物料绑定页面吗?
- **对应方案**(💬解释):在「装配物料绑定」页面完成电气件 SN 扫码绑定到当前工件。
- **影响范围**:无(解释类)。
#### T4 移料作用
- **原问题**:移料的作用解释一下。
- **对应方案**(💬解释):移料=物料在工位间或暂存-库房间转移操作,系统记账,实际流转靠人工/AGV。
- **影响范围**:无(解释类)。
### 9.5 决策优先级速查
| 优先级 | 条目 | 决策点(详见第五/八节) |
|---|---|---|
| 🔴 必须先拍板 | S1 / M4 / T1 / W1 / W12 / M9 | 改名 or 重构、口径 or 放开、量化规则 |
| 🟡 需定口径后做 | S2 / M2 / W6 / W7 / M3 / M13 / M14 | 默认值、业务流边界、是否 bug、菜单定位澄清 |
| 🟢 可直接做 | S3/S4/S5/W2/W3/W4/W4'/W5/W8/W9/W10/W11/M1/M5/M6/M7/M10/M11/M12/T2/T3/T4 | 低风险,批次①/②推进 |
| ⚪ 暂不做 | M8 | 列入后期 |
---
## 十、第二轮交叉审计(DeepSeek 5 处修正的独立核实)
> 客户转来 DeepSeek 二审意见(5 处修正)。逐条对照源码 d9d4155 独立核实:**1 处已被现有文本覆盖、2 处采纳、1 处采纳并精确化、1 处按代码事实改判**。不盲从,结论如下。
| # | DeepSeek 修正 | 核实结果 | 处理 |
|---|---|---|---|
| 1 | W10 补「排产不锁库存、锁定量≤可用库存」 | **已覆盖**:§二逐条表、§七草拟回复、§九 W10 三处均已显式写明「排产仅为计划、不锁库存(排产量可大于库存);锁定量恒 ≤ 可用库存」 | 无需改 |
| 2 | M7 明确「不合并,实例 vs 模板」 | **采纳并精确化**:源码实有**两种流程卡**(SN 级实例打印 processcard.go + 型号级全景模板 processcard_model.go)+ 工件追溯,三种定位均不合并;"实例 vs 模板"二分法不全(SN 卡与追溯都是实例,是"查询 vs 打印"之别) | §二/§九 M7 已改 |
| 3 | M2 先核实 MES 物料档案存了什么 | **按代码事实改判**:核实 product.go——该页是**产品型号/成品档案**(WMS 代理 item_type=3,本地无表),存的就是产品信息、**并非设备**;客户"应保存的都是产线设备"与代码事实不符。「设备管理」改名不成立,真正问题是**菜单命名误导**,改「成品档案」即可;设备/工具档案若确需属新增模块 | §二/§五/§九 M2 已改判,移出批次② |
| 4 | T1 补「报检」与「检测确认」关系 | **采纳**:源码证实 needCheck(process_step.go:31,标记+工人勾选自检+服务端强校验 validateNeedCheck)已存在;「报检」=动作节点,两者配合不重复,上线后通过依据由"勾选"升级为"报检单通过" | §三.4/§九 T1 已补 |
| 5 | S1 补「选项B=推翻工单模型」 | **采纳**:选项 B 后果已写透——产品工号升为型号级维度、工单降为实例(一对多)、关联键全改+历史迁移,工作量对标 M4 | §三.1/§九 S1 已补 |
### 三重角色视角的增量优化(架构 / 产品 / UI)
- **架构**:M2 无拆表问题(MES 本地无表、纯 WMS 代理,主数据单一来源原则不被破坏);T1 报检节点可复用 `inspection_record`(已有 `reportNo` 报检单号字段)扩展为工序报检或新实体,实施时定;S1 若选 B 需全链路迁移脚本 + 回归。
- **产品**:M2 的根源是**客户对菜单命名的误解**——先澄清页面实际数据(产品/成品档案),再谈改名,避免为不存在的"设备档案"做改造;W10 口径已进解释稿,客户疑问可直接回应。
- **UI**:菜单命名规范化(MES「物料档案」→「成品档案」,与 WMS「物料档案」明确区分,消除跨系统同名不同义的混淆);工位终端报检节点需设计按钮状态机(可报检/待检/驳回/可报工);M12 多工单分栏避免重叠。
> 本文档现为**第三版**,可直接用于与客户对齐。