Files
bj_power/bj_power_wms/schema/inventory.go
T
SunYF 1e92b2a596 feat: 核心业务实体扩充(混产模板/产品BOM/试制记录)、WMS 库存检验增强与前端通用能力
- MES 新增实体:混产模板、产品BOM、产品工艺物料、试制记录(schema + ent 生成码 + logic/handler/前端页)
- WMS 实体增强:检验记录、库存、半成品重构;新增序列号库存与短缺代报
- AGV 与产能:AGV 手动点位与链路、物料守卫、短缺预测、原因字典
- 前端通用能力:新增下一步引导组件 NextStepBar,统一帮助文档/布局/请求拦截与操作列
- 工位终端:界面与各 handler 调整(api/store/绑定/PLC/拧紧/上报等)
- 配置与文档:更新 mes-api.yaml、WMS README 及案例/产线API/问题记录/项目说明/流程说明
2026-11-15 12:17:39 +08:00

133 lines
8.4 KiB
Go
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
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("记录员(展示名;2026-11-13 起由服务端按登录人覆写,前端不可编辑)"),
// 2026-11-13 拍板:记录员必须留当前登录人的结构化 ID,禁止前端伪造姓名字符串。
field.Int64("recorded_by_id").Optional().Comment("记录员 user_id(取自 JWT X-UserID,服务端强制写入)"),
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"),
}
}