- MES 新增实体:混产模板、产品BOM、产品工艺物料、试制记录(schema + ent 生成码 + logic/handler/前端页) - WMS 实体增强:检验记录、库存、半成品重构;新增序列号库存与短缺代报 - AGV 与产能:AGV 手动点位与链路、物料守卫、短缺预测、原因字典 - 前端通用能力:新增下一步引导组件 NextStepBar,统一帮助文档/布局/请求拦截与操作列 - 工位终端:界面与各 handler 调整(api/store/绑定/PLC/拧紧/上报等) - 配置与文档:更新 mes-api.yaml、WMS README 及案例/产线API/问题记录/项目说明/流程说明
73 lines
3.4 KiB
Go
73 lines
3.4 KiB
Go
package logic
|
|
|
|
import (
|
|
"context"
|
|
"errors"
|
|
"fmt"
|
|
"strings"
|
|
|
|
"bj_power_mes/ent/linepoint"
|
|
"bj_power_mes/ent/workpiece"
|
|
)
|
|
|
|
// ============ 工件报废 / 人工取走(异常人工操作闭环,2026-11-03 补全) ============
|
|
//
|
|
// 业务背景:工件在产线上可能被人工非正常取走(报废、丢失、磕碰损伤、人工处理等)。
|
|
// 此前 SCRAPPED 是六态状态机里的"死状态"——全项目只有读过滤、无任何写入者,
|
|
// 导致被取走的工件永久停在 ONLINE/PROCESSING,把工单「强制完工」卡死
|
|
// (强制完工前置校验:在制必须清零,报错引导"请先下线完工或报废",但报废能力缺失)。
|
|
//
|
|
// 与「暂存退库(在制品回库)」的本质区别(业务不可互替):
|
|
// - 报废/人工取走 = 永久退出产线,工件状态 → SCRAPPED,不产生任何库存,工单须以强制完工收尾;
|
|
// - 暂存退库 = 合法暂停,工件 → SEMI_STORED + WMS 在制品库存 +1,可再出库重上线。
|
|
// 二者状态机、库存影响、工单影响完全不同,前端入口与提示均分开。
|
|
|
|
// ScrapWorkpiece 工件报废/人工取走登记(SCRAPPED 六态机唯一写入者)。
|
|
// 适用状态:NEW(预生成未上线)/ ONLINE / PROCESSING(在制)。
|
|
// SEMI_STORED(已退库在制品)走 WMS 在库处置;DONE(已完工)已成事实,均拒绝在本入口操作。
|
|
// 副作用:状态→SCRAPPED、清 at_station、释放点位台账占用、写生命周期流水(action=SCRAPPED+原因)、
|
|
// 操作日志留痕;报废后不计入在制(工单强制完工校验放行),已完工数不变(报废≠完工)。
|
|
func (s *Service) ScrapWorkpiece(ctx context.Context, sn, reason, operator, source string) error {
|
|
sn = strings.TrimSpace(sn)
|
|
reason = strings.TrimSpace(reason)
|
|
if sn == "" {
|
|
return errors.New("请扫描/输入工件 SN")
|
|
}
|
|
if reason == "" {
|
|
return errors.New("必须填写报废/取走原因(如:报废 / 人工处理 / 丢失 / 磕碰损伤)")
|
|
}
|
|
if source == "" {
|
|
source = "admin"
|
|
}
|
|
wp, err := s.ctx.EntClient.Workpiece.Query().Where(workpiece.Sn(sn)).First(ctx)
|
|
if err != nil {
|
|
return errors.New("工件不存在:" + sn)
|
|
}
|
|
switch wp.Status {
|
|
case "NEW", "ONLINE", "PROCESSING":
|
|
// 可报废三态
|
|
case "SEMI_STORED":
|
|
return errors.New("该工件为已退库在制品,请在 WMS 走在库处置(退货/返修/报废),不能在本页登记")
|
|
case "DONE":
|
|
return errors.New("该工件已完工入库,无需报废")
|
|
default:
|
|
return fmt.Errorf("当前状态 %s 不可报废", wp.Status)
|
|
}
|
|
from := wp.Status
|
|
if _, err := s.ctx.EntClient.Workpiece.UpdateOneID(wp.ID).
|
|
SetStatus("SCRAPPED").SetAtStationNo(0).Save(ctx); err != nil {
|
|
return err
|
|
}
|
|
// 释放点位台账占用(该 SN 若登记在产线任一点位上):唯一事实源同步清空,避免残留幽灵占用
|
|
n, _ := s.ctx.EntClient.LinePoint.Update().
|
|
Where(linepoint.CurrentSnEQ(sn)).
|
|
SetCurrentSn("").SetOrderNo("").SetOccupied(false).Save(ctx)
|
|
s.writeLifecycle(ctx, sn, wp.OrderNo, from, "SCRAPPED", wp.AtStationNo, 0, operator, source,
|
|
fmt.Sprintf("报废/人工取走:%s(释放点位台账 %d 处)", reason, n))
|
|
s.ctx.EventLog.Write(ctx, "workpiece.scrap", wp.OrderNo, operator, "workpiece", sn,
|
|
"工件报废/人工取走(原状态 "+from+"):"+reason,
|
|
map[string]any{"from": from, "reason": reason, "source": source, "releasedPoints": n})
|
|
s.notifyDashboard()
|
|
return nil
|
|
}
|