- MES 新增实体:混产模板、产品BOM、产品工艺物料、试制记录(schema + ent 生成码 + logic/handler/前端页) - WMS 实体增强:检验记录、库存、半成品重构;新增序列号库存与短缺代报 - AGV 与产能:AGV 手动点位与链路、物料守卫、短缺预测、原因字典 - 前端通用能力:新增下一步引导组件 NextStepBar,统一帮助文档/布局/请求拦截与操作列 - 工位终端:界面与各 handler 调整(api/store/绑定/PLC/拧紧/上报等) - 配置与文档:更新 mes-api.yaml、WMS README 及案例/产线API/问题记录/项目说明/流程说明
84 lines
5.4 KiB
Go
84 lines
5.4 KiB
Go
package schema
|
||
|
||
import (
|
||
"entgo.io/ent"
|
||
"entgo.io/ent/dialect/entsql"
|
||
"entgo.io/ent/schema"
|
||
"entgo.io/ent/schema/field"
|
||
"entgo.io/ent/schema/index"
|
||
)
|
||
|
||
// Material 物料档案(主数据)
|
||
// 全系统物料的唯一定义来源,入库/出库/库存/检验都通过 material_code 关联本表。
|
||
// 「类型」(manage_mode) 与「序列号=是/否」(sn_mode) 是两个相互独立的维度:
|
||
// 类型(分类,入库「结构件/电气件/其他」三个页签同源,仅用于分类统计/筛选/页签归属):
|
||
// - manage_mode=1 结构件;manage_mode=2 电气件;manage_mode=3 其他(辅料/工装/试验设备)。
|
||
//
|
||
// sn_mode(是否逐件 SN 管理,决定入库/出库/库存的序列号方式):
|
||
// - sn_mode=1 序列号=是:逐件录 SN,库存以单件行计数,可单件追溯;
|
||
// - sn_mode=2 序列号=否:按数量记账,不录 SN;
|
||
// - sn_mode=0 未选择(默认):物料档案必选后才能出入库(业务层校验)。
|
||
//
|
||
// 物料类别(与库存主表 inventories.category 对应,独立于类型):
|
||
// - item_type=1 原材料 / 3 成品(成品即"产品型号"档案,MES 实时从本表拉取,
|
||
// 消除两系统双录——2026-09-08 并表定稿)。
|
||
// 「其他」类别已按 2026-10-19 用户裁决全项目移除(两库存量均为 0 行)。
|
||
// 在制品不是物料类别(2026-09-22 定稿):在制品是工件状态,由库存 category=2 承载,
|
||
// 物料档案不再有 item_type=2 行(存量由 internal/db 迁移补丁幂等清理)。
|
||
//
|
||
// 注意:物料档案只描述"这个物料是什么、怎么管",不承载生命周期状态。
|
||
type Material struct {
|
||
ent.Schema
|
||
}
|
||
|
||
func (Material) Annotations() []schema.Annotation {
|
||
return []schema.Annotation{entsql.Table("materials"), entsql.WithComments(true), schema.Comment("Material 物料档案(主数据)")}
|
||
}
|
||
func (Material) Fields() []ent.Field {
|
||
return []ent.Field{
|
||
field.String("code").Unique().Comment("物料唯一编码"),
|
||
field.String("name").Comment("物料真实名称"),
|
||
// 「简称」字段已按 2026-09-19 用户裁决整体删除(新增/编辑表单不再出现)。
|
||
// 字段级必填口径:图号 code / 名称 name / 规格 spec / 单位 unit / 物料类别 item_type /
|
||
// 类型 manage_mode / 安全库存 safety_stock 均必填;仅「说明」description 可空。
|
||
// 必填在 handler 层校验(DB 列保持可空,避免存量行 NULL 扫描失败)。
|
||
field.String("spec").Optional().Comment("规格型号"),
|
||
field.String("unit").Optional().Comment("单位"),
|
||
field.String("description").Optional().Comment("描述"),
|
||
// 物料类别(独立于类型的维度):1=原材料 3=成品(在制品不是物料类别,由库存承载)
|
||
field.Int("item_type").Default(1).Comment("物料类别 1原材料/3成品(在制品不是物料类别,由库存 category=2 承载)"),
|
||
// 类型(分类,入库「结构件/电气件/其他」三页签同源,仅用于分类统计/筛选/页签归属):
|
||
// 1=结构件 2=电气件 3=其他(辅料/工装/试验设备);与 SN 行为无关(见 sn_mode)
|
||
field.Int("manage_mode").Default(1).Comment("类型 1结构件/2电气件/3其他"),
|
||
// 是否逐件 SN 管理(2026-09-30 与类型解耦):1=序列号=是(逐件SN) 2=序列号=否(数量) 0=未选择
|
||
// 默认联动:电气件→1,结构件/其他→2;必选约束在业务层(0 不可出入库)
|
||
field.Int("sn_mode").Default(0).Comment("序列号 1=是(逐件录SN)/2=否(按数量)/0未选择"),
|
||
field.Bool("is_batch_managed").Default(false).Comment("是否批次管理(按 sn_mode=2 派生)"),
|
||
field.Bool("is_serial_managed").Default(false).Comment("是否序列号管理(按 sn_mode=1 派生)"),
|
||
// 所属物料模板(种类)
|
||
field.String("template_code").Optional().Comment("物料模板编码(物料种类)"),
|
||
// 图号已按客户裁决(问题记录 L18)与物料编码合并:code 即图号,界面统一显示「图号」,
|
||
// 不再保留独立 drawing_no 字段(避免两个「图号」并存造成混乱)。
|
||
// 安全库存:低于该值触发缺货预警(客户诉求 问题记录 L473:安全库存/缺货预警进 WMS 首页)
|
||
field.Int("safety_stock").Default(0).Comment("安全库存(低于则缺货预警,0=不预警)"),
|
||
// 启用状态:停用后不在新建工单/备料下拉出现(对齐 MES 产品型号 isActive)
|
||
field.Bool("is_active").Default(true).Comment("是否启用"),
|
||
// WMS→MES 推送失败标记(C4 反向,对齐 MES material.sync_pending):
|
||
// 推送 MES 本地副本失败时置 true 并写 event_log;成功或手动重推成功后清位。
|
||
// 仅作失败状态标识,不参与业务逻辑判定(质量门禁等仍以合格状态为准)。
|
||
field.Bool("sync_pending").Default(false).Comment("WMS→MES 推送失败标记(手动重推清位)"),
|
||
// 物料编码(问题12):普通档案字段,列名统一「物料编码」,不参与业务/必填校验,也不参与编码唯一约束。
|
||
field.String("material_code").Optional().MaxLen(128).Comment("物料编码(普通字段,不参与业务)"),
|
||
field.Int64("created_at").DefaultFunc(nowUnix).Comment("创建时间"),
|
||
field.Int64("updated_at").DefaultFunc(nowUnix).Comment("更新时间"),
|
||
}
|
||
}
|
||
|
||
func (Material) Indexes() []ent.Index {
|
||
return []ent.Index{
|
||
index.Fields("name"),
|
||
index.Fields("template_code"),
|
||
index.Fields("item_type"),
|
||
}
|
||
}
|