- 同步失败台账:MES/WMS 双端新增台账与页面,跨系统通知失败落台账、人工重试或标记已处理,不自动重传;重试前先判对端终态;叫料、配送、出库回写失败提示指向台账;补幂等建表脚本与菜单权限。 - 拧紧枪:新增按工位配置页,展示控制器地址与三把枪通道号(仅供查看,不参与采集校验);「允许手填」由全局开关改为每工位开关,关闭时校验该工位已配控制器;终端启动/登录上报配置并按本工位拉取,扭矩手填框按本工位置灰;补全局值迁移到各工位的脚本。 - 工位体系:终端未配置工位号时登录页可选(含虚拟工位),固定工位模式保留;虚拟/线下位不叫料、不退料、不作转产目标,未采集绑定放行并说明原因;叫料期望接驳台改为选填。 - AGV与出库:补「出库单已送达」回写;空车回充、接驳台传感器失联、配送状态更新失败均落预警或留痕并提示人工核对;人工出库不引入送达状态;出库单支持目标工位/接驳台并扩展导出列。 - 基础设施:看板缓存由Redis改为MES进程内实现,文档与启动脚本同步去Redis;扫码监听支持多地址、端口被占自动降级;PLC对账与工位报警在MES不可达时降级放行并留日志。 - 文档与帮助:案例与部署手册按实测订正(工位绑定、菜单名称、补料由班组长代提、菜单覆盖对照、虚拟工位);迁移脚本改为本地即时执行并登记7个已执行脚本;三端页面帮助改为「业务/操作/影响范围/后果」四要素。 - 测试:新增独立Go模块,按三个业务场景做真实HTTP与真实写库的流水测试,含运行报告。
226 lines
8.4 KiB
Go
226 lines
8.4 KiB
Go
package handler
|
|
|
|
import (
|
|
"encoding/json"
|
|
"io"
|
|
"net/http"
|
|
"strconv"
|
|
|
|
"bj_power_workstation/internal/svc"
|
|
)
|
|
|
|
// ============ 工位终端 → MES 内部 API 代理(巡检/应急/数量不符/退料) ============
|
|
// MES 侧对应接口以 X-API-TOKEN 保护(/api/internal/station/*),本服务用配置 token 转发。
|
|
// 统一:读请求体 → 注入 operator(当前登录人) → POST MES → 原样透传响应体。
|
|
|
|
// inspectionSubmitHandler POST /api/inspection/submit(签到/点检/过程巡检/完工确认/异常)
|
|
// 请求体:{category, stationNo, orderNo, sn, shift, result, items, photo, remark, processCode, stepId, stepName, measuredValue}
|
|
func inspectionSubmitHandler(ctx *svc.ServiceContext) http.HandlerFunc {
|
|
return func(w http.ResponseWriter, r *http.Request) {
|
|
payload, err := io.ReadAll(r.Body)
|
|
if err != nil {
|
|
fail(w, http.StatusBadRequest, "请求体读取失败")
|
|
return
|
|
}
|
|
var req map[string]any
|
|
if err := json.Unmarshal(payload, &req); err != nil {
|
|
fail(w, http.StatusBadRequest, "请求体解析失败")
|
|
return
|
|
}
|
|
if req["category"] == nil || req["category"] == "" {
|
|
fail(w, http.StatusBadRequest, "记录类型 category 必填")
|
|
return
|
|
}
|
|
injectOperator(req, r)
|
|
body, _ := json.Marshal(req)
|
|
resp, _, perr := ctx.Mes.Post("/api/internal/station/inspection", json.RawMessage(body))
|
|
mesJSON(w, resp, perr)
|
|
}
|
|
}
|
|
|
|
// emergencyCallHandler POST /api/emergency/call(应急呼叫:落 MES 预警中心)
|
|
// 请求体:{stationNo, orderNo, remark}
|
|
func emergencyCallHandler(ctx *svc.ServiceContext) http.HandlerFunc {
|
|
return func(w http.ResponseWriter, r *http.Request) {
|
|
payload, err := io.ReadAll(r.Body)
|
|
if err != nil {
|
|
fail(w, http.StatusBadRequest, "请求体读取失败")
|
|
return
|
|
}
|
|
var req map[string]any
|
|
if err := json.Unmarshal(payload, &req); err != nil {
|
|
fail(w, http.StatusBadRequest, "请求体解析失败")
|
|
return
|
|
}
|
|
injectOperator(req, r)
|
|
body, _ := json.Marshal(req)
|
|
resp, _, perr := ctx.Mes.Post("/api/internal/station/emergency", json.RawMessage(body))
|
|
mesJSON(w, resp, perr)
|
|
}
|
|
}
|
|
|
|
// qtyReportHandler POST /api/qty-report(工位数量不符上报:应发/实收/差异+原因)
|
|
// 请求体:{stationNo, orderNo, sn, materialCode, materialName, planQty, actualQty, cause}
|
|
func qtyReportHandler(ctx *svc.ServiceContext) http.HandlerFunc {
|
|
return func(w http.ResponseWriter, r *http.Request) {
|
|
payload, err := io.ReadAll(r.Body)
|
|
if err != nil {
|
|
fail(w, http.StatusBadRequest, "请求体读取失败")
|
|
return
|
|
}
|
|
var req map[string]any
|
|
if err := json.Unmarshal(payload, &req); err != nil {
|
|
fail(w, http.StatusBadRequest, "请求体解析失败")
|
|
return
|
|
}
|
|
if req["materialCode"] == nil || req["materialCode"] == "" {
|
|
fail(w, http.StatusBadRequest, "物料编码必填")
|
|
return
|
|
}
|
|
injectOperator(req, r)
|
|
body, _ := json.Marshal(req)
|
|
resp, _, perr := ctx.Mes.Post("/api/internal/station/qty-report", json.RawMessage(body))
|
|
mesJSON(w, resp, perr)
|
|
}
|
|
}
|
|
|
|
// returnMaterialHandler POST /api/return-material(工位退料回库房 → WMS 预建待确认退库单)
|
|
// 请求体:{orderNo, stationNo, sn, materialCode, materialName, spec, qty, unit, reason}
|
|
func returnMaterialHandler(ctx *svc.ServiceContext) http.HandlerFunc {
|
|
return func(w http.ResponseWriter, r *http.Request) {
|
|
payload, err := io.ReadAll(r.Body)
|
|
if err != nil {
|
|
fail(w, http.StatusBadRequest, "请求体读取失败")
|
|
return
|
|
}
|
|
var req map[string]any
|
|
if err := json.Unmarshal(payload, &req); err != nil {
|
|
fail(w, http.StatusBadRequest, "请求体解析失败")
|
|
return
|
|
}
|
|
if req["materialCode"] == nil || req["materialCode"] == "" {
|
|
fail(w, http.StatusBadRequest, "物料编码必填")
|
|
return
|
|
}
|
|
if q, ok := req["qty"].(float64); !ok || int(q) <= 0 {
|
|
fail(w, http.StatusBadRequest, "退库数量必须大于 0")
|
|
return
|
|
}
|
|
injectOperator(req, r)
|
|
body, _ := json.Marshal(req)
|
|
resp, _, perr := ctx.Mes.Post("/api/internal/station/return-material", json.RawMessage(body))
|
|
mesJSON(w, resp, perr)
|
|
}
|
|
}
|
|
|
|
// stationReturnListHandler GET /api/return-list —— 工位终端「我的退料单」列表(PENDING 可取消)。
|
|
func stationReturnListHandler(ctx *svc.ServiceContext) http.HandlerFunc {
|
|
return func(w http.ResponseWriter, r *http.Request) {
|
|
stationNo := stationNoFromRequest(ctx)
|
|
resp, _, perr := ctx.Mes.Get("/api/internal/station/return-list?stationNo="+strconv.Itoa(stationNo), nil)
|
|
mesJSON(w, resp, perr)
|
|
}
|
|
}
|
|
|
|
// stationReturnCancelHandler POST /api/return-cancel {returnNo, reason}
|
|
// 工位取消自己发起的 PENDING 退料单(MES 转发 WMS 校验工位归属后取消;已收货不可取消)。
|
|
func stationReturnCancelHandler(ctx *svc.ServiceContext) http.HandlerFunc {
|
|
return func(w http.ResponseWriter, r *http.Request) {
|
|
payload, err := io.ReadAll(r.Body)
|
|
if err != nil {
|
|
fail(w, http.StatusBadRequest, "请求体读取失败")
|
|
return
|
|
}
|
|
var req map[string]any
|
|
if err := json.Unmarshal(payload, &req); err != nil {
|
|
fail(w, http.StatusBadRequest, "请求体解析失败")
|
|
return
|
|
}
|
|
if rn, _ := req["returnNo"].(string); rn == "" {
|
|
fail(w, http.StatusBadRequest, "returnNo 必填")
|
|
return
|
|
}
|
|
req["stationNo"] = stationNoFromRequest(ctx)
|
|
injectOperator(req, r)
|
|
body, _ := json.Marshal(req)
|
|
resp, _, perr := ctx.Mes.Post("/api/internal/station/return-cancel", json.RawMessage(body))
|
|
mesJSON(w, resp, perr)
|
|
}
|
|
}
|
|
|
|
// stationReturnReferenceHandler GET /api/return-reference
|
|
// 工位终端余量参考值(剩余余量=应剩余量−已退余量−已损耗;仅展示不阻断提交)。
|
|
func stationReturnReferenceHandler(ctx *svc.ServiceContext) http.HandlerFunc {
|
|
return func(w http.ResponseWriter, r *http.Request) {
|
|
stationNo := stationNoFromRequest(ctx)
|
|
resp, _, perr := ctx.Mes.Get("/api/internal/station/return-reference?stationNo="+strconv.Itoa(stationNo), nil)
|
|
mesJSON(w, resp, perr)
|
|
}
|
|
}
|
|
|
|
// shiftGetHandler GET /api/shift —— 当前班次状态(退出登录前提示「未下班」用,2026-11-03 下班闭环)。
|
|
func shiftGetHandler(ctx *svc.ServiceContext) http.HandlerFunc {
|
|
return func(w http.ResponseWriter, r *http.Request) {
|
|
stationNo := stationNoFromRequest(ctx)
|
|
resp, _, perr := ctx.Mes.Get("/api/internal/station/shift?stationNo="+strconv.Itoa(stationNo), nil)
|
|
mesJSON(w, resp, perr)
|
|
}
|
|
}
|
|
|
|
// offDutyHandler POST /api/off-duty —— 下班/结束作业(工人自检接驳台剩余物料后提交)。
|
|
// {hasLeftover, items[]}:确认无剩余直接下班;有剩余走退料流程(指定接驳台/实际量/损耗原因)后离场。
|
|
func offDutyHandler(ctx *svc.ServiceContext) http.HandlerFunc {
|
|
return func(w http.ResponseWriter, r *http.Request) {
|
|
payload, err := io.ReadAll(r.Body)
|
|
if err != nil {
|
|
fail(w, http.StatusBadRequest, "请求体读取失败")
|
|
return
|
|
}
|
|
var req map[string]any
|
|
if err := json.Unmarshal(payload, &req); err != nil {
|
|
fail(w, http.StatusBadRequest, "请求体解析失败")
|
|
return
|
|
}
|
|
req["stationNo"] = stationNoFromRequest(ctx)
|
|
injectOperator(req, r)
|
|
body, _ := json.Marshal(req)
|
|
resp, _, perr := ctx.Mes.Post("/api/internal/station/off-duty", json.RawMessage(body))
|
|
mesJSON(w, resp, perr)
|
|
}
|
|
}
|
|
|
|
// stationNoFromRequest 业务工位号(2026-11-09 拍板):配置固定工位(>0)直接用配置;
|
|
// 未配置(<=0,登录页选择)时回退登录会话保存的实际工位号(登录响应 stationNo 落 SQLite session)。
|
|
func stationNoFromRequest(ctx *svc.ServiceContext) int {
|
|
if ctx.Config.Station.StationNo > 0 {
|
|
return ctx.Config.Station.StationNo
|
|
}
|
|
if ss, err := ctx.Store.GetStationSession(); err == nil && ss != nil {
|
|
return ss.StationNo
|
|
}
|
|
return 0
|
|
}
|
|
|
|
// inspectionUploadHandler POST /api/inspection/upload(巡检拍照 base64 上传,代理 MES 内部接口)
|
|
// 请求体:{filename, data(base64)}
|
|
func inspectionUploadHandler(ctx *svc.ServiceContext) http.HandlerFunc {
|
|
return func(w http.ResponseWriter, r *http.Request) {
|
|
payload, err := io.ReadAll(r.Body)
|
|
if err != nil {
|
|
fail(w, http.StatusBadRequest, "请求体读取失败")
|
|
return
|
|
}
|
|
resp, _, perr := ctx.Mes.Post("/api/internal/station/inspection-upload", json.RawMessage(payload))
|
|
mesJSON(w, resp, perr)
|
|
}
|
|
}
|
|
|
|
// injectOperator 若请求体未带 operator,则补当前登录人(工位终端 JWT 解析)
|
|
func injectOperator(req map[string]any, r *http.Request) {
|
|
if req["operator"] == nil || req["operator"] == "" {
|
|
if u := currentUsername(r); u != "" {
|
|
req["operator"] = u
|
|
}
|
|
}
|
|
}
|