feat: 解耦管理类型与SN管理方式,新增sn_mode字段实现全链路SN管理标准化
本次重构将原manage_mode字段拆分为独立的分类维度(manage_mode)和SN管理维度(sn_mode),实现全链路(MES/WMS/工位终端)的SN管理行为统一依据: 1. 新增sn_mode字段,定义1=序列号件、2=批次件、0=未选择,替代原manage_mode的SN判断逻辑 2. 移除冗余的manage_mode字段在多个实体中的使用,统一使用sn_mode决定业务行为 3. 新增工位接驳台配置,服务端固定接驳台,前端不可修改,确保AGV送达准确性 4. 优化检验记录导出,新增装配物料绑定明细,满足客户追溯需求 5. 修正前端提示文本,统一使用序列号件/批次件表述,与后端逻辑对齐
This commit is contained in:
@@ -18,8 +18,10 @@ func (InboundOrder) Fields() []ent.Field {
|
||||
field.String("inbound_type").Default("purchase").Comment("入库类型 purchase/semi/finished/return/other"),
|
||||
field.String("material_code").Comment("物料编码"),
|
||||
field.String("material_name").Optional().Comment("物料名称(冗余)"),
|
||||
// 管理粒度 1批次(结构件)/2序列号(电气件),冗余自物料档案,便于单单据直接判断
|
||||
field.Int("manage_mode").Default(1).Comment("管理粒度 1批次/2序列号"),
|
||||
// 类型(分类语境,冗余自物料档案):1结构件/2电气件/3其他
|
||||
field.Int("manage_mode").Default(1).Comment("类型 1结构件/2电气件/3其他"),
|
||||
// 记账方式(2026-09-30 解耦定稿,冗余自物料档案,便于单单据直接判断):1序列号件(逐件SN)/2批次件(数量)
|
||||
field.Int("sn_mode").Default(0).Comment("SN管理 1序列号件(逐件SN)/2批次件(数量)/0未选择"),
|
||||
field.String("batch_no").Optional().Comment("批次号(结构件)"),
|
||||
field.String("zone_code").Optional().Comment("入库区域(大区)"),
|
||||
// 库位四级贯通(客户诉求 问题记录 L32/L169 + D5):区域→货架号→第几层→位置号。
|
||||
|
||||
@@ -10,13 +10,14 @@ import (
|
||||
//
|
||||
// 业务背景:原系统把库存拆成「结构件批次(inventory_batch)」与「电气件序列号(serial_number)」
|
||||
// 两张表,导致 锁库存 / 导出 / 汇总 都要分别写两套逻辑,运维成本高且容易不一致。
|
||||
// 现合并为一张表,用 manage_mode 区分管理粒度,对外提供统一的 锁/查询/汇总/盘点 能力。
|
||||
// 现合并为一张表,用 sn_mode 区分记账方式(2026-09-30 与类型 manage_mode 解耦),
|
||||
// 对外提供统一的 锁/查询/汇总/盘点 能力。
|
||||
//
|
||||
// 两种管理粒度的存储约定:
|
||||
// - manage_mode = 1 结构件(批次管理):
|
||||
// 两种记账方式的存储约定:
|
||||
// - sn_mode = 2 批次件(数量管理):
|
||||
// 一条记录 = 一个批次,quantity 表示该批次当前余量,locked_qty 表示已锁定件数。
|
||||
// 可用量 = quantity - locked_qty。出库/盘点都按"数量"增减。
|
||||
// - manage_mode = 2 电气件(SN 管理):
|
||||
// - sn_mode = 1 序列号件(SN 管理):
|
||||
// 一条记录 = 一个单件(SN),quantity 恒为 1,locked_qty 为 0 或 1(锁定时=1)。
|
||||
// 生命周期用 status 字段跟踪:在库/锁定/出库/使用/报废。
|
||||
// 可用量 = quantity - locked_qty(锁定时为 0)。
|
||||
@@ -29,8 +30,8 @@ type Inventory struct {
|
||||
ent.Schema
|
||||
}
|
||||
|
||||
// 品类(category):1=原材料 2=半成品 3=成品。与 manage_mode 正交:
|
||||
// manage_mode 管"怎么管"(批次数量 vs SN 单件),category 管"是什么"(原料/半成品/成品)。
|
||||
// 品类(category):1=原材料 2=半成品 3=成品。与 sn_mode 正交:
|
||||
// sn_mode 管"怎么管"(批次数量 vs SN 单件),category 管"是什么"(原料/半成品/成品)。
|
||||
const (
|
||||
InvCategoryRaw = 1
|
||||
InvCategorySemi = 2
|
||||
@@ -39,8 +40,10 @@ const (
|
||||
|
||||
func (Inventory) Fields() []ent.Field {
|
||||
return []ent.Field{
|
||||
// 管理粒度:1=结构件(批次) 2=电气件(SN)。决定本行按"数量"还是按"单件"解释。
|
||||
field.Int("manage_mode").Comment("管理粒度 1=结构件(批次) 2=电气件(SN)"),
|
||||
// 类型(分类语境:结构件/电气件/其他,仅用于分类统计/筛选,2026-09-30 与记账方式解耦)
|
||||
field.Int("manage_mode").Comment("类型 1结构件/2电气件/3其他"),
|
||||
// 记账方式(2026-09-30 解耦定稿):1=序列号件(逐件SN) 2=批次件(数量)。决定本行按"单件"还是"数量"解释。
|
||||
field.Int("sn_mode").Default(0).Comment("SN管理 1序列号件(逐件SN)/2批次件(数量)/0未选择"),
|
||||
// 品类:1=原材料 2=半成品 3=成品(统一库存主表收编 semi_finished 后新增)
|
||||
field.Int("category").Default(InvCategoryRaw).Comment("品类 1=原材料 2=半成品 3=成品"),
|
||||
|
||||
@@ -49,16 +52,16 @@ func (Inventory) Fields() []ent.Field {
|
||||
// 物料名称冗余存储,查询时无需再 join 主数据。
|
||||
field.String("material_name").Optional().Comment("物料名称(冗余,便于直接展示)"),
|
||||
|
||||
// 批次号:结构件必填(系统生成);电气件可填所属批次用于分组追溯。
|
||||
field.String("batch_no").Optional().Comment("批次号(系统生成);电气件可关联所属批次"),
|
||||
// 序列号:仅电气件填写,作为单件唯一追溯锚点。全局唯一(一物一码,P2-2):
|
||||
// 代码层跨 manage_mode 查重 + DB 部分唯一索引 ux_inventories_sn_code(非空值)双重保证;空值表示非 SN 行。
|
||||
field.String("sn_code").Optional().Comment("序列号(SN,仅电气件);全局唯一,空值表示非 SN 行"),
|
||||
// 批次号:批次件必填(系统生成);序列号件可填所属批次用于分组追溯。
|
||||
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"),
|
||||
// 数量:批次件=批次余量;序列号件恒为 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("检验状态 未检/合格/不合格"),
|
||||
@@ -71,13 +74,13 @@ func (Inventory) Fields() []ent.Field {
|
||||
field.String("position_no").Optional().Comment("位置号(手填,如 12)"),
|
||||
|
||||
// 生命周期状态:
|
||||
// 结构件一律"在库"(锁定看 locked_qty,不靠本字段);
|
||||
// 电气件随业务流转:在库/锁定/出库/使用/报废。
|
||||
field.String("status").Default("在库").Comment("生命周期:在库/锁定/出库/使用/报废(电气件用;结构件恒在库)"),
|
||||
// 批次件一律"在库"(锁定看 locked_qty,不靠本字段);
|
||||
// 序列号件随业务流转:在库/锁定/出库/使用/报废。
|
||||
field.String("status").Default("在库").Comment("生命周期:在库/锁定/出库/使用/报废(序列号件用;批次件恒在库)"),
|
||||
|
||||
// 生产日期(结构件批次用)。
|
||||
// 生产日期(批次件用)。
|
||||
field.String("production_date").Optional().Comment("生产日期"),
|
||||
// 供应商(结构件批次用)。
|
||||
// 供应商(批次件用)。
|
||||
field.String("supplier").Optional().Comment("供应商"),
|
||||
// 关联入库单号,便于正向追溯。
|
||||
field.String("inbound_no").Optional().Comment("关联入库单号"),
|
||||
@@ -111,6 +114,7 @@ func (Inventory) Fields() []ent.Field {
|
||||
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"),
|
||||
|
||||
@@ -8,11 +8,14 @@ import (
|
||||
|
||||
// Material 物料档案(主数据)
|
||||
// 全系统物料的唯一定义来源,入库/出库/库存/检验都通过 material_code 关联本表。
|
||||
// 「类型」(manage_mode) 与「品类」(item_type) 是两个相互独立的维度:
|
||||
// 类型(管理粒度,入库「结构件/电气件/其他」三个页签同源):
|
||||
// - manage_mode=1 结构件:按"批次"管理,一次到货入一批,库存以 quantity 计数;
|
||||
// - manage_mode=2 电气件:按"SN 序列号"逐件管理,库存以单件行计数,可单件追溯;
|
||||
// - manage_mode=3 其他(辅料/工装/试验设备):按"批次数量"管理,不做 SN。
|
||||
// 「类型」(manage_mode) 与「序列号件/批次件」(sn_mode) 是两个相互独立的维度:
|
||||
// 类型(分类,入库「结构件/电气件/其他」三个页签同源,仅用于分类统计/筛选/页签归属):
|
||||
// - manage_mode=1 结构件;manage_mode=2 电气件;manage_mode=3 其他(辅料/工装/试验设备)。
|
||||
//
|
||||
// sn_mode(是否逐件 SN 管理,决定入库/出库/库存的记账方式):
|
||||
// - sn_mode=1 序列号件:逐件录 SN,库存以单件行计数,可单件追溯;
|
||||
// - sn_mode=2 批次件:按数量记账,不录 SN;
|
||||
// - sn_mode=0 未选择(默认):物料档案必选后才能出入库(业务层校验)。
|
||||
//
|
||||
// 品类(与库存主表 inventories.category 对应,独立于类型):
|
||||
// - item_type=1 原材料 / 3 成品 / 4 其他(成品即"产品型号"档案,MES 实时从本表拉取,
|
||||
@@ -38,11 +41,14 @@ func (Material) Fields() []ent.Field {
|
||||
field.String("description").Optional().Comment("描述"),
|
||||
// 品类(独立于类型的维度):1=原材料 3=成品 4=其他(半成品不是物料品类,由库存承载)
|
||||
field.Int("item_type").Default(1).Comment("品类 1原材料/3成品/4其他(半成品不是物料品类,由库存 category=2 承载)"),
|
||||
// 类型(管理粒度,入库「结构件/电气件/其他」三页签同源):
|
||||
// 1=结构件(批次) 2=电气件(序列号) 3=其他(辅料/工装/试验设备,按批次数量,不做 SN)
|
||||
field.Int("manage_mode").Default(1).Comment("类型 1结构件(批次)/2电气件(序列号)/3其他"),
|
||||
field.Bool("is_batch_managed").Default(false).Comment("是否批次管理"),
|
||||
field.Bool("is_serial_managed").Default(false).Comment("是否序列号管理"),
|
||||
// 类型(分类,入库「结构件/电气件/其他」三页签同源,仅用于分类统计/筛选/页签归属):
|
||||
// 1=结构件 2=电气件 3=其他(辅料/工装/试验设备);与 SN 行为无关(见 sn_mode)
|
||||
field.Int("manage_mode").Default(1).Comment("类型 1结构件/2电气件/3其他"),
|
||||
// 是否逐件 SN 管理(2026-09-30 与类型解耦):1=序列号件(逐件SN) 2=批次件(数量) 0=未选择
|
||||
// 默认联动:电气件→1,结构件/其他→2;必选约束在业务层(0 不可出入库)
|
||||
field.Int("sn_mode").Default(0).Comment("SN管理 1序列号件(逐件SN)/2批次件(数量)/0未选择"),
|
||||
field.Bool("is_batch_managed").Default(false).Comment("是否批次管理(按 sn_mode=2 派生)"),
|
||||
field.Bool("is_serial_managed").Default(false).Comment("是否序列号管理(按 sn_mode=1 派生)"),
|
||||
// 所属物料模板(种类)
|
||||
field.String("template_code").Optional().Comment("物料模板编码(物料种类)"),
|
||||
// 图号已按客户裁决(问题记录 L18)与物料编码合并:code 即图号,界面统一显示「图号」,
|
||||
|
||||
@@ -36,7 +36,10 @@ func (OutboundOrder) Fields() []ent.Field {
|
||||
field.String("order_no").Optional().Comment("关联工单号(工单为唯一挂靠载体)"),
|
||||
field.String("material_code").Comment("物料编码"),
|
||||
field.String("material_name").Optional().Comment("物料名称(冗余)"),
|
||||
field.Int("manage_mode").Default(1).Comment("管理粒度 1批次/2序列号"),
|
||||
// 类型(分类语境):1结构件/2电气件/3其他
|
||||
field.Int("manage_mode").Default(1).Comment("类型 1结构件/2电气件/3其他"),
|
||||
// 记账方式(2026-09-30 解耦定稿):1序列号件(逐件SN)/2批次件(数量)
|
||||
field.Int("sn_mode").Default(0).Comment("SN管理 1序列号件(逐件SN)/2批次件(数量)/0未选择"),
|
||||
field.String("batch_no").Optional().Comment("批次号(结构件)"),
|
||||
// 出库库位四级(客户诉求:出库与入库同口径,2026-09-19 补齐)
|
||||
field.String("zone_code").Optional().Comment("出库区域(大区)"),
|
||||
|
||||
Reference in New Issue
Block a user