feat&refactor: 2026-09-22 半成品业务模型重构与功能完善

- 重构半成品流转逻辑:进度权威源改为 workpiece.currentStationNo,新增 completedText 快照字段,废除 doneProcessCodes
- 清理物料品类中半成品类型,存量数据幂等清理,调整物料管理方式文案为批次/序列号
- 新增日排产状态专用更新接口,修复工单工艺校验逻辑
- 新增物料档案代理接口、深路径文件下载接口
- 优化前端界面文案与工位选择逻辑,补充追溯页半成品流转展示
- 调整WMS端物料品类校验与入库接口契约
- 新增/更新数据库表结构与实体类代码
This commit is contained in:
SunYF
2026-09-22 14:42:52 +08:00
parent 09cfc6ca1c
commit d3eda6b588
49 changed files with 1155 additions and 1122 deletions
+9 -9
View File
@@ -68,7 +68,7 @@ export const helpOutbound = {
{ name: '备料出库-目标工位', source: '下拉选择 DOCK01~DOCK20(选填,可过滤搜索)。', purpose: 'AGV 配送送达的接驳台(toDock 参数)', fill: '选择如 DOCK05;不选默认运到产线入口 DOCK01' },
{ name: '备料出库-一键分配出库', source: '系统自动按 FIFO 分配。数据来自合格区Z02的批次库存。', purpose: '从合格区按先进先出凑够缺口并出库', fill: '点按钮,系统自动算批次并二次确认' },
{ name: '通用出库-物料', source: '下拉选择(全项目统一组件)。', purpose: '选定要出库的物料', fill: '下拉显示 编码/图号/类型(电气件/结构件/其他)/品类(原材料/半成品/成品/其他),支持远程搜索' },
{ name: '通用出库-出库类型', source: '系统自动判定(来自物料档案的管理粒度)。', purpose: '决定走批次扣减还是 SN 扣减', fill: '只读:选物料后自动显示结构件(批次)或电气件(SN),无需也不允许手选' },
{ name: '通用出库-出库类型', source: '系统自动判定(来自物料档案的管理粒度)。', purpose: '决定走批次扣减还是 SN 扣减', fill: '只读:选物料后自动显示批次或序列号,无需也不允许手选' },
{ name: '通用出库-出库类别', source: '下拉点选(纯标签记录,不联动任何地方)。', purpose: '区分退料/退货/样品/报废/发货/其他,列表与出库单均显示', fill: '必选;选「其他」时需在备注填写具体原因' },
{ name: '通用出库-归属', source: '下拉选归属类型 + 手填归属编号。', purpose: '记录出库归属(工单编号/科技项目号/其他),仅追溯不联动 MES', fill: '默认「其他」;选工单编号/科技项目号时归属编号必填,长度≤64' },
{ name: '通用出库-目标工位', source: '下拉选择(来自 MES 工位列表,不允许手输)。', purpose: '出库送到哪个装配工位,出库记录留痕工位号', fill: '下拉选工位(可搜索);选填' },
@@ -111,7 +111,7 @@ export const helpInspection = {
'【三检分工与边界】\n· 来料检(incoming):对采购/外协到货、入库前的物料验收,按入库批次/SN 判定。合格才能入库上架,不合格隔离退货。\n· 过程检(process):对产线在制物料/半成品巡检,判定质量状态。\n· 完工检(finished):对 MES 回流的成品 SN 做最终检验(对象固定为成品 SN,无“批次”选项)。成品入库时质量状态为“未检”,完工检合格后置“合格”,成品方可发货;不合格可返修/让步接收。闭环:MES 报工→成品入库(未检)→WMS 完工检→合格→可发货。\n\n【检验做什么】把库存行的“质量状态”从未检翻转为合格/不合格,与存放区域无关。库存校验只取质量状态=合格的行参与出库/锁库。\n\n【报检数守恒】报检数 = 合格数 + 不合格数;合格数不得大于报检数;判定合格时合格数应等于报检数(否则请改判不合格并选处置方式)。\n\n【不合格处置(需求23 换修闭环)】判不合格必选处置:退货(须填货运单号、库存置待退) / 换修(隔离为不合格,等返修后重新报检) / 让步接收(审批后放行,质量状态置合格) / 报废 / 部分入库(仅结构件批次:一次只处理 1 个批次,按合格数拆行)。已判不合格的记录也可在列表里再次处置。\n\n【结构件 vs 电气件/其他的不合格口径】\n· 结构件(批次):一行数量 N,判不合格=整批隔离;“N 里坏 M 个”用「部分入库」填合格数 N−M,系统拆出 (N−M) 合格批次 + M 不合格批次。\n· 电气件(SN)/其他:逐个判定(检验数固定 1),每个 SN/件一条记录、一行库存,选中判不合格即隔离该件,无需拆分。\n\n【归属口径(需求22)】归属类型 = 工单编号 / 科技项目号 / 其他,默认“其他”。这里的“工单编号”是独立维度标签,与 MES 工单号不是同一东西;手动输入、不联动 MES、不校验格式(长度≤64)。\n\n【按物料统计】统计页需先选择物料再点“统计”,不做全表实时聚合。\n\n本页四个页签(录入在前、记录在后点击才加载):\n· 质量检验录入(默认打开):逐个判定——每一条待检目标(批次号/SN)独立成一行,分别选结论、填检验数/合格数,不合格数=检验数−合格数自动算出;整组点一次「提交」调 /inspection/batch-flip 原子翻转,多行同 id 自动去重。\n· 待检清单:按入库单分组展示(主行=入库单,展开看该单的批次/SN 明细与未检数量),支持整单送检、单条送检、跨行勾选送检;送检即把目标回填到「质量检验录入」并带入归属,免去手输编号。\n· 检验记录(点击才加载):历史判定记录,含「不合格数」列(=检验数−合格数,后端复核)。\n· 按物料统计:选物料后聚合其检验次数与合格率。\n\n菜单按业务分为来料/过程/完工三个入口,同一张表、同一接口,仅按检验类别默认过滤。每条检验记录可上传/查看附件(检测报告/照片)。',
fields: [
{ name: '三检边界', source: '菜单入口锁定检验类别。', purpose: '来料检=入库验收;过程检=在制巡检;完工检=成品 SN 终检', fill: '按左侧菜单进入对应页面,页内不再切换类别' },
{ name: '目标类型', source: '单选,决定录入框标题与可选库存范围。完工检固定为 SN,不展示切换。', purpose: '检验对象:批次(结构件) / SN(电气件) / 其他(辅料·工装·试验设备,按 1 件判定)', fill: '批次 BATCH / 序列号 SN / 其他 OTHER(任一切换都会自动刷新“从库存选”下拉与可选库存范围)' },
{ name: '目标类型', source: '单选,决定录入框标题与可选库存范围。完工检固定为 SN,不展示切换。', purpose: '检验对象:批次(结构件) / 序列号(电气件) / 其他(辅料·工装·试验设备,按 1 件判定)', fill: '批次 BATCH / 序列号 SN / 其他 OTHER(任一切换都会自动刷新“从库存选”下拉与可选库存范围)' },
{ name: '检验结论', source: '单选。', purpose: '判定结果', fill: '合格 / 不合格' },
{ name: '记录人 / 审核人', source: '手动填写(默认当前用户)。完工检显示为“审核人”。', purpose: '谁检验/审核的,追溯用', fill: '姓名' },
{ name: '从库存选批次号/SN', source: '下拉选择,数据来自当前库存(按目标类型过滤;完工检只列成品 category=3)。', purpose: '避免手输编号、防止输错', fill: '在库存里挑待检的批次号/SN,自动加入清单' },
@@ -158,8 +158,8 @@ export const helpStocktake = {
export const helpSemi = {
title: '半成品管理(流转)',
overview:
'产线工位"暂存/退回"的半成品先在此入库(记已完成工序),需要时再出库(重上线),MES 从下一工序继续;成品则由 MES 完工后自动回流入库(品类=成品),不经本页手工操作。\n\n闭环逻辑(与 MES 自动打通):\n' +
'① 工位终端"暂存退库" → 调 MES 工序流转接口 → MES 自动调 WMS /api/internal/semi/inbound 入库(带 SN、工单号、已完成工序码)。\n' +
'产线工位"暂存/退回"的半成品先在此入库(记"已完成至工位"快照),需要时再出库(重上线),MES 从下一工序继续;成品则由 MES 完工后自动回流入库(品类=成品),不经本页手工操作。\n\n闭环逻辑(与 MES 自动打通):\n' +
'① 工位终端"暂存退库" → 调 MES 工序流转接口 → MES 自动调 WMS /api/internal/semi/inbound 入库(带 SN、工单号、completedText 展示快照)。\n' +
'② WMS 收到后写入统一库存主表(品类=半成品),与原材料/成品同表管理——库存查询三视图、区域汇总、导出都能看到它。\n' +
'③ 该件后续要接着做时,在本页"半成品出库"或 MES 重上线 → WMS /api/internal/semi/outbound 把状态置为出库。\n' +
'④ MES 据此下发下一工序,工位继续装配,直至完工。\n\n' +
@@ -169,8 +169,8 @@ export const helpSemi = {
title: '半成品/成品入库',
overview: '把产线退回的半成品或成品收进库房(手工录入或 MES 自动同步均走此接口)。',
fields: [
{ name: '物料', source: '下拉选择。来自物料档案(最近100条+模糊搜索)。', purpose: '入库物料(MES 自动同步时以请求传入为准,WMS 补齐物料名称)', fill: '选择图号' },
{ name: '已完成工序', source: 'MES 自动带出(doneProcessCodes,如 [1,3,5]);手工录入填逗号分隔,如 1,3,5。', purpose: '该件已做到哪些工序,重上线时 MES 从下一工序继续', fill: '如 1,3,5,可空' },
{ name: '物料', source: '下拉选择。来自物料档案(最近100条+模糊搜索,仅列成品品类 item_type=3)。', purpose: '入库物料(MES 自动同步时以请求传入为准,WMS 补齐物料名称)', fill: '选择图号' },
{ name: '已完成至工位', source: 'MES 自动带出(completedText 展示快照);手工录入填文本,如"工位5"。', purpose: '该件进展到哪个工位的人类可读快照,WMS 只原样存展示、不解析', fill: '如 工位5,可空=未报工' },
{ name: '工单号', source: '自动带出/手工填写。来自工单。', purpose: '来源工单', fill: '输入工单号' },
{ name: '归属', source: '下拉:工单号 / 科技项目号 / 其他(必选,与入库管理同口径,不再有"无")。', purpose: '标记该件归属哪个工单或科技项目', fill: '必选一项;选"其他"可不填编号,选"工单号/科技项目号"须填归属编号' },
{ name: '区域', source: '手动填写(可空)。', purpose: '存放库区', fill: '如 Z05' },
@@ -274,14 +274,14 @@ export const helpAttachment = {
export const helpMaterial = {
title: '物料档案',
overview:
'定义每一种物料的字典:叫什么、什么规格、什么品类(原材料/半成品/成品/其他)、是【结构件(批次)】还是【电气件(SN)】。\n此处维护的物料会作为下拉选项出现在入库/出库/装箱等页面;其中"类型"直接决定后续入库方式——结构件走批次(一批多件)、电气件走 SN 逐件扫码(单件追溯)。\n\n品类来源:原材料=进货来的(外购);半成品、成品=自己生产的;其他=辅料/工装/试验设备等。成品还可以作为零部件,放进另一个成品的物料清单(BOM)里被再次加工成新的成品。\n\n品类说明:1=原材料(默认) / 2=半成品 / 3=成品 / 4=其他(辅料/工装/试验设备)。编码主数据单一来源在本表:MES 的「物料档案」页面即是本表中"成品"品类的视图(实时拉取本表,不双录)——两系统的「物料档案」指向同一份主数据,以本表为准。库存主表 inventories 的品类与其呼应。列表支持按品类筛选,导出含品类列。\n\n物料档案是库房的另一道地基:先建好物料,入库时才能选到;类型选错会导致入库方式与追溯粒度不符。\n\n命名说明:本档案维护的物料在出库/看板等页面统一以"图号"展示(客户口径)。安全库存在本档案维护,可用量低于它时会在「库房看板」首页触发缺货预警。',
'定义每一种物料的字典:叫什么、什么规格、什么品类(原材料/成品/其他)、是【结构件(批次)】还是【电气件(SN)】。\n此处维护的物料会作为下拉选项出现在入库/出库/装箱等页面;其中"类型"直接决定后续入库方式——结构件走批次(一批多件)、电气件走 SN 逐件扫码(单件追溯)。\n\n品类来源:原材料=进货来的(外购);成品=自己生产的;其他=辅料/工装/试验设备等。成品还可以作为零部件,放进另一个成品的物料清单(BOM)里被再次加工成新的成品。\n\n品类说明:1=原材料(默认) / 3=成品 / 4=其他(辅料/工装/试验设备)。半成品不是物料品类(2026-09-22 定稿)——半成品是工件状态,由统一库存主表品类 category=2 承载,物料档案不再有半成品行。编码主数据单一来源在本表:MES 的「物料档案」页面即是本表中"成品"品类的视图(实时拉取本表,不双录)——两系统的「物料档案」指向同一份主数据,以本表为准。库存主表 inventories 的品类与其呼应。列表支持按品类筛选,导出含品类列。\n\n物料档案是库房的另一道地基:先建好物料,入库时才能选到;类型选错会导致入库方式与追溯粒度不符。\n\n命名说明:本档案维护的物料在出库/看板等页面统一以"图号"展示(客户口径)。安全库存在本档案维护,可用量低于它时会在「库房看板」首页触发缺货预警。',
fields: [
{ name: '图号', source: '手工填写,仓库自定义(新增后不可改)。在出库/看板等页面显示为"图号"。', purpose: '物料唯一编号(即图号)', fill: '如 SCREW-M3;新增后不可改编码' },
{ name: '名称', source: '手工填写(必填)。', purpose: '物料名称', fill: '如 螺丝 M3' },
{ name: '规格', source: '手工填写(必填)。', purpose: '规格型号', fill: '如 M3×8' },
{ name: '单位', source: '手工填写(必填)。', purpose: '计量单位', fill: '如 个/套' },
{ name: '品类', source: '必填。创建时默认"原材料";成品品类也可在 MES 的「物料档案」页维护(两系统同一份主数据,以本表为准)。', purpose: '区分原材料/半成品/成品/其他,与统一库存主表品类对应;原材料为进货、半成品/成品为自产', fill: '查询区可选 原材料/半成品/成品/其他' },
{ name: '类型', source: '必填(与「品类」相互独立)。选择:1=结构件(批次管理) / 2=电气件(SN 管理) / 3=其他(辅料/工装/试验设备,按批次数量管理)。', purpose: '决定入库方式:结构件/其他走批次、电气件走 SN 逐件扫码', fill: '结构件(批次) / 电气件(SN) / 其他' },
{ name: '品类', source: '必填。创建时默认"原材料";成品品类也可在 MES 的「物料档案」页维护(两系统同一份主数据,以本表为准)。', purpose: '区分原材料/成品/其他,与统一库存主表品类对应;原材料为进货、成品为自产(半成品不是物料品类,由库存 category=2 承载)', fill: '查询区可选 原材料/成品/其他' },
{ name: '类型', source: '必填(与「品类」相互独立)。选择:批次(结构件,按批管料) / 序列号(电气件,按件唯一) / 其他(辅料/工装/试验设备,按批次数量管理)。', purpose: '决定入库方式:结构件/其他走批次、电气件走 SN 逐件扫码', fill: '批次 / 序列号 / 其他' },
{ name: '安全库存', source: '必填整数(默认0)。', purpose: '该物料的最低库存警戒线;可用量低于它会在「库房看板」首页触发缺货预警', fill: '如 100;0=不预警' },
{ name: '说明', source: '手工填写(可空)。', purpose: '补充描述', fill: '可空' }
]