Files
bj_power/bj_power_mes/internal/logic/workpiece_scrap.go
T
SunYF 42bcf395d2 feat: AGV三段链安全机制、补料/损耗/下班闭环、接驳台左右互换
AGV 调度:
- 任务重构为 GO_LOAD/TRANSPORT/EMPTY_RETURN/FREE 三段链,到位即停(ARRIVED)需人工确认装卸
- 自由调度单点步进,每段强制弹"请确保路径畅通无杂物";托盘回收独立工作台
- 接驳台 PLC 传感器检测到托盘即自动卸货放行,传感器故障由人工按钮兜底(无轮询)
- 车辆状态只读展示(海康3.1.7 queryAgvStatus),调度仍由 RCS 负责

物料闭环:
- 补料管理(SHORTAGE):工位申请 + 主管审批调增叫料池额度,与借料/差异补发三轨并行
- 损耗台账(loss_ledger):退料实际 < 理论必填原因、后审核,工单不记损耗
- 退料强制指定左/右接驳台,WMS 库管可代工位退料

下班闭环:
- 工位终端自检接驳台剩余物料后下班;库管收货 + 托盘拉走后事件驱动自动结班
- 退出登录未下班仅作安全提示(不强制拦截、不新增责任审批)

接驳台左右按操作员朝向建模(dock.side 字段),废除"奇左偶右"隐式约定;
看板标签 / seed / 迁移补丁 / 布局文档统一为中文左/右。

产线布局说明:C1 前线头 AGV 点、C15 后线尾 AGV 点、外部 O1/O2/O3 散点,
清理修订痕迹为最终态描述。
2026-11-03 18:29:31 +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
}