Files
bj_power/bj_power_mes/internal/logic/line.go
T
SunYF 8be6e03a15 docs: 统一修正全项目“SN管理”相关术语为“序列号”
本次 commit 统一修正了全项目范围内关于 SN 管理的术语表述,将原“SN管理”、“序列号件”、“批次件”等表述调整为“序列号”、“序列号=是”、“序列号=否”,同时同步更新了相关文档、代码注释、前端提示文本、数据库 schema 注释、API 文档等,确保全链路术语统一,消除理解歧义。
2026-10-10 15:58:59 +08:00

183 lines
7.2 KiB
Go
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
package logic
import (
"context"
"errors"
"fmt"
"strings"
"time"
"bj_power_mes/ent"
"bj_power_mes/ent/linepoint"
)
// ============ 产线点位台账(产线布局说明·修正版) ============
// 布局:上料位 IN(工位1/2间主线,人工投料)→ [1,2] → C1,C2 → [3,4] → C3,C4 → [5,6] → C5,C6 → [7,8] → C7,C8 → [9,10] → 上排末端11 / 下排末端12(下料检测位)
// 接驳台:工位1~10 各 2 个(R1=1号AGV、R2=2号AGV),属 AGV 点位,PLC 只读在位信号
// 上料位:工位1/2 之间的主传送带,人工投料,带传感器,PLC 上报在位信号
type pointDef struct {
pointType string
pointNo string
label string
seq int
stationNo int
}
// InitLinePoints 初始化点位台账(幂等:只补缺失,不覆盖已占用点位)
func (s *Service) InitLinePoints(ctx context.Context) error {
defs := []pointDef{}
seq := 10
add := func(pt, no, label string, stationNo int) {
seq += 10
defs = append(defs, pointDef{pt, no, label, seq, stationNo})
}
add("FEED", "IN", "上料位(工位1/2间主线)", 0)
for i := 1; i <= 10; i += 2 {
add("STATION", fmt.Sprint(i), fmt.Sprintf("工位%d", i), i)
add("STATION", fmt.Sprint(i+1), fmt.Sprintf("工位%d", i+1), i+1)
if i <= 7 {
add("CACHE", fmt.Sprintf("C%d", i), fmt.Sprintf("缓存位C%d", i), 0)
add("CACHE", fmt.Sprintf("C%d", i+1), fmt.Sprintf("缓存位C%d", i+1), 0)
}
}
add("END", "END-U", "上排末端下料检测位(工位11)", 11)
add("END", "END-D", "下排末端下料检测位(工位12)", 12)
for st := 1; st <= 10; st++ {
for agv := 1; agv <= 2; agv++ {
add("DOCK", fmt.Sprintf("%d-R%d", st, agv), fmt.Sprintf("工位%d %d号AGV接驳台", st, agv), st)
}
}
for _, d := range defs {
exist, _ := s.ctx.EntClient.LinePoint.Query().
Where(linepoint.PointType(d.pointType), linepoint.PointNo(d.pointNo)).First(ctx)
if exist != nil {
continue
}
_, _ = s.ctx.EntClient.LinePoint.Create().
SetPointType(d.pointType).SetPointNo(d.pointNo).SetLabel(d.label).
SetSeq(d.seq).SetStationNo(d.stationNo).Save(ctx)
}
return nil
}
// ListPoints 查询点位台账(按传送带顺序)
func (s *Service) ListPoints(ctx context.Context) ([]map[string]any, error) {
pts, err := s.ctx.EntClient.LinePoint.Query().Order(ent.Asc(linepoint.FieldSeq)).All(ctx)
if err != nil {
return nil, err
}
out := make([]map[string]any, 0, len(pts))
for _, p := range pts {
out = append(out, map[string]any{
"id": p.ID, "pointType": p.PointType, "pointNo": p.PointNo, "label": p.Label,
"seq": p.Seq, "stationNo": p.StationNo, "currentSn": p.CurrentSn,
"orderNo": p.OrderNo, "occupied": p.Occupied, "updatedAt": p.UpdatedAt,
})
}
return out, nil
}
// CallMaterialItem 叫料明细
type CallMaterialItem struct {
MaterialCode string `json:"materialCode"`
MaterialName string `json:"materialName"`
Unit string `json:"unit"`
SnMode int `json:"snMode"` // 是否逐件SN管理 1序列号=是/2序列号=否
Qty float64 `json:"qty"`
}
// CallMaterial 工位终端叫料:操作员选定接驳台(R1/R2)后生成备料需求,物料送达该接驳台。
// 规则(产线布局修正版):叫料/退料均由工位终端发起,日排产不发起;接驳台属 AGV 点位。
func (s *Service) CallMaterial(ctx context.Context, stationNo int, dock, orderNo, operator string, items []CallMaterialItem) (int, error) {
if stationNo < 1 {
return 0, errors.New("工位号无效")
}
if dock == "" {
return 0, errors.New("请选择接驳台(R1/R2)")
}
_, err := s.ctx.EntClient.LinePoint.Query().
Where(linepoint.PointType("DOCK"), linepoint.PointNo(dock), linepoint.StationNo(stationNo)).First(ctx)
if err != nil {
// 0/13 为 OFFLINE 虚拟上下线位,11/12 为末端无接驳台;一律按「无此接驳台」拒绝,不写死工位范围
return 0, errors.New("该工位无此接驳台:" + dock)
}
if len(items) == 0 {
return 0, errors.New("请添加叫料明细")
}
created := 0
planDate := time.Now().Format("2006-01-02")
for _, it := range items {
if it.MaterialCode == "" || it.Qty <= 0 {
continue
}
reqNo := fmt.Sprintf("MR%d", time.Now().UnixNano()+int64(created))
// 真 bug 修复(2026-09-19):必须写 stationNo,否则工位终端「待接料」按
// stationNo=本工位 查询时看不见自己叫的料(只有扫码接料能撞上,隐蔽)。
// 补料单 source=REFILL:优先于排产备料,且默认叫 AGV 配送到该工位接驳台。
if _, err := s.ctx.EntClient.MaterialRequest.Create().
SetRequestNo(reqNo).SetOrderNo(orderNo).SetPlanDate(planDate).
SetMaterialCode(it.MaterialCode).SetMaterialName(it.MaterialName).SetUnit(it.Unit).
SetSnMode(it.SnMode).SetReqQty(it.Qty).SetStatus("PENDING").
SetStationNo(stationNo).
SetSource("REFILL").SetNeedAgv(true).
SetTargetDock(dock).SetOperator(operator).Save(ctx); err != nil {
return created, err
}
created++
}
if created == 0 {
return 0, errors.New("没有有效的叫料明细(物料编码与数量必填)")
}
s.ctx.EventLog.Write(ctx, "line.call_material", orderNo, operator, "material_request", dock,
fmt.Sprintf("工位%d 叫料 %d 项 → 接驳台 %s", stationNo, created, dock),
map[string]any{"stationNo": stationNo, "dock": dock, "count": created})
return created, nil
}
// OccupyPoint 点位人工记账(唯一事实源维护入口)。
// action=IN :上料/占位,把工件 SN 记到该点位(点位被其它工件占用时报错;同一工件幂等放行)。
// action=OUT :下料/释放,清空该点位(传入 sn 时校验点位当前就是该工件)。
// 用途:产线首件上线、上料位(IN)投料、末端下料检测位(11/12)下料、未联调 PLC 时的人工记账。
func (s *Service) OccupyPoint(ctx context.Context, pointNo, sn, orderNo, operator, action string) error {
pointNo = strings.TrimSpace(pointNo)
sn = strings.TrimSpace(sn)
if pointNo == "" {
return errors.New("点位编号必填")
}
pt, err := s.ctx.EntClient.LinePoint.Query().Where(linepoint.PointNo(pointNo)).First(ctx)
if err != nil {
return errors.New("点位不存在:" + pointNo)
}
if operator == "" {
operator = "SYSTEM"
}
if action == "OUT" {
if pt.Occupied && sn != "" && pt.CurrentSn != sn {
return errors.New("点位 " + pointNo + " 当前不是该工件,无法下料")
}
if _, err := s.ctx.EntClient.LinePoint.UpdateOneID(pt.ID).
SetCurrentSn("").SetOrderNo("").SetOccupied(false).Save(ctx); err != nil {
return err
}
s.ctx.EventLog.Write(ctx, "line.point.out", pt.CurrentSn, operator, "line_point", pointNo,
"点位下料释放 "+pointNo, map[string]any{"sn": pt.CurrentSn, "orderNo": pt.OrderNo})
s.notifyDashboard()
return nil
}
if sn == "" {
return errors.New("上料必须提供工件SN")
}
if pt.Occupied && pt.CurrentSn != sn {
return errors.New("点位 " + pointNo + " 已被工件 " + pt.CurrentSn + " 占用")
}
if _, err := s.ctx.EntClient.LinePoint.UpdateOneID(pt.ID).
SetCurrentSn(sn).SetOrderNo(orderNo).SetOccupied(true).Save(ctx); err != nil {
return err
}
s.ctx.EventLog.Write(ctx, "line.point.in", sn, operator, "line_point", pointNo,
"点位上料占位 "+pointNo, map[string]any{"sn": sn, "orderNo": orderNo})
s.notifyDashboard()
return nil
}