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 }