PDA下发任务栏领取任务修改

mhd_wms/src/main/java/com/mhd/wms/interfaces/facadeApp/deliveTask/DeliveTaskAppApi.java

@@ -31,8 +31,9 @@ public class DeliveTaskAppApi extends BaseController {
     private DeliveTaskAssembler deliveTaskAssembler;
 
     /**
-     * 分页查询下发任务列表
-     * @return
+     * 分页查询下发任务列表。条件：del_flag=1、当前一级组织、请求参数 warehouseId、
+     * task_distribution_id=当前登录用户；不按 task_status 过滤（入参传入 taskStatus 时可选筛状态）。
+     * 与 PC 列表不同，不按 tabType/operators_by 过滤。
      */
     @ApiOperation("查询下发任务列表")
     @GetMapping("/list")

mhd_wms/src/main/java/com/mhd/wms/interfaces/facadeApp/reviewOrder/ReviewOrderAppApi.java

@@ -48,7 +48,7 @@ public class ReviewOrderAppApi extends BaseController {
      * 分页查询复核单列表（仅已下发任务，按当前用户仓库过滤）
      * <ul>
      *   <li>{@code tabType=2}：历史（{@code review_status=3} 已复核）</li>
-     *   <li>其它：待办（{@code review_status &lt; 3}，待复核/复核中）</li>
+     *   <li>其它：待办（{@code review_status &lt; 3}，待复核/复核中），且仅 {@code receive_time} 非空（已在下发任务中接收）</li>
      * </ul>
      */
     @ApiOperation("PDA 复核单列表（REVIEW_ORDER）")
@@ -104,7 +104,7 @@ public class ReviewOrderAppApi extends BaseController {
     }
 
     /**
-     * 完成复核确认（无待复核数量时可确认，同步出库明细并生成交接等，与 PC checkConfirm 一致）
+     * 完成复核确认（同步出库明细、生成交接作业单，并自动下发交接类 PDA 任务 delive_task/taskType=7，与拣货完成后自动复核下发对齐）
      */
     @ApiOperation("PDA 完成复核")
     @PostMapping("/completeCheck")

mhd_wms/src/main/java/com/mhd/wms/interfaces/facadeApp/stockReceiptOrder/StockReceiptOrderAppApi.java

@@ -132,16 +132,17 @@ public class StockReceiptOrderAppApi extends BaseController {
     }
 
     /**
-     * 完成收货
+     * 完成收货：生成上架单后自动创建上架类下发任务（delive_task.task_type=2，tracking_number=上架单号），
+     * 作业人 operators_by/operators_name 默认为空；作业人在 {@code DeliveTaskAppApi#receive} 接收任务后写入。
      */
-    @ApiOperation("完成收货")
+    @ApiOperation("完成收货（自动生成上架单及上架 delive_task，作业人须接收任务后才有）")
     @PostMapping("/completeReceipt")
     public AjaxResult completeReceipt(@RequestBody StockReceiptOrderDTO stockReceiptOrderDTO) {
         stockReceiptOrderApplicationService.updateInOrder(stockReceiptOrderDTO);
         return toAjax(stockReceiptOrderApplicationService.completeReceiptByApp(stockReceiptOrderDTO.getReceiptOrderId()));
     }
 
-    @ApiOperation("生成上架单")
+    @ApiOperation("生成上架单（PDA 路径同完成收货：自动上架 delive_task，作业人接收后赋值）")
     @PostMapping("/genStockShelfOrder")
     public AjaxResult genStockShelfOrder(@RequestBody StockReceiptOrderDTO stockReceiptOrderDTO) {
         return toAjax(stockReceiptOrderApplicationService.genStockShelfOrder(stockReceiptOrderDTO.getReceiptOrderId()));