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
+264
View File
@@ -0,0 +1,264 @@
// Package db 直连三个库做 L2 落库断言:
// MES PostgreSQL(bj_power_mes)、WMS PostgreSQL(bj_power_wms)、工位终端 SQLite(workstation.db)。
// 只读查询,不写库、不删测试数据。
package db
import (
"context"
"database/sql"
"fmt"
"strings"
"github.com/jackc/pgx/v5/pgtype"
"github.com/jackc/pgx/v5/pgxpool"
_ "modernc.org/sqlite"
)
// Target 目标库。
type Target string
const (
MES Target = "MES"
WMS Target = "WMS"
WS Target = "工位终端"
)
// DB 三库连接集合。
type DB struct {
mes *pgxpool.Pool
wms *pgxpool.Pool
ws *sql.DB
}
// Open 建连并 Ping 三库;任一失败返回错误清单,已成功的连接仍保留可用。
func Open(ctx context.Context, mesDSN, wmsDSN, sqlitePath string) (*DB, []error) {
d := &DB{}
var errs []error
if p, err := pgxpool.New(ctx, mesDSN); err != nil {
errs = append(errs, fmt.Errorf("MES 库建连:%w", err))
} else if err := p.Ping(ctx); err != nil {
errs = append(errs, fmt.Errorf("MES 库 Ping:%w", err))
p.Close()
} else {
d.mes = p
}
if p, err := pgxpool.New(ctx, wmsDSN); err != nil {
errs = append(errs, fmt.Errorf("WMS 库建连:%w", err))
} else if err := p.Ping(ctx); err != nil {
errs = append(errs, fmt.Errorf("WMS 库 Ping:%w", err))
p.Close()
} else {
d.wms = p
}
// 工位终端与业务服务共用同一文件,只读方式打开,避免与运行中的终端抢写锁。
if s, err := sql.Open("sqlite", "file:"+sqlitePath+"?mode=ro&_pragma=busy_timeout(5000)"); err != nil {
errs = append(errs, fmt.Errorf("工位终端 SQLite 建连:%w", err))
} else if err := s.PingContext(ctx); err != nil {
errs = append(errs, fmt.Errorf("工位终端 SQLite Ping:%w", err))
_ = s.Close()
} else {
d.ws = s
}
return d, errs
}
func (d *DB) Close() {
if d.mes != nil {
d.mes.Close()
}
if d.wms != nil {
d.wms.Close()
}
if d.ws != nil {
_ = d.ws.Close()
}
}
// Ready 某库是否可用。
func (d *DB) Ready(t Target) bool {
switch t {
case MES:
return d.mes != nil
case WMS:
return d.wms != nil
case WS:
return d.ws != nil
}
return false
}
// normalizeArgs 兼容「调用方把参数打包成 []any 整体传入」的写法:
// Scalar/Rows 是变参,若只收到一个 []any 则展开;单个 nil 视为无参数。
// (2026-11-08 断链核实:此前 scenario1 直接传 []any{code},pgx 收到的是
// 单个切片而非展开后的元素,导致查询失败/空值,进而误判为数据缺失。)
func normalizeArgs(args []any) []any {
if len(args) == 1 {
switch v := args[0].(type) {
case []any:
return v
case nil:
return nil
}
}
return args
}
// scalarString 把数据库标量统一转成可比对的字符串。
// pgx v5 把 NUMERIC 解成 pgtype.Numeric 结构体,直接 fmt.Sprint 会得到
// "{2 0 false finite true}" 这类不可比对文本(RUN20261108-05 的 S1-10/S1-16
// 库存汇总断言即由此误判为失败),故按 Int * 10^Exp 还原成十进制文本。
func scalarString(v any) string {
switch n := v.(type) {
case pgtype.Numeric:
return numericString(n)
case *pgtype.Numeric:
if n == nil {
return "<nil>"
}
return numericString(*n)
}
return fmt.Sprint(v)
}
func numericString(n pgtype.Numeric) string {
if !n.Valid || n.NaN || n.InfinityModifier != pgtype.Finite || n.Int == nil {
return "<nil>"
}
s := n.Int.String()
neg := strings.HasPrefix(s, "-")
if neg {
s = s[1:]
}
switch {
case n.Exp > 0:
s += strings.Repeat("0", int(n.Exp))
case n.Exp < 0:
k := int(-n.Exp)
if len(s) <= k {
s = strings.Repeat("0", k-len(s)+1) + s
}
s = s[:len(s)-k] + "." + s[len(s)-k:]
s = strings.TrimRight(s, "0")
s = strings.TrimSuffix(s, ".")
}
if neg && s != "0" {
s = "-" + s
}
return s
}
// Scalar 返回单值(统一转字符串,便于断言比较)。无行返回 "" 且 err=nil。
func (d *DB) Scalar(ctx context.Context, t Target, query string, args ...any) (string, error) {
args = normalizeArgs(args)
switch t {
case MES, WMS:
p := d.mes
if t == WMS {
p = d.wms
}
if p == nil {
return "", fmt.Errorf("%s 库未连接", t)
}
var v any
err := p.QueryRow(ctx, query, args...).Scan(&v)
if err != nil {
if strings.Contains(err.Error(), "no rows") {
return "", nil
}
return "", err
}
return scalarString(v), nil
case WS:
if d.ws == nil {
return "", fmt.Errorf("%s 库未连接", t)
}
var v any
err := d.ws.QueryRowContext(ctx, query, args...).Scan(&v)
if err != nil {
if err == sql.ErrNoRows {
return "", nil
}
return "", err
}
return scalarString(v), nil
}
return "", fmt.Errorf("未知目标库 %s", t)
}
// Rows 返回多行(列名 → 字符串值),用于逐行核对落库字段。
func (d *DB) Rows(ctx context.Context, t Target, query string, args ...any) ([]map[string]string, error) {
args = normalizeArgs(args)
out := []map[string]string{}
switch t {
case MES, WMS:
p := d.mes
if t == WMS {
p = d.wms
}
if p == nil {
return nil, fmt.Errorf("%s 库未连接", t)
}
rows, err := p.Query(ctx, query, args...)
if err != nil {
return nil, err
}
defer rows.Close()
fields := rows.FieldDescriptions()
for rows.Next() {
vals, err := rows.Values()
if err != nil {
return nil, err
}
m := make(map[string]string, len(fields))
for i, f := range fields {
m[f.Name] = scalarString(vals[i])
}
out = append(out, m)
}
return out, rows.Err()
case WS:
if d.ws == nil {
return nil, fmt.Errorf("%s 库未连接", t)
}
rows, err := d.ws.QueryContext(ctx, query, args...)
if err != nil {
return nil, err
}
defer rows.Close()
cols, err := rows.Columns()
if err != nil {
return nil, err
}
for rows.Next() {
buf := make([]any, len(cols))
ptr := make([]any, len(cols))
for i := range buf {
ptr[i] = &buf[i]
}
if err := rows.Scan(ptr...); err != nil {
return nil, err
}
m := make(map[string]string, len(cols))
for i, c := range cols {
m[c] = fmt.Sprint(buf[i])
}
out = append(out, m)
}
return out, rows.Err()
}
return nil, fmt.Errorf("未知目标库 %s", t)
}
// Count 便捷计数。
func (d *DB) Count(ctx context.Context, t Target, query string, args ...any) (int, error) {
s, err := d.Scalar(ctx, t, query, args...)
if err != nil {
return 0, err
}
if s == "" || s == "<nil>" {
return 0, nil
}
var n int
_, err = fmt.Sscan(s, &n)
return n, err
}