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_wms(MES 库另有一份同名脚本,两端各执行一次)
-- 背景:服务启动期禁止任何 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);