package com.ruoyi.asset.service;

import java.util.List;
import com.ruoyi.asset.domain.AmsInventoryTask;
import com.ruoyi.asset.domain.AmsInventoryTaskSurplus;

/**
 * 盘点任务管理Service接口
 *
 * @author Yangk
 * @date 2026-06-18
 */
public interface IAmsInventoryTaskService
{
    /**
     * 查询盘点任务管理
     *
     * @param taskId 盘点任务管理主键
     * @return 盘点任务管理
     */
    public AmsInventoryTask selectAmsInventoryTaskByTaskId(Long taskId);

    /**
     * 查询盘点任务管理列表
     *
     * @param amsInventoryTask 盘点任务管理
     * @return 盘点任务管理集合
     */
    public List<AmsInventoryTask> selectAmsInventoryTaskList(AmsInventoryTask amsInventoryTask);

    /**
     * 新增盘点任务管理
     *
     * @param amsInventoryTask 盘点任务管理
     * @return 结果
     */
    public int insertAmsInventoryTask(AmsInventoryTask amsInventoryTask, Long ownerUserId, String ownerUserName);

    /**
     * 修改盘点任务管理
     *
     * @param amsInventoryTask 盘点任务管理
     * @return 结果
     */
    public int updateAmsInventoryTask(AmsInventoryTask amsInventoryTask);

    /**
     * 下发盘点任务，按范围生成资产快照明细
     *
     * @param taskId 盘点任务ID
     * @param operateLoginName 操作登录账号
     * @return 结果
     */
    public int issueTask(Long taskId, String operateLoginName);

    /**
     * 提交盘点结果，进入待确认状态
     *
     * @param amsInventoryTask 盘点任务及明细结果
     * @param operateUserId 操作用户ID
     * @param operateUserName 操作用户名称
     * @param operateLoginName 操作登录账号
     * @return 结果
     */
    public int submitResult(AmsInventoryTask amsInventoryTask, Long operateUserId, String operateUserName,
            String operateLoginName);

    /**
     * 新增盘点任务盘盈明细
     *
     * @param surplus 盘盈明细
     * @param operateUserId 操作用户ID
     * @param operateUserName 操作用户名称
     * @param operateLoginName 操作登录账号
     * @return 结果
     */
    public int addSurplusItem(AmsInventoryTaskSurplus surplus, Long operateUserId, String operateUserName,
            String operateLoginName);

    /**
     * 删除盘点任务盘盈明细
     *
     * @param surplusId 盘盈明细ID
     * @param operateLoginName 操作登录账号
     * @return 结果
     */
    public int deleteSurplusItem(Long surplusId, String operateLoginName);

    /**
     * 确认盘点结果，只确认任务事实，不调整资产台账，也不写资产履历
     *
     * @param taskId 盘点任务ID
     * @param operateUserId 操作用户ID
     * @param operateUserName 操作用户名称
     * @param operateLoginName 操作登录账号
     * @return 结果
     */
    public int confirmResult(Long taskId, Long operateUserId, String operateUserName, String operateLoginName);

    /**
     * 关闭未完成盘点任务
     *
     * @param taskId 盘点任务ID
     * @param operateLoginName 操作登录账号
     * @return 结果
     */
    public int closeTask(Long taskId, String operateLoginName);

    /**
     * 批量删除盘点任务管理
     *
     * @param taskIds 需要删除的盘点任务管理主键集合
     * @return 结果
     */
    public int deleteAmsInventoryTaskByTaskIds(String taskIds);

    /**
     * 删除盘点任务管理信息
     *
     * @param taskId 盘点任务管理主键
     * @return 结果
     */
    public int deleteAmsInventoryTaskByTaskId(Long taskId);
}
