@RequestMapping("/inbound")  // 保持不变
public class InboundController {

    // GET /api/v1/inbound/orders?current=1&size=20&tenantId=1
    @GetMapping("/orders")
    public Result<Page<InboundOrder>> getOrdersByPage(...)

    // GET /api/v1/inbound/orders/{id}
    @GetMapping("/orders/{id}")

    // GET /api/v1/inbound/orders/no/{orderNo}
    @GetMapping("/orders/no/{orderNo}")

    // POST /api/v1/inbound/orders
    @PostMapping("/orders")

    // PUT /api/v1/inbound/orders/{id}
    @PutMapping("/orders/{id}")

    // DELETE /api/v1/inbound/orders/{id}
    @DeleteMapping("/orders/{id}")

    // POST /api/v1/inbound/orders/{id}/confirm
    @PostMapping("/orders/{id}/confirm")

    // POST /api/v1/inbound/orders/{id}/receive
    @PostMapping("/orders/{id}/receive")

    // GET /api/v1/inbound/orders/{orderId}/lines
    @GetMapping("/orders/{orderId}/lines")

    // POST /api/v1/inbound/orders/{id}/complete
    @PostMapping("/orders/{id}/complete")

    // POST /api/v1/inbound/orders/{id}/cancel
    @PostMapping("/orders/{id}/cancel")
}

@RequestMapping("/outbound")
public class OutboundController {

    @GetMapping("/orders")  // 分页查询
    @GetMapping("/orders/{id}")  // 详情查询
    @GetMapping("/orders/no/{orderNo}")  // 单号查询
    @PostMapping("/orders")  // 创建
    @PutMapping("/orders/{id}")  // 更新
    @DeleteMapping("/orders/{id}")  // 删除
    @PostMapping("/orders/{id}/confirm")  // 确认
    @PostMapping("/orders/{id}/allocate")  // 分配库存
    @PostMapping("/orders/{id}/start-picking")  // 开始拣货
    @PostMapping("/orders/{id}/complete-picking")  // 完成拣货
    @PostMapping("/orders/{id}/start-checking")  // 开始复核
    @PostMapping("/orders/{id}/complete-checking")  // 完成复核
    @PostMapping("/orders/{id}/ship")  // 发货
    @PostMapping("/orders/{id}/cancel")  // 取消
    @GetMapping("/orders/{orderId}/lines")  // 获取明细
}

public class Result<T> {
    private Integer code;     // 200成功, 其他失败
    private String message;
    private T data;
    private Long timestamp;
}

public interface InventoryReservationService {
    // 创建预留
    InventoryReservation reserve(ReservationRequest request);

    // 使用预留
    void use(Long reservationId, BigDecimal quantity);

    // 释放预留
    void release(Long reservationId);

    // 过期预留自动释放(定时任务)
    void autoReleaseExpired();

    // 查询预留
    List<InventoryReservation> findByBusinessNo(String businessNo);
}

public class ReceiveDifference {
    private Long lineId;
    private BigDecimal plannedQty;      // 计划数量
    private BigDecimal receivedQty;     // 实收数量
    private BigDecimal differenceQty;   // 差异数量
    private String differenceType;      // MORE多收, LESS少收, DAMAGE破损
    private String differenceReason;    // 差异原因
    private String handleMethod;        // 处理方式: ACCEPT接受, REJECT拒收, REPORT上报
}

@RestController
@RequestMapping("/pda")
public class PDAController {

    // PDA登录
    @PostMapping("/auth/login")
    public Result<PDASession> login(@RequestBody PDALoginRequest request);

    // 扫描条码解析
    @PostMapping("/barcode/scan")
    public Result<BarcodeInfo> scanBarcode(@RequestBody ScanRequest request);

    // 查询产品信息
    @GetMapping("/products/{code}")
    public Result<ProductInfo> getProductByCode(@PathVariable String code);

