feat: 同步失败台账双向可重试 + 拧紧枪按工位配置 + 虚拟工位体系 + 去Redis与文档口径对齐

- 同步失败台账:MES/WMS 双端新增台账与页面,跨系统通知失败落台账、人工重试或标记已处理,不自动重传;重试前先判对端终态;叫料、配送、出库回写失败提示指向台账;补幂等建表脚本与菜单权限。
- 拧紧枪:新增按工位配置页,展示控制器地址与三把枪通道号(仅供查看,不参与采集校验);「允许手填」由全局开关改为每工位开关,关闭时校验该工位已配控制器;终端启动/登录上报配置并按本工位拉取,扭矩手填框按本工位置灰;补全局值迁移到各工位的脚本。
- 工位体系:终端未配置工位号时登录页可选(含虚拟工位),固定工位模式保留;虚拟/线下位不叫料、不退料、不作转产目标,未采集绑定放行并说明原因;叫料期望接驳台改为选填。
- AGV与出库:补「出库单已送达」回写;空车回充、接驳台传感器失联、配送状态更新失败均落预警或留痕并提示人工核对;人工出库不引入送达状态;出库单支持目标工位/接驳台并扩展导出列。
- 基础设施:看板缓存由Redis改为MES进程内实现,文档与启动脚本同步去Redis;扫码监听支持多地址、端口被占自动降级;PLC对账与工位报警在MES不可达时降级放行并留日志。
- 文档与帮助:案例与部署手册按实测订正(工位绑定、菜单名称、补料由班组长代提、菜单覆盖对照、虚拟工位);迁移脚本改为本地即时执行并登记7个已执行脚本;三端页面帮助改为「业务/操作/影响范围/后果」四要素。
- 测试:新增独立Go模块,按三个业务场景做真实HTTP与真实写库的流水测试,含运行报告。
This commit is contained in:
SunYF
2026-11-09 18:58:47 +08:00
parent 5e2640c13a
commit af554cea75
149 changed files with 35119 additions and 296 deletions
+212
View File
@@ -0,0 +1,212 @@
// Package env 负责探活、登录与运行配置。
// 所有地址、账号、DSN 均可由环境变量覆盖,默认值取自四服务 etc/*.yaml 实测配置。
package env
import (
"bytes"
"context"
"encoding/json"
"fmt"
"io"
"net/http"
"os"
"strings"
"time"
)
// Config 一次运行所需的全部外部配置。
type Config struct {
MESURL string
WMSURL string
WSURL string
BoardURL string
MESDSN string
WMSDSN string
SQLitePath string
User string
Password string
// 工位终端登录需要额外工位号,且使用 MES 独立字段 WorkstationPassword。
StationNo int
InternalToken string
ReportDir string
HTTPTimeout time.Duration
}
func envIntOr(key string, def int) int {
if v := strings.TrimSpace(os.Getenv(key)); v != "" {
var n int
if _, err := fmt.Sscan(v, &n); err == nil && n > 0 {
return n
}
}
return def
}
func envOr(key, def string) string {
if v := strings.TrimSpace(os.Getenv(key)); v != "" {
return v
}
return def
}
// Load 读取运行配置。默认源:
// MES etc/bj_power_mes-api.yaml:1-25 / WMS etc/bj_power_wms-api.yaml:1-24 /
// 工位终端 etc/bj_power_workstation.yaml:1-22,54-55。
func Load() Config {
mesDSN := envOr("TEST_MES_DSN", "postgres://postgres:postgres@127.0.0.1:5432/bj_power_mes?sslmode=disable")
wmsDSN := envOr("TEST_WMS_DSN", "postgres://postgres:postgres@127.0.0.1:5432/bj_power_wms?sslmode=disable")
return Config{
MESURL: envOr("TEST_MES_URL", "http://127.0.0.1:8888"),
WMSURL: envOr("TEST_WMS_URL", "http://127.0.0.1:8890"),
WSURL: envOr("TEST_WS_URL", "http://127.0.0.1:8892"),
BoardURL: envOr("TEST_BOARD_URL", "http://127.0.0.1:5173"),
MESDSN: mesDSN,
WMSDSN: wmsDSN,
SQLitePath: envOr("TEST_SQLITE_PATH", "D:/hardman/bj_power/bj_power_workstation/workstation.db"),
User: envOr("TEST_USER", "admin"),
Password: envOr("TEST_PASSWORD", "123456"),
// T3:工位号由 test 自己持有,不再依赖工位终端 etc/*.yaml 的 Station.StationNo。
// 各步骤请求体显式带 stationNo(S1-05/09/14),此处仅用于工位终端登录凭证。
StationNo: envIntOr("TEST_STATION_NO", 3),
InternalToken: envOr("TEST_INTERNAL_TOKEN", "Hardman_2026"),
ReportDir: envOr("TEST_REPORT_DIR", "D:/hardman/bj_power/test/reports"),
HTTPTimeout: 15 * time.Second,
}
}
// Service 四服务标识。
type Service string
const (
MES Service = "MES"
WMS Service = "WMS"
WS Service = "工位终端"
Board Service = "看板"
)
// ProbeResult 单个服务的探活结果。
type ProbeResult struct {
Name string `json:"name"`
URL string `json:"url"`
OK bool `json:"ok"`
Detail string `json:"detail"`
}
// Probe 探活:能收到任意 HTTP 响应即视为服务在监听(404/405 也算,连接失败才算不可达)。
func (c Config) Probe(ctx context.Context) []ProbeResult {
targets := []struct {
name, base, path string
}{
{string(MES), c.MESURL, "/api/v1/login"},
{string(WMS), c.WMSURL, "/api/health"},
{string(WS), c.WSURL, "/api/health"},
{string(Board), c.BoardURL, "/"},
}
hc := &http.Client{Timeout: 3 * time.Second}
out := make([]ProbeResult, 0, len(targets))
for _, t := range targets {
r := ProbeResult{Name: t.name, URL: t.base}
req, err := http.NewRequestWithContext(ctx, http.MethodGet, t.base+t.path, nil)
if err != nil {
r.Detail = err.Error()
out = append(out, r)
continue
}
resp, err := hc.Do(req)
if err != nil {
r.Detail = "不可达:" + err.Error()
out = append(out, r)
continue
}
_, _ = io.Copy(io.Discard, resp.Body)
_ = resp.Body.Close()
r.OK = true
r.Detail = fmt.Sprintf("HTTP %d", resp.StatusCode)
out = append(out, r)
}
return out
}
// Tokens 登录后持有的凭证。看板免登录,恒为空。
type Tokens struct {
MES string
WMS string
WS string
Board string
}
// LoginError 单端登录失败,不阻断其它端。
type LoginError struct {
Service string
Err error
}
func (e LoginError) Error() string { return e.Service + " 登录失败:" + e.Err.Error() }
type loginReply struct {
Code int `json:"code"`
Message string `json:"message"`
Data json.RawMessage `json:"data"`
}
// Login 依次登录三端,返回凭证与逐端错误清单。
// MES: POST /api/v1/login → data.accessToken(internal/logic/auth.go:26-28)
// WMS: POST /api/auth/login → data.token (internal/handler/auth.go:84-89)
// 终端: POST /api/auth/login → 原样透传 MES,data.accessToken(internal/handler/auth.go:69-93)
func (c Config) Login(ctx context.Context) (Tokens, []LoginError) {
var tk Tokens
var errs []LoginError
hc := &http.Client{Timeout: c.HTTPTimeout}
doLogin := func(name, url, body, dataKey string) string {
req, err := http.NewRequestWithContext(ctx, http.MethodPost, url, bytes.NewBufferString(body))
if err != nil {
errs = append(errs, LoginError{name, err})
return ""
}
req.Header.Set("Content-Type", "application/json")
resp, err := hc.Do(req)
if err != nil {
errs = append(errs, LoginError{name, err})
return ""
}
defer resp.Body.Close()
raw, _ := io.ReadAll(resp.Body)
var lr loginReply
if err := json.Unmarshal(raw, &lr); err != nil {
errs = append(errs, LoginError{name, fmt.Errorf("响应非 JSON:%s", truncate(string(raw), 160))})
return ""
}
if resp.StatusCode != http.StatusOK || lr.Code != 0 {
errs = append(errs, LoginError{name, fmt.Errorf("HTTP %d code=%d %s", resp.StatusCode, lr.Code, lr.Message)})
return ""
}
var m map[string]any
if err := json.Unmarshal(lr.Data, &m); err != nil {
errs = append(errs, LoginError{name, fmt.Errorf("data 解析失败:%v", err)})
return ""
}
v, _ := m[dataKey].(string)
if v == "" {
errs = append(errs, LoginError{name, fmt.Errorf("data.%s 为空", dataKey)})
}
return v
}
mesBody := fmt.Sprintf(`{"username":%q,"password":%q}`, c.User, c.Password)
wsBody := fmt.Sprintf(`{"username":%q,"password":%q,"stationNo":%d}`, c.User, c.Password, c.StationNo)
tk.MES = doLogin(string(MES), c.MESURL+"/api/v1/login", mesBody, "accessToken")
tk.WMS = doLogin(string(WMS), c.WMSURL+"/api/auth/login", mesBody, "token")
tk.WS = doLogin(string(WS), c.WSURL+"/api/auth/login", wsBody, "accessToken")
return tk, errs
}
func truncate(s string, n int) string {
if len(s) <= n {
return s
}
return s[:n] + "…"
}