Files
bj_power/bj_power_mes/internal/logic/workpiece_scrap.go
T
SunYF 1e92b2a596 feat: 核心业务实体扩充(混产模板/产品BOM/试制记录)、WMS 库存检验增强与前端通用能力
- MES 新增实体:混产模板、产品BOM、产品工艺物料、试制记录(schema + ent 生成码 + logic/handler/前端页)
- WMS 实体增强:检验记录、库存、半成品重构;新增序列号库存与短缺代报
- AGV 与产能:AGV 手动点位与链路、物料守卫、短缺预测、原因字典
- 前端通用能力:新增下一步引导组件 NextStepBar,统一帮助文档/布局/请求拦截与操作列
- 工位终端:界面与各 handler 调整(api/store/绑定/PLC/拧紧/上报等)
- 配置与文档:更新 mes-api.yaml、WMS README 及案例/产线API/问题记录/项目说明/流程说明
2026-11-15 12:17:39 +08:00

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
}