一、MES — 叫料单扩展(schema + 逻辑) material_request 新增字段:packageNo(叫料包号,一次提交=一包)、callDate(叫料日,默认当天)、planBreakdown(jsonb,工单×排产日明细 []CallPlanBreakdown);targetDock 语义降级为"期望接驳台(可空,配送时 WMS 确定实际台)"。 新增 internal/logic/call_plan.go:实时计算「叫料需求明细(工单×排产日×物料)」,派生两类提示(当日剩余未叫 / 跨日量明细),不落库、不拦提交;接驳台空台校验 EnsureStationDocksEmpty、托盘回库 DispatchPalletReturnManual、人工清台 ClearDockLedger、配送单派车 DispatchDeliveryAgv、工位物料明细 StationMaterialDetail。 新增 internal/handler/production/call_pkg.go:8 个 MES 内部端点(X-API-TOKEN 网关),供 WMS 调用——叫料需求明细、按包查单、接驳台状态、托盘回库、人工清台、配送单派车、叫料池原始行、工位物料明细、WMS 代叫料。 internal/handler/production/call.go、internal/logic/call.go、agv.go、qty_report.go、routes_production.go、wmsclient/client.go、db.go 同步接入上述逻辑。 二、WMS — 配送单(新功能,叫料与送料彻底拆开) 新增 schema/delivery_order.go + delivery_order_item.go 及 ent 生成代码:delivery_order(PENDING→DISPATCHED→DONE / CANCELLED,一单=一次托盘配送)、delivery_order_item(配送物料明细快照:工单/工艺/排产日)。 新增 internal/handler/delivery.go + 路由 + DeliveryOrders.vue 页面(仓储作业 → 配送单)。 mesclient/client.go 扩展:MES 叫料单结构补 packageNo/callDate/workOrderNo/planBreakdown,新增 PoolRow/DockPalletState/DeliveryAgvItem/getJSON 等。 CallQueue.vue:按叫料包展示,新增「代叫料」「建配送单」按钮与对话框;出库单回写所属配送单号(outbound_order 加字段);AGV 派送改由配送单驱动。 三、工位终端 — 叫料体验升级 MaterialPanel.vue:新增「本工位物料明细」卡(工艺物料全集×工位账四数,量为 0 也显示);叫料改为「叫料包」模式(默认当天、可勾选分批、可选其他排产日、期望接驳台可空),新增叫料日选择器、两条提示横幅(当日剩余未叫 / 跨日量明细)、托盘回库按钮。 InspectPanel.vue/Main.vue/OnlinePanel.vue/OfflinePanel.vue/WorkPanel.vue/SyncQueueDialog.vue/api/index.js/internal/handler/line.go/routes.go 同步接入接驳台状态、托盘回库、下班双台空台校验等。 web/static/index.html 构建刷新。 四、文档 案例.md:重写第 5/6/8/9 节与新「配送单」流程,补「模拟模式跳过接驳台校验」说明,库管员菜单加「配送单」;并修正"本单箱体"等措辞歧义。 客户问题.md:同步本轮拍板口径。 五、构建产物 / 同步 多个 MES 前端页面(.vue)随本次改动统一重新构建刷新;ent 生成代码(MES material_request、WMS delivery_order/outbound_order 相关)随 schema 更新重新生成。
378 lines
27 KiB
Go
378 lines
27 KiB
Go
package handler
|
||
|
||
import (
|
||
"net/http"
|
||
|
||
"bj_power_wms/internal/svc"
|
||
|
||
"github.com/zeromicro/go-zero/rest"
|
||
)
|
||
|
||
func RegisterHandlers(server *rest.Server, ctx *svc.ServiceContext) {
|
||
server.AddRoutes(
|
||
[]rest.Route{
|
||
{Method: http.MethodGet, Path: "/api/health", Handler: healthHandler(ctx)},
|
||
{Method: http.MethodPost, Path: "/api/auth/login", Handler: loginHandler(ctx)},
|
||
},
|
||
)
|
||
|
||
// 附件静态文件(图纸 PDF / 图片预览):免鉴权,供 <a target=_blank> / 新窗口直接打开
|
||
server.AddRoutes(
|
||
[]rest.Route{
|
||
{Method: http.MethodGet, Path: "/uploads/:name", Handler: serveUploadFileHandler(ctx)},
|
||
},
|
||
)
|
||
|
||
server.Use(authInterceptor(ctx))
|
||
|
||
// 当前登录用户(JWT 鉴权)
|
||
server.AddRoutes(
|
||
[]rest.Route{
|
||
{Method: http.MethodPost, Path: "/api/user/change-password", Handler: changePasswordHandler(ctx)},
|
||
{Method: http.MethodPost, Path: "/api/user/logout", Handler: logoutHandler(ctx)},
|
||
{Method: http.MethodGet, Path: "/api/user/info", Handler: userInfoHandler(ctx)},
|
||
{Method: http.MethodGet, Path: "/api/user/list", Handler: listUsersHandler(ctx)},
|
||
{Method: http.MethodPost, Path: "/api/user/create", Handler: createUserHandler(ctx)},
|
||
{Method: http.MethodPost, Path: "/api/user/update", Handler: updateUserHandler(ctx)},
|
||
{Method: http.MethodPost, Path: "/api/user/delete", Handler: deleteUserHandler(ctx)},
|
||
},
|
||
)
|
||
|
||
// 角色与权限(RBAC 数据化,取代 rbac.go 中的硬编码权限 map)
|
||
server.AddRoutes(
|
||
[]rest.Route{
|
||
{Method: http.MethodPost, Path: "/api/rbac/seed", Handler: seedRbacHandler(ctx)},
|
||
{Method: http.MethodGet, Path: "/api/roles", Handler: listRolesHandler(ctx)},
|
||
{Method: http.MethodGet, Path: "/api/roles/options", Handler: roleOptionsHandler(ctx)},
|
||
{Method: http.MethodPost, Path: "/api/roles", Handler: createRoleHandler(ctx)},
|
||
{Method: http.MethodPost, Path: "/api/roles/update", Handler: updateRoleHandler(ctx)},
|
||
{Method: http.MethodPost, Path: "/api/roles/delete", Handler: deleteRoleHandler(ctx)},
|
||
{Method: http.MethodGet, Path: "/api/permissions", Handler: listPermissionsHandler(ctx)},
|
||
{Method: http.MethodGet, Path: "/api/event/logs", Handler: eventLogListHandler(ctx)},
|
||
},
|
||
)
|
||
|
||
// 物料档案(写操作权限守卫;query/list/detail 供各页下拉拾取器使用,保持登录可访问)
|
||
server.AddRoutes(
|
||
[]rest.Route{
|
||
{Method: http.MethodPost, Path: "/api/material/create", Handler: requirePerm(ctx, "material:create", createMaterialHandler(ctx))},
|
||
{Method: http.MethodPost, Path: "/api/material/update", Handler: requirePerm(ctx, "material:edit", updateMaterialHandler(ctx))},
|
||
{Method: http.MethodGet, Path: "/api/material/query", Handler: queryMaterialsHandler(ctx)},
|
||
{Method: http.MethodGet, Path: "/api/material/list", Handler: listMaterialsHandler(ctx)},
|
||
{Method: http.MethodGet, Path: "/api/material/detail", Handler: getMaterialHandler(ctx)},
|
||
{Method: http.MethodGet, Path: "/api/material/export", Handler: requirePerm(ctx, "material:export", exportMaterialsHandler(ctx))},
|
||
{Method: http.MethodPost, Path: "/api/material/import", Handler: requirePerm(ctx, "material:import", excelMaterialImportHandler(ctx))},
|
||
{Method: http.MethodGet, Path: "/api/material/import-template", Handler: requirePerm(ctx, "material:import", excelMaterialImportTemplateHandler(ctx))},
|
||
{Method: http.MethodPost, Path: "/api/material/toggle-status", Handler: requirePerm(ctx, "material:edit", toggleMaterialStatusHandler(ctx))},
|
||
{Method: http.MethodPost, Path: "/api/material/retry-sync", Handler: requirePerm(ctx, "material:edit", retryMaterialSyncHandler(ctx))},
|
||
},
|
||
)
|
||
|
||
// 入库
|
||
server.AddRoutes(
|
||
[]rest.Route{
|
||
{Method: http.MethodPost, Path: "/api/inbound/create", Handler: createInboundHandler(ctx)},
|
||
{Method: http.MethodGet, Path: "/api/inbound/query", Handler: queryInboundHandler(ctx)},
|
||
{Method: http.MethodGet, Path: "/api/inbound/details", Handler: inboundDetailsHandler(ctx)},
|
||
{Method: http.MethodGet, Path: "/api/inbound/export", Handler: exportInboundHandler(ctx)},
|
||
{Method: http.MethodPost, Path: "/api/inbound/batch-excel", Handler: excelInboundHandler(ctx)},
|
||
{Method: http.MethodGet, Path: "/api/inbound/import-template", Handler: excelInboundImportTemplateHandler(ctx)},
|
||
// 入库库位联动:选物料后回填最近一次入库库位
|
||
{Method: http.MethodGet, Path: "/api/inbound/last-location", Handler: lastInboundLocationHandler(ctx)},
|
||
// 入库作废:填原因 + 回滚库存(结构件按批次、电气件按 SN 精确回滚)
|
||
{Method: http.MethodPost, Path: "/api/inbound/void", Handler: requirePerm(ctx, "inbound:void", voidInboundHandler(ctx))},
|
||
},
|
||
)
|
||
|
||
// 出库(统一主表:备料出库 workorder / 通用出库 general,装箱信息落在同一张表)
|
||
server.AddRoutes(
|
||
[]rest.Route{
|
||
{Method: http.MethodPost, Path: "/api/outbound/general", Handler: makeOutboundHandler(ctx, "general")},
|
||
{Method: http.MethodPost, Path: "/api/outbound/project", Handler: makeOutboundHandler(ctx, "project")},
|
||
{Method: http.MethodGet, Path: "/api/outbound/query", Handler: queryOutboundHandler(ctx)},
|
||
{Method: http.MethodGet, Path: "/api/outbound/export", Handler: exportOutboundHandler(ctx)},
|
||
// 出库库位联动:优先批次在库库位,其次该物料最近一次入库库位(客户诉求 一.9「出库相同」)
|
||
{Method: http.MethodGet, Path: "/api/outbound/location-hint", Handler: outboundLocationHintHandler(ctx)},
|
||
// 出库作废(2026-11-03 断头路补全,对齐入库作废):仅通用/科技项目出库可作废,
|
||
// 填原因+按明细回滚库存;备料/补料/叫料出库不在此列,走退库逆向闭环。
|
||
{Method: http.MethodPost, Path: "/api/outbound/void", Handler: requirePerm(ctx, "outbound:void", voidOutboundHandler(ctx))},
|
||
// 目标工位下拉选项(需求20:来自 MES 工位列表,不允许手输)
|
||
{Method: http.MethodGet, Path: "/api/outbound/stations", Handler: listStationOptionsHandler(ctx)},
|
||
// B5 叫料队列(仓库端):待备料列表 / 完成备料(WMS 扣库存+通知 MES)/ 驳回
|
||
{Method: http.MethodGet, Path: "/api/call/pending", Handler: requirePerm(ctx, "call:view", callPendingHandler(ctx))},
|
||
{Method: http.MethodPost, Path: "/api/call/complete", Handler: requirePerm(ctx, "call:manage", callCompleteHandler(ctx))},
|
||
{Method: http.MethodPost, Path: "/api/call/reject", Handler: requirePerm(ctx, "call:manage", callRejectHandler(ctx))},
|
||
// AGV 三段链装货确认(2026-11-03 三层机制):到位待令 → 库管「确认装车并送货」
|
||
{Method: http.MethodPost, Path: "/api/call/confirm-load", Handler: requirePerm(ctx, "call:manage", ConfirmCallLoadHandler(ctx))},
|
||
// 库管人工派车(2026-11-03 定论:废除备料完成自动派车):点「送货」AGV 才出发
|
||
{Method: http.MethodPost, Path: "/api/call/dispatch", Handler: requirePerm(ctx, "call:manage", DispatchCallHandler(ctx))},
|
||
// 托盘工作台(2026-11-03):接驳台台账列表 + 手动派 AGV 回收空托盘(单点步进、到位待令)
|
||
{Method: http.MethodGet, Path: "/api/pallet/docks", Handler: PalletDocksHandler(ctx)},
|
||
{Method: http.MethodGet, Path: "/api/pallet/station-docks", Handler: StationDocksProxyHandler(ctx)},
|
||
{Method: http.MethodPost, Path: "/api/pallet/dispatch", Handler: requirePerm(ctx, "call:manage", PalletDispatchHandler(ctx))},
|
||
// E4 托盘余料明细(2026-11-04 拍板):代发起退料弹窗自动带出(只读转发 MES)
|
||
{Method: http.MethodGet, Path: "/api/pallet/residual", Handler: palletResidualHandler(ctx)},
|
||
// JBT21 空位查询(2026-11-04 定稿 Q5:无空位派 AGV 回收按钮禁用并提示;只读转发 MES)
|
||
{Method: http.MethodGet, Path: "/api/pallet/jbt21-free", Handler: Jbt21FreeHandler(ctx)},
|
||
// 人工清台(2026-11-05 兜底:托盘被人工卸走后台账卡死;仅清台账不碰账)
|
||
{Method: http.MethodPost, Path: "/api/pallet/clear", Handler: requirePerm(ctx, "call:manage", palletClearHandler(ctx))},
|
||
// 配送单(2026-11-05 拍板:叫料与送料拆开——一包可拆多张配送单,一单=一次托盘配送)
|
||
{Method: http.MethodGet, Path: "/api/delivery/list", Handler: requirePerm(ctx, "call:view", deliveryListHandler(ctx))},
|
||
{Method: http.MethodGet, Path: "/api/delivery/detail", Handler: requirePerm(ctx, "call:view", deliveryDetailHandler(ctx))},
|
||
{Method: http.MethodGet, Path: "/api/delivery/package", Handler: requirePerm(ctx, "call:view", deliveryPackageHandler(ctx))},
|
||
{Method: http.MethodPost, Path: "/api/delivery/create", Handler: requirePerm(ctx, "call:manage", deliveryCreateHandler(ctx))},
|
||
{Method: http.MethodPost, Path: "/api/delivery/cancel", Handler: requirePerm(ctx, "call:manage", deliveryCancelHandler(ctx))},
|
||
{Method: http.MethodPost, Path: "/api/delivery/dispatch", Handler: requirePerm(ctx, "call:manage", deliveryDispatchHandler(ctx))},
|
||
// WMS 代叫料(2026-11-05 拍板:与工位终端同一套叫料包逻辑)
|
||
{Method: http.MethodPost, Path: "/api/call/create", Handler: requirePerm(ctx, "call:manage", callCreateProxyHandler(ctx))},
|
||
{Method: http.MethodGet, Path: "/api/call/pool-raw", Handler: requirePerm(ctx, "call:view", callPoolRawProxyHandler(ctx))},
|
||
},
|
||
)
|
||
|
||
// P1 备料清单(2026-11-04 用户拍板):只读展示"今天及以后×工单×工位×物料×数量",数据源 MES 日排产实时算
|
||
server.AddRoutes(
|
||
[]rest.Route{
|
||
{Method: http.MethodGet, Path: "/api/preparation/list", Handler: requirePerm(ctx, "preparation:view", queryPreparationListHandler(ctx))},
|
||
},
|
||
)
|
||
|
||
// 库存
|
||
server.AddRoutes(
|
||
[]rest.Route{
|
||
{Method: http.MethodGet, Path: "/api/stock/query", Handler: queryStockHandler(ctx)},
|
||
{Method: http.MethodGet, Path: "/api/stock/material-summary", Handler: materialSummaryHandler(ctx)},
|
||
{Method: http.MethodGet, Path: "/api/stock/details", Handler: stockDetailsHandler(ctx)},
|
||
{Method: http.MethodGet, Path: "/api/stock/export", Handler: exportStockHandler(ctx)},
|
||
{Method: http.MethodGet, Path: "/api/stock/zone-summary", Handler: zoneSummaryHandler(ctx)},
|
||
{Method: http.MethodPost, Path: "/api/stock/lock", Handler: lockStockHandler(ctx)},
|
||
{Method: http.MethodPost, Path: "/api/stock/unlock", Handler: unlockStockHandler(ctx)},
|
||
{Method: http.MethodPost, Path: "/api/stock/check", Handler: checkStockHandler(ctx)},
|
||
{Method: http.MethodGet, Path: "/api/stock/shortage", Handler: shortageHandler(ctx)},
|
||
{Method: http.MethodGet, Path: "/api/stock/material-demand", Handler: materialDemandHandler(ctx)},
|
||
},
|
||
)
|
||
|
||
// 检验
|
||
server.AddRoutes(
|
||
[]rest.Route{
|
||
{Method: http.MethodPost, Path: "/api/inspection/batch-flip", Handler: batchFlipInspectionHandler(ctx)},
|
||
{Method: http.MethodPost, Path: "/api/inspection/dispose", Handler: disposeInspectionHandler(ctx)},
|
||
// 在库处置:从在库库存行直接发起不合格处置(JWT 登录即可,与同组检验接口权限一致)
|
||
{Method: http.MethodPost, Path: "/api/inspection/inventory-dispose", Handler: inventoryDisposeHandler(ctx)},
|
||
// 复检(换修闭环):针对「在库 + 不合格」库存行重新判定,闭合换修 / 不合格处置后续
|
||
{Method: http.MethodPost, Path: "/api/inspection/reinspect", Handler: reinspectHandler(ctx)},
|
||
{Method: http.MethodGet, Path: "/api/inspection/query", Handler: queryInspectionHandler(ctx)},
|
||
{Method: http.MethodGet, Path: "/api/inspection/export", Handler: exportInspectionHandler(ctx)},
|
||
{Method: http.MethodGet, Path: "/api/inspection/stats", Handler: statsInspectionHandler(ctx)},
|
||
{Method: http.MethodGet, Path: "/api/inspection/pending", Handler: pendingInspectionHandler(ctx)},
|
||
{Method: http.MethodGet, Path: "/api/inspection/pending/details", Handler: pendingDetailsInspectionHandler(ctx)},
|
||
},
|
||
)
|
||
|
||
// 接驳台主数据已迁 MES(2026-09-21,AGV 配送真源 2026-10-14 迁 MES):
|
||
// 仓库不再维护 dock 表、不再下发/查询 AGV 任务;出库目标工位下拉(/api/outbound/stations) 只读 MES 内部接口。
|
||
// 「AGV配送」页已随 GUI 一并移除,MES 为 AGV 任务与海康 RCS 客户端唯一真源。
|
||
|
||
// 区域(多级父子结构:区域/货架/层/位置号 4 个 Tab)
|
||
server.AddRoutes(
|
||
[]rest.Route{
|
||
{Method: http.MethodGet, Path: "/api/zone/list", Handler: requirePerm(ctx, "zone:view", listZonesHandler(ctx))},
|
||
{Method: http.MethodPost, Path: "/api/zone/node/create", Handler: requirePerm(ctx, "zone:create", createZoneNodeHandler(ctx))},
|
||
{Method: http.MethodPost, Path: "/api/zone/node/update", Handler: requirePerm(ctx, "zone:edit", updateZoneNodeHandler(ctx))},
|
||
{Method: http.MethodPost, Path: "/api/zone/batch-generate", Handler: requirePerm(ctx, "zone:create", batchGenerateHandler(ctx))},
|
||
// 下拉(兼容旧调用 + 层级级联),原样保留无权限包裹
|
||
{Method: http.MethodGet, Path: "/api/zone/picker", Handler: listZonesForPicker(ctx)},
|
||
// 同区空位推荐(入库选物料后无历史库位时自动推荐),无权限包裹
|
||
{Method: http.MethodGet, Path: "/api/zone/vacant", Handler: vacantZoneHandler(ctx)},
|
||
},
|
||
)
|
||
|
||
// 盘点(问题12 权限:发起/扫码/取消需 stocktake:start;查询/导出需 stocktake:view;写回分支在 handler 内再校 stocktake:writeback)
|
||
server.AddRoutes(
|
||
[]rest.Route{
|
||
{Method: http.MethodPost, Path: "/api/stocktake/start", Handler: requirePerm(ctx, "stocktake:start", startStocktakeHandler(ctx))},
|
||
{Method: http.MethodPost, Path: "/api/stocktake/record", Handler: requirePerm(ctx, "stocktake:start", recordStocktakeHandler(ctx))},
|
||
{Method: http.MethodPost, Path: "/api/stocktake/finish", Handler: requirePerm(ctx, "stocktake:start", finishStocktakeHandler(ctx))},
|
||
{Method: http.MethodPost, Path: "/api/stocktake/cancel", Handler: requirePerm(ctx, "stocktake:start", cancelStocktakeHandler(ctx))},
|
||
{Method: http.MethodGet, Path: "/api/stocktake/query", Handler: requirePerm(ctx, "stocktake:view", queryStocktakeHandler(ctx))},
|
||
{Method: http.MethodGet, Path: "/api/stocktake/active", Handler: requirePerm(ctx, "stocktake:view", activeStocktakeHandler(ctx))},
|
||
{Method: http.MethodGet, Path: "/api/stocktake/export", Handler: requirePerm(ctx, "stocktake:view", exportStocktakeHandler(ctx))},
|
||
},
|
||
)
|
||
|
||
// 半成品
|
||
server.AddRoutes(
|
||
[]rest.Route{
|
||
{Method: http.MethodPost, Path: "/api/semi/inbound", Handler: semiInboundHandler(ctx)},
|
||
{Method: http.MethodPost, Path: "/api/semi/outbound", Handler: semiOutboundHandler(ctx)},
|
||
{Method: http.MethodGet, Path: "/api/semi/query", Handler: querySemiHandler(ctx)},
|
||
// A2 半成品入库继承产线工单:前端凭工单号只读带出合同号(归属)
|
||
{Method: http.MethodGet, Path: "/api/workorder/contract", Handler: workOrderContractHandler(ctx)},
|
||
// B1 入库产品工号软校验:只判工单存在(不要求有合同号),红字不阻断
|
||
{Method: http.MethodGet, Path: "/api/workorder/exists", Handler: workOrderExistsHandler(ctx)},
|
||
},
|
||
)
|
||
|
||
// 手工成品入库(方案A:完工检合格才入成品库,与 MES 完工回流内部接口共享创建逻辑)
|
||
server.AddRoutes(
|
||
[]rest.Route{
|
||
{Method: http.MethodPost, Path: "/api/finished/inbound", Handler: requirePerm(ctx, "wms.finished:edit", manualFinishedInboundHandler(ctx))},
|
||
// 今日成品入库记录(只读表:统一库存主表 category=3 当天,登录可查)
|
||
{Method: http.MethodGet, Path: "/api/finished/inbound/today", Handler: finishedInboundTodayHandler(ctx)},
|
||
},
|
||
)
|
||
|
||
// 退库单(工位退料回库房,WMS 库管确认收货后库存加回)
|
||
server.AddRoutes(
|
||
[]rest.Route{
|
||
{Method: http.MethodPost, Path: "/api/return-order/confirm", Handler: confirmReturnOrderHandler(ctx)},
|
||
{Method: http.MethodGet, Path: "/api/return-order/query", Handler: queryReturnOrdersHandler(ctx)},
|
||
{Method: http.MethodGet, Path: "/api/return-order/suggest-location", Handler: suggestReturnLocationHandler(ctx)},
|
||
// 库管代工位退料(2026-11-03 拍板):库管替操作工建退库单(选工位/工单/物料/数量/接驳台)
|
||
{Method: http.MethodPost, Path: "/api/return-order/manual", Handler: createReturnOrderInternalHandler(ctx)},
|
||
// 取消 PENDING 退料单(2026-11-04 拍板:库房可取消工位申请;已收货不可取消;联动作废未完成 AGV 任务)
|
||
{Method: http.MethodPost, Path: "/api/return-order/cancel", Handler: cancelReturnOrderHandler(ctx)},
|
||
// 余量参考值(2026-11-04 定稿:剩余余量=应剩余量−已退余量−已损耗,转发 MES 聚合;仅展示不阻断)
|
||
{Method: http.MethodGet, Path: "/api/return-order/reference", Handler: returnReferenceHandler(ctx)},
|
||
// D1 工单备料台账已于 2026-11-04 按用户拍板移除(台账页/路由/权限一并退役,不再复活)
|
||
},
|
||
)
|
||
|
||
// 生产退不良(产线使用中发现的不良品退回库房隔离,质量异常处置入口)
|
||
server.AddRoutes(
|
||
[]rest.Route{
|
||
{Method: http.MethodPost, Path: "/api/production-return", Handler: requirePerm(ctx, "prodreturn:manage", createProductionReturnHandler(ctx))},
|
||
{Method: http.MethodGet, Path: "/api/production-return/query", Handler: requirePerm(ctx, "prodreturn:manage", queryProductionReturnHandler(ctx))},
|
||
{Method: http.MethodGet, Path: "/api/production-return/export", Handler: requirePerm(ctx, "prodreturn:manage", exportProductionReturnHandler(ctx))},
|
||
},
|
||
)
|
||
|
||
// 工单物料台账(WMS 侧)
|
||
server.AddRoutes(
|
||
[]rest.Route{
|
||
{Method: http.MethodGet, Path: "/api/orders", Handler: ordersHandler(ctx)},
|
||
},
|
||
)
|
||
|
||
// 附件(下沉到各业务页内嵌使用:入库/物料/检验/半成品/出库)
|
||
// 2026-10-28 生命周期重构:附件中心转纯查阅;删除/恢复/彻底清除唯一入口=数据归档页(attachment:manage);
|
||
// 业务面板仅保留上传人本人「移除」误传附件(/remove,handler 内校验本人)。
|
||
server.AddRoutes(
|
||
[]rest.Route{
|
||
{Method: http.MethodPost, Path: "/api/attachments/upload", Handler: uploadAttachmentHandler(ctx)},
|
||
{Method: http.MethodGet, Path: "/api/attachments", Handler: listAttachmentsHandler(ctx)},
|
||
{Method: http.MethodPost, Path: "/api/attachments/remove", Handler: removeAttachmentHandler(ctx)},
|
||
// 删除前提示清楚:预检只读(保护期/引用/备份覆盖情况),登录即可查
|
||
{Method: http.MethodPost, Path: "/api/attachments/delete-precheck", Handler: deletePrecheckHandler(ctx)},
|
||
// 以下为数据归档页清理工作台(attachment:manage)
|
||
{Method: http.MethodPost, Path: "/api/attachments/delete", Handler: requirePerm(ctx, "attachment:manage", deleteAttachmentHandler(ctx))},
|
||
{Method: http.MethodPost, Path: "/api/attachments/restore", Handler: requirePerm(ctx, "attachment:manage", restoreAttachmentHandler(ctx))},
|
||
{Method: http.MethodPost, Path: "/api/attachments/purge", Handler: requirePerm(ctx, "attachment:manage", purgeAttachmentHandler(ctx))},
|
||
{Method: http.MethodGet, Path: "/api/attachments/orphans", Handler: requirePerm(ctx, "attachment:manage", orphanScanHandler(ctx))},
|
||
{Method: http.MethodPost, Path: "/api/attachments/orphans/purge", Handler: requirePerm(ctx, "attachment:manage", orphanPurgeHandler(ctx))},
|
||
// 附件中心(系统管理 → 附件中心)
|
||
{Method: http.MethodGet, Path: "/api/attachments/all", Handler: requirePerm(ctx, "attachment:view", listAllAttachmentsHandler(ctx))},
|
||
{Method: http.MethodGet, Path: "/api/attachments/disk-status", Handler: requirePerm(ctx, "attachment:view", diskStatusHandler(ctx))},
|
||
// 空间清理:批量物理清理已删附件归 attachment:manage
|
||
{Method: http.MethodPost, Path: "/api/attachments/purge-deleted", Handler: requirePerm(ctx, "attachment:manage", purgeDeletedHandler(ctx))},
|
||
},
|
||
)
|
||
|
||
// 大屏展示数据(免登录)
|
||
server.AddRoutes(
|
||
[]rest.Route{
|
||
{Method: http.MethodGet, Path: "/api/display/overview", Handler: internalDisplayHandler(ctx)},
|
||
{Method: http.MethodGet, Path: "/api/display/analytics", Handler: internalDisplayAnalyticsHandler(ctx)},
|
||
{Method: http.MethodGet, Path: "/api/display/calls", Handler: internalDisplayCallsHandler(ctx)},
|
||
{Method: http.MethodGet, Path: "/api/display/config", Handler: displayConfigHandler(ctx)},
|
||
},
|
||
)
|
||
|
||
// 数据归档(系统管理 → 备份到 U 盘 / 腾空间):仅管理员。
|
||
// 备份=流式导出到外部存储并记 backup_record;清理=物理删除(严格覆盖校验,不可逆)。
|
||
server.AddRoutes(
|
||
[]rest.Route{
|
||
{Method: http.MethodGet, Path: "/api/backup/items", Handler: requireAdmin(backupItemsHandler(ctx))},
|
||
{Method: http.MethodPost, Path: "/api/backup/start", Handler: requireAdmin(backupStartHandler(ctx))},
|
||
{Method: http.MethodGet, Path: "/api/backup/progress", Handler: requireAdmin(backupProgressHandler(ctx))},
|
||
{Method: http.MethodPost, Path: "/api/cleanup/check", Handler: requireAdmin(cleanupCheckHandler(ctx))},
|
||
{Method: http.MethodPost, Path: "/api/cleanup/start", Handler: requireAdmin(cleanupStartHandler(ctx))},
|
||
{Method: http.MethodGet, Path: "/api/cleanup/progress", Handler: requireAdmin(cleanupProgressHandler(ctx))},
|
||
// 数据归档增强:目录选择器 / 提醒 / 预览 / 历史
|
||
{Method: http.MethodGet, Path: "/api/backup/drives", Handler: requireAdmin(backupDrivesHandler(ctx))},
|
||
{Method: http.MethodGet, Path: "/api/backup/listdir", Handler: requireAdmin(backupListDirHandler(ctx))},
|
||
{Method: http.MethodGet, Path: "/api/backup/reminder", Handler: requireAdmin(backupReminderHandler(ctx))},
|
||
{Method: http.MethodPost, Path: "/api/cleanup/preview", Handler: requireAdmin(cleanupPreviewHandler(ctx))},
|
||
{Method: http.MethodGet, Path: "/api/backup/records", Handler: requireAdmin(backupRecordsHandler(ctx))},
|
||
},
|
||
)
|
||
|
||
// 预警中心(顶栏铃铛 + 预警列表):JWT 鉴权后注册
|
||
server.AddRoutes(
|
||
[]rest.Route{
|
||
{Method: http.MethodGet, Path: "/api/alerts", Handler: listAlertsHandler(ctx)},
|
||
{Method: http.MethodPost, Path: "/api/alerts/:id/read", Handler: readAlertHandler(ctx)},
|
||
{Method: http.MethodPost, Path: "/api/alerts/read-all", Handler: readAllAlertsHandler(ctx)},
|
||
{Method: http.MethodGet, Path: "/api/alert-rules", Handler: listAlertRulesHandler(ctx)},
|
||
{Method: http.MethodPost, Path: "/api/alert-rules/update", Handler: updateAlertRuleHandler(ctx)},
|
||
},
|
||
)
|
||
|
||
// 系统基础设置(admin-only):保存即生效,无需重启。
|
||
server.AddRoutes(
|
||
[]rest.Route{
|
||
{Method: http.MethodGet, Path: "/api/settings", Handler: requireAdmin(SettingsHandler(ctx))},
|
||
{Method: http.MethodPut, Path: "/api/settings", Handler: requireAdmin(SaveSettingsHandler(ctx))},
|
||
},
|
||
)
|
||
|
||
// 本机只读信息(OS / 主机名 / Go 版本 / 端口 / 启动时间 / 当前生效 MES 地址)。
|
||
// MES 地址可在「基础设置」页修改(保存即生效,2026-11-02);mes-ping 供页面"测试连接"。
|
||
server.AddRoutes(
|
||
[]rest.Route{
|
||
{Method: http.MethodGet, Path: "/api/system/info", Handler: SystemInfoHandler(ctx)},
|
||
{Method: http.MethodGet, Path: "/api/system/mes-ping", Handler: requireAdmin(MesPingHandler(ctx))},
|
||
},
|
||
)
|
||
|
||
// 项目间内部 API(X-API-TOKEN 写死 token 保护)
|
||
// 与 JWT 侧业务接口同实现,仅供 MES(B)/工位终端(D) 等服务间调用
|
||
server.AddRoutes(
|
||
[]rest.Route{
|
||
{Method: http.MethodPost, Path: "/api/internal/stock/check", Handler: wrapInternal(ctx)(checkStockHandler(ctx))},
|
||
{Method: http.MethodPost, Path: "/api/internal/stock/lock", Handler: wrapInternal(ctx)(lockStockHandler(ctx))},
|
||
{Method: http.MethodPost, Path: "/api/internal/stock/unlock", Handler: wrapInternal(ctx)(unlockStockHandler(ctx))},
|
||
{Method: http.MethodGet, Path: "/api/internal/stock/query", Handler: wrapInternal(ctx)(queryStockHandler(ctx))},
|
||
// 可用批次/SN 查询(MES 物料存在性校验等内部调用)
|
||
{Method: http.MethodGet, Path: "/api/internal/stock/batches", Handler: wrapInternal(ctx)(listStockBatchesInternalHandler(ctx))},
|
||
{Method: http.MethodPost, Path: "/api/internal/semi/inbound", Handler: wrapInternal(ctx)(semiInboundHandler(ctx))},
|
||
{Method: http.MethodPost, Path: "/api/internal/semi/outbound", Handler: wrapInternal(ctx)(semiOutboundHandler(ctx))},
|
||
{Method: http.MethodPost, Path: "/api/internal/finished/inbound", Handler: wrapInternal(ctx)(finishedInboundHandler(ctx))},
|
||
// 型号导出(MES 型号维护已本地化 M3/M6,列表/增改删内部接口随调用方消亡移除,仅保留导出)
|
||
{Method: http.MethodGet, Path: "/api/internal/product-types/export", Handler: wrapInternal(ctx)(exportProductTypesInternalHandler(ctx))},
|
||
// 物料两库对等(需求一 M3/M5):MES→WMS 推送落点,按 code 幂等 upsert(删除=停用 isActive=false)
|
||
{Method: http.MethodPost, Path: "/api/internal/materials/upsert", Handler: wrapInternal(ctx)(upsertMaterialInternalHandler(ctx))},
|
||
{Method: http.MethodPost, Path: "/api/internal/material/exists", Handler: wrapInternal(ctx)(materialExistsHandler(ctx))},
|
||
// 看板物料追溯入口复用:物料档案 + 库存查询(按编码/批次)
|
||
{Method: http.MethodGet, Path: "/api/internal/material/query", Handler: wrapInternal(ctx)(materialQueryInternalHandler(ctx))},
|
||
{Method: http.MethodPost, Path: "/api/internal/material/manage-modes", Handler: wrapInternal(ctx)(materialManageModesHandler(ctx))},
|
||
// 物料分页查询(需求一 M7:MES 冷启动全量拉取用;MES 推送走上方 /upsert)
|
||
{Method: http.MethodGet, Path: "/api/internal/materials", Handler: wrapInternal(ctx)(queryMaterialsHandler(ctx))},
|
||
{Method: http.MethodGet, Path: "/api/internal/material/list-all", Handler: wrapInternal(ctx)(listMaterialsHandler(ctx))},
|
||
{Method: http.MethodPost, Path: "/api/internal/return-order", Handler: wrapInternal(ctx)(createReturnOrderInternalHandler(ctx))},
|
||
// 取消退料单/派车标记/工位列表/已退汇总(2026-11-04 口径定稿)
|
||
{Method: http.MethodPost, Path: "/api/internal/return-order/cancel", Handler: wrapInternal(ctx)(cancelReturnOrderInternalHandler(ctx))},
|
||
{Method: http.MethodGet, Path: "/api/internal/return-order/station-list", Handler: wrapInternal(ctx)(stationReturnListInternalHandler(ctx))},
|
||
{Method: http.MethodGet, Path: "/api/internal/return-order/pending-agv", Handler: wrapInternal(ctx)(pendingAgvReturnsInternalHandler(ctx))},
|
||
{Method: http.MethodPost, Path: "/api/internal/return-order/mark-dispatched", Handler: wrapInternal(ctx)(markReturnDispatchedInternalHandler(ctx))},
|
||
{Method: http.MethodGet, Path: "/api/internal/return-order/returned-summary", Handler: wrapInternal(ctx)(returnedSummaryInternalHandler(ctx))},
|
||
// MES 质量检验(过程检/完工检)判不合格 → 联动 WMS 在库处置(按物料+SN/批次定位库存行)
|
||
{Method: http.MethodPost, Path: "/api/internal/inventory/dispose", Handler: wrapInternal(ctx)(internalInventoryDisposeHandler(ctx))},
|
||
// AGV 到位回写(MES AGV 回调调用):出库单 已出库 → 已送达(补齐状态机无写者的断头路)
|
||
{Method: http.MethodPost, Path: "/api/internal/outbound/delivered", Handler: wrapInternal(ctx)(markOutboundDeliveredHandler(ctx))},
|
||
// 配送单送达回写(2026-11-05 拍板:AGV 卸货放行后 MES 回写;配送单不存在时忽略,兼容旧链路)
|
||
{Method: http.MethodPost, Path: "/api/internal/delivery/delivered", Handler: wrapInternal(ctx)(deliveryDeliveredInternalHandler(ctx))},
|
||
},
|
||
)
|
||
}
|