Files
bj_power/bj_power_wms/schema/material.go
T
SunYF 619fc8983d feat: 全端体验与稳定性整改(帮助文档清理/收集式报错/操作列统一/托盘与WS通知/物料同步重推)
- 移除 bj_power_dashboard 旧 React 大屏源码(迁移至 2D SVG 方案)
- MES/WMS/工位终端前端:清理 help.js 与 PageHelp 帮助文档,统一操作列与布局,接入请求拦截器
- 新增收集式校验错误弹窗(ErrorListDialog 统一拦截 3015,逐条列现象+建议)
- 新增托盘程序(tray)与 WebSocket(ws) 实时通知模块(三端共用)
- MES/WMS 物料档案新增同步状态字段,补齐双向失败重推与默认角色 seed
- 工单/产能/产品工艺/日排产逻辑调整;拧紧枪按工位配置
- 新增迁移 SQL:扭矩按工位、sysconfig 序列修复
- 更新 技术约束/案例/部署手册/项目说明 等文档
2026-11-10 23:42:50 +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"),
}
}