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
+19 -19
View File
@@ -11,22 +11,22 @@ import (
"bj_power_wms/internal/svc"
)
// 库存物料类别(与 schema/inventory.go 保持一致):1=原材料 2=半成品 3=成品
// 库存物料类别(与 schema/inventory.go 保持一致):1=原材料 2=在制品 3=成品
const (
invCatRaw = 1
invCatSemi = 2
invCatFinished = 3
)
// 半成品 / 台账 相关(盘点见 stocktake.go)
// 在制品 / 台账 相关(盘点见 stocktake.go)
//
// 【统一库存主表收编 2026-09-07】半成品不再写独立 semi_finisheds 表,
// 全部落 inventories(sn_mode=1 序列号=是SN单件, category=2 半成品)。
// 【统一库存主表收编 2026-09-07】在制品不再写独立 semi_finisheds 表,
// 全部落 inventories(sn_mode=1 序列号=是SN单件, category=2 在制品)。
// 三个 semi 接口签名与响应结构保持不变,MES / 前端零改造平滑切换。
// semiInboundHandler 半成品/成品入库(携带「已完成至工位」展示快照)
// semiInboundHandler 在制品/成品入库(携带「已完成至工位」展示快照)
// 与 MES 闭环:MES 工位报工暂存退库 / 完工回流时调用本接口,把 SN 入 WMS 库
// (inventories,category=2 半成品 / 3 成品,客户诉求 问题记录 L222 半成品与成品要区分)。
// (inventories,category=2 在制品 / 3 成品,客户诉求 问题记录 L222 在制品与成品要区分)。
// 成品入库 9 字段(L218):SN/图号/归属/产品状态/相关标准/试验记录单号/记录员/记录日期/工单号。
// 契约(2026-09-22 定稿):废除 completedProcess/doneProcessCodes 字段,改为 completedText
// ——人类可读展示快照(如"已完成至工位5",空=未报工)。WMS 只原样存入
@@ -42,7 +42,7 @@ func semiInboundHandler(ctx *svc.ServiceContext) http.HandlerFunc {
OrderNo string `json:"orderNo"`
ProductWorkNo string `json:"productWorkNo"` // 产品工号(A1 五页带出;MES 回流可顺带传)
Operator string `json:"operator"`
Category int `json:"category"` // 2=半成品 3=成品(默认 2)
Category int `json:"category"` // 2=在制品 3=成品(默认 2)
OwnershipType string `json:"ownershipType"`
OwnershipNo string `json:"ownershipNo"`
ProductStatus string `json:"productStatus"` // 已通过/部分通过/返修(成品用)
@@ -63,7 +63,7 @@ func semiInboundHandler(ctx *svc.ServiceContext) http.HandlerFunc {
if category != invCatFinished {
category = invCatSemi
}
catLabel := "半成品"
catLabel := "在制品"
if category == invCatFinished {
catLabel = "成品"
}
@@ -95,9 +95,9 @@ func semiInboundHandler(ctx *svc.ServiceContext) http.HandlerFunc {
}
}
// A2 半成品入库归属:请求体已带 ownershipType(workorder=合同号/project=科技项目号/other=其他)
// A2 在制品入库归属:请求体已带 ownershipType(workorder=合同号/project=科技项目号/other=其他)
// 时以请求体为准,ownershipNo 同样保留原值,不再按 contractNo 强制覆盖
// (2026-09-30:科技项目号半成品回流不再被误标为「合同号」)。
// (2026-09-30:科技项目号在制品回流不再被误标为「合同号」)。
// 兜底:ownershipType 为空且填了工单号时,沿用原推断——按工单带出合同号作为归属。
if req.OwnershipType == "" && req.OrderNo != "" && ctx.Mes != nil {
if wo, e := ctx.Mes.GetWorkOrder(ctx0(), req.OrderNo); e == nil && wo != nil && wo.ContractNo != "" {
@@ -142,7 +142,7 @@ func semiInboundHandler(ctx *svc.ServiceContext) http.HandlerFunc {
}
// workOrderContractHandler GET /api/workorder/contract?orderNo=
// 供前端半成品入库表单只读带出归属(A2 半成品入库继承产线工单):凭工单号解析合同号/工程编号。
// 供前端在制品入库表单只读带出归属(A2 在制品入库继承产线工单):凭工单号解析合同号/工程编号。
func workOrderContractHandler(ctx *svc.ServiceContext) http.HandlerFunc {
return func(w http.ResponseWriter, r *http.Request) {
orderNo := r.URL.Query().Get("orderNo")
@@ -198,7 +198,7 @@ func workOrderExistsHandler(ctx *svc.ServiceContext) http.HandlerFunc {
}
}
// semiOutboundHandler 半成品/成品出库(重上线/发货等):更新 inventories 状态
// semiOutboundHandler 在制品/成品出库(重上线/发货等):更新 inventories 状态
// 客户诉求 L224:出库原因必选(包装/继续生产/检验试验/其他),写入 outbound_reason 留痕。
func semiOutboundHandler(ctx *svc.ServiceContext) http.HandlerFunc {
return func(w http.ResponseWriter, r *http.Request) {
@@ -207,7 +207,7 @@ func semiOutboundHandler(ctx *svc.ServiceContext) http.HandlerFunc {
ZoneCode string `json:"zoneCode"`
Operator string `json:"operator"`
Reason string `json:"reason"` // 出库原因:包装/继续生产/检验试验/其他
Category int `json:"category"` // 2=半成品 3=成品(默认 2)
Category int `json:"category"` // 2=在制品 3=成品(默认 2)
}
if err := parseJSON(r, &req); err != nil {
fail(w, http.StatusBadRequest, "参数错误")
@@ -225,7 +225,7 @@ func semiOutboundHandler(ctx *svc.ServiceContext) http.HandlerFunc {
if category != invCatFinished {
category = invCatSemi
}
catLabel := "半成品"
catLabel := "在制品"
if category == invCatFinished {
catLabel = "成品"
}
@@ -241,7 +241,7 @@ func semiOutboundHandler(ctx *svc.ServiceContext) http.HandlerFunc {
fail(w, http.StatusConflict, catLabel+"不在库: "+rec.Status)
return
}
// 盘点冻结守卫(问题2):盘点期间库存量冻结,禁止半成品/成品出库。
// 盘点冻结守卫(问题2):盘点期间库存量冻结,禁止在制品/成品出库。
if rec.StocktakeNo != "" {
fail(w, http.StatusConflict, catLabel+" "+req.Sn+" 正在盘点单 "+rec.StocktakeNo+" 中冻结,盘点期间禁止出库")
return
@@ -259,13 +259,13 @@ func semiOutboundHandler(ctx *svc.ServiceContext) http.HandlerFunc {
}
}
// semiView 把统一库存行映射为半成品/成品视图(保持原 /api/semi/query 响应结构,前端零改造)
// semiView 把统一库存行映射为在制品/成品视图(保持原 /api/semi/query 响应结构,前端零改造)
type semiViewRow struct {
ID int `json:"id"`
Sn string `json:"sn"`
MaterialCode string `json:"materialCode"`
MaterialName string `json:"materialName"`
Category int `json:"category"` // 2=半成品 3=成品
Category int `json:"category"` // 2=在制品 3=成品
CompletedProcess string `json:"completedProcess"`
Quantity int `json:"quantity"`
ZoneCode string `json:"zoneCode"`
@@ -312,8 +312,8 @@ func semiView(inv *ent.Inventory) *semiViewRow {
}
}
// querySemiHandler 半成品查询(读统一库存主表 category=2 半成品)。
// 半成品管理页只处理半成品;成品由 MES 完工回流入库、经 WMS 完工检验,在「库存查询」页按物料类别查看,不在本页手工出入库。
// querySemiHandler 在制品查询(读统一库存主表 category=2 在制品)。
// 在制品管理页只处理在制品;成品由 MES 完工回流入库、经 WMS 完工检验,在「库存查询」页按物料类别查看,不在本页手工出入库。
func querySemiHandler(ctx *svc.ServiceContext) http.HandlerFunc {
return func(w http.ResponseWriter, r *http.Request) {
page := atoi(r.URL.Query().Get("page"), 1)