fix: 任务定位

nl-framework/nl-spring-boot-starter-execute/src/main/java/cn/code/nl/framework/execute/core/AbstractTask.java

@@ -1,28 +1,53 @@
 package cn.code.nl.framework.execute.core;
 
+import cn.code.nl.framework.execute.core.dto.TaskExecuteDTO;
+
 /**
  * 抽象类任务契约
  * LMS/WMS子类遵守
+ * owner_service：定位服务
+ * handle_code：定位bean对象（子类任务）
  *
  * @Author: liyongde
  * @Date: 2026/7/15 11:21
  */
 public abstract class AbstractTask {
 
-    // ========== 取货完成、完成、取消的逻辑 ==========
-    public void doHandlePicked(Long taskId) {
+    // ========== 任务状态变化 ==========
+    /** 完成任务逻辑 */
+    public abstract void doHandleFinish(TaskExecuteDTO taskExecuteDTO);
+
+    /** 取消任务逻辑 */
+    public abstract void doHandleCancel(TaskExecuteDTO taskExecuteDTO);
+
+    // ========== 行为动作 ==========
+    /** 取货完成逻辑 */
+    public void doHandlePicked(TaskExecuteDTO taskExecuteDTO) {
         // 子类实现取货完成业务
     }
 
-    public abstract void doHandleFinish(Long taskId);
-
-    public abstract void doHandleCancel(Long taskId);
-
-    /**
-     * 二次请求
-     * @param taskId：任务id
-     */
-    public Long againApply(Long taskId) {
+    /** 二次请求逻辑 */
+    public String againApply(TaskExecuteDTO taskExecuteDTO) {
         return null;
     }
+
+    /** 请求放货*/
+    public Boolean requestPutAway(TaskExecuteDTO taskExecuteDTO) {
+        return true;
+    }
+
+    /** 请求取货 */
+    public Boolean requestPickGoods(TaskExecuteDTO taskExecuteDTO) {
+        return true;
+    }
+
+    /** 请求进入 */
+    public Boolean requestIn(TaskExecuteDTO taskExecuteDTO) {
+        return true;
+    }
+
+    /** 请求离开 */
+    public Boolean requestOut(TaskExecuteDTO taskExecuteDTO) {
+        return true;
+    }
 }

nl-framework/nl-spring-boot-starter-execute/src/main/java/cn/code/nl/framework/execute/core/dto/TaskExecuteDTO.java

@@ -0,0 +1,23 @@
+package cn.code.nl.framework.execute.core.dto;
+
+import io.swagger.v3.oas.annotations.media.Schema;
+import jakarta.validation.constraints.NotNull;
+import lombok.Data;
+
+import java.util.Map;
+
+/**
+ * 任务执行操作的dto
+ * @Author: liyongde
+ * @Date: 2026/7/16 14:57
+ */
+@Data
+public class TaskExecuteDTO {
+
+    @Schema(description = "任务id")
+    @NotNull(message = "任务ID不能为空")
+    private Long taskId;
+
+    @Schema(description = "ACS反馈扩展数据")
+    private Map<String, Object> payload;
+}