Files
bj_power/bj_power_workstation/internal/handler/station_ops.go
T
SunYF af554cea75 feat: 同步失败台账双向可重试 + 拧紧枪按工位配置 + 虚拟工位体系 + 去Redis与文档口径对齐
- 同步失败台账:MES/WMS 双端新增台账与页面,跨系统通知失败落台账、人工重试或标记已处理,不自动重传;重试前先判对端终态;叫料、配送、出库回写失败提示指向台账;补幂等建表脚本与菜单权限。
- 拧紧枪:新增按工位配置页,展示控制器地址与三把枪通道号(仅供查看,不参与采集校验);「允许手填」由全局开关改为每工位开关,关闭时校验该工位已配控制器;终端启动/登录上报配置并按本工位拉取,扭矩手填框按本工位置灰;补全局值迁移到各工位的脚本。
- 工位体系:终端未配置工位号时登录页可选(含虚拟工位),固定工位模式保留;虚拟/线下位不叫料、不退料、不作转产目标,未采集绑定放行并说明原因;叫料期望接驳台改为选填。
- AGV与出库:补「出库单已送达」回写;空车回充、接驳台传感器失联、配送状态更新失败均落预警或留痕并提示人工核对;人工出库不引入送达状态;出库单支持目标工位/接驳台并扩展导出列。
- 基础设施:看板缓存由Redis改为MES进程内实现,文档与启动脚本同步去Redis;扫码监听支持多地址、端口被占自动降级;PLC对账与工位报警在MES不可达时降级放行并留日志。
- 文档与帮助:案例与部署手册按实测订正(工位绑定、菜单名称、补料由班组长代提、菜单覆盖对照、虚拟工位);迁移脚本改为本地即时执行并登记7个已执行脚本;三端页面帮助改为「业务/操作/影响范围/后果」四要素。
- 测试:新增独立Go模块,按三个业务场景做真实HTTP与真实写库的流水测试,含运行报告。
2026-11-09 18:58:47 +08:00

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
}
}
}