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 散点, 清理修订痕迹为最终态描述。
345 lines
13 KiB
Go
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
|
|
}
|