Files
bj_power/bj_power_mes/internal/logic/loss_ledger.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

84 lines
2.9 KiB
Go

package logic
import (
"context"
"errors"
"fmt"
"strings"
"time"
"bj_power_mes/ent"
"bj_power_mes/ent/lossledger"
)
// ============ 损耗台账(2026-11-03 拍板) ============
// 退料时实际退回 < 理论应退的差额=损耗;差额必填原因;「后审核」——先允许直接退库,
// 台账落 MES,主管事后批注回复。工单不记录损耗;台账可见「哪个人、哪个工位、损耗多少」。
// CreateLossRecord 退料差额落账(内部:由退料链路调用)。
func (s *Service) CreateLossRecord(ctx context.Context, stationNo int, materialCode, materialName string,
theoryQty, actualQty float64, reason, returnNo, workOrderNo, operator string) (*ent.LossLedger, error) {
loss := theoryQty - actualQty
if loss <= 0 {
return nil, nil // 无损耗不落账
}
if strings.TrimSpace(reason) == "" {
return nil, errors.New("存在损耗(实际退回少于理论应退),损耗原因必填")
}
row, err := s.ctx.EntClient.LossLedger.Create().
SetStationNo(stationNo).SetMaterialCode(materialCode).SetMaterialName(materialName).
SetTheoryQty(theoryQty).SetActualQty(actualQty).SetLossQty(loss).
SetReason(reason).SetReturnNo(returnNo).SetWorkOrderNo(workOrderNo).
SetStatus("PENDING").SetOperator(operator).Save(ctx)
if err != nil {
return nil, err
}
s.ctx.EventLog.Write(ctx, "loss.create", "", operator, "loss_ledger",
fmt.Sprintf("%d", row.ID), fmt.Sprintf("损耗落账 工位%d %s 理论%.2f 实际%.2f 损耗%.2f",
stationNo, materialCode, theoryQty, actualQty, loss), nil)
return row, nil
}
// ListLosses 损耗台账列表(status 可空=全部;分页)。
func (s *Service) ListLosses(ctx context.Context, status string, page, size int) (map[string]any, error) {
q := s.ctx.EntClient.LossLedger.Query()
if status != "" {
q = q.Where(lossledger.StatusEQ(status))
}
total, err := q.Clone().Count(ctx)
if err != nil {
return nil, err
}
if size < 1 || size > 200 {
size = 20
}
if page < 1 {
page = 1
}
rows, err := q.Order(ent.Desc(lossledger.FieldCreatedAt)).
Offset((page - 1) * size).Limit(size).All(ctx)
if err != nil {
return nil, err
}
return map[string]any{"list": rows, "total": total, "page": page, "pageSize": size}, nil
}
// CommentLoss 主管批注回复(后审核)。
func (s *Service) CommentLoss(ctx context.Context, id int, comment, operator string) error {
row, err := s.ctx.EntClient.LossLedger.Get(ctx, id)
if err != nil || row == nil {
return errors.New("损耗记录不存在")
}
if strings.TrimSpace(comment) == "" {
return errors.New("批注内容必填")
}
if _, uerr := s.ctx.EntClient.LossLedger.UpdateOneID(id).
SetComment(comment).SetCommenter(operator).SetCommentedAt(time.Now().Unix()).
SetStatus("COMMENTED").Save(ctx); uerr != nil {
return uerr
}
s.ctx.EventLog.Write(ctx, "loss.comment", "", operator, "loss_ledger",
fmt.Sprintf("%d", id), "主管批注:"+comment, nil)
return nil
}