84 lines
4.0 KiB
Go
84 lines
4.0 KiB
Go
|
package schema
|
|||
|
|
|
|||
|
|
import (
|
|||
|
|
"entgo.io/ent"
|
|||
|
|
"entgo.io/ent/schema/field"
|
|||
|
|
"entgo.io/ent/schema/index"
|
|||
|
|
)
|
|||
|
|
|
|||
|
|
// Inventory 统一库存台账
|
|||
|
|
//
|
|||
|
|
// 业务背景：原系统把库存拆成「结构件批次(inventory_batch)」与「精密件序列号(serial_number)」
|
|||
|
|
// 两张表，导致 锁库存 / 导出 / 汇总 都要分别写两套逻辑，运维成本高且容易不一致。
|
|||
|
|
// 现合并为一张表，用 manage_mode 区分管理粒度，对外提供统一的 锁/查询/汇总/盘点 能力。
|
|||
|
|
//
|
|||
|
|
// 两种管理粒度的存储约定：
|
|||
|
|
// - manage_mode = 1 结构件（批次管理）：
|
|||
|
|
// 一条记录 = 一个批次，quantity 表示该批次当前余量，locked_qty 表示已锁定件数。
|
|||
|
|
// 可用量 = quantity - locked_qty。出库/盘点都按"数量"增减。
|
|||
|
|
// - manage_mode = 2 精密件（SN 管理）：
|
|||
|
|
// 一条记录 = 一个单件(SN)，quantity 恒为 1，locked_qty 为 0 或 1（锁定时=1）。
|
|||
|
|
// 生命周期用 status 字段跟踪：在库/锁定/出库/使用/报废。
|
|||
|
|
// 可用量 = quantity - locked_qty（锁定时为 0）。
|
|||
|
|
//
|
|||
|
|
// 区域(zone_code)只到 Z01~Z04 大分区级别，不引入货架/层/格（业务决策：小货架高频取货场景无需精确货位索引）。
|
|||
|
|
// 半成品(semifinished)是独立的固定业务类型，不进本表（由 MES 报工闭环单独管理）。
|
|||
|
|
type Inventory struct {
|
|||
|
|
ent.Schema
|
|||
|
|
}
|
|||
|
|
|
|||
|
|
func (Inventory) Fields() []ent.Field {
|
|||
|
|
return []ent.Field{
|
|||
|
|
// 管理粒度：1=结构件(批次) 2=精密件(SN)。决定本行按"数量"还是按"单件"解释。
|
|||
|
|
field.Int("manage_mode").Comment("管理粒度 1=结构件(批次) 2=精密件(SN)"),
|
|||
|
|
|
|||
|
|
// 物料编码，关联 materials 主数据。
|
|||
|
|
field.String("material_code").Comment("物料编码(关联 materials 表)"),
|
|||
|
|
// 物料名称冗余存储，查询时无需再 join 主数据。
|
|||
|
|
field.String("material_name").Optional().Comment("物料名称(冗余，便于直接展示)"),
|
|||
|
|
|
|||
|
|
// 批次号：结构件必填(系统生成)；精密件可填所属批次用于分组追溯。
|
|||
|
|
field.String("batch_no").Optional().Comment("批次号(系统生成)；精密件可关联所属批次"),
|
|||
|
|
// 序列号：仅精密件填写，作为单件唯一追溯锚点。空字符串不保证唯一，由代码层查重。
|
|||
|
|
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 大分区)"),
|
|||
|
|
|
|||
|
|
// 生命周期状态：
|
|||
|
|
// 结构件一律"在库"（锁定看 locked_qty，不靠本字段）；
|
|||
|
|
// 精密件随业务流转：在库/锁定/出库/使用/报废。
|
|||
|
|
field.String("status").Default("在库").Comment("生命周期：在库/锁定/出库/使用/报废(精密件用；结构件恒在库)"),
|
|||
|
|
|
|||
|
|
// 生产日期（结构件批次用）。
|
|||
|
|
field.String("production_date").Optional().Comment("生产日期"),
|
|||
|
|
// 供应商（结构件批次用）。
|
|||
|
|
field.String("supplier").Optional().Comment("供应商"),
|
|||
|
|
// 关联入库单号，便于正向追溯。
|
|||
|
|
field.String("inbound_no").Optional().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("material_code"),
|
|||
|
|
index.Fields("quality_status"),
|
|||
|
|
index.Fields("zone_code"),
|
|||
|
|
index.Fields("batch_no"),
|
|||
|
|
index.Fields("sn_code"),
|
|||
|
|
}
|
|||
|
|
}
|