package com.fs.provider.service;

import java.util.List;

import com.fs.provider.domain.ServiceGenConfig;
import com.fs.provider.domain.ServiceOrder;
import com.fs.provider.vo.ServiceOrderAuditReqVO;
import com.fs.provider.vo.ServiceOrderAuditRespVO;
import com.fs.provider.vo.ServiceOrderInfoVO;
import com.fs.provider.vo.ServiceOrderStatisticsReqVO;
import com.fs.provider.vo.ServiceOrderStatisticsVO;
import com.fs.task.domain.ServiceGenResult;
import com.fs.task.vo.GetTaskCompleteStatsVO;

/**
 * 服务单信息Service接口
 *
 * @author fs
 * @date 2026-01-26
 */
public interface IServiceOrderService
{
    /**
     * 查询服务单信息
     *
     * @param id 服务单信息主键
     * @return 服务单信息
     */
    public ServiceOrderInfoVO selectServiceOrderById(Long id);

    /**
     * 服务单统计查询
     * @param getTaskCompleteStatsVO VO
     * @return List<ServiceOrder>
     */
    List<ServiceOrder> queryStatis(GetTaskCompleteStatsVO getTaskCompleteStatsVO);

    /**
     * 服务单统计汇总（按部门分组）
     *
     * @param reqVO 查询条件
     * @return 统计结果列表
     */
    List<ServiceOrderStatisticsVO> getServiceOrderStatistics(ServiceOrderStatisticsReqVO reqVO);

    /**
     * 查询服务单信息列表
     *
     * @param serviceOrder 服务单信息
     * @return 服务单信息集合
     */
    public List<ServiceOrder> selectServiceOrderList(ServiceOrder serviceOrder);

    /**
     * 新增服务单信息
     *
     * @param serviceOrder 服务单信息
     * @return 结果
     */
    public int insertServiceOrder(ServiceOrder serviceOrder);

    /**
     * 修改服务单信息
     *
     * @param serviceOrder 服务单信息
     * @return 结果
     */
    public int updateServiceOrder(ServiceOrder serviceOrder);

    /**
     * 批量删除服务单信息
     *
     * @param ids 需要删除的服务单信息主键集合
     * @return 结果
     */
    public int deleteServiceOrderByIds(Long[] ids);

    /**
     * 删除服务单信息信息
     *
     * @param id 服务单信息主键
     * @return 结果
     */
    public int deleteServiceOrderById(Long id);

    int generateByTaskId(Long taskId);

    ServiceOrderAuditRespVO getAuditInfo(ServiceOrderAuditReqVO serviceOrderAuditReqVO);

    void autoConfirmAndSettleIfNeeded(Long id);

    ServiceGenResult generateByConfig(ServiceGenConfig cfg);

    Long selectServiceOrderStatCount(ServiceOrderStatisticsReqVO reqVO);

}
