feat: 核心业务实体扩充(混产模板/产品BOM/试制记录)、WMS 库存检验增强与前端通用能力

- MES 新增实体:混产模板、产品BOM、产品工艺物料、试制记录(schema + ent 生成码 + logic/handler/前端页)
- WMS 实体增强:检验记录、库存、半成品重构;新增序列号库存与短缺代报
- AGV 与产能:AGV 手动点位与链路、物料守卫、短缺预测、原因字典
- 前端通用能力:新增下一步引导组件 NextStepBar,统一帮助文档/布局/请求拦截与操作列
- 工位终端:界面与各 handler 调整(api/store/绑定/PLC/拧紧/上报等)
- 配置与文档:更新 mes-api.yaml、WMS README 及案例/产线API/问题记录/项目说明/流程说明
This commit is contained in:
SunYF
2026-11-15 12:17:39 +08:00
parent 7e8066ab66
commit 1e92b2a596
221 changed files with 26421 additions and 2230 deletions
+1 -1
View File
@@ -37,7 +37,7 @@ func (Material) Fields() []ent.Field {
field.String("spec").Default("").MaxLen(128).Comment("规格型号"),
field.String("unit").Default("").MaxLen(32).Comment("计量单位"),
field.String("description").Default("").MaxLen(255).Comment("说明"),
field.Int("itemType").Default(1).Comment("物料类别 1原材料/3成品(半成品不是物料类别,「其他」已移除)"),
field.Int("itemType").Default(1).Comment("物料类别 1原材料/3成品(在制品不是物料类别,「其他」已移除)"),
field.Int("manageMode").Default(1).Comment("类型 1结构件/2电气件/3其他(仅分类,不决定SN行为)"),
field.Int("snMode").Default(0).Comment("是否逐件SN管理 0未选择(必填)/1序列号=是(录SN)/2序列号=否(不录SN)"),
field.String("templateCode").Default("").MaxLen(64).Comment("模板编码"),
@@ -0,0 +1,42 @@
package schema
import (
"time"
"entgo.io/ent"
"entgo.io/ent/dialect/entsql"
"entgo.io/ent/schema"
"entgo.io/ent/schema/field"
"entgo.io/ent/schema/index"
)
// MixProductionTemplate 混产模板(2026-11-13 拍板):
// 「生成工位模板」的原始需求是快捷操作 + 支持多工单(多成品)混产,不是换线工具。
// 模板圈定「哪几个成品可以在同一套工位绑定下混线生产」;同模板内产品切换靠扫码防错,
// 不强制停机清线;引入模板外的新产品才触发清线门禁(在制品/余料/托盘/AGV 在途)。
// 工位绑定的是【基础工艺(工序)】,不是成品;成品只在本模板里作为可混产集合出现。
type MixProductionTemplate struct {
ent.Schema
}
func (MixProductionTemplate) Annotations() []schema.Annotation {
return []schema.Annotation{
entsql.Annotation{Table: "mix_production_template"}, entsql.WithComments(true),
schema.Comment("MixProductionTemplate 混产模板:可混线生产的成品集合。"),
}
}
func (MixProductionTemplate) Fields() []ent.Field {
return []ent.Field{
field.Int("id").Positive(),
field.String("name").MaxLen(128).Comment("模板名称"),
field.Text("productCodes").Default("").Comment("可混产成品编码集合(逗号分隔)"),
field.String("remark").Default("").MaxLen(255),
field.String("status").Default("ACTIVE").MaxLen(16).Comment("ACTIVE/INACTIVE"),
field.Time("createdAt").Default(time.Now).Immutable(),
}
}
func (MixProductionTemplate) Indexes() []ent.Index {
return []ent.Index{index.Fields("name").Unique()}
}
+49
View File
@@ -0,0 +1,49 @@
package schema
import (
"time"
"entgo.io/ent"
"entgo.io/ent/dialect/entsql"
"entgo.io/ent/schema"
"entgo.io/ent/schema/field"
"entgo.io/ent/schema/index"
)
// ProductBOM 成品 BOM 总账(2026-11-13 拍板「总分制」):
// 挂在【成品】下,一台成品需要哪些物料、各用多少,只在这里维护一次。
// 彻底废除旧的「分总公用」思路——flow_material 不再是可被多个成品随意借用的公共清单,
// 而是由「产品工艺」把本表物料分配到各工序后生成的执行口径(见 ProductProcessMaterial)。
// 总账不直接参与备料计算;下游 10+ 消费方仍读 flow_material,避免一次改全链路。
type ProductBOM struct {
ent.Schema
}
func (ProductBOM) Annotations() []schema.Annotation {
return []schema.Annotation{
entsql.Annotation{Table: "product_bom"}, entsql.WithComments(true),
schema.Comment("ProductBOM 成品BOM总账:某成品整机需要的物料及单台用量(总分制的总账)。"),
}
}
func (ProductBOM) Fields() []ent.Field {
return []ent.Field{
field.Int("id").Positive(),
field.String("productCode").MaxLen(64).Comment("成品编码(成品档案 code,即图号唯一码)"),
field.String("materialCode").MaxLen(64).Comment("物料编码"),
field.String("materialName").Default("").MaxLen(128),
field.String("spec").Default("").MaxLen(128),
field.String("unit").Default("").MaxLen(16),
field.Float("unitQty").Default(0).Comment("单台用量(总账量,必须等于各工序分账量之和)"),
field.Float("lossRate").Default(0).Comment("损耗率%(展示口径,不参与备料计算)"),
field.String("remark").Default("").MaxLen(255),
field.Time("createdAt").Default(time.Now).Immutable(),
}
}
func (ProductBOM) Indexes() []ent.Index {
return []ent.Index{
index.Fields("productCode"),
index.Fields("productCode", "materialCode").Unique(),
}
}
@@ -0,0 +1,48 @@
package schema
import (
"time"
"entgo.io/ent"
"entgo.io/ent/dialect/entsql"
"entgo.io/ent/schema"
"entgo.io/ent/schema/field"
"entgo.io/ent/schema/index"
)
// ProductProcessMaterial 分账(2026-11-13 拍板):产品工艺把成品 BOM 总账的物料
// 拆分分配到【具体工序】上。一道工艺只承担该成品的部分物料,不是全部。
// 同一道基础工艺(flowId)可被不同产品工艺使用,因分账挂在 productProcessId 上,
// 所以「成品A 用工位3 的这套料、成品B 用另一套料」不再冲突(解决旧模型的最大结构冲突)。
// 保存产品工艺时硬校验:Σ分账 = 总账、分账物料必须是总账子集、总账物料必须全部分配完。
type ProductProcessMaterial struct {
ent.Schema
}
func (ProductProcessMaterial) Annotations() []schema.Annotation {
return []schema.Annotation{
entsql.Annotation{Table: "product_process_material"}, entsql.WithComments(true),
schema.Comment("ProductProcessMaterial 分账:产品工艺把成品BOM总账物料分配到各工序。"),
}
}
func (ProductProcessMaterial) Fields() []ent.Field {
return []ent.Field{
field.Int("id").Positive(),
field.Int("productProcessId").Comment("所属产品工艺ID(不是 flowId!分账按产品隔离)"),
field.Int("seq").Default(0).Comment("工序顺序,与 product_process_item.seq 对齐"),
field.Int("flowId").Comment("分配到的基础工艺(工序)ID"),
field.String("materialCode").MaxLen(64).Comment("物料编码(必须存在于该成品总账)"),
field.String("materialName").Default("").MaxLen(128),
field.String("unit").Default("").MaxLen(16),
field.Float("unitQty").Default(0).Comment("该工序分配到的单台用量"),
field.Time("createdAt").Default(time.Now).Immutable(),
}
}
func (ProductProcessMaterial) Indexes() []ent.Index {
return []ent.Index{
index.Fields("productProcessId"),
index.Fields("productProcessId", "flowId", "materialCode").Unique(),
}
}
+2 -2
View File
@@ -10,13 +10,13 @@ import (
"entgo.io/ent/schema/index"
)
// SemiFlow 半成品流转记录:进度快照(完成至工位N),调用 WMS /api/internal/semi/*
// SemiFlow 在制品流转记录:进度快照(完成至工位N),调用 WMS /api/internal/semi/*
type SemiFlow struct {
ent.Schema
}
func (SemiFlow) Annotations() []schema.Annotation {
return []schema.Annotation{entsql.Annotation{Table: "semi_flow"}, entsql.WithComments(true), schema.Comment("SemiFlow 半成品流转记录:进度快照(完成至工位N),调用 WMS /api/internal/semi/*")}
return []schema.Annotation{entsql.Annotation{Table: "semi_flow"}, entsql.WithComments(true), schema.Comment("SemiFlow 在制品流转记录:进度快照(完成至工位N),调用 WMS /api/internal/semi/*")}
}
func (SemiFlow) Fields() []ent.Field {
+28
View File
@@ -0,0 +1,28 @@
package schema
import (
"time"
"entgo.io/ent"
"entgo.io/ent/schema/field"
)
// TrialRecord 生产后试验区登记(2026-11-14 用户拍板新增):
// 扫成品 SN 登记试验结果,默认「合格」;标记「报废 / 返修」时原因必填(≤500 字,
// 前后端双重校验);报废联动 WMS 库存核销(/api/internal/inventory/dispose SCRAP)。
type TrialRecord struct {
ent.Schema
}
func (TrialRecord) Fields() []ent.Field {
return []ent.Field{
field.Int("id").Positive(),
field.String("sn").MaxLen(64).Comment("成品序列号(扫码/手填)"),
field.String("materialCode").Default("").MaxLen(64).Comment("成品编码(图号),由 SN 反查工单带出,用于 WMS 核销定位"),
field.String("orderNo").Default("").MaxLen(64).Comment("所属工单号(由 SN 反查)"),
field.String("result").MaxLen(16).Comment("登记结果:OK=合格 / SCRAP=报废 / REPAIR=返修"),
field.String("reason").Default("").MaxLen(512).Comment("报废/返修原因(OK 为空;≤500 字按字符计)"),
field.String("operator").Default("").MaxLen(64).Comment("登记人"),
field.Time("created_at").Default(time.Now).Immutable().Comment("登记时间"),
}
}
+1 -1
View File
@@ -31,7 +31,7 @@ func (Workpiece) Fields() []ent.Field {
field.Int("atStationNo").Optional().Comment("物理位置:工件当前实际所在工位号(0=未在工位;建档/到达即写,完工/入库清空)"),
// 工件生命周期六态(问题.md 一.1 已定稿,单字段状态驱动):
// NEW(随工单预生成的待上线SN) / ONLINE(已进线未报工) / PROCESSING(在工位报工中)
// / SEMI_STORED(半成品入库,已下线完工但成品工艺未结束) / DONE(完工) / SCRAPPED(报废)
// / SEMI_STORED(在制品入库,已下线完工但成品工艺未结束) / DONE(完工) / SCRAPPED(报废)
// NEW→ONLINE 唯一触发=上线建档(业务定稿·一.6);ONLINE 与 PROCESSING 必须分开(业务定稿·一.1)。
// 六态为完整枚举,REPAIR 已退役(六.6),不再作为合法状态。
field.String("status").Default("NEW").MaxLen(20),