Files
bj_power/bj_power_mes/internal/logic/product.go
T
SunYF b0c048d9aa feat: 新增收集式校验错误弹窗及工位报警语音播报
新增 ErrorListDialog 组件用于统一展示结构化校验错误信息,实现报错一次收全;新增工位报警语音播报功能,通过浏览器 SpeechSynthesis 播放本工位相关报警;调整物料类别及序列号字段文案,移除「其他」类别;新增工单实际开始字段及采集方式配置;优化 AGV 及 PlcSend 页签刷新逻辑;新增看板物料追溯及工位报警接口;删除 PLC 强制写 M 位及相关测试代码;同步数据库字段注释及补丁。
2026-10-20 16:36:26 +08:00

299 lines
11 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"
"log"
"strings"
"time"
"bj_power_mes/ent"
"bj_power_mes/ent/material"
"bj_power_mes/internal/wmsclient"
)
// 产品型号(成品档案 item_type=3):两库对等双向同步(需求一 M3/M5/M6,2026-09-29 定稿)。
// MES 侧维护改为「本地优先」:先写 MES 本地 materials 表,再推 WMS /api/internal/materials/upsert,
// 推失败置 sync_pending 由列表请求异步重推,不回滚本地(M3)。
// 查询全部读本地——WMS 宕机时 MES 建单/排产/型号下拉照常可用(M6)。
// 与 WMS product-types 接口同口径:物料类别固定 3(成品)、编码留空自动生成 PROD-YYYYMMDD-当日流水、
// Category 列取说明列(历史迁移约定)。「类型」(manageMode) 与「是否逐件SN管理」(snMode) 解耦,
// 两者均为建档必选:snMode 1序列号=是(录SN)/2序列号=否(不录SN),0=未选择不可保存。
// 备料"物料在 WMS 档案存在"校验仍直查 WMS(M8,库存真源在 WMS,见 logic/material.go)。
type ProductTypeReq struct {
Id int `json:"id"`
Name string `json:"name"`
Code string `json:"code"`
Spec string `json:"spec"`
Unit string `json:"unit"`
ManageMode int `json:"manageMode"` // 类型 1结构件/2电气件/3其他(必选)
SnMode int `json:"snMode"` // 是否逐件SN管理 1序列号=是/2序列号=否(必选,0=未选择不可保存)
IsActive bool `json:"isActive"`
Description string `json:"description"` // 说明(与 WMS 物料档案同口径,可空)
}
// validateTypeAndSnMode 建档必选校验:类型 1/2/3、序列号=是 1/2(0=未选择直接拒绝)。
func validateTypeAndSnMode(manageMode, snMode int) error {
if manageMode != 1 && manageMode != 2 && manageMode != 3 {
return errors.New("请选择类型(结构件/电气件/其他)")
}
if snMode != 1 && snMode != 2 {
return errors.New("请先选择序列号管理方式(序列号=是/序列号=否)")
}
return nil
}
// productTypeCodePrefix 与 WMS 编码规则同源:PROD-YYYYMMDD-流水
const productTypeCodePrefix = "PROD"
// genProductTypeCode 本地生成型号编码:PROD-YYYYMMDD-流水(当日序号递增,与 WMS 规则一致)
func (s *Service) genProductTypeCode(ctx context.Context) (string, error) {
date := time.Now().Format("20060102")
prefix := fmt.Sprintf("%s-%s-", productTypeCodePrefix, date)
all, err := s.ctx.EntClient.Material.Query().Where(material.CodeHasPrefix(prefix)).All(ctx)
if err != nil {
return "", err
}
maxSeq := 0
for _, m := range all {
var seq int
if _, err := fmt.Sscanf(m.Code, prefix+"%d", &seq); err == nil && seq > maxSeq {
maxSeq = seq
}
}
return fmt.Sprintf("%s%03d", prefix, maxSeq+1), nil
}
// productTypeRowOf 本地物料行 → 前端型号 DTO(与 WMS productTypeRow 同形;Category 取说明列)。
func productTypeRowOf(m *ent.Material) wmsclient.ProductTypeRow {
return wmsclient.ProductTypeRow{
ID: m.ID,
Code: m.Code,
Name: m.Name,
Spec: m.Spec,
Unit: m.Unit,
Category: m.Description,
ManageMode: m.ManageMode,
SnMode: m.SnMode,
IsActive: m.IsActive,
CreatedAt: m.CreatedAt.Unix(),
UpdatedAt: m.UpdatedAt.Unix(),
SyncPending: m.SyncPending,
}
}
// CreateProductType 新建型号:本地优先落库 → 推 WMS(M3)。
// 推送失败不报错、不回滚本地(sync_pending 已置位,列表请求自动重推)。
func (s *Service) CreateProductType(ctx context.Context, req ProductTypeReq) error {
active := req.IsActive
if !req.IsActive {
active = true
}
if strings.TrimSpace(req.Name) == "" {
return errors.New("名称为必填项")
}
if strings.TrimSpace(req.Spec) == "" {
return errors.New("规格型号为必填项")
}
if strings.TrimSpace(req.Unit) == "" {
return errors.New("单位为必填项")
}
if err := validateTypeAndSnMode(req.ManageMode, req.SnMode); err != nil {
return err
}
code := strings.TrimSpace(req.Code)
if code == "" {
var err error
if code, err = s.genProductTypeCode(ctx); err != nil {
return errors.New("生成编码失败:" + err.Error())
}
}
if exists, _ := s.ctx.EntClient.Material.Query().Where(material.CodeEQ(code)).Exist(ctx); exists {
return errors.New("编码已存在: " + code)
}
// 成品档案(本页 itemType 恒=3)序列号强制「是」,与 WMS 编辑/同步同口径(2026-10-19 拍板)
snMode := req.SnMode
if snMode != 1 {
snMode = 1
}
m, err := s.ctx.EntClient.Material.Create().
SetCode(code).
SetName(req.Name).
SetSpec(req.Spec).
SetUnit(req.Unit).
SetDescription(req.Description).
SetItemType(3).
SetManageMode(req.ManageMode).
SetSnMode(snMode).
SetIsActive(active).
Save(ctx)
if err != nil {
return errors.New("保存物料档案失败:" + err.Error())
}
if err := s.pushMaterialToWMS(ctx, m); err != nil {
log.Printf("[material-sync] 新建 %s 已落本地,推送 WMS 失败(待重推): %v", code, err)
}
return nil
}
// UpdateProductType 编辑型号(编码不可改):本地优先 → 推 WMS(M3)。
func (s *Service) UpdateProductType(ctx context.Context, req ProductTypeReq) error {
if req.Id == 0 {
return errors.New("缺少 id")
}
if strings.TrimSpace(req.Name) == "" {
return errors.New("名称为必填项")
}
if strings.TrimSpace(req.Spec) == "" {
return errors.New("规格型号为必填项")
}
if strings.TrimSpace(req.Unit) == "" {
return errors.New("单位为必填项")
}
if err := validateTypeAndSnMode(req.ManageMode, req.SnMode); err != nil {
return err
}
cur, err := s.ctx.EntClient.Material.Get(ctx, req.Id)
if err != nil || cur.ItemType != 3 {
return errors.New("物料档案不存在")
}
// 成品(3)序列号强制「是」,与 WMS 同口径(2026-10-19 拍板);防历史脏值经本接口翻案
m, err := s.ctx.EntClient.Material.UpdateOneID(cur.ID).
SetName(req.Name).
SetSpec(req.Spec).
SetUnit(req.Unit).
SetDescription(req.Description).
SetManageMode(req.ManageMode).
SetSnMode(1).
SetIsActive(req.IsActive).
Save(ctx)
if err != nil {
return errors.New("更新物料档案失败:" + err.Error())
}
if err := s.pushMaterialToWMS(ctx, m); err != nil {
log.Printf("[material-sync] 编辑 %s 已落本地,推送 WMS 失败(待重推): %v", cur.Code, err)
}
return nil
}
// DeleteProductType 「删除」=停用(客户裁决"都不可删除",M5 两库一致):
// 本地置 isActive=false → 推 WMS 同步停用。停用不影响历史工单/库存引用(行保留)。
func (s *Service) DeleteProductType(ctx context.Context, id int) error {
return s.SetProductTypeStatus(ctx, id, false)
}
// SetProductTypeStatus 物料档案启用/停用专用通道(POST /product-types/status)。
// 本地置 isActive → 推 WMS 同步;停用不影响历史工单/库存引用(行保留)。
func (s *Service) SetProductTypeStatus(ctx context.Context, id int, isActive bool) error {
cur, err := s.ctx.EntClient.Material.Get(ctx, id)
if err != nil || cur.ItemType != 3 {
return errors.New("物料档案不存在")
}
if cur.IsActive == isActive {
return nil // 幂等
}
m, err := s.ctx.EntClient.Material.UpdateOneID(id).SetIsActive(isActive).Save(ctx)
if err != nil {
return errors.New("更新物料档案状态失败:" + err.Error())
}
if err := s.pushMaterialToWMS(ctx, m); err != nil {
act := "启用"
if !isActive {
act = "停用"
}
log.Printf("[material-sync] %s %s 已落本地,推送 WMS 失败(待重推): %v", act, cur.Code, err)
}
return nil
}
// ListProductTypes 全量列表(下拉/兼容形态,id asc 新建在底部)。读 MES 本地(M6)。
// degraded 恒为 true(仅兼容前端字段)。
func (s *Service) ListProductTypes(ctx context.Context, isActive string) ([]wmsclient.ProductTypeRow, bool, error) {
q := s.ctx.EntClient.Material.Query().Where(material.ItemTypeEQ(3))
switch isActive {
case "true":
q = q.Where(material.IsActiveEQ(true))
case "false":
q = q.Where(material.IsActiveEQ(false))
}
list, err := q.Order(ent.Asc("id")).All(ctx)
if err != nil {
return nil, false, errors.New("查询成品档案失败:" + err.Error())
}
rows := make([]wmsclient.ProductTypeRow, 0, len(list))
for i := range list {
rows = append(rows, productTypeRowOf(list[i]))
}
return rows, true, nil
}
// ListProductTypesPage 分页+搜索(管理页真分页,真源=本地)。
// 2026-09-08 禁止关键字混搜:编码/名称各自独立模糊。wmsOnline 恒为 true(仅兼容前端字段)。
// 本地副本为空时异步自 WMS 全量拉取补齐(M7),并顺带重推 pending 行(M3)。
// 筛选参数:code/name/spec 独立模糊(大小写无关),manageMode(1结构件/2电气件/3其他)与
// snMode(1序列号=是/2序列号=否)精确筛选,isActive 启用状态筛选。
func (s *Service) ListProductTypesPage(ctx context.Context, code, name, spec string, manageMode, snMode int, isActive string, page, pageSize int) (int64, []wmsclient.ProductTypeRow, bool, error) {
s.EnsureMaterialCacheAsync()
q := s.ctx.EntClient.Material.Query().Where(material.ItemTypeEQ(3))
if code != "" {
q = q.Where(material.CodeContainsFold(code))
}
if name != "" {
q = q.Where(material.NameContainsFold(name))
}
if spec != "" {
q = q.Where(material.SpecContainsFold(spec))
}
if manageMode > 0 {
q = q.Where(material.ManageModeEQ(manageMode))
}
if snMode > 0 {
q = q.Where(material.SnModeEQ(snMode))
}
switch isActive {
case "true":
q = q.Where(material.IsActiveEQ(true))
case "false":
q = q.Where(material.IsActiveEQ(false))
}
total, err := q.Count(ctx)
if err != nil {
return 0, nil, false, errors.New("查询成品档案失败:" + err.Error())
}
list, err := q.Order(ent.Asc("id")).
Offset((page - 1) * pageSize).Limit(pageSize).All(ctx)
if err != nil {
return 0, nil, false, errors.New("查询成品档案失败:" + err.Error())
}
rows := make([]wmsclient.ProductTypeRow, 0, len(list))
for i := range list {
rows = append(rows, productTypeRowOf(list[i]))
}
return int64(total), rows, true, nil
}
// ProductTypeByID 按本地 id 取成品档案(item_type=3)。
func (s *Service) ProductTypeByID(ctx context.Context, id int) (*wmsclient.ProductTypeRow, error) {
m, err := s.ctx.EntClient.Material.Get(ctx, id)
if err != nil || m.ItemType != 3 {
return nil, errors.New("物料档案不存在")
}
row := productTypeRowOf(m)
return &row, nil
}
// ProductTypeByCode 按编码取成品档案(item_type=3)。
func (s *Service) ProductTypeByCode(ctx context.Context, code string) (*wmsclient.ProductTypeRow, error) {
m, err := s.ctx.EntClient.Material.Query().Where(material.CodeEQ(code)).Only(ctx)
if err != nil || m.ItemType != 3 {
return nil, errors.New("物料档案不存在")
}
row := productTypeRowOf(m)
return &row, nil
}
// 引用保护说明:原「被工单引用禁删」检查随删除→停用语义取消(M5)——
// 停用仅令该型号退出新建下拉,历史工单/库存行原样保留,不存在悬挂引用。