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