feat: 移除工位模板、AGV 链路增强与产品BOM/混产模板完善

- 移除工位模板体系(handler/logic 全删),同步路由与 seed
- AGV 链路增强:点位锁、车辆状态、退料派车调整,新增海康 RCS Postman 调试集合
- MES 产品BOM/混产模板完善:新增 ProductBOMDialog 组件,调整 handler/logic;日排产达成对比调整
- WMS 业务完善:出入库、检验、备料、退料、成品入库、缺料代报等 handler 与前端页面调整
- 前端通用:双端新增 RemotePageSelect 组件,统一 nextStep 规则/帮助文档/布局/请求拦截
- 文档:更新产线API/案例/部署手册/问题记录等
This commit is contained in:
SunYF
2026-11-18 09:53:42 +08:00
parent 5c9a7e32d2
commit f8482b18f6
122 changed files with 3381 additions and 2004 deletions
+7 -7
View File
@@ -277,14 +277,14 @@ type importErr struct {
// excelInboundHandler Excel 批量导入入库
// mode=batch(序列号=否) 列头(首行忽略):
//
// 图号 | 数量 | 生产日期 | 供应商 | 区域 | 架 | 层 | 位 | 备注 | 检测单号 | 产品工号 | 归属类型 | 归属编号
// 图号 | 数量 | 生产日期 | 供应商 | 区域 | 架 | 层 | 位 | 备注 | 检测单号 | 工单号 | 归属类型 | 归属编号
//
// 批次号不再出现在模板中(2026-10-21 批次号收口):一律由系统自动生成(物料编码-日期-流水号)。
// mode=sn(序列号=是) 列头(首行忽略):
//
// 图号 | SN | 区域 | 生产日期 | 供应商 | 架 | 层 | 位 | 备注 | 检测单号 | 产品工号 | 归属类型 | 归属编号
// 图号 | SN | 区域 | 生产日期 | 供应商 | 架 | 层 | 位 | 备注 | 检测单号 | 工单号 | 归属类型 | 归属编号
//
// 新增列(架/层/位/备注/检测单号/产品工号/归属) 均为【可选、追加在末尾】,老模板文件缺这些列仍可导入(对应字段留空)。
// 新增列(架/层/位/备注/检测单号/工单号/归属) 均为【可选、追加在末尾】,老模板文件缺这些列仍可导入(对应字段留空)。
// 归属类型填 workorder/project/other(其他值按 other 处理);workorder/project 必须同时填归属编号,other 可不填。
//
// 强约束:全成功或全失败(一次性全导入 or 全失败,禁止部分成功)。
@@ -299,14 +299,14 @@ func excelInboundImportTemplateHandler(ctx *svc.ServiceContext) http.HandlerFunc
var headers []string
var rows [][]any
if mode == "sn" {
headers = []string{"图号", "序列号", "区域", "生产日期", "供应商", "架", "层", "位", "备注", "检测单号", "产品工号", "归属类型", "归属编号"}
headers = []string{"图号", "序列号", "区域", "生产日期", "供应商", "架", "层", "位", "备注", "检测单号", "工单号", "归属类型", "归属编号"}
rows = [][]any{
{"DX100-001", "SN0001", "A区", "2026-10-21", "示例供应商", "1", "1", "1", "示例备注", "Jian001", "WO-20261021-001", "workorder", "HT-001"},
}
sendExcel(w, "入库序列号导入模板.xlsx", headers, rows)
return
}
headers = []string{"图号", "数量", "生产日期", "供应商", "区域", "架", "层", "位", "备注", "检测单号", "产品工号", "归属类型", "归属编号"}
headers = []string{"图号", "数量", "生产日期", "供应商", "区域", "架", "层", "位", "备注", "检测单号", "工单号", "归属类型", "归属编号"}
rows = [][]any{
{"DX100-001", "100", "2026-10-21", "示例供应商", "A区", "1", "1", "1", "示例备注", "Jian001", "WO-20261021-001", "workorder", "HT-001"},
}
@@ -533,7 +533,7 @@ func parseInboundImportPlan(ctx *svc.ServiceContext, rows [][]string, mode strin
pr := inboundImportPlan{row: i + 1}
pr.code = cell(0)
if mode == "sn" {
// 图号|SN|区域|生产日期|供应商|架|层|位|备注|检测单号|产品工号|归属类型|归属编号
// 图号|SN|区域|生产日期|供应商|架|层|位|备注|检测单号|工单号|归属类型|归属编号
pr.sn = cell(1)
pr.zone = cell(2)
pr.prodDate = cell(3)
@@ -547,7 +547,7 @@ func parseInboundImportPlan(ctx *svc.ServiceContext, rows [][]string, mode strin
pr.ownershipType = cell(11)
pr.ownershipNo = cell(12)
} else {
// 图号|数量|生产日期|供应商|区域|架|层|位|备注|检测单号|产品工号|归属类型|归属编号(批次号由系统自动生成,模板不再含该列)
// 图号|数量|生产日期|供应商|区域|架|层|位|备注|检测单号|工单号|归属类型|归属编号(批次号由系统自动生成,模板不再含该列)
pr.qty = atoi(cell(1), 0)
pr.prodDate = cell(2)
pr.supplier = cell(3)
@@ -151,7 +151,7 @@ func isUniqueViolation(err error) bool {
strings.Contains(msg, "violates unique constraint")
}
// finishedLookupHandler GET /api/finished/lookup?sn= —— 前端扫码后立即调用,反查 MES 工单与成品档案。
// finishedLookupHandler GET /api/finished/lookup?sn= —— 前端扫码后立即调用,反查 MES 工单与产品档案。
// 只读、不改库;MES 不可达回 502,SN 查不到回 404,前端据此禁用「提交成品入库」。
func finishedLookupHandler(ctx *svc.ServiceContext) http.HandlerFunc {
return func(w http.ResponseWriter, r *http.Request) {
@@ -185,7 +185,7 @@ func finishedLookupHandler(ctx *svc.ServiceContext) http.HandlerFunc {
// ① 扫 SN 反查 MES;MES 不可达 / SN 查不到 → 硬拒入库(502/404)。
// ② 图号/产品名称/工单/产品状态一律由 MES 透传,服务端强制覆写,禁止库管手选或前端伪造。
// ③ 记录员锁死,后端按 JWT 的 X-UserID + X-Username 写入 recorded_by_id / recorded_by。
// 【红线】本拦截只放在这个成品专用 handler 内:绝不挂全局中间件、绝不改 createFinishedInventory
// 【红线】本拦截只放在这个产品专用 handler 内:绝不挂全局中间件、绝不改 createFinishedInventory
// (MES 完工检自动回流共用)、绝不改 /api/inbound/* 物料入库链——物料入库不调用 MES,宕机完全不受影响。
func manualFinishedInboundHandler(ctx *svc.ServiceContext) http.HandlerFunc {
return func(w http.ResponseWriter, r *http.Request) {
@@ -216,7 +216,7 @@ func manualFinishedInboundHandler(ctx *svc.ServiceContext) http.HandlerFunc {
return
}
if strings.TrimSpace(lookup.ProductCode) == "" {
fail(w, http.StatusBadRequest, "MES 未返回成品编码,禁止成品入库")
fail(w, http.StatusBadRequest, "MES 未返回产品编码,禁止成品入库")
return
}
// ② 服务端强制覆写:忽略前端传入的 productCode/productName/orderNo/productStatus
+1 -1
View File
@@ -174,7 +174,7 @@ func createInboundHandler(ctx *svc.ServiceContext) http.HandlerFunc {
InspectionNo string `json:"inspectionNo"`
OwnershipType string `json:"ownershipType"` // workorder/project/other/none
OwnershipNo string `json:"ownershipNo"`
ProductWorkNo string `json:"productWorkNo"` // 产品工号(归属下手填二级编号)
ProductWorkNo string `json:"productWorkNo"` // 工单号(归属下手填二级编号)
}
if err := parseJSON(r, &req); err != nil {
fail(w, http.StatusBadRequest, "参数错误: "+err.Error())
+22 -1
View File
@@ -116,7 +116,7 @@ func batchFlipInspectionHandler(ctx *svc.ServiceContext) http.HandlerFunc {
inspNo string
batchSeq int // 第几批(序列号=否必填≥1;序列号=是恒 0=未填)
batchTotal int // 共几件(序列号=否必填≥1;序列号=是恒 0=未填)
pw string // 产品工号:从源库存(入库单)带出,五页带出展示/筛选
pw string // 工单号:从源库存(入库单)带出,五页带出展示/筛选
}
items := make([]item, 0, len(req.Items))
codes := make([]string, 0, len(req.Items))
@@ -730,10 +730,31 @@ func disposeInspectionHandler(ctx *svc.ServiceContext) http.HandlerFunc {
switch dt {
case "RETURN":
// 2026-11-17 拍板:检验页「处置」与库存查询页「处置」统一扣减口径——
// 退货不再只翻「待退」状态,而是自动生成退供应商出库单并真实扣减库存,
// 与 inventoryDisposeHandler RETURN 分支走同一个 createSupplierReturnOutbound,
// 保证无论从检验页还是库存页发起退货,批次/SN 明细与汇总账都一致。
// 守卫:合格行不在检验页直接退(避免误扣合格库存);已待退/已出库拒绝重复退货。
if inv.QualityStatus == "合格" {
fail(w, http.StatusBadRequest, "该库存行已是合格状态,不能在检验页直接退货;请到「库存管理 → 库存查询 → 批次/序列号明细」按实际库存处置")
return
}
if inv.Status == "出库" || inv.QualityStatus == "待退" {
fail(w, http.StatusConflict, "该物料已处置或已出库,请勿重复退货")
return
}
if _, err = tx.Inventory.UpdateOneID(inv.ID).SetQualityStatus("待退").Save(ctx0()); err != nil {
fail(w, http.StatusInternalServerError, "更新库存状态失败: "+err.Error())
return
}
operator := r.Header.Get("X-Username")
if operator == "" {
operator = req.Operator
}
if _, err = createSupplierReturnOutbound(ctx, tx, inv, req.DisposalRemark, operator); err != nil {
fail(w, http.StatusInternalServerError, "自动退供应商出库失败: "+err.Error())
return
}
case "REWORK":
// 换修/返修:隔离为不合格,备注标返修,等待返修后重新报检(不上线、不发货)
if _, err = tx.Inventory.UpdateOneID(inv.ID).SetQualityStatus("不合格").Save(ctx0()); err != nil {
+1 -1
View File
@@ -536,7 +536,7 @@ type finishedInboundRequest struct {
// 归属三字段(照 semiInboundHandler 口径)
OwnershipType string `json:"ownershipType"` // workorder=合同号 / project=科技项目号 / other=其他
OwnershipNo string `json:"ownershipNo"` // 归属编号
ProductWorkNo string `json:"productWorkNo"` // 产品工号
ProductWorkNo string `json:"productWorkNo"` // 工单号
// 成品质量档案(客户问题记录 L218 九字段)
ProductStatus string `json:"productStatus"` // 已通过/部分通过/返修
RelatedStandard string `json:"relatedStandard"` // 相关标准(试验方案号)
+1 -1
View File
@@ -109,7 +109,7 @@ func validateMaterialRequired(name, spec, unit string, itemType, manageMode, snM
return "单位为必填项"
case itemType == invCatSemi:
// 2026-09-22 定稿:在制品是工件状态(由库存 category=2 承载),不再是物料类别
return "在制品不再是物料类别,请选择成品档案并在库存中记录工序状态"
return "在制品不再是物料类别,请选择产品档案并在库存中记录工序状态"
case itemType != invCatRaw && itemType != invCatFinished:
return "物料类别为必填项(原材料 / 成品)"
case manageMode != 1 && manageMode != 2 && manageMode != invManageOther:
+2 -2
View File
@@ -40,7 +40,7 @@ func semiInboundHandler(ctx *svc.ServiceContext) http.HandlerFunc {
CompletedText string `json:"completedText"` // 已完成至工位(展示快照,空=未报工)
ZoneCode string `json:"zoneCode"`
OrderNo string `json:"orderNo"`
ProductWorkNo string `json:"productWorkNo"` // 产品工号(A1 五页带出;MES 回流可顺带传)
ProductWorkNo string `json:"productWorkNo"` // 工单号(A1 五页带出;MES 回流可顺带传)
Operator string `json:"operator"`
Category int `json:"category"` // 2=在制品 3=成品(默认 2)
OwnershipType string `json:"ownershipType"`
@@ -172,7 +172,7 @@ func workOrderContractHandler(ctx *svc.ServiceContext) http.HandlerFunc {
}
// workOrderExistsHandler GET /api/workorder/exists?orderNo=
// 入库「产品工号」软校验(B1):只判工单是否存在(不要求有合同号)。
// 入库「工单号」软校验(B1):只判工单是否存在(不要求有合同号)。
// 红字提示由前端出、不阻断保存;404=查不到,5xx=MES 不可达。
func workOrderExistsHandler(ctx *svc.ServiceContext) http.HandlerFunc {
return func(w http.ResponseWriter, r *http.Request) {
+4 -4
View File
@@ -253,7 +253,7 @@ func makeOutboundHandler(ctx *svc.ServiceContext, outboundType string) http.Hand
}
}()
pw := "" // 产品工号:从源库存取,出库单创建后回填(五页带出)
pw := "" // 工单号:从源库存取,出库单创建后回填(五页带出)
obCreate := tx.OutboundOrder.Create().
SetOutboundNo(outboundNo).
SetOutboundType(outboundType).
@@ -327,7 +327,7 @@ func makeOutboundHandler(ctx *svc.ServiceContext, outboundType string) http.Hand
fail(w, http.StatusBadRequest, "批次不存在: "+req.BatchNo)
return
}
pw = b.ProductWorkNo // 取源库存产品工号,回填出库单
pw = b.ProductWorkNo // 取源库存工单号,回填出库单
// 质量门禁(U5,客户口径):发货/样品/其他类出库仅允许「合格」品流向下游;
// 退货/报废/退料类豁免(本身即处置不合格品)。
if outboundBlocksUnqualified(req.OutboundCategory) && !qualityShippable(b.QualityStatus) {
@@ -428,10 +428,10 @@ func makeOutboundHandler(ctx *svc.ServiceContext, outboundType string) http.Hand
return
}
// 回填产品工号(从源库存取,五页带出展示/筛选)
// 回填工单号(从源库存取,五页带出展示/筛选)
if pw != "" {
if _, e := tx.OutboundOrder.UpdateOneID(ob.ID).SetNillableProductWorkNo(strPtr(pw)).Save(ctx0()); e != nil {
fail(w, http.StatusInternalServerError, "回填产品工号失败: "+e.Error())
fail(w, http.StatusInternalServerError, "回填工单号失败: "+e.Error())
return
}
}
+2 -2
View File
@@ -8,12 +8,12 @@ import (
"bj_power_wms/internal/svc"
)
// 成品档案(产品型号 item_type=3)内部接口 —— 导出。
// 产品档案(产品型号 item_type=3)内部接口 —— 导出。
// 两库对等落地后(需求一 M3/M6,2026-09-29):MES 型号维护与查询已全部读 MES 本地 materials 副本,
// 原列表/新增/编辑/删除内部接口随调用方消亡一并移除;本文件仅保留导出(MES 型号导出走 WMS 统一 xlsx 规则)。
// MES 侧推 WMS 统一走 /api/internal/materials/upsert(见 material.go)。
// productTypeQuery 成品档案查询基(item_type=3)
// productTypeQuery 产品档案查询基(item_type=3)
func productTypeQuery(ctx *svc.ServiceContext) *ent.MaterialQuery {
return ctx.EntClient.Material.Query().Where(material.ItemTypeEQ(3))
}
+1 -1
View File
@@ -46,7 +46,7 @@ var seedPermissions = []seedPerm{
{"wms.finished:edit", "成品入库", "MENU", "/finished-inbound", "Box", 72, ""},
{"return:view", "退库单收货", "MENU", "/return-order", "RefreshLeft", 85, ""},
{"prodreturn:manage", "不良品退库", "MENU", "/production-return", "WarningFilled", 87, ""},
{"zone:view", "仓库结构", "MENU", "/zone", "Location", 90, ""},
{"zone:view", "仓库管理", "MENU", "/zone", "Location", 90, ""},
{"material:view", "物料档案", "MENU", "/material", "Goods", 100, ""},
{"user:manage", "账号管理", "MENU", "/users", "EditPen", 110, ""},
{"role:manage", "角色管理", "MENU", "/roles", "Key", 120, ""},
+1 -1
View File
@@ -234,7 +234,7 @@ func RegisterHandlers(server *rest.Server, ctx *svc.ServiceContext) {
{Method: http.MethodGet, Path: "/api/semi/query", Handler: querySemiHandler(ctx)},
// A2 在制品入库继承产线工单:前端凭工单号只读带出合同号(归属)
{Method: http.MethodGet, Path: "/api/workorder/contract", Handler: workOrderContractHandler(ctx)},
// B1 入库产品工号软校验:只判工单存在(不要求有合同号),红字不阻断
// B1 入库工单号软校验:只判工单存在(不要求有合同号),红字不阻断
{Method: http.MethodGet, Path: "/api/workorder/exists", Handler: workOrderExistsHandler(ctx)},
},
)
@@ -9,7 +9,7 @@ import (
// shortageOnBehalfHandler POST /api/shortage/on-behalf 库管代工位提交补料申请。
// 只转发 MES 生成「待主管在 MES 补料审批处理」的补料单:WMS 不审批、不调增叫料池额度。
// 产品工号不作为独立字段发往 MES(shortage_requests 无此列),附在补料原因里带过去。
// 工单号不作为独立字段发往 MES(shortage_requests 无此列),附在补料原因里带过去。
func shortageOnBehalfHandler(ctx *svc.ServiceContext) http.HandlerFunc {
return func(w http.ResponseWriter, r *http.Request) {
if ctx.Mes == nil {
@@ -33,7 +33,7 @@ func shortageOnBehalfHandler(ctx *svc.ServiceContext) http.HandlerFunc {
}
reason := strings.TrimSpace(req.Reason)
if strings.TrimSpace(req.ProductWorkNo) != "" {
reason = "产品工号[" + strings.TrimSpace(req.ProductWorkNo) + "] " + reason
reason = "工单号[" + strings.TrimSpace(req.ProductWorkNo) + "] " + reason
}
op := req.Operator
if op == "" {