    // 查询库位信息
    @GetMapping("/locations/{code}")
    public Result<LocationInfo> getLocationByCode(@PathVariable String code);

    // 查询库存
    @PostMapping("/inventory/query")
    public Result<List<InventoryInfo>> queryInventory(@RequestBody QueryRequest request);

    // === 入库操作 ===
    // 获取待收货任务
    @GetMapping("/inbound/tasks")
    public Result<List<InboundTask>> getInboundTasks();

    // 扫码收货
    @PostMapping("/inbound/receive")
    public Result<ReceiveResult> receive(@RequestBody ReceiveRequest request);

    // 扫码上架
    @PostMapping("/inbound/putaway")
    public Result<PutawayResult> putaway(@RequestBody PutawayRequest request);

    // === 出库操作 ===
    // 获取拣货任务
    @GetMapping("/outbound/picking-tasks")
    public Result<List<PickingTask>> getPickingTasks();

    // 扫码拣货
    @PostMapping("/outbound/pick")
    public Result<PickResult> pick(@RequestBody PickRequest request);

    // 扫码复核
    @PostMapping("/outbound/check")
    public Result<CheckResult> check(@RequestBody CheckRequest request);

    // === 移库操作 ===
    // 获取移库任务
    @GetMapping("/transfer/tasks")
    public Result<List<TransferTask>> getTransferTasks();

    // 扫码移库
    @PostMapping("/transfer/move")
    public Result<MoveResult> move(@RequestBody MoveRequest request);

    // === 盘点操作 ===
    // 获取盘点任务
    @GetMapping("/stocktaking/tasks")
    public Result<List<StocktakingTask>> getStocktakingTasks();

    // 扫码盘点
    @PostMapping("/stocktaking/count")
    public Result<CountResult> count(@RequestBody CountRequest request);

    // 提交盘点结果
    @PostMapping("/stocktaking/submit")
    public Result<Void> submitStocktaking(@RequestBody SubmitRequest request);
}

/**
 * 智能波次算法
 * 根据订单特征自动分波
 */
public class SmartWaveStrategy {

    /**
     * 按区域分波
     * 同一拣货区域的订单分到一个波次
     */
    public List<WaveOrder> allocateByZone(List<OutboundOrder> orders);

    /**
     * 按客户分波
     * 同一客户的多个订单合并
     */
    public List<WaveOrder> allocateByCustomer(List<OutboundOrder> orders);

    /**
     * 按时效分波
     * 紧急订单优先,时效相同的合并
     */
    public List<WaveOrder> allocateByPriority(List<OutboundOrder> orders);

    /**
     * 混合策略
     * 综合考虑区域、时效、订单量
     */
    public List<WaveOrder> allocateBySmart(List<OutboundOrder> orders);
}

/**
 * 拣货路径优化算法
 * 基于TSP(旅行商问题)求解最短拣货路径
 */
public class PickingPathOptimizer {

    /**
     * S型路径: 按货架顺序依次拣货
     */
    public List<PickingTask> optimizeBySType(List<Location> locations);

    /**
     * Z型路径: 之字形穿越货架
     */
    public List<PickingTask> optimizeByZType(List<Location> locations);

    /**
     * 最短路径: 使用遗传算法计算
     */
    public List<PickingTask> optimizeByShortestPath(List<Location> locations);
}

@RestController
@RequestMapping("/print")
public class PrintController {

    // 打印入库标签
    @PostMapping("/inbound/label")
    public Result<String> printInboundLabel(@RequestBody PrintRequest request);

    // 打印拣货单
    @PostMapping("/picking/list")
    public Result<String> printPickingList(@RequestBody PrintRequest request);

    // 打印发货标签
    @PostMapping("/shipping/label")
    public Result<String> printShippingLabel(@RequestBody PrintRequest request);

    // 打印库位标签
    @PostMapping("/location/label")
    public Result<String> printLocationLabel(@RequestBody PrintRequest request);
}