Files
SunYF af554cea75 feat: 同步失败台账双向可重试 + 拧紧枪按工位配置 + 虚拟工位体系 + 去Redis与文档口径对齐
- 同步失败台账:MES/WMS 双端新增台账与页面,跨系统通知失败落台账、人工重试或标记已处理,不自动重传;重试前先判对端终态;叫料、配送、出库回写失败提示指向台账;补幂等建表脚本与菜单权限。
- 拧紧枪:新增按工位配置页,展示控制器地址与三把枪通道号(仅供查看,不参与采集校验);「允许手填」由全局开关改为每工位开关,关闭时校验该工位已配控制器;终端启动/登录上报配置并按本工位拉取,扭矩手填框按本工位置灰;补全局值迁移到各工位的脚本。
- 工位体系:终端未配置工位号时登录页可选(含虚拟工位),固定工位模式保留;虚拟/线下位不叫料、不退料、不作转产目标,未采集绑定放行并说明原因;叫料期望接驳台改为选填。
- AGV与出库:补「出库单已送达」回写;空车回充、接驳台传感器失联、配送状态更新失败均落预警或留痕并提示人工核对;人工出库不引入送达状态;出库单支持目标工位/接驳台并扩展导出列。
- 基础设施:看板缓存由Redis改为MES进程内实现,文档与启动脚本同步去Redis;扫码监听支持多地址、端口被占自动降级;PLC对账与工位报警在MES不可达时降级放行并留日志。
- 文档与帮助:案例与部署手册按实测订正(工位绑定、菜单名称、补料由班组长代提、菜单覆盖对照、虚拟工位);迁移脚本改为本地即时执行并登记7个已执行脚本;三端页面帮助改为「业务/操作/影响范围/后果」四要素。
- 测试:新增独立Go模块,按三个业务场景做真实HTTP与真实写库的流水测试,含运行报告。
2026-11-09 18:58:47 +08:00

