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

58 lines
3.1 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"
)
// 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"),
}
}