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

70 lines
3.5 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 schema
import (
"time"
"entgo.io/ent"
"entgo.io/ent/dialect/entsql"
"entgo.io/ent/schema"
"entgo.io/ent/schema/field"
"entgo.io/ent/schema/index"
)
// MaterialRequest 备料单:按日排产自动算料生成
type MaterialRequest struct {
ent.Schema
}
func (MaterialRequest) Annotations() []schema.Annotation {
return []schema.Annotation{entsql.Annotation{Table: "material_request"}, entsql.WithComments(true), schema.Comment("MaterialRequest 备料单:按日排产自动算料生成")}
}
func (MaterialRequest) Fields() []ent.Field {
return []ent.Field{
field.Int("id").Positive(),
field.String("requestNo").MaxLen(64).Comment("备料单号"),
field.String("orderNo").MaxLen(64).Comment("工单号"),
field.String("planDate").MaxLen(10).Comment("对应排产日"),
field.String("materialCode").MaxLen(64).Comment("物料编码"),
field.String("materialName").Default("").MaxLen(128),
field.String("unit").Default("").MaxLen(16),
// 是否逐件SN管理(冗余自物料档案 sn_mode,出库口径唯一依据):1 序列号=是(逐件SN) / 2 序列号=否
field.Int("snMode").Default(2),
field.Float("reqQty").Default(0).Comment("需备数量"),
// PENDING / LOCKED / DELIVERING / DONE
field.String("status").Default("PENDING").MaxLen(20),
field.String("targetDock").Default("").MaxLen(20).Comment("目标接驳台 DOCK01..20"),
// 工位级备料:物料送达的工位号(由 工单工艺组合+日排产分产量 派生)
field.Int("stationNo").Default(0).Comment("目标工位号(0=未指定)"),
field.Int("flowId").Default(0).Comment("该物料所属工艺ID(0=整线共用)"),
// 字段口径(2026-09-19 定稿,一个字段只有一个写者):
// sentQty 已发出量 [写者:自动出库/WMS 回写],同时是「还需发多少 = reqQty − sentQty」的幂等基准
// receivedQty 已接料量 [写者:工位扫码接料]
// 派生:在途 = sentQty − receivedQty
field.Float("sentQty").Default(0).Comment("已发出量(分批出库累加;幂等基准,勿与已接料混用)"),
field.Float("receivedQty").Default(0).Comment("已接料量(工位扫码接料累加)"),
field.Int64("receivedAt").Default(0).Comment("最近接料时间(unix 秒)"),
field.String("receiveBy").Default("").MaxLen(64).Comment("接料人"),
// 来源:PLAN=日排产备料(默认) / REFILL=工位叫料·数量不符补发(优先级高于 PLAN)
field.String("source").Default("PLAN").MaxLen(16).Comment("来源 PLAN/REFILL"),
// 补料/超领:超出 物料清单需求的量与原因为必填(超领不硬卡,但必须留痕可统计)
field.Float("overQty").Default(0).Comment("超出 物料清单需求的数量"),
field.String("overReason").Default("").MaxLen(64).Comment("超领原因 损耗/报废/返修/其他"),
// 补发来源:关联的数量不符单号(source=REFILL 且有值时填写)
field.String("refReportNo").Default("").MaxLen(64).Comment("关联数量不符单号"),
field.Bool("needAgv").Default(false).Comment("是否需要AGV配送到接驳台"),
field.String("batchNo").Default("").MaxLen(64).Comment("发料批次号(分批出库时填写)"),
field.String("operator").Default("").MaxLen(64),
field.Time("createdAt").Default(time.Now).Immutable(),
field.Time("updatedAt").Default(time.Now).UpdateDefault(time.Now).Optional().Nillable(),
}
}
func (MaterialRequest) Indexes() []ent.Index {
return []ent.Index{
index.Fields("orderNo"),
index.Fields("materialCode"),
index.Fields("status"),
}
}