Files
bj_power/bj_power_workstation/internal/mes/client.go
T
SunYF 7b7d27d150 feat: 会话令牌与守卫、看板组件及工位终端功能完善
- 用户表扩展:MES/WMS user 实体新增字段,新增 active_token 迁移 SQL(2026-11-11)
- 会话机制:MES 新增 session_guard,重构 token/auth/jwt/perm 与路由;WMS/工作站同步令牌续签与鉴权
- 看板(board):调整 MES 看板产线/生产/侧栏/仓库组件及样式;WMS 看板展示页同步调整
- 工位终端后端:完善报警流、绑定、PLC 对账、拧紧、proxy、上报、站点告警/操作等 handler,补充 mes client/store
- 工位终端前端:登录/主界面/各操作面板调整,新增滚动分页与多语言 yaml 文案,刷新构建产物
- MES 业务:新增流程链 logic,调整待审核/产能支撑/产品工艺/设置页、PLC 监控与帮助文档,刷新构建产物
- 更新问题记录文档
2026-11-11 14:36:16 +08:00

196 lines
7.2 KiB
Go
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
package mes
import (
"bytes"
"encoding/json"
"errors"
"fmt"
"io"
"net/http"
"net/url"
"strings"
"sync"
"time"
"bj_power_workstation/internal/tightening"
)
// ErrAuth 认证失效(401 / 登录态过期):可恢复错误。
// 调用方据此提示重新登录(2026-11-05 拍板:断网/认证失败直接报错,无离线重试)。
var ErrAuth = errors.New("station auth expired or invalid")
// BizError MES 业务拒绝(HTTP 2xx + code≠0):请求已送达且被明确拒绝,数据本身不合法,
// 调用方应把拒绝原因直接回前端。
type BizError struct {
Body []byte // MES 原始响应体
Code int // 业务码
Message string // 业务消息
}
func (e *BizError) Error() string {
return fmt.Sprintf("MES 业务拒绝(code=%d): %s", e.Code, truncate(e.Message, 200))
}
// Client MES 内部 API HTTP 客户端。
// 自动携带请求头:X-API-TOKEN(项目间 token)、Content-Type: application/json。
// 任何非 2xx 状态返回包含响应体的错误信息。
// 多会话版(2026-11-11):Bearer 不再是单一全局登录态,Get/Post 支持可选 bearer 参数——
// 终端 handler 把「当前请求的 JWT」透传给 MES(token 即会话身份),多个会话互不串身份;
// 不传 bearer 的调用(登录/内部通知等)只带 X-API-TOKEN。
type Client struct {
baseURL string
token string // X-API-TOKEN 共享内部 token(项目间)
httpClient *http.Client
streamClient *http.Client // SSE 长连接专用(无总超时)
mu sync.Mutex
Touch func(bearer string) // 每次以有效登录态(bearer 非空)发起的调用触发,刷新该会话空闲计时(核实4)
}
func New(baseURL, token string) *Client {
return &Client{
baseURL: strings.TrimRight(baseURL, "/"),
token: token,
httpClient: &http.Client{Timeout: 10 * time.Second},
streamClient: &http.Client{}, // SSE 长连接专用:无总超时,靠服务端心跳+断线重连兜底
}
}
// Get 发送 GET 请求,query 为空则忽略;bearer 可选(当前请求的工位登录 JWT)。
func (c *Client) Get(path string, query url.Values, bearer ...string) ([]byte, http.Header, error) {
u := c.baseURL + path
if len(query) > 0 {
u += "?" + query.Encode()
}
return c.do(http.MethodGet, u, nil, firstBearer(bearer))
}
// Post 发送 POST 请求(实时路径),body 序列化为 JSON;bearer 可选(当前请求的工位登录 JWT)。
func (c *Client) Post(path string, body any, bearer ...string) ([]byte, http.Header, error) {
var reader io.Reader
if body != nil {
b, err := json.Marshal(body)
if err != nil {
return nil, nil, fmt.Errorf("序列化请求体失败: %w", err)
}
reader = bytes.NewReader(b)
}
return c.do(http.MethodPost, c.baseURL+path, reader, firstBearer(bearer))
}
func firstBearer(v []string) string {
for _, s := range v {
if s != "" {
return s
}
}
return ""
}
// ReportTighteningConfig 向 MES 上报本终端 yaml 的拧紧枪配置快照,仅供「拧紧枪配置」页展示。
// 2026-11-09 拍板:三把枪通道号仅展示,不参与任何拧紧数据区分 / 校验 / 拦截;不下发控制指令、
// 不改变本终端控制器连接与采集链路。启动与登录各调用一次(best-effort),MES 侧该工位已有
// 展示记录时自动跳过,绝不覆盖页面人工编辑。
func (c *Client) ReportTighteningConfig(cfg tightening.TighteningConfig, stationNo int) error {
if stationNo <= 0 {
return nil
}
payload := map[string]any{
"stationNo": stationNo,
"enable": cfg.Enable,
"controllerAddr": cfg.ControllerAddr,
"cellId": cfg.CellID,
"channelId": cfg.ChannelID,
"stationId": cfg.StationID,
"operatorId": cfg.OperatorID,
"heartbeatSec": cfg.HeartbeatSec,
}
_, _, err := c.Post("/api/internal/torque/config/report", payload)
return err
}
// GetStream 发起 SSE 长连接(工位报警事件流,2026-10-20):仅 X-API-TOKEN 鉴权,
// 不携带/不刷新工位登录态(长连接期间登录态可能过期,SSE 鉴权只认项目间 token)。
// 使用独立的无超时 http.Client(默认 httpClient 的 10s 总超时会掐断长连接);
// 调用方负责关闭返回的 ReadCloser,断线重连由调用方(alertstream.Manager)负责。
func (c *Client) GetStream(path string, query url.Values) (io.ReadCloser, error) {
u := c.baseURL + path
if len(query) > 0 {
u += "?" + query.Encode()
}
req, err := http.NewRequest(http.MethodGet, u, nil)
if err != nil {
return nil, err
}
req.Header.Set("X-API-TOKEN", c.token)
req.Header.Set("Accept", "text/event-stream")
resp, err := c.streamClient.Do(req)
if err != nil {
return nil, err
}
if resp.StatusCode != http.StatusOK {
body, _ := io.ReadAll(resp.Body)
resp.Body.Close()
return nil, fmt.Errorf("MES %s 返回 %d:%s", path, resp.StatusCode, truncate(string(body), 200))
}
return resp.Body, nil
}
// do 执行请求:Bearer 使用调用方传入的请求级 JWT(多会话透传),空则不携带。
// 仅在携带有效登录态时刷新对应会话的空闲计时(核实4)。
func (c *Client) do(method, u string, body io.Reader, bearer string) ([]byte, http.Header, error) {
req, err := http.NewRequest(method, u, body)
if err != nil {
return nil, nil, err
}
req.Header.Set("X-API-TOKEN", c.token)
req.Header.Set("Content-Type", "application/json;charset=utf-8")
// 方案 B(多会话):透传当前请求的工位登录态 JWT,使 MES 能从 claims 取出可信操作人/工位号
if bearer != "" {
req.Header.Set("Authorization", "Bearer "+bearer)
// 核实4:携带当前登录态的调用视为一次人工活动,刷新该会话的空闲计时
if c.Touch != nil {
c.Touch(bearer)
}
}
resp, err := c.httpClient.Do(req)
if err != nil {
return nil, nil, err
}
defer resp.Body.Close()
respBody, err := io.ReadAll(resp.Body)
if err != nil {
return nil, resp.Header, err
}
if resp.StatusCode == http.StatusUnauthorized {
// 401 = 工位登录态过期/无效:调用方据此提示重新登录。
return respBody, resp.Header, fmt.Errorf("MES %s %s: %w", method, u, ErrAuth)
}
if resp.StatusCode < 200 || resp.StatusCode > 299 {
return respBody, resp.Header, fmt.Errorf("MES %s %s 返回 %d:%s",
method, u, resp.StatusCode, truncate(string(respBody), 200))
}
// W2(安全审计):MES 内部接口常以 HTTP 200 + {code≠0} 返回业务失败(如数据校验不通过、
// 重复提交被拒)。仅看 HTTP 状态会误判成功,导致离线队列数据被标记 synced=1 永久丢失。
// 此处解析业务码,code≠0 一律视为失败;但与网络失败不同——业务拒绝返回 BizError
//(调用方直接回前端/死信,不进离线队列无限重传),网络失败返回普通 error(可重试,入离线队列)。
var br struct {
Code int `json:"code"`
Message string `json:"message"`
}
if err := json.Unmarshal(respBody, &br); err == nil && br.Code != 0 {
return respBody, resp.Header, &BizError{Body: respBody, Code: br.Code, Message: br.Message}
}
return respBody, resp.Header, nil
}
func truncate(s string, n int) string {
s = strings.TrimSpace(s)
if len(s) > n {
return s[:n] + "..."
}
return s
}