/*
 *      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.service;

import com.baomidou.mybatisplus.core.conditions.Wrapper;
import com.baomidou.mybatisplus.core.metadata.IPage;
import org.springblade.core.mp.base.BaseService;
import org.springblade.core.tool.api.R;
import org.sxkj.gd.workorder.entity.GdPatrolTaskEntity;
import org.sxkj.gd.workorder.excel.GdPatrolTaskExcel;
import org.sxkj.gd.workorder.param.GdPatrolTaskAuditParam;
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 java.util.List;

/**
 * 巡查任务表 服务类
 *
 * @author lw
 * @since 2026-01-14
 */
public interface IGdPatrolTaskService extends BaseService<GdPatrolTaskEntity> {
	/**
	 * 自定义分页
	 *
	 * @param page
	 * @param gdPatrolTask
	 * @return
	 */
	IPage<GdPatrolTaskVO> selectGdPatrolTaskPage(IPage<GdPatrolTaskVO> page, GdPatrolTaskPageParam gdPatrolTask);


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

	/**
	 * 批量保存或更新
	 * @param taskEntityList
	 * @return
	 */
	boolean savePatrolTask(List<GdPatrolTaskEntity> taskEntityList);

	/**
	 * 审核巡查任务
	 * @param auditParam
	 * @return
	 */
	boolean auditPatrolTask(GdPatrolTaskAuditParam auditParam);

	/**
	 * 更新单个巡查任务信息
	 * @param taskEntity 巡查任务实体
	 * @return 更新后的任务状态枚举
	 */
	boolean republishPatrolTask(GdPatrolTaskEntity taskEntity);

	/**
	 * 生成巡查报告
	 *
	 * @param patrolTaskId 巡查任务主键
	 * @return 是否上传附件成果成功
	 */
	boolean exportPatrolReport(Long patrolTaskId);

	/**
	 * 推送巡查任务到星图平台（新增飞行任务）
	 *
	 * @param patrolTaskId 巡查任务主键
	 * @return 接口响应
	 */
	R pushXingtuFlyTask(Long patrolTaskId);

	/**
	 * 获取巡查任务详情
	 * @param gdPatrolTaskEntity
	 * @return
	 */
    GdPatrolTaskVO getPatrolTaskDetail(GdPatrolTaskEntity gdPatrolTaskEntity);

	/**
	 *
	 * @param auditParam
	 * @return
	 */
	boolean updatePatrolTaskById(GdPatrolTaskEntity auditParam);

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

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