本次 commit 统一修正了全项目范围内关于 SN 管理的术语表述,将原“SN管理”、“序列号件”、“批次件”等表述调整为“序列号”、“序列号=是”、“序列号=否”,同时同步更新了相关文档、代码注释、前端提示文本、数据库 schema 注释、API 文档等,确保全链路术语统一,消除理解歧义。
58 lines
3.1 KiB
Go
58 lines
3.1 KiB
Go
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"
|
||
)
|
||
|
||
// Material 物料主数据 MES 本地副本(两库对等双向同步,2026-09-29 定稿 M1)。
|
||
// 与 WMS materials 表同口径对等:code(图号=物料编码)为两库同步唯一业务键,两库均不物理删除(只停用)。
|
||
// 同步链路:
|
||
// · WMS 增/改/停用 → 内部接口 POST/PUT /api/internal/materials 按 code 幂等 upsert 到本表(M2/M4);
|
||
// · MES 侧型号维护:先写本表,再推 WMS /api/internal/materials/upsert,推失败置 sync_pending 待重推(M3);
|
||
// · 本地为空(冷启动)异步从 WMS 全量拉取补齐(M7);列表请求顺带重推 sync_pending 行;
|
||
// · 工位终端/排产/型号下拉全部读本表,WMS 宕机不受影响(M6)。
|
||
// 字段与 WMS MaterialRow 一致(item_type 1原材料/2半成品/3成品/4其他)。
|
||
// 「类型」与「是否逐件SN管理」解耦(2026-09-30 定稿):
|
||
// - manage_mode = 纯类型:1结构件/2电气件/3其他,不参与任何批次/SN 行为判断;
|
||
// - sn_mode = 是否逐件SN管理:0未选择(默认,必填)/1序列号=是(录SN)/2序列号=否(不录SN),
|
||
// 全链路(上线建档/装机绑定/备料出库/质量检验)唯一行为依据。
|
||
type Material struct {
|
||
ent.Schema
|
||
}
|
||
|
||
func (Material) Annotations() []schema.Annotation {
|
||
return []schema.Annotation{entsql.Annotation{Table: "materials"}, entsql.WithComments(true), schema.Comment("Material 物料主数据 MES 本地副本(两库对等双向同步,2026-09-29 定稿 M1)。")}
|
||
}
|
||
|
||
func (Material) Fields() []ent.Field {
|
||
return []ent.Field{
|
||
field.String("code").Unique().MaxLen(64).Comment("物料编码(图号),两库同步唯一业务键"),
|
||
field.String("name").MaxLen(128).Comment("物料名称"),
|
||
field.String("spec").Default("").MaxLen(128).Comment("规格型号"),
|
||
field.String("unit").Default("").MaxLen(32).Comment("计量单位"),
|
||
field.String("description").Default("").MaxLen(255).Comment("说明"),
|
||
field.Int("itemType").Default(1).Comment("物料类别 1原材料/3成品/4其他(半成品不是物料物料类别)"),
|
||
field.Int("manageMode").Default(1).Comment("类型 1结构件/2电气件/3其他(仅分类,不决定SN行为)"),
|
||
field.Int("snMode").Default(0).Comment("是否逐件SN管理 0未选择(必填)/1序列号=是(录SN)/2序列号=否(不录SN)"),
|
||
field.String("templateCode").Default("").MaxLen(64).Comment("模板编码"),
|
||
field.Int("safetyStock").Default(0).Comment("安全库存(低于触发缺货预警)"),
|
||
field.Bool("isActive").Default(true).Comment("启用/停用(两库均不物理删除)"),
|
||
field.Bool("syncPending").Default(false).Comment("推送WMS失败标记,列表请求时异步重推"),
|
||
field.Time("createdAt").Default(time.Now).Immutable(),
|
||
field.Time("updatedAt").Default(time.Now).UpdateDefault(time.Now),
|
||
}
|
||
}
|
||
|
||
func (Material) Indexes() []ent.Index {
|
||
return []ent.Index{
|
||
index.Fields("code").Unique(),
|
||
index.Fields("itemType"),
|
||
}
|
||
}
|