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
{
///
/// AGV 平库任务对外接口(方案 4.2)
/// 调用方向:AGV 调度系统 / 上游系统 → WMS
/// 接口:Receive(接单)、Callback(状态回调)
/// 鉴权:本期暂不实施,保持 Public 公开访问(AppKey/AppSecret 预留待后续启用)
///
[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 option)
{
_taskService = taskService;
_option = option.Value;
}
///
/// 接单:创建 AGV 任务(幂等 + 8 项校验 + LS 临时容器 + SKU 可选补建 + 接单落库即锁)
/// 参数与手动下任务页面保持一致
///
[HttpPost]
public async Task 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}");
}
}
///
/// 状态回调:AGV 事件 → 状态机单调推进(Accepted/ArrivedLoad/Loaded/ArrivedUnload/Unloaded/Error/Cancel)
///
[HttpPost]
public async Task 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}");
}
}
}
}