94 lines
3.2 KiB
C#
94 lines
3.2 KiB
C#
using System;
|
||
using System.Threading.Tasks;
|
||
using HHWMS.Web.Models.Agv;
|
||
using HHWMS.Web.Services.Agv;
|
||
using Microsoft.AspNetCore.Mvc;
|
||
using Microsoft.Extensions.Options;
|
||
using WalkingTec.Mvvm.Core;
|
||
|
||
namespace HHWMS.Web.Controllers
|
||
{
|
||
/// <summary>
|
||
/// AGV 平库任务对外接口(方案 4.2)
|
||
/// 调用方向:AGV 调度系统 / 上游系统 → WMS
|
||
/// 接口:Receive(接单)、Callback(状态回调)
|
||
/// 鉴权:本期暂不实施,保持 Public 公开访问(AppKey/AppSecret 预留待后续启用)
|
||
/// </summary>
|
||
[Public]
|
||
[ActionDescription("AGV接口")]
|
||
[ApiController]
|
||
[Route("api/[controller]/[action]"), ApiExplorerSettings(GroupName = "User")]
|
||
public class AgvController : ApiController
|
||
{
|
||
private readonly AgvTaskService _taskService;
|
||
private readonly AgvOption _option;
|
||
|
||
public AgvController(AgvTaskService taskService, IOptions<AgvOption> option)
|
||
{
|
||
_taskService = taskService;
|
||
_option = option.Value;
|
||
}
|
||
|
||
/// <summary>
|
||
/// 接单:创建 AGV 任务(幂等 + 8 项校验 + LS 临时容器 + SKU 可选补建 + 接单落库即锁)
|
||
/// 参数与手动下任务页面保持一致
|
||
/// </summary>
|
||
[HttpPost]
|
||
public async Task<IActionResult> Receive(AgvReceiveRequest request)
|
||
{
|
||
try
|
||
{
|
||
if (!_option.Enabled)
|
||
{
|
||
return ApiResultError("AGV 模块已停用");
|
||
}
|
||
// API 入口:来源系统未传则默认 THIRD_PARTY(页面手动下发走 Service 默认 WMS)
|
||
if (string.IsNullOrWhiteSpace(request.SourceSystem))
|
||
{
|
||
request.SourceSystem = "THIRD_PARTY";
|
||
}
|
||
var task = await _taskService.CreateTaskAsync(request);
|
||
return ApiResult(new
|
||
{
|
||
TaskNo = task.TaskNo,
|
||
ContainerCode = task.ContainerCode,
|
||
AgvStatus = task.AgvStatus?.ToString()
|
||
});
|
||
}
|
||
catch (AgvBizException ex)
|
||
{
|
||
return ApiResultError($"接单失败: {ex.Message}");
|
||
}
|
||
catch (Exception ex)
|
||
{
|
||
return ApiResultError($"接单异常: {ex.Message}");
|
||
}
|
||
}
|
||
|
||
/// <summary>
|
||
/// 状态回调:AGV 事件 → 状态机单调推进(Accepted/ArrivedLoad/Loaded/ArrivedUnload/Unloaded/Error/Cancel)
|
||
/// </summary>
|
||
[HttpPost]
|
||
public async Task<IActionResult> Callback(AgvCallbackRequest request)
|
||
{
|
||
try
|
||
{
|
||
if (!_option.Enabled)
|
||
{
|
||
return ApiResultError("AGV 模块已停用");
|
||
}
|
||
await _taskService.HandleCallbackAsync(request);
|
||
return ApiResult(null);
|
||
}
|
||
catch (AgvBizException ex)
|
||
{
|
||
return ApiResultError($"回调处理失败: {ex.Message}");
|
||
}
|
||
catch (Exception ex)
|
||
{
|
||
return ApiResultError($"回调处理异常: {ex.Message}");
|
||
}
|
||
}
|
||
}
|
||
}
|