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

77 lines
4.7 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"),
}
}