Files
bj_power/bj_power_mes/internal/logic/product.go
T
SunYF 4c4cda1d41 feat: 移除工艺物料与混产模板实体、新增产线清线与 PLC 监控实时推送、看板双屏增强
- 移除实体:MES 删除 FlowMaterial(工艺物料)与 MixProductionTemplate(混产模板)全套(schema/ent 生成码/handler/logic),清理关联路由与种子
- 新增功能:产线清线(line_clearance handler + logic)、PLC 监控 WebSocket 实时推送(ws/plc_monitor_hub + handler)
- 看板增强:新增管理屏与 KPI 组件(BoardManage/BoardKpi),调整演示屏 Mock 与各看板面板
- MES 完善:PLC 匹配/扭矩扫描/签收、工艺卡 PDF 与工单、AGV 链路、叫料/备料/在制品/短料预测等逻辑与前端调整
- 工位终端:删除离线面板 OfflinePanel,调整主界面/物料面板与 api/store/handler/路由
- WMS:AGV 托盘、物料与 MES 客户端调整及前端帮助/基础数据/叫料/托盘页
- 文档:更新产线API/客户问题/案例/部署手册/问题记录
2026-11-19 08:31:05 +08:00

373 lines
14 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/ent/productbom"
"bj_power_mes/ent/productprocess"
"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 物料档案同口径,可空)
MaterialCode string `json:"materialCode"` // 物料编码(普通字段,不参与业务与必填校验)
}
// 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,
MaterialCode: m.MaterialCode,
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 已置位,列表请求自动重推)。
// ensureDefaultProcess 建产品时自动带出一套「占位工艺」(2026-11-17 拍板)。
// 行业标配「一个产品同时只有一套启用工艺」+「新建产品即有一套可编辑工艺」,避免每个产品都要手动去产品工艺页新增。
// 幂等:该产品已有启用工艺则跳过;没有则建一套 ACTIVE 空工艺(工艺顺序留给用户配置),名称=产品名+「工艺」(2026-11-18 拍板)。
// ppc 可传 s.ctx.EntClient.ProductProcess 或事务 tx.ProductProcess,供单条建档 / 批量导入共用。
func (s *Service) ensureDefaultProcess(ctx context.Context, ppc *ent.ProductProcessClient, productCode, productName string) error {
productCode = strings.TrimSpace(productCode)
if productCode == "" {
return nil
}
exists, _ := ppc.Query().Where(productprocess.ProductCode(productCode), productprocess.Status("ACTIVE")).Exist(ctx)
if exists {
return nil
}
name := strings.TrimSpace(productName)
if name == "" {
name = productCode
}
name += "工艺"
_, err := ppc.Create().
SetProductCode(productCode).
SetProductName(productName).
SetName(name).
SetStatus("ACTIVE").
SetRemark("建产品时自动生成,请在产品工艺中配置工艺顺序").
Save(ctx)
if err != nil {
return fmt.Errorf("自动创建占位工艺失败(成品 %s):%v", productCode, err)
}
log.Printf("[product-process] 成品 %s 已自动创建占位工艺(名称=%s)", productCode, name)
return nil
}
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("单位为必填项")
}
// 2026-11-13 拍板「产品档案视图适配」:成品不需要选类型/序列号,页面隐藏这两个字段,
// 后端按成品固定注入默认值(类型=3 其他、序列号=是),双库同步契约不变。
// 图号(code) 仍由 genProductTypeCode 按时间+流水自动生成,作为成品唯一码。
if req.ManageMode == 0 {
req.ManageMode = 3
}
if req.SnMode == 0 {
req.SnMode = 1
}
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).
SetMaterialCode(strings.TrimSpace(req.MaterialCode)).
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)
}
// 自动带出占位工艺:失败只记日志,不让产品建档回滚(成品已落库+推 WMS)。
if err := s.ensureDefaultProcess(ctx, s.ctx.EntClient.ProductProcess, code, req.Name); err != nil {
log.Printf("[product-process] 成品 %s 占位工艺自动创建失败(可到产品工艺页手动新建): %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).
SetMaterialCode(strings.TrimSpace(req.MaterialCode)).
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))
codes := make([]string, 0, len(list))
for i := range list {
rows = append(rows, productTypeRowOf(list[i]))
codes = append(codes, list[i].Code)
}
// 2026-11-17:产品档案列表汇总该产品总账的材料种类数 / 单台用量合计(件数口径)。
// 一次查询当前页所有成品的总账行,Go 里聚合;无总账的成品两项均为 0。
if len(codes) > 0 {
boms, bErr := s.ctx.EntClient.ProductBOM.Query().
Where(productbom.ProductCodeIn(codes...)).All(ctx)
if bErr == nil {
kindSet := map[string]map[string]bool{}
qtySum := map[string]float64{}
for _, b := range boms {
if kindSet[b.ProductCode] == nil {
kindSet[b.ProductCode] = map[string]bool{}
}
kindSet[b.ProductCode][b.MaterialCode] = true
qtySum[b.ProductCode] += b.UnitQty
}
for i := range rows {
rows[i].BOMKinds = len(kindSet[rows[i].Code])
rows[i].BOMQty = qtySum[rows[i].Code]
}
}
}
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)——
// 停用仅令该型号退出新建下拉,历史工单/库存行原样保留,不存在悬挂引用。