232 lines
5.6 KiB
Go
Raw Permalink 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 client 四服务统一 HTTP 客户端。
// 统一响应为 {code, message, data},HTTP 业务失败可能 200 也可能 4xx/5xx,两者均由 L1 断言判读。
package client
import (
"bytes"
"context"
"encoding/json"
"fmt"
"io"
"net/http"
"strconv"
"strings"
"time"
"bj_power_test/internal/env"
)
// Response 一次真实调用的完整结果。
type Response struct {
HTTPStatus int `json:"httpStatus"`
Code int `json:"code"`
Message string `json:"message"`
Data json.RawMessage `json:"data"`
Raw string `json:"raw"`
URL string `json:"url"`
}
// DataGet 从 data 里按层级取字符串值,支持数组首元素;用于把上一步产生的真实单号传给下一步。
func (r *Response) DataGet(keys ...string) string {
if r == nil || len(r.Data) == 0 {
return ""
}
var cur any
if err := json.Unmarshal(r.Data, &cur); err != nil {
return ""
}
for _, k := range keys {
switch v := cur.(type) {
case map[string]any:
cur = v[k]
case []any:
if len(v) == 0 {
return ""
}
if m, ok := v[0].(map[string]any); ok {
cur = m[k]
} else {
return ""
}
default:
return ""
}
if cur == nil {
return ""
}
}
switch v := cur.(type) {
case string:
return v
case float64:
return fmt.Sprintf("%.0f", v)
case bool:
return fmt.Sprintf("%v", v)
default:
return fmt.Sprint(v)
}
}
// DataArray 取 data 里的数组字段(如 list/items),返回原始对象切片。
func (r *Response) DataArray(keys ...string) []map[string]any {
if r == nil || len(r.Data) == 0 {
return nil
}
var cur any
if err := json.Unmarshal(r.Data, &cur); err != nil {
return nil
}
for _, k := range keys {
m, ok := cur.(map[string]any)
if !ok {
return nil
}
cur = m[k]
}
arr, ok := cur.([]any)
if !ok {
return nil
}
out := make([]map[string]any, 0, len(arr))
for _, item := range arr {
if m, ok := item.(map[string]any); ok {
out = append(out, m)
}
}
return out
}
// Set 持有四端 baseURL 与登录凭证。
type Set struct {
cfg env.Config
tokens env.Tokens
hc *http.Client
}
func New(cfg env.Config, tk env.Tokens) *Set {
return &Set{cfg: cfg, tokens: tk, hc: &http.Client{Timeout: cfg.HTTPTimeout}}
}
func (s *Set) baseURL(svc env.Service) string {
switch svc {
case env.MES:
return s.cfg.MESURL
case env.WMS:
return s.cfg.WMSURL
case env.WS:
return s.cfg.WSURL
case env.Board:
return s.cfg.BoardURL
}
return ""
}
func (s *Set) token(svc env.Service) string {
switch svc {
case env.MES:
return s.tokens.MES
case env.WMS:
return s.tokens.WMS
case env.WS:
return s.tokens.WS
}
return ""
}
// stationNoFromBody 从请求体取工位号:test 自己持有工位号,不依赖工位终端 yaml 配置。
func stationNoFromBody(body any) int {
m, ok := body.(map[string]any)
if !ok {
return 0
}
switch v := m["stationNo"].(type) {
case int:
return v
case float64:
return int(v)
case string:
n, _ := strconv.Atoi(v)
return n
}
return 0
}
// Do 发起真实 HTTP 调用。
// MES /api/internal/* 同时受 InternalAuth(X-API-TOKEN) 与 StationSessionAuth(Bearer) 保护,
// 二者互补而非二选一;工位号由 X-Station-No 头显式指定(默认取 body.stationNo)。
func (s *Set) Do(ctx context.Context, svc env.Service, method, path string, body any) (*Response, error) {
return s.DoWithStation(ctx, svc, method, path, body, stationNoFromBody(body))
}
// DoWithStation 同 Do,但显式指定工位号(工位 3/6/12 可在同一进程内切换)。
func (s *Set) DoWithStation(ctx context.Context, svc env.Service, method, path string, body any, stationNo int) (*Response, error) {
var reader io.Reader
if body != nil {
b, err := json.Marshal(body)
if err != nil {
return nil, err
}
reader = bytes.NewReader(b)
}
url := s.baseURL(svc) + path
req, err := http.NewRequestWithContext(ctx, method, url, reader)
if err != nil {
return nil, err
}
if body != nil {
req.Header.Set("Content-Type", "application/json")
}
if strings.HasPrefix(path, "/api/internal/") {
req.Header.Set("X-API-TOKEN", s.cfg.InternalToken)
if svc == env.MES {
if t := s.token(svc); t != "" {
req.Header.Set("Authorization", "Bearer "+t)
}
if stationNo > 0 {
req.Header.Set("X-Station-No", strconv.Itoa(stationNo))
}
}
} else if t := s.token(svc); t != "" {
req.Header.Set("Authorization", "Bearer "+t)
}
started := time.Now()
resp, err := s.hc.Do(req)
if err != nil {
return nil, fmt.Errorf("%s %s:%w(耗时 %s)", method, url, err, time.Since(started).Round(time.Millisecond))
}
defer resp.Body.Close()
raw, _ := io.ReadAll(resp.Body)
r := &Response{HTTPStatus: resp.StatusCode, Raw: string(raw), URL: url}
var parsed struct {
Code int `json:"code"`
Message string `json:"message"`
Data json.RawMessage `json:"data"`
}
if err := json.Unmarshal(raw, &parsed); err == nil {
r.Code, r.Message, r.Data = parsed.Code, parsed.Message, parsed.Data
} else {
r.Code, r.Message = -1, "响应非 JSON"
}
return r, nil
}
func (s *Set) Get(ctx context.Context, svc env.Service, path string) (*Response, error) {
return s.Do(ctx, svc, http.MethodGet, path, nil)
}
func (s *Set) Post(ctx context.Context, svc env.Service, path string, body any) (*Response, error) {
return s.Do(ctx, svc, http.MethodPost, path, body)
}
// Brief 生成人类可读的「实际」摘要,用于报告。
func (r *Response) Brief() string {
if r == nil {
return "无响应"
}
raw := r.Raw
if len(raw) > 400 {
raw = raw[:400] + "…"
}
return fmt.Sprintf("HTTP %d / code=%d / message=%q / body=%s", r.HTTPStatus, r.Code, r.Message, raw)
}