/*
 *      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 org.sxkj.gd.workorder.entity.GdClueEventEntity;
import org.sxkj.gd.workorder.param.GdClueEventDistributeParam;
import org.sxkj.gd.workorder.param.GdClueEventRejectParam;
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.metadata.IPage;
import org.springblade.core.mp.base.BaseService;
import java.util.List;

/**
 * 事件表（线索事件） 服务类
 *
 * @author lw
 * @since 2026-01-14
 */
public interface IGdClueEventService extends BaseService<GdClueEventEntity> {
	/**
	 * 自定义分页
	 *
	 * @param page
	 * @param gdClueEvent
	 * @return
	 */
	IPage<GdClueEventVO> selectGdClueEventPage(IPage<GdClueEventVO> page, GdClueEventVO gdClueEvent);

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

	/**
	 * 列表查询（不分页）
	 *
	 * @param onlyMine
	 * @return
	 */
	List<GdClueEventListVO> listGdClueEventByDept(Integer onlyMine, String keyword);

	/**
	 * 详情查询
	 *
	 * @param id
	 * @return
	 */
	GdClueEventVO getGdClueEventDetail(Long id);

	/**
	 * 数量统计
	 *
	 * @return
	 */
	GdClueEventCountVO getGdClueEventCount(String keyword);

	/**
	 * 分发事件
	 *
	 * @param distributeParam
	 * @return
	 */
	boolean distributeClueEvent(GdClueEventDistributeParam distributeParam);

	/**
	 * 驳回事件
	 *
	 * @param rejectParam
	 * @return
	 */
	boolean handleClueEvent(GdClueEventRejectParam rejectParam);

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

	/**
	 * 对外接口新增或修改事件
	 * <p>
	 * 生成事件编号并保存或更新事件信息
	 * </p>
	 *
	 * @param gdClueEvent 事件实体
	 * @return 是否操作成功
	 */
	boolean saveOrUpdateExternal(GdClueEventEntity gdClueEvent);

}