feat: 退料闭环定稿(损耗台账/备料清单/退料AGV自动派车/剩余量参考)+ 工位托盘守卫

- MES 新增损耗台账 loss_ledger,差异确认损耗接口 ConfirmReceiveLoss(按工单归集)
- 备料清单 preparation:MES 按 日计划×工单×工位×物料 实时计算,WMS 只读展示 PreparationList
- 退料闭环:N5 工位托盘守卫(未完成禁止退料)、退料 AGV 自动派车(JBT21 空位判定 + 托盘回收链路)、退料参考剩余量接口(应剩余=实备-已耗-已退-已损)
- 新增 AGV 车辆状态表 agv_vehicle_state 及查询
- 整合接驳台/叫料池/库存锁既有闭环,清理 sql 目录注释生成脚本与 catalog,更新文档
This commit is contained in:
SunYF
2026-11-04 19:06:03 +08:00
parent 42bcf395d2
commit 46fcb59079
123 changed files with 10666 additions and 3227 deletions
+11 -10
View File
@@ -25,8 +25,9 @@ type Client interface {
// SubmitTask 下发搬运任务 fromDock -> toDock。taskCode 为我方任务单号(透传给 RCS 便于回查)。
// 成功返回该 taskCode(RCS-Lite 不下发明文任务码,以我方 taskCode 为唯一追踪键)。
SubmitTask(ctx context.Context, taskCode, fromDock, toDock, carrierCode string) (string, error)
// QueryTask 查询任务状态,返回 RCS 数字状态:"1"已创建/"2"执行中/"5"取消完成/"9"已结束。
QueryTask(ctx context.Context, taskCode string) (string, error)
// QueryTask 查询任务状态,返回 RCS 数字状态:"1"已创建/"2"执行中/"5"取消完成/"9"已结束;
// 第二返回值为 RCS 分配的车辆编号 agvCode(任务分车后回传,用于绑定 agv_vehicle_state;可能为空)。
QueryTask(ctx context.Context, taskCode string) (status string, agvCode string, err error)
// CancelTask 取消任务(按 taskCode)。
CancelTask(ctx context.Context, taskCode, reason string) error
// QueryAgvStatus 只读获取车辆状态(3.1.7 queryAgvStatus):车辆闲忙/充电/电量/位置。
@@ -172,8 +173,8 @@ type queryTaskData struct {
}
// QueryTask 实现 Client:查询任务状态(queryTaskStatus)。
// 按 taskCode 查询,返回匹配项的 taskStatus(数字字符串);无匹配视为刚创建("1")。
func (c *realClient) QueryTask(ctx context.Context, taskCode string) (string, error) {
// 按 taskCode 查询,返回匹配项的 taskStatus(数字字符串)与 RCS 分配的 agvCode;无匹配视为刚创建("1")。
func (c *realClient) QueryTask(ctx context.Context, taskCode string) (string, string, error) {
payload := map[string]any{
"agvCode": "",
"taskCodes": []string{taskCode},
@@ -182,14 +183,14 @@ func (c *realClient) QueryTask(ctx context.Context, taskCode string) (string, er
Data []queryTaskData `json:"data"`
}
if err := c.call(ctx, "/queryTaskStatus", payload, &out); err != nil {
return "", err
return "", "", err
}
for _, d := range out.Data {
if d.TaskCode == taskCode && d.TaskStatus != "" {
return d.TaskStatus, nil
return d.TaskStatus, d.AgvCode, nil
}
}
return "1", nil
return "1", "", nil
}
// CancelTask 实现 Client:取消任务(cancelTask,按 taskCode)。
@@ -263,9 +264,9 @@ func (m *mockClient) SubmitTask(ctx context.Context, taskCode, fromDock, toDock,
return taskCode, nil
}
func (m *mockClient) QueryTask(ctx context.Context, taskCode string) (string, error) {
// 模拟:MOCK 任务一律视为已结束,便于离线联调观察"待搬运→已到位"
return "9", nil
func (m *mockClient) QueryTask(ctx context.Context, taskCode string) (string, string, error) {
// 模拟:MOCK 任务一律视为已结束,便于离线联调观察"待搬运→已到位";模拟模式无真实分车,agvCode 为空
return "9", "", nil
}
func (m *mockClient) CancelTask(ctx context.Context, taskCode, reason string) error {