Files
bj_power/bj_power_wms/schema/material.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

84 lines
5.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"
)
// Material 物料档案(主数据)
// 全系统物料的唯一定义来源,入库/出库/库存/检验都通过 material_code 关联本表。
// 「类型」(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 成品(成品即"产品型号"档案,MES 实时从本表拉取,
// 消除两系统双录——2026-09-08 并表定稿)。
// 「其他」类别已按 2026-10-19 用户裁决全项目移除(两库存量均为 0 行)。
// 在制品不是物料类别(2026-09-22 定稿):在制品是工件状态,由库存 category=2 承载,
// 物料档案不再有 item_type=2 行(存量由 internal/db 迁移补丁幂等清理)。
//
// 注意:物料档案只描述"这个物料是什么、怎么管",不承载生命周期状态。
type Material struct {
ent.Schema
}
func (Material) Annotations() []schema.Annotation {
return []schema.Annotation{entsql.Table("materials"), entsql.WithComments(true), schema.Comment("Material 物料档案(主数据)")}
}
func (Material) Fields() []ent.Field {
return []ent.Field{
field.String("code").Unique().Comment("物料唯一编码"),
field.String("name").Comment("物料真实名称"),
// 「简称」字段已按 2026-09-19 用户裁决整体删除(新增/编辑表单不再出现)。
// 字段级必填口径:图号 code / 名称 name / 规格 spec / 单位 unit / 物料类别 item_type /
// 类型 manage_mode / 安全库存 safety_stock 均必填;仅「说明」description 可空。
// 必填在 handler 层校验(DB 列保持可空,避免存量行 NULL 扫描失败)。
field.String("spec").Optional().Comment("规格型号"),
field.String("unit").Optional().Comment("单位"),
field.String("description").Optional().Comment("描述"),
// 物料类别(独立于类型的维度):1=原材料 3=成品(在制品不是物料类别,由库存承载)
field.Int("item_type").Default(1).Comment("物料类别 1原材料/3成品(在制品不是物料类别,由库存 category=2 承载)"),
// 类型(分类,入库「结构件/电气件/其他」三页签同源,仅用于分类统计/筛选/页签归属):
// 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("序列号 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 即图号,界面统一显示「图号」,
// 不再保留独立 drawing_no 字段(避免两个「图号」并存造成混乱)。
// 安全库存:低于该值触发缺货预警(客户诉求 问题记录 L473:安全库存/缺货预警进 WMS 首页)
field.Int("safety_stock").Default(0).Comment("安全库存(低于则缺货预警,0=不预警)"),
// 启用状态:停用后不在新建工单/备料下拉出现(对齐 MES 产品型号 isActive)
field.Bool("is_active").Default(true).Comment("是否启用"),
// WMS→MES 推送失败标记(C4 反向,对齐 MES material.sync_pending):
// 推送 MES 本地副本失败时置 true 并写 event_log;成功或手动重推成功后清位。
// 仅作失败状态标识,不参与业务逻辑判定(质量门禁等仍以合格状态为准)。
field.Bool("sync_pending").Default(false).Comment("WMS→MES 推送失败标记(手动重推清位)"),
// 物料编码(问题12):普通档案字段,列名统一「物料编码」,不参与业务/必填校验,也不参与编码唯一约束。
field.String("material_code").Optional().MaxLen(128).Comment("物料编码(普通字段,不参与业务)"),
field.Int64("created_at").DefaultFunc(nowUnix).Comment("创建时间"),
field.Int64("updated_at").DefaultFunc(nowUnix).Comment("更新时间"),
}
}
func (Material) Indexes() []ent.Index {
return []ent.Index{
index.Fields("name"),
index.Fields("template_code"),
index.Fields("item_type"),
}
}