bj_power/bj_power_wms/schema/zone.go

package schema

import (
	"entgo.io/ent"
	"entgo.io/ent/schema/field"
)

// Zone 库房库位主数据（统一主表 + 层级类型字段，符合「统一主表+类型字段，禁拆表」铁律）。
// 四级父子结构：区域(level=1) → 货架(level=2) → 层(level=3) → 位置号(level=4)。
// 每一行是一个层级节点；zone_code/shelf_no/layer_no/position_no 为冗余全路径，便于按区域筛选与库存关联，
// 库存/入库/出库/盘点仍沿用这四级冗余字段，追溯零断裂。
// 唯一性由 ux_zones_node(level, zone_code, shelf_no, layer_no, code) 保证（见 internal/db/db.go）。
type Zone struct {
	ent.Schema
}

func (Zone) Fields() []ent.Field {
	return []ent.Field{
		field.Int("level").Comment("层级 1区域/2货架/3层/4位置号"),
		field.String("code").Comment("本级编码（区域编码/货架号/层号/位置号）"),
		field.String("name").Optional().Comment("显示名：区域名称(level1)或位置名称(level4，现场可读如'A架3层12位')；其他级可空"),
		field.String("parent_code").Optional().Comment("上级节点编码；根级(level1)为空"),
		// 区域编码（冗余，所有层级都带，用于按区域筛选/库存关联）：level1 行 = 自身 code
		field.String("zone_code").Comment("区域编码(冗余：本节点所属区域；level1=自身code)"),
		// 区域名称（仅 level1 区域行有值，保留兼容 stock.go 区域名映射）
		field.String("zone_name").Optional().Comment("区域名称(仅 level1 区域行有值)"),
		field.String("description").Optional().Comment("说明(区域级)"),
		// 货架号（冗余）：level2/3/4 行有值
		field.String("shelf_no").Optional().Comment("货架号(冗余)"),
		// 第几层（冗余）：level3/4 行有值（默认位置 layer_no 为空）
		field.String("layer_no").Optional().Comment("第几层(冗余；默认位置为空)"),
		// 位置号（冗余）：level4 行 = 自身 code
		field.String("position_no").Optional().Comment("位置号(冗余；level4=自身code)"),
		field.String("status").Default("启用").Comment("状态：启用/停用"),
		field.Int64("created_at").DefaultFunc(nowUnix),
		field.Int64("updated_at").DefaultFunc(nowUnix).Optional().Comment("更新时间"),
	}
}