Files
bj_power/bj_power_wms/schema/material.go
T
SunYF 1f7a42fc38 refactor(mes): 移除工位接驳台绑定逻辑,改为独立dock主数据
- 移除station表的hasDock、dockCode字段及相关代码
- 新增dock表注释及关联逻辑,支持一个工位绑定多个接驳台
- 更新工位相关的seed、logic、schema及前端代码,适配新的接驳台管理方式
- 新增SQL注释固化脚本,完善MES表注释
2026-10-08 13:09:53 +08:00

77 lines
4.6 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 (
"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 成品 / 4 其他(成品即"产品型号"档案,MES 实时从本表拉取,
// 消除两系统双录——2026-09-08 并表定稿)。
// 半成品不是物料品类(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=成品 4=其他(半成品不是物料品类,由库存承载)
field.Int("item_type").Default(1).Comment("品类 1原材料/3成品/4其他(半成品不是物料品类,由库存 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("SN管理 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("是否启用"),
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"),
}
}