package com.zy.asrs.service;

import com.baomidou.mybatisplus.service.IService;
import com.core.common.R;
import com.zy.asrs.entity.LocCache;
import com.zy.asrs.entity.param.LocMastInitParam;

public interface LocCacheService extends IService<LocCache> {


    /**
     * @author Ryan
     * @date 2025/9/18
     * @description: 初始化库区库位
     * @version 1.0
     */
    R initLocCache(LocMastInitParam param, Long userId);

    /**
     * 锁定/解锁缓存库位
     * @param locNo 库位号
     * @param lock 是否锁定，true-锁定，false-解锁
     * @param fullPlt 是否满托，true-满托（设置为F），false-空托（设置为D），解锁时忽略此参数
     * @param userId 用户ID
     * @return 操作结果
     */
    R lockOrUnlockLocCache(String locNo, Boolean lock, Boolean fullPlt, Long userId);

    /**
     * 锁定/解锁当前排的所有库位
     * @param locNo 库位号（用于获取排号）
     * @param lock 是否锁定，true-锁定，false-解锁
     * @param fullPlt 是否满托，true-满托（设置为F），false-空托（设置为D），解锁时忽略此参数
     * @param userId 用户ID
     * @return 操作结果
     */
    R lockOrUnlockRowLocCache(String locNo, Boolean lock, Boolean fullPlt, Long userId);

    /**
     * 锁定/解锁当前列的所有库位
     * @param locNo 库位号（用于获取列号bay1）
     * @param lock 是否锁定，true-锁定，false-解锁
     * @param fullPlt 是否满托，true-满托（设置为F），false-空托（设置为D），解锁时忽略此参数
     * @param userId 用户ID
     * @return 操作结果
     */
    R lockOrUnlockBayLocCache(String locNo, Boolean lock, Boolean fullPlt, Long userId);

    /**
     * 清空整排的所有库位（所有列）
     * @param locNo 库位号（用于获取排号row1）
     * @param lock 是否锁定，true-锁定，false-解锁（清空）
     * @param fullPlt 是否满托，true-满托（设置为F），false-空托（设置为D），解锁时忽略此参数
     * @param userId 用户ID
     * @return 操作结果
     */
    R clearAllColumnsInRow(String locNo, Boolean lock, Boolean fullPlt, Long userId);
}