From f5f0e65c5732b65a50461887c18492666e60f1df Mon Sep 17 00:00:00 2001 From: "weixiao_world@163.com" Date: Sun, 27 Sep 2026 21:07:21 +0800 Subject: [PATCH] =?UTF-8?q?docs:=20=E6=96=B0=E5=A2=9E=E7=94=B2=E6=96=B9?= =?UTF-8?q?=E9=97=AE=E9=A2=98=E6=B8=85=E5=8D=95=E5=8F=8A=E6=95=B4=E6=94=B9?= =?UTF-8?q?=E6=96=B9=E6=A1=88=E6=96=87=E6=A1=A3?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- 问题.md | 50 ++++ 问题清单整改方案_待决策.md | 483 +++++++++++++++++++++++++++++++++++++ 2 files changed, 533 insertions(+) create mode 100644 问题.md create mode 100644 问题清单整改方案_待决策.md diff --git a/问题.md b/问题.md new file mode 100644 index 0000000..2690b33 --- /dev/null +++ b/问题.md @@ -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、移料的作用解释一下。 + + diff --git a/问题清单整改方案_待决策.md b/问题清单整改方案_待决策.md new file mode 100644 index 0000000..4105778 --- /dev/null +++ b/问题清单整改方案_待决策.md @@ -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 多工单分栏避免重叠。 + +> 本文档现为**第三版**,可直接用于与客户对齐。