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
+69 -4
View File
@@ -151,7 +151,8 @@ type DeliveryAgvItem struct {
Qty float64 `json:"qty"`
}
// getJSON MES GET 通用(带 token;返回 body 的 data 字段)
// getJSON MES GET 通用(带 token;返回 body 的 data 字段)。
// 2026-11-09 缺陷修复:同 postJSON——HTTP 200 + 业务码≠0 也透出错误原文。
func (c *Client) getJSON(ctx context.Context, path string, out any) error {
req, err := http.NewRequestWithContext(ctx, http.MethodGet, c.baseURL+path, nil)
if err != nil {
@@ -175,19 +176,29 @@ func (c *Client) getJSON(ctx context.Context, path string, out any) error {
return fmt.Errorf("MES 返回 HTTP %d", resp.StatusCode)
}
var env struct {
Code int `json:"code"`
Data json.RawMessage `json:"data"`
Code int `json:"code"`
Message string `json:"message"`
Data json.RawMessage `json:"data"`
}
if err := json.Unmarshal(raw, &env); err != nil {
return err
}
if env.Code != 0 {
if env.Message != "" {
return fmt.Errorf("MES 业务错误(code=%d): %s", env.Code, env.Message)
}
return fmt.Errorf("MES 业务错误 code=%d", env.Code)
}
if out != nil && len(env.Data) > 0 {
return json.Unmarshal(env.Data, out)
}
return nil
}
// postJSON MES POST 通用(带 token;非 2xx 透出业务错误原文)
// postJSON MES POST 通用(带 token)。
// 2026-11-09 缺陷修复:MES 业务失败 = HTTP 200 + code≠0(common/httpx.Fail),
// 此前只透出非 2xx,HTTP 200 的业务拒绝(如派车点位冲突)被当成功 → 上游假成功。
// 现统一解包 envelope:非 2xx 或业务码≠0 均透出错误原文。
func (c *Client) postJSON(ctx context.Context, path string, body any) error {
b, _ := json.Marshal(body)
req, err := http.NewRequestWithContext(ctx, http.MethodPost, c.baseURL+path, bytes.NewReader(b))
@@ -212,6 +223,17 @@ func (c *Client) postJSON(ctx context.Context, path string, body any) error {
}
return fmt.Errorf("MES 返回 HTTP %d", resp.StatusCode)
}
var env struct {
Code int `json:"code"`
Message string `json:"message"`
}
_ = json.Unmarshal(raw, &env)
if env.Code != 0 {
if env.Message != "" {
return fmt.Errorf("MES 业务错误(code=%d): %s", env.Code, env.Message)
}
return fmt.Errorf("MES 业务错误 code=%d", env.Code)
}
return nil
}
@@ -763,6 +785,39 @@ func (c *Client) UpsertMaterial(ctx context.Context, m MaterialUpsert) error {
return nil
}
// CallStatus 查询 MES 叫料单状态(同步失败台账重试前判对端终态)。
// 已 SHIPPED/DONE 说明通知其实已成功,台账直接置 SUCCESS,不再重放。
func (c *Client) CallStatus(ctx context.Context, requestNo string) (string, error) {
req, err := http.NewRequestWithContext(ctx, http.MethodGet,
c.BaseURL()+"/api/internal/call/status?requestNo="+url.QueryEscape(requestNo), nil)
if err != nil {
return "", err
}
req.Header.Set("X-API-TOKEN", c.token)
resp, err := c.hc.Do(req)
if err != nil {
return "", err
}
defer resp.Body.Close()
if resp.StatusCode >= 300 {
return "", &RespError{Status: resp.StatusCode}
}
var env struct {
Code int `json:"code"`
Message string `json:"message"`
Data struct {
Status string `json:"status"`
} `json:"data"`
}
if err := json.NewDecoder(resp.Body).Decode(&env); err != nil {
return "", err
}
if env.Code != 0 {
return "", errors.New(env.Message)
}
return env.Data.Status, nil
}
// CallComplete 通知 MES 仓库已完成备料(B5):实发量 + WMS 出库单号。
// MES 侧只做状态迁移(PENDING→SHIPPED)与四数账记账,不反向调 WMS 出库。
func (c *Client) CallComplete(ctx context.Context, requestNo string, sentQty float64, outboundNo, operator string) error {
@@ -786,6 +841,16 @@ func (c *Client) CallReturnConfirm(ctx context.Context, requestNo, operator stri
return c.postInternal(ctx, "/api/internal/call/return-confirm", b, "MES 叫料单退库确认回写失败")
}
// PostRaw 同步失败台账人工重试:按 endpoint 原样重放通知请求体。
// 只重放通知,绝不重跑任何本地业务(如 doGeneralOutbound 出库扣减)。
func (c *Client) PostRaw(ctx context.Context, path string, payload map[string]any) error {
b, err := json.Marshal(payload)
if err != nil {
return err
}
return c.postInternal(ctx, path, b, "同步失败重试")
}
// postInternal 通用内部 POST:带 X-API-TOKEN;解析 MES 业务错误(HTTP 200 + body{code≠0} 必须判读)
func (c *Client) postInternal(ctx context.Context, path string, body []byte, errPrefix string) error {
req, err := http.NewRequestWithContext(ctx, http.MethodPost, c.baseURL+path, bytes.NewReader(body))