Files
SunYF f35e9b5b75 docs(deployment): 更新部署手册和业务架构说明
- 更新MES和WMS服务端口配置说明
- 详细说明产线工位设备配置(扫码枪+拧紧枪)
- 明确AGV配送和接驳台的模拟模式与真实对接方案
- 更新WMS中AGV配送默认模拟模式说明
- 完善厂内物流(AGV/接驳台)的业务架构约束
- 修订临时文档为详细的项目问题和解决方案规划
2026-09-20 14:52:36 +08:00

76 lines
3.5 KiB
Go

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