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
@@ -0,0 +1,45 @@
-- ============================================================
-- 同步失败台账 sync_failure(2026-11-09 补登记,部署时手工执行)
-- 适用库:bj_power_mes(WMS 库另有一份同名脚本,两端各执行一次)
-- 背景:服务启动期禁止任何 DDL(见 internal/syncfailure/syncfailure.go 顶部口径),
-- 该表此前只在运行库由运维一次性建好,未落 sql/pending/,
-- 新环境部署会漏建,表现为「查询同步失败台账失败」。
-- 幂等:CREATE TABLE IF NOT EXISTS + 逐列 ADD COLUMN IF NOT EXISTS +
-- CREATE INDEX IF NOT EXISTS,可重复执行。
-- ============================================================
CREATE TABLE IF NOT EXISTS sync_failure (
id bigserial PRIMARY KEY,
direction text NOT NULL DEFAULT '',
biz_type text NOT NULL DEFAULT '',
biz_key text NOT NULL DEFAULT '',
endpoint text NOT NULL DEFAULT '',
payload_json text NOT NULL DEFAULT '{}',
error_msg text NOT NULL DEFAULT '',
idempotency_key text NOT NULL,
status text NOT NULL DEFAULT 'PENDING',
retry_count integer NOT NULL DEFAULT 0,
created_at bigint NOT NULL DEFAULT 0,
last_error_at bigint NOT NULL DEFAULT 0,
handled_by text NOT NULL DEFAULT ''
);
-- 存量库补列(ent 的 Schema.Create 不会给已存在的表 ADD COLUMN)。
-- idempotency_key 是「非空且无默认值」列:先带默认值补齐存量行,再 DROP DEFAULT
-- 与运行库结构对齐(避免 SQLSTATE 23502 启动失败)。
ALTER TABLE sync_failure ADD COLUMN IF NOT EXISTS direction text NOT NULL DEFAULT '';
ALTER TABLE sync_failure ADD COLUMN IF NOT EXISTS biz_type text NOT NULL DEFAULT '';
ALTER TABLE sync_failure ADD COLUMN IF NOT EXISTS biz_key text NOT NULL DEFAULT '';
ALTER TABLE sync_failure ADD COLUMN IF NOT EXISTS endpoint text NOT NULL DEFAULT '';
ALTER TABLE sync_failure ADD COLUMN IF NOT EXISTS payload_json text NOT NULL DEFAULT '{}';
ALTER TABLE sync_failure ADD COLUMN IF NOT EXISTS error_msg text NOT NULL DEFAULT '';
ALTER TABLE sync_failure ADD COLUMN IF NOT EXISTS idempotency_key text NOT NULL DEFAULT '';
ALTER TABLE sync_failure ALTER COLUMN idempotency_key DROP DEFAULT;
ALTER TABLE sync_failure ADD COLUMN IF NOT EXISTS status text NOT NULL DEFAULT 'PENDING';
ALTER TABLE sync_failure ADD COLUMN IF NOT EXISTS retry_count integer NOT NULL DEFAULT 0;
ALTER TABLE sync_failure ADD COLUMN IF NOT EXISTS created_at bigint NOT NULL DEFAULT 0;
ALTER TABLE sync_failure ADD COLUMN IF NOT EXISTS last_error_at bigint NOT NULL DEFAULT 0;
ALTER TABLE sync_failure ADD COLUMN IF NOT EXISTS handled_by text NOT NULL DEFAULT '';
CREATE UNIQUE INDEX IF NOT EXISTS idx_sync_failure_idem ON sync_failure (idempotency_key);
CREATE INDEX IF NOT EXISTS idx_sync_failure_status ON sync_failure (status);
@@ -0,0 +1,62 @@
-- 2026-11-09:「允许手填」由全局开关改为按工位配置
-- 目标库:bj_power_mes。幂等,可重复执行;写入后直接在本地运行库执行,不挂起等待部署。
--
-- 背景:原全局键 sys_config.torque.manual.input(allow/forbid)已被代码废弃,
-- 新判据为每工位一条 sys_config.torque.gun.config.<工位号> 里的 manualInput 字段,
-- 与该工位控制器地址、枪1/2/3 通道号同存一条 JSON(见 internal/logic/torque_gun_config.go)。
--
-- 迁移规则:
-- 1) 全局 = allow、键不存在、或值非法 → 各工位 manualInput = allow(默认,虚拟工位必须能手填);
-- 2) 全局 = forbid → 仅「已有控制器地址」的工位 manualInput = forbid,其余仍 allow;
-- 避免无控制器工位既不能手填又没有拧紧枪可采集;
-- 3) 该工位记录里 manualInput 已是 allow/forbid → 视为人工配置,一律不覆盖;
-- 4) 工位清单真源 = station 表,不硬编码 1~12(含 14 等线下虚拟位)。
--
-- 说明:全局键 torque.manual.input 保留作历史,代码已无任何读取点;如需物理删除请单独确认。
DO $$
DECLARE
v_global text;
v_st record;
v_key text;
v_val jsonb;
v_mi text;
v_exists boolean;
BEGIN
SELECT value INTO v_global FROM sys_config WHERE key = 'torque.manual.input';
IF v_global IS NULL OR v_global NOT IN ('allow', 'forbid') THEN
v_global := 'allow';
END IF;
FOR v_st IN SELECT station_no FROM station ORDER BY station_no LOOP
v_key := 'torque.gun.config.' || v_st.station_no::text;
SELECT value::jsonb INTO v_val FROM sys_config WHERE key = v_key;
v_exists := FOUND;
IF v_val IS NULL THEN
v_val := '{}'::jsonb;
END IF;
-- 人工已配过开关的工位不覆盖,保证重复执行幂等
IF v_val ? 'manualInput' AND v_val->>'manualInput' IN ('allow', 'forbid') THEN
CONTINUE;
END IF;
v_mi := 'allow';
IF v_global = 'forbid' AND coalesce(v_val->>'controllerAddr', '') <> '' THEN
v_mi := 'forbid';
END IF;
v_val := v_val || jsonb_build_object('manualInput', v_mi);
IF v_exists THEN
UPDATE sys_config SET value = v_val::text WHERE key = v_key;
ELSE
INSERT INTO sys_config (id, key, value, remark)
VALUES (
(SELECT coalesce(max(id), 0) + 1 FROM sys_config),
v_key,
v_val::text,
'拧紧枪展示配置(含本工位允许手填开关)'
);
END IF;
END LOOP;
END $$;