/*
 *      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.GdClueEventEntity;
import org.sxkj.gd.workorder.vo.GdClueEventCountVO;
import org.sxkj.gd.workorder.vo.GdClueEventListVO;
import org.sxkj.gd.workorder.vo.GdClueEventVO;
import org.sxkj.gd.workorder.excel.GdClueEventExcel;
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 GdClueEventMapper extends BaseMapper<GdClueEventEntity> {

	/**
	 * 自定义分页
	 *
	 * @param page
	 * @param gdClueEvent
	 * @return
	 */
	List<GdClueEventVO> selectGdClueEventPage(IPage page, GdClueEventVO gdClueEvent);

	/**
	 * 列表查询
	 *
	 * @param page
	 * @param queryWrapper
	 * @return
	 */
	List<GdClueEventVO> selectGdClueEventList(IPage page, @Param("ew") Wrapper<GdClueEventEntity> queryWrapper);

	/**
	 * 列表查询（不分页）
	 *
	 * @param deptId 部门ID
	 * @param userId 用户ID
	 * @param onlyMine 是否只查询我的工单
	 * @param keyword 事件编号关键字
	 * @param statusList 允许查询的状态列表
	 * @return 事件列表
	 */
	List<GdClueEventListVO> selectGdClueEventSimpleList(@Param("deptId") Long deptId, @Param("userId") Long userId,
			@Param("onlyMine") Integer onlyMine, @Param("keyword") String keyword, @Param("statusList") List<Integer> statusList);

	/**
	 * 列表查询（分页）
	 *
	 * @param page 分页对象
	 * @param deptId 部门ID
	 * @param userId 用户ID
	 * @param onlyMine 是否只查询我的工单
	 * @param keyword 事件编号关键字
	 * @param statusList 允许查询的状态列表
	 * @param startTime 开始时间
	 * @param endTime 结束时间
	 * @return 事件列表
	 */
	List<GdClueEventListVO> selectGdClueEventSimpleList(IPage<GdClueEventListVO> page, @Param("deptId") Long deptId,
			@Param("userId") Long userId, @Param("onlyMine") Integer onlyMine, @Param("keyword") String keyword,
			@Param("statusList") List<Integer> statusList, @Param("startTime") String startTime,
			@Param("endTime") String endTime);

	/**
	 * 详情查询
	 *
	 * @param id
	 * @param deptId
	 * @return
	 */
	GdClueEventVO selectGdClueEventDetailById(@Param("id") Long id, @Param("deptId") Long deptId);

	/**
	 * 数量统计
	 *
	 * @param deptId 部门ID
	 * @param userId 用户ID
	 * @param keyword 事件编号关键字
	 * @param statusList 允许查询的状态列表
	 * @return 统计数据
	 */
	GdClueEventCountVO selectGdClueEventCount(@Param("deptId") Long deptId, @Param("userId") Long userId,
			@Param("keyword") String keyword, @Param("statusList") List<Integer> statusList);


	/**
	 * 获取导出数据
	 *
	 * @param queryWrapper
	 * @return
	 */
	List<GdClueEventExcel> exportGdClueEvent(@Param("ew") Wrapper<GdClueEventEntity> queryWrapper);

}