Files
bj_power/bj_power_workstation/internal/handler/station_ops.go
T
SunYF 42bcf395d2 feat: AGV三段链安全机制、补料/损耗/下班闭环、接驳台左右互换
AGV 调度:
- 任务重构为 GO_LOAD/TRANSPORT/EMPTY_RETURN/FREE 三段链,到位即停(ARRIVED)需人工确认装卸
- 自由调度单点步进,每段强制弹"请确保路径畅通无杂物";托盘回收独立工作台
- 接驳台 PLC 传感器检测到托盘即自动卸货放行,传感器故障由人工按钮兜底(无轮询)
- 车辆状态只读展示(海康3.1.7 queryAgvStatus),调度仍由 RCS 负责

物料闭环:
- 补料管理(SHORTAGE):工位申请 + 主管审批调增叫料池额度,与借料/差异补发三轨并行
- 损耗台账(loss_ledger):退料实际 < 理论必填原因、后审核,工单不记损耗
- 退料强制指定左/右接驳台,WMS 库管可代工位退料

下班闭环:
- 工位终端自检接驳台剩余物料后下班;库管收货 + 托盘拉走后事件驱动自动结班
- 退出登录未下班仅作安全提示(不强制拦截、不新增责任审批)

接驳台左右按操作员朝向建模(dock.side 字段),废除"奇左偶右"隐式约定;
看板标签 / seed / 迁移补丁 / 布局文档统一为中文左/右。

产线布局说明:C1 前线头 AGV 点、C15 后线尾 AGV 点、外部 O1/O2/O3 散点,
清理修订痕迹为最终态描述。
2026-11-03 18:29:31 +08:00

174 lines
6.3 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)
}
}
// 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 固定工位号(与 /api/config 同源:workstation 配置)。
func stationNoFromRequest(ctx *svc.ServiceContext) int {
return ctx.Config.Station.StationNo
}
// 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
}
}
}