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

265 lines
6.3 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 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
}