package com.zhentao.service;

import com.baomidou.mybatisplus.extension.plugins.pagination.Page;
import com.baomidou.mybatisplus.extension.service.IService;
import com.zhentao.dto.MatchmakerQueryDTO;
import com.zhentao.entity.Matchmaker;
import com.zhentao.vo.MatchmakerVO;

/**
 * 红娘服务接口
 */
public interface MatchmakerService extends IService<Matchmaker> {
    
    /**
     * 分页查询红娘列表
     * 
     * @param queryDTO 查询条件
     * @return 红娘VO分页数据
     */
    Page<MatchmakerVO> getMatchmakerPage(MatchmakerQueryDTO queryDTO);
    
    /**
     * 根据ID查询红娘详情
     * 
     * @param matchmakerId 红娘ID
     * @return 红娘VO
     */
    MatchmakerVO getMatchmakerDetail(Integer matchmakerId);
    
    /**
     * 获取全职红娘列表（用于首页展示）
     * 
     * @return 红娘VO分页数据
     */
    Page<MatchmakerVO> getFormalMatchmakers(Integer pageNum, Integer pageSize);
    
    /**
     * 清除红娘相关缓存（用于数据更新时）
     * 
     * @param matchmakerId 红娘ID，如果为null则只清除列表缓存
     */
    void clearMatchmakerCache(Integer matchmakerId);
}

