package schema import ( "entgo.io/ent" "entgo.io/ent/schema/field" "entgo.io/ent/schema/index" ) // StocktakeOrder 盘点单:发起时冻结当时库存快照(明细行) type StocktakeOrder struct { ent.Schema } func (StocktakeOrder) Fields() []ent.Field { return []ent.Field{ field.String("stocktake_no").Unique().Comment("盘点单号"), // 状态机(盘点15问 问题10):进行中(已锁定库存) → 已完成(仅出结论) / 已写回(差异已修正库存) / 已取消 field.String("status").Default("进行中").Comment("进行中/已完成/已写回/已取消"), field.String("operator").Optional().Comment("发起人"), field.Int("total_targets").Default(0).Comment("快照目标数(本次盘点覆盖的批次/SN总数)"), // 差异项数(问题13):完成时统计 diff!=0 的明细行数,便于历史列表一眼看出盘盈盘亏规模。 field.Int("diff_count").Default(0).Comment("差异项数(diff!=0 的明细数)"), // 是否写回 + 调整单号 + 写回时间/操作人(问题4/13):写回走盘点调整单,留痕可追溯。 field.Bool("adjusted").Default(false).Comment("差异是否已写回库存"), field.String("adjust_no").Optional().Comment("盘点调整单号(写回时生成)"), field.Int64("written_at").Optional().Comment("写回时间(unix 秒)"), field.String("written_by").Optional().Comment("写回操作人"), // 未盘项处理方式(问题5):keep=按账面保留 / zero=盘亏为0 field.String("uncounted_mode").Optional().Comment("未盘项处理 keep=按账面保留/zero=盘亏为0"), // 取消原因(问题9):取消盘点时记录,便于追溯。 field.String("cancel_reason").Optional().Comment("取消原因"), field.Int64("created_at").DefaultFunc(nowUnix), field.Int64("finished_at").Optional().Comment("完成时间"), } } func (StocktakeOrder) Indexes() []ent.Index { return []ent.Index{ index.Fields("status"), } } // StocktakeItem 盘点明细(发起时的账面快照 + 扫码实盘数) type StocktakeItem struct { ent.Schema } func (StocktakeItem) Fields() []ent.Field { return []ent.Field{ field.String("stocktake_no").Comment("所属盘点单号"), field.String("target_type").Comment("BATCH/SN"), field.String("target_id").Comment("批次号或SN码"), field.String("material_code").Optional().Comment("物料编码(冗余,便于盘点差异按物料归类)"), field.String("zone_code").Optional().Comment("所在区域"), // 库位四级贯通(U18):盘点快照除区域外,冻结货架/层/位置,盘点差异可精确定位到货位。 field.String("shelf_no").Optional().Comment("货架号(快照)"), field.String("layer_no").Optional().Comment("第几层(快照)"), field.String("position_no").Optional().Comment("位置号(快照)"), field.Int("book_qty").Default(0).Comment("账面数量"), field.Int("scanned_qty").Default(-1).Comment("实盘数量,-1=未盘"), field.Int("diff_qty").Default(0).Comment("差异 = 实盘 - 账面"), field.Bool("counted").Default(false).Comment("是否已扫码"), // 实盘人/实盘时间(问题14):导出盘点明细时「操作人」取实盘扫码人,而非发起人。 field.String("counted_by").Optional().Comment("实盘人(扫码录入者)"), field.Int64("counted_at").Optional().Comment("实盘时间(unix 秒)"), field.Int64("updated_at").DefaultFunc(nowUnix), } } func (StocktakeItem) Indexes() []ent.Index { return []ent.Index{ index.Fields("stocktake_no"), index.Fields("target_id"), } }