Files
bj_power/bj_power_mes/internal/handler/station.go
T
SunYF 1e92b2a596 feat: 核心业务实体扩充(混产模板/产品BOM/试制记录)、WMS 库存检验增强与前端通用能力
- MES 新增实体:混产模板、产品BOM、产品工艺物料、试制记录(schema + ent 生成码 + logic/handler/前端页)
- WMS 实体增强:检验记录、库存、半成品重构;新增序列号库存与短缺代报
- AGV 与产能:AGV 手动点位与链路、物料守卫、短缺预测、原因字典
- 前端通用能力:新增下一步引导组件 NextStepBar,统一帮助文档/布局/请求拦截与操作列
- 工位终端:界面与各 handler 调整(api/store/绑定/PLC/拧紧/上报等)
- 配置与文档:更新 mes-api.yaml、WMS README 及案例/产线API/问题记录/项目说明/流程说明
2026-11-15 12:17:39 +08:00

358 lines
14 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"
}
// StationOptionsInternalHandler GET /api/internal/station/options(内部接口,X-API-TOKEN 保护)
// 登录页可选工位清单(实体+虚拟,全部启用),供未配置固定工位的终端登录页下拉(2026-11-09 拍板)。
func StationOptionsInternalHandler(svcCtx *svc.ServiceContext) http.HandlerFunc {
return func(w http.ResponseWriter, r *http.Request) {
list, err := logic.New(svcCtx).StationOptions(r.Context())
if err != nil {
httpx.Fail(w, 2108, err.Error())
return
}
httpx.Ok(w, list)
}
}
// 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, "当前终端未确定工位,请重新登录并选择工位")
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
}