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原材料/3成品;「其他」已按 2026-10-19 裁决移除)。 // 「类型」与「是否逐件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成品(半成品不是物料类别,「其他」已移除)"), 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"), } }