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