Files
bj_power/bj_power_mes/internal/handler/station.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

345 lines
13 KiB
Go

package handler
import (
"errors"
"net/http"
"net/url"
"strconv"
"strings"
"time"
"bj_power_mes/common/httpx"
"bj_power_mes/internal/handler/production"
"bj_power_mes/internal/logic"
"bj_power_mes/internal/svc"
"github.com/xuri/excelize/v2"
)
// atoiDefault 解析整型字符串,非法返回默认值
func atoiDefault(s string, def int) int {
if s == "" {
return def
}
if n, err := strconv.Atoi(s); err == nil {
return n
}
return def
}
// operator 从 JWT 上下文取操作人,取不到回退 fallback
func operator(r *http.Request, fallback string) string {
if v, ok := r.Context().Value("name").(string); ok && v != "" {
return v
}
if v, ok := r.Context().Value("username").(string); ok && v != "" {
return v
}
if fallback != "" {
return fallback
}
return "system"
}
// StationLoginInternalHandler 工位终端登录(内部接口,X-API-TOKEN 保护)
// 校验 用户名 + 工位终端密码 + 工位权限,签发与 MES 同密钥 JWT
func StationLoginInternalHandler(svcCtx *svc.ServiceContext) http.HandlerFunc {
return func(w http.ResponseWriter, r *http.Request) {
var req logic.StationLoginReq
if err := httpx.ParseJSON(r, &req); err != nil {
httpx.BadRequest(w, "请求体解析失败")
return
}
data, err := logic.New(svcCtx).StationLogin(r.Context(), req)
if err != nil {
httpx.Fail(w, 2101, err.Error())
return
}
// 操作日志:工位终端登录(写失败不阻断登录)
svcCtx.EventLog.Write(r.Context(), "auth.station_login", "", req.Username, "auth", req.Username,
"工位终端登录(工位"+strconv.Itoa(req.StationNo)+")",
map[string]any{"ip": clientIP(r), "stationNo": req.StationNo})
// 登录建班(下班闭环,2026-11-03):无进行中班次则创建 ON_DUTY(失败不阻断登录)
if serr := logic.New(svcCtx).EnsureShiftOnLogin(r.Context(), req.StationNo, req.Username); serr != nil {
svcCtx.EventLog.Write(r.Context(), "shift.start.fail", "", req.Username, "station_shift",
"station:"+strconv.Itoa(req.StationNo), "登录建班失败: "+serr.Error(), nil)
}
httpx.Ok(w, data)
}
}
// StationLogoutInternalHandler 工位终端退出(内部接口,X-API-TOKEN 保护)
func StationLogoutInternalHandler(svcCtx *svc.ServiceContext) http.HandlerFunc {
return func(w http.ResponseWriter, r *http.Request) {
var req struct {
Username string `json:"username"`
StationNo int `json:"stationNo"`
}
if err := httpx.ParseJSON(r, &req); err != nil {
httpx.BadRequest(w, "请求体解析失败")
return
}
if req.Username != "" {
svcCtx.EventLog.Write(r.Context(), "auth.station_logout", "", req.Username, "auth", req.Username,
"工位终端退出(工位"+strconv.Itoa(req.StationNo)+")",
map[string]any{"ip": clientIP(r), "stationNo": req.StationNo})
}
httpx.OkMessage(w, "已退出", nil)
}
}
// StationRefreshTokenInternalHandler 工位终端滑动续签(内部接口,X-API-TOKEN 保护):
// 校验当前工位登录态 Bearer 有效后原样重签新 JWT(延长有效期),由工位终端 Go 后端节流代理调用。
func StationRefreshTokenInternalHandler(svcCtx *svc.ServiceContext) http.HandlerFunc {
return func(w http.ResponseWriter, r *http.Request) {
authz := r.Header.Get("Authorization")
if !strings.HasPrefix(authz, "Bearer ") {
httpx.FailHTTP(w, http.StatusUnauthorized, "缺少工位登录凭证,请重新登录")
return
}
data, err := logic.New(svcCtx).StationRefreshToken(strings.TrimPrefix(authz, "Bearer "))
if err != nil {
httpx.Fail(w, 2107, err.Error())
return
}
httpx.Ok(w, data)
}
}
// StationChangePasswordInternalHandler 工位终端修改自己的工位终端密码
func StationChangePasswordInternalHandler(svcCtx *svc.ServiceContext) http.HandlerFunc {
return func(w http.ResponseWriter, r *http.Request) {
var req struct {
UserId int `json:"userId"`
OldPassword string `json:"oldPassword"`
NewPassword string `json:"newPassword"`
}
if err := httpx.ParseJSON(r, &req); err != nil {
httpx.BadRequest(w, "请求体解析失败")
return
}
if err := logic.New(svcCtx).StationChangePassword(r.Context(), req.UserId, req.OldPassword, req.NewPassword); err != nil {
httpx.Fail(w, 2102, err.Error())
return
}
httpx.OkMessage(w, "工位终端密码修改成功", nil)
}
}
// StationTaskInternalHandler 工位终端拉取当前任务(工位/流程/步骤/活跃工单)
func StationTaskInternalHandler(svcCtx *svc.ServiceContext) http.HandlerFunc {
return func(w http.ResponseWriter, r *http.Request) {
stationNo := atoiDefault(r.URL.Query().Get("stationNo"), 0)
// 工位号须为正整数(原 0/13 虚拟位已废弃,业务定稿·一.10)
if stationNo <= 0 {
httpx.BadRequest(w, "缺少有效的 stationNo 参数")
return
}
data, err := logic.New(svcCtx).StationTask(r.Context(), stationNo)
if err != nil {
httpx.Fail(w, 2103, err.Error())
return
}
httpx.Ok(w, data)
}
}
// StationTaskAdminHandler GET /station/task?stationNo= 管理后台「虚拟工位作业」页拉取任务(与终端同逻辑)
func StationTaskAdminHandler(svcCtx *svc.ServiceContext) http.HandlerFunc {
return StationTaskInternalHandler(svcCtx)
}
// StationReportAdminHandler POST /station/report 管理后台「虚拟工位作业」报工(与终端同逻辑,operator=登录账号)
func StationReportAdminHandler(svcCtx *svc.ServiceContext) http.HandlerFunc {
return StationReportInternalHandler(svcCtx)
}
// StationReportInternalHandler 工位终端工艺报工(写工位实绩 + 步骤考核)
func StationReportInternalHandler(svcCtx *svc.ServiceContext) http.HandlerFunc {
return func(w http.ResponseWriter, r *http.Request) {
var req logic.ReportProcessReq
if err := httpx.ParseJSON(r, &req); err != nil {
httpx.BadRequest(w, "请求体解析失败")
return
}
// 方案 B(#11/#14):优先取工位登录态可信身份;未携带(MES 前端虚拟工位路径)回退 JWT 登录账号。
recOpId, derr := production.StationOpIdInt(r)
if derr != nil {
httpx.Fail(w, 2104, derr.Error())
return
}
recOpName := production.StationOp(r, req.Operator)
if v := r.Header.Get("X-Station-No"); v != "" {
if n, e := strconv.Atoi(v); e == nil && n > 0 {
req.StationNo = n
}
}
if err := logic.New(svcCtx).ReportProcess(r.Context(), req, recOpName, recOpId); err != nil {
httpx.Fail(w, 2104, err.Error())
return
}
httpx.OkMessage(w, "报工成功", nil)
}
}
// WorkloadInternalHandler 工作量/绩效报表(工位终端"我的工作量" + MES 绩效报表共用)
// operator=操作人、stationNo=工位号(空=全部工位)、from/to=日期范围
func WorkloadInternalHandler(svcCtx *svc.ServiceContext) http.HandlerFunc {
return func(w http.ResponseWriter, r *http.Request) {
q := r.URL.Query()
data, err := logic.New(svcCtx).Workload(r.Context(), q.Get("operator"), q.Get("stationNo"), q.Get("orderNo"), q.Get("from"), q.Get("to"),
atoiDefault(q.Get("opPage"), 1), atoiDefault(q.Get("opPageSize"), 20),
atoiDefault(q.Get("stPage"), 1), atoiDefault(q.Get("stPageSize"), 20),
atoiDefault(q.Get("detPage"), 1), atoiDefault(q.Get("detPageSize"), 20))
if err != nil {
httpx.Fail(w, 2105, err.Error())
return
}
httpx.Ok(w, data)
}
}
// FileDownloadInternalHandler 内部文件下载(工艺图纸 PDF,供工位终端代理)
func FileDownloadInternalHandler(svcCtx *svc.ServiceContext) http.HandlerFunc {
return func(w http.ResponseWriter, r *http.Request) {
serveUploadFile(w, r, svcCtx.Config.Upload.Dir, r.URL.Query().Get("name"))
}
}
// StationCheckinInternalHandler 工位终端暂存退库(半成品入库,块4/5)
// 进度由 MES 服务端自取(workpiece.currentStationNo),按半成品 INBOUND 流转并通知 WMS 入库。
func StationCheckinInternalHandler(svcCtx *svc.ServiceContext) http.HandlerFunc {
return func(w http.ResponseWriter, r *http.Request) {
var req struct {
Sn string `json:"sn"`
OrderNo string `json:"orderNo"`
StationNo int `json:"stationNo"`
Operator string `json:"operator"`
}
if err := httpx.ParseJSON(r, &req); err != nil {
httpx.BadRequest(w, "请求体解析失败")
return
}
if req.Sn == "" {
httpx.BadRequest(w, "缺少 sn")
return
}
production.LogImpersonation(svcCtx, r, req.Operator, "/api/internal/station/checkin")
op := production.StationOp(r, req.Operator)
if err := logic.New(svcCtx).SemiFlow(r.Context(), logic.SemiReq{
Sn: req.Sn,
OrderNo: req.OrderNo,
Action: "INBOUND",
}, op); err != nil {
httpx.Fail(w, 2106, err.Error())
return
}
httpx.OkMessage(w, "暂存退库已登记", nil)
}
}
// PerformanceExportHandler GET /performance/export 绩效报表导出(一个 xlsx 四个 sheet:按人/按工位/明细/上机记录)
// 执行全项目统一导出时间硬规则:起止必填(默认近3个月)、间隔≤1年
func PerformanceExportHandler(svcCtx *svc.ServiceContext) http.HandlerFunc {
return func(w http.ResponseWriter, r *http.Request) {
q := r.URL.Query()
startDate, endDate, rerr := normalizeExportRange(q.Get("startDate"), q.Get("endDate"))
if rerr != nil {
httpx.Fail(w, 2106, rerr.Error())
return
}
data, err := logic.New(svcCtx).Workload(r.Context(), q.Get("operator"), q.Get("stationNo"), q.Get("orderNo"), startDate, endDate,
1, 1<<30, 1, 1<<30, 1, 1<<30)
if err != nil {
httpx.Fail(w, 2105, err.Error())
return
}
f := excelize.NewFile()
type view struct {
name string
key string
headers []string
cols func(r *logic.WorkloadRow) []any
}
views := []view{
{"按人", "byOperator", []string{"操作人", "完成数", "合格", "不合格", "累计作业时长(秒)", "平均作业时长(秒)", "效率(件/小时)"}, func(r *logic.WorkloadRow) []any {
return []any{r.Operator, r.DoneCount, r.OkCount, r.NgCount, r.TotalDurationSec, r.AvgDurationSec, r.Efficiency}
}},
{"按工位", "byStation", []string{"工位", "完成数", "合格", "不合格", "累计作业时长(秒)", "平均作业时长(秒)", "效率(件/小时)"}, func(r *logic.WorkloadRow) []any {
return []any{r.StationNo, r.DoneCount, r.OkCount, r.NgCount, r.TotalDurationSec, r.AvgDurationSec, r.Efficiency}
}},
{"明细", "detail", []string{"操作人", "工单号", "工位", "日期", "工艺ID", "工艺名", "完成数", "合格", "不合格", "累计作业时长(秒)", "平均作业时长(秒)", "效率(件/小时)"}, func(r *logic.WorkloadRow) []any {
return []any{r.Operator, r.OrderNo, r.StationNo, r.Date, r.FlowId, r.ProcessName, r.DoneCount, r.OkCount, r.NgCount, r.TotalDurationSec, r.AvgDurationSec, r.Efficiency}
}},
}
for i, vw := range views {
sheet := vw.name
if i == 0 {
f.SetSheetName("Sheet1", sheet)
} else {
f.NewSheet(sheet)
}
for c, h := range vw.headers {
cell, _ := excelize.CoordinatesToCellName(c+1, 1)
_ = f.SetCellValue(sheet, cell, h)
}
vm, _ := data[vw.key].(map[string]any)
list, _ := vm["list"].([]*logic.WorkloadRow)
for rIdx, it := range list {
vals := vw.cols(it)
for c := range vw.headers {
cell, _ := excelize.CoordinatesToCellName(c+1, rIdx+2)
_ = f.SetCellValue(sheet, cell, vals[c])
}
}
}
// 第四个 sheet:上机记录(由开工签到+报工实绩推导,不受工单号筛选影响)
if sess, ok := data["sessions"].(map[string]any); ok {
if sessList, ok2 := sess["list"].([]logic.StationSessionRow); ok2 {
sheet := "上机记录"
f.NewSheet(sheet)
headers := []string{"操作人", "工位", "日期", "上机时间(签到)", "下机时间(最后活动)", "在机时长(秒)", "加工件数", "效率(件/小时)"}
for c, h := range headers {
cell, _ := excelize.CoordinatesToCellName(c+1, 1)
_ = f.SetCellValue(sheet, cell, h)
}
for rIdx, it := range sessList {
vals := []any{it.Operator, it.StationNo, it.Date, it.CheckinAt, it.LastActiveAt, it.DurationSec, it.DoneCount, it.Efficiency}
for c := range headers {
cell, _ := excelize.CoordinatesToCellName(c+1, rIdx+2)
_ = f.SetCellValue(sheet, cell, vals[c])
}
}
}
}
w.Header().Set("Content-Type", "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet")
w.Header().Set("Content-Disposition", "attachment; filename*=UTF-8''"+url.PathEscape("绩效报表.xlsx"))
_, _ = f.WriteTo(w)
}
}
// normalizeExportRange MES 侧导出时间硬规则(与 WMS 同一套):
// ① 起止都空 → 默认近 3 个月;② 只传一个 → 报错;③ 间隔 > 1 年 → 报错;④ 结束早于起始 → 报错。
func normalizeExportRange(startDate, endDate string) (string, string, error) {
if startDate == "" && endDate == "" {
now := time.Now()
return now.AddDate(0, -3, 0).Format("2006-01-02"), now.Format("2006-01-02"), nil
}
if startDate == "" || endDate == "" {
return "", "", errors.New("导出必须同时提供起始时间与结束时间")
}
st, err1 := time.ParseInLocation("2006-01-02", startDate, time.Local)
et, err2 := time.ParseInLocation("2006-01-02", endDate, time.Local)
if err1 != nil || err2 != nil {
return "", "", errors.New("时间格式应为 YYYY-MM-DD")
}
if et.Before(st) {
return "", "", errors.New("结束时间不能早于起始时间")
}
if et.Sub(st) > 366*24*time.Hour {
return "", "", errors.New("导出时间间隔不能超过 1 年")
}
return startDate, endDate, nil
}