/*
 *      Copyright (c) 2018-2028, Chill Zhuang All rights reserved.
 *
 *  Redistribution and use in source and binary forms, with or without
 *  modification, are permitted provided that the following conditions are met:
 *
 *  Redistributions of source code must retain the above copyright notice,
 *  this list of conditions and the following disclaimer.
 *  Redistributions in binary form must reproduce the above copyright
 *  notice, this list of conditions and the following disclaimer in the
 *  documentation and/or other materials provided with the distribution.
 *  Neither the name of the dreamlu.net developer nor the names of its
 *  contributors may be used to endorse or promote products derived from
 *  this software without specific prior written permission.
 *  Author: Chill 庄骞 (smallchill@163.com)
 */
package org.sxkj.gd.workorder.mapper;

import org.sxkj.gd.workorder.entity.GdPatrolTaskEntity;
import org.sxkj.gd.workorder.entity.GdWorkOrderEntity;
import org.sxkj.gd.workorder.param.GdPatrolTaskPageParam;
import org.sxkj.gd.workorder.param.GdPatrolTaskPendingAcceptanceQueryParam;
import org.sxkj.gd.workorder.vo.GdPatrolTaskSimpleVO;
import org.sxkj.gd.workorder.vo.GdPatrolTaskVO;
import org.sxkj.gd.workorder.excel.GdPatrolTaskExcel;
import com.baomidou.mybatisplus.core.mapper.BaseMapper;
import com.baomidou.mybatisplus.core.conditions.Wrapper;
import com.baomidou.mybatisplus.core.metadata.IPage;
import org.apache.ibatis.annotations.Param;
import java.util.List;

/**
 * 巡查任务表 Mapper 接口
 *
 * @author lw
 * @since 2026-01-14
 */
public interface GdPatrolTaskMapper extends BaseMapper<GdPatrolTaskEntity> {

    /**
     * 自定义分页
     *
     * @param page
     * @param gdPatrolTask
     * @return
     */
    List<GdPatrolTaskVO> selectGdPatrolTaskPage(IPage page, GdPatrolTaskPageParam gdPatrolTask);


    /**
     * 获取导出数据
     *
     * @param queryWrapper
     * @return
     */
    List<GdPatrolTaskExcel> exportGdPatrolTask(@Param("ew") Wrapper<GdPatrolTaskEntity> queryWrapper);

    /**
     * 更新工单状态
     *
     * @param workOrderParam 工单实体
     * @return 更新影响行数
     */
    Integer updateWorkOrderById(@Param("workOrderParam") GdWorkOrderEntity workOrderParam);

	/**
	 * 获取巡查任务详情
	 * @param patrolTaskId
	 * @return
	 */
	GdPatrolTaskVO getPatrolTaskIdById(Long patrolTaskId);

	/**
	 *
	 * @param gdPatrolTaskEntity
	 * @return
	 */
    GdPatrolTaskVO getPatrolTaskDetail(GdPatrolTaskEntity gdPatrolTaskEntity);

	/**
	 *
	 * @param id
	 * @param code
	 * @return
	 */
	GdWorkOrderEntity getWorkOrderIdById(Long id, String code);

	/**
	 * 根据工单ID查询巡查任务列表（仅id和名称）
	 *
	 * @param workOrderId 工单ID
	 * @return 巡查任务列表
	 */
	List<GdPatrolTaskSimpleVO> selectListByWorkOrderId(@Param("workOrderId") Long workOrderId);

	/**
	 * 查询待验收状态的巡查任务列表（对外接口）
	 *
	 * @param queryParam 查询参数，包含任务名称和时间区间
	 * @return 待验收状态的巡查任务列表
	 */
	List<GdPatrolTaskVO> selectPendingAcceptanceTasks(@Param("queryParam") GdPatrolTaskPendingAcceptanceQueryParam queryParam);
}