- MES 新增实体:混产模板、产品BOM、产品工艺物料、试制记录(schema + ent 生成码 + logic/handler/前端页) - WMS 实体增强:检验记录、库存、半成品重构;新增序列号库存与短缺代报 - AGV 与产能:AGV 手动点位与链路、物料守卫、短缺预测、原因字典 - 前端通用能力:新增下一步引导组件 NextStepBar,统一帮助文档/布局/请求拦截与操作列 - 工位终端:界面与各 handler 调整(api/store/绑定/PLC/拧紧/上报等) - 配置与文档:更新 mes-api.yaml、WMS README 及案例/产线API/问题记录/项目说明/流程说明
59 lines
3.2 KiB
Go
59 lines
3.2 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原材料/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.String("material_code").Optional().MaxLen(128).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"),
|
||
}
|
||
}
|