本次 commit 统一修正了全项目范围内关于 SN 管理的术语表述,将原“SN管理”、“序列号件”、“批次件”等表述调整为“序列号”、“序列号=是”、“序列号=否”,同时同步更新了相关文档、代码注释、前端提示文本、数据库 schema 注释、API 文档等,确保全链路术语统一,消除理解歧义。
131 lines
8.1 KiB
Go
131 lines
8.1 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"
|
||
)
|
||
|
||
// Inventory 统一库存台账
|
||
//
|
||
// 业务背景:原系统把库存拆成「结构件批次(inventory_batch)」与「电气件序列号(serial_number)」
|
||
// 两张表,导致 锁库存 / 导出 / 汇总 都要分别写两套逻辑,运维成本高且容易不一致。
|
||
// 现合并为一张表,用 sn_mode 区分序列号(2026-09-30 与类型 manage_mode 解耦),
|
||
// 对外提供统一的 锁/查询/汇总/盘点 能力。
|
||
//
|
||
// 两种序列号(sn_mode)的存储约定:
|
||
// - sn_mode = 2 序列号=否(数量管理):
|
||
// 一条记录 = 一个批次,quantity 表示该批次当前余量,locked_qty 表示已锁定件数。
|
||
// 可用量 = quantity - locked_qty。出库/盘点都按"数量"增减。
|
||
// - sn_mode = 1 序列号=是(SN 管理):
|
||
// 一条记录 = 一个单件(SN),quantity 恒为 1,locked_qty 为 0 或 1(锁定时=1)。
|
||
// 生命周期用 status 字段跟踪:在库/锁定/出库/使用/报废。
|
||
// 可用量 = quantity - locked_qty(锁定时为 0)。
|
||
//
|
||
// 库位四级贯通(U18):zone_code(区域) + shelf_no(货架) + layer_no(层) + position_no(位置),均手填、不做编号规则校验,
|
||
// 贯穿入库/出库/库存明细/盘点/导出全链路;精确货位串由 locLabel 拼接(如 Z01/A架/3层/12位)。
|
||
// 统一收编(2026-09-07 定稿):半成品/成品也进本表(category 区分物料类别),废除独立 semi_finisheds 孤表;
|
||
// 成品由 MES 完工发码后经内部接口自动回流入库,成品 SN 与实物码解耦(系统必发号,实物可不贴码,允许手填覆盖)。
|
||
type Inventory struct {
|
||
ent.Schema
|
||
}
|
||
|
||
// 物料类别(category):1=原材料 2=半成品 3=成品。与 sn_mode 正交:
|
||
// sn_mode 管"怎么管"(批次数量 vs SN 单件),category 管"是什么"(原料/半成品/成品)。
|
||
const (
|
||
InvCategoryRaw = 1
|
||
InvCategorySemi = 2
|
||
InvCategoryFinished = 3
|
||
)
|
||
|
||
func (Inventory) Annotations() []schema.Annotation {
|
||
return []schema.Annotation{entsql.Table("inventories"), entsql.WithComments(true), schema.Comment("Inventory 统一库存台账")}
|
||
}
|
||
func (Inventory) Fields() []ent.Field {
|
||
return []ent.Field{
|
||
// 类型(分类语境:结构件/电气件/其他,仅用于分类统计/筛选,2026-09-30 与序列号方式解耦)
|
||
field.Int("manage_mode").Comment("类型 1结构件/2电气件/3其他"),
|
||
// 序列号(sn_mode,2026-09-30 解耦定稿):1=序列号=是(逐件SN) 2=序列号=否(数量)。决定本行按"单件"还是"数量"解释。
|
||
field.Int("sn_mode").Default(0).Comment("序列号 1=是(逐件SN)/2=否(按批次数量)/0未选择"),
|
||
// 物料类别:1=原材料 2=半成品 3=成品(统一库存主表收编 semi_finished 后新增)
|
||
field.Int("category").Default(InvCategoryRaw).Comment("物料类别 1=原材料 2=半成品 3=成品"),
|
||
|
||
// 物料编码,关联 materials 主数据。
|
||
field.String("material_code").Comment("物料编码(关联 materials 表)"),
|
||
// 物料名称冗余存储,查询时无需再 join 主数据。
|
||
field.String("material_name").Optional().Comment("物料名称(冗余,便于直接展示)"),
|
||
|
||
// 批次号:序列号=否必填(系统生成);序列号=是可填所属批次用于分组追溯。
|
||
field.String("batch_no").Optional().Comment("批次号(系统生成);序列号=是可关联所属批次"),
|
||
// 序列号:仅序列号=是填写,作为单件唯一追溯锚点。全局唯一(一物一码,P2-2):
|
||
// 代码层跨 sn_mode 查重 + DB 部分唯一索引 ux_inventories_sn_code(非空值)双重保证;空值表示非 SN 行。
|
||
field.String("sn_code").Optional().Comment("序列号(SN,仅序列号=是);全局唯一,空值表示非 SN 行"),
|
||
|
||
// 数量:序列号=否=批次余量;序列号=是恒为 1。
|
||
field.Int("quantity").Default(0).Comment("数量:序列号=否=批次余量;序列号=是=1"),
|
||
// 已锁定数量:序列号=否=锁定件数;序列号=是=0或1。可用量 = quantity - locked_qty。
|
||
field.Int("locked_qty").Default(0).Comment("已锁定数量(库存占用):序列号=否=件数;序列号=是=0/1"),
|
||
|
||
// 检验状态,由质量检验模块翻转。
|
||
field.String("quality_status").Default("未检").Comment("检验状态 未检/合格/不合格"),
|
||
// 所在区域(大分区)。
|
||
field.String("zone_code").Optional().Comment("所在区域(Z01~Z04 大分区)"),
|
||
// 库位四级贯通(客户诉求 问题记录 L32/L169 + D5):区域→货架号→第几层→位置号。
|
||
// 与 zones 表 shelf_no/layer_no/position_no 对齐,落位到具体货架/层/位置。
|
||
field.String("shelf_no").Optional().Comment("货架号(手填,如 A)"),
|
||
field.String("layer_no").Optional().Comment("第几层(手填,如 3)"),
|
||
field.String("position_no").Optional().Comment("位置号(手填,如 12)"),
|
||
|
||
// 生命周期状态:
|
||
// 序列号=否一律"在库"(锁定看 locked_qty,不靠本字段);
|
||
// 序列号=是随业务流转:在库/锁定/出库/使用/报废。
|
||
field.String("status").Default("在库").Comment("生命周期:在库/锁定/出库/使用/报废(序列号=是用;序列号=否恒在库)。使用=预留未启用:原 SN 件产线在制态,现统一走「出库」,枚举值保留不动以保持兼容"),
|
||
|
||
// 生产日期(序列号=否用)。
|
||
field.String("production_date").Optional().Comment("生产日期"),
|
||
// 供应商(序列号=否用)。
|
||
field.String("supplier").Optional().Comment("供应商"),
|
||
// 关联入库单号,便于正向追溯。
|
||
field.String("inbound_no").Optional().Comment("关联入库单号"),
|
||
// 关联工单号(半成品流转/成品完工回流时由 MES 传入)。
|
||
field.String("order_no").Default("").MaxLen(64).Comment("关联工单号(半成品/成品回流)"),
|
||
// 产品工号(归属下手填二级编号;半成品/成品随工单带出;贯穿库存便于出库·检验·半成品展示/筛选)。
|
||
field.String("product_work_no").Optional().Comment("产品工号(贯穿库存,出库/检验/半成品带出展示)"),
|
||
// 已完成工序(半成品暂存回流用,如 135)。
|
||
field.String("completed_process").Default("").MaxLen(64).Comment("已完成工序(半成品用,如 135)"),
|
||
// 半成品/成品入库扩展字段(客户诉求 问题记录 L218/L222/L230:归属/产品状态/相关标准/试验记录单号/记录员/记录日期)
|
||
field.String("ownership_type").Optional().Comment("归属类型 workorder/project/other"),
|
||
field.String("ownership_no").Optional().Comment("归属编号(工单号/科技项目号/其他)"),
|
||
field.String("product_status").Optional().Comment("产品状态 已通过/部分通过/返修(成品用)"),
|
||
field.String("related_standard").Optional().Comment("相关标准(试验方案号)"),
|
||
field.String("test_record_no").Optional().Comment("试验记录单号"),
|
||
field.String("recorded_by").Optional().Comment("记录员"),
|
||
field.Int64("recorded_at").Optional().Comment("记录日期(unix 秒)"),
|
||
// 半成品/成品出库原因(客户诉求 L224:包装/继续生产/检验试验/其他)
|
||
field.String("outbound_reason").Optional().Comment("出库原因(半成品/成品出库用)"),
|
||
// 盘点冻结标记(盘点15问 问题2 最严重):非空=本行正被该盘点单锁定,盘点期间禁止出库/入库/锁定,
|
||
// 保证「库存量/锁定量/可用量」在盘点期间冻结,差异只反映盘盈盘亏而非业务变动。发起时置盘点单号,完成/取消时清空。
|
||
field.String("stocktake_no").Default("").MaxLen(64).Comment("盘点冻结标记(进行中盘点单号;空=未冻结)"),
|
||
// 备注。
|
||
field.String("remark").Optional().Comment("备注"),
|
||
|
||
field.Int64("created_at").DefaultFunc(nowUnix),
|
||
field.Int64("updated_at").DefaultFunc(nowUnix),
|
||
}
|
||
}
|
||
|
||
func (Inventory) Indexes() []ent.Index {
|
||
return []ent.Index{
|
||
index.Fields("manage_mode"),
|
||
index.Fields("sn_mode"),
|
||
index.Fields("category"),
|
||
index.Fields("material_code"),
|
||
index.Fields("quality_status"),
|
||
index.Fields("zone_code"),
|
||
index.Fields("batch_no"),
|
||
index.Fields("sn_code"),
|
||
}
|
||
}
|