120 lines
2.7 KiB
Java
120 lines
2.7 KiB
Java
package com.ruoyi.group.service;
|
||
|
||
import com.ruoyi.group.domain.dto.CustGroupQueryDTO;
|
||
import com.ruoyi.group.domain.dto.GridImportDTO;
|
||
import com.ruoyi.group.domain.entity.CustGroup;
|
||
import com.ruoyi.group.domain.vo.CustGroupVO;
|
||
import org.springframework.web.multipart.MultipartFile;
|
||
|
||
import java.util.List;
|
||
|
||
/**
|
||
* 客群Service接口
|
||
*
|
||
* @author ruoyi
|
||
*/
|
||
public interface ICustGroupService {
|
||
|
||
/**
|
||
* 查询客群列表
|
||
*
|
||
* @param dto 查询条件
|
||
* @return 客群VO列表
|
||
*/
|
||
List<CustGroupVO> listCustGroup(CustGroupQueryDTO dto);
|
||
|
||
/**
|
||
* 异步创建客群（模板导入）
|
||
*
|
||
* @param custGroup 客群实体
|
||
* @param file Excel文件
|
||
* @return 客群ID
|
||
*/
|
||
String createCustGroupByTemplate(CustGroup custGroup, MultipartFile file);
|
||
|
||
/**
|
||
* 异步创建客群（网格导入）
|
||
*
|
||
* @param gridImportDTO 网格导入条件
|
||
* @return 客群ID
|
||
*/
|
||
String createCustGroupByGrid(GridImportDTO gridImportDTO);
|
||
|
||
/**
|
||
* 更新客群（网格导入）
|
||
*
|
||
* @param gridImportDTO 网格导入条件
|
||
* @return 结果消息
|
||
*/
|
||
String updateCustGroupByGrid(GridImportDTO gridImportDTO);
|
||
|
||
/**
|
||
* 更新客群（模板导入）
|
||
*
|
||
* @param custGroup 客群实体
|
||
* @param file Excel文件
|
||
* @return 结果消息
|
||
*/
|
||
String updateCustGroupByTemplate(CustGroup custGroup, MultipartFile file);
|
||
|
||
/**
|
||
* 更新客群
|
||
*
|
||
* @param custGroup 客群实体
|
||
* @return 结果消息
|
||
*/
|
||
String updateCustGroup(CustGroup custGroup);
|
||
|
||
/**
|
||
* 删除客群
|
||
*
|
||
* @param idList 客群ID列表
|
||
* @return 结果消息
|
||
*/
|
||
String deleteCustGroup(List<Long> idList);
|
||
|
||
/**
|
||
* 获取客群详情
|
||
*
|
||
* @param id 客群ID
|
||
* @return 客群VO
|
||
*/
|
||
CustGroupVO getCustGroup(Long id);
|
||
|
||
/**
|
||
* 检查客群名称是否存在
|
||
*
|
||
* @param groupName 客群名称
|
||
* @return true=存在, false=不存在
|
||
*/
|
||
boolean checkGroupNameExist(String groupName);
|
||
|
||
/**
|
||
* 查询客群创建状态
|
||
*
|
||
* @param id 客群ID
|
||
* @return 创建状态：0=创建中, 1=创建成功, 2=创建失败
|
||
*/
|
||
String getCreateStatus(Long id);
|
||
|
||
/**
|
||
* 手动移除客群客户
|
||
*
|
||
* @param groupId 客群ID
|
||
* @param memberIds 客群成员ID列表
|
||
* @return 结果消息
|
||
*/
|
||
String removeMembers(Long groupId, List<Long> memberIds);
|
||
|
||
/**
|
||
* 更新动态客群（定时任务调用）
|
||
* 根据原始导入条件重新查询并更新客户列表
|
||
*/
|
||
void updateDynamicCustGroups();
|
||
|
||
/**
|
||
* 检查并禁用过期客群（定时任务调用）
|
||
*/
|
||
void checkAndDisableExpiredGroups();
|
||
|
||
} |