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}"); } } } }