package com.seer.teach.mp.app.service;

import com.seer.teach.common.PageListBean;
import com.seer.teach.mp.app.controller.req.AgentActivityParentQueryReq;
import com.seer.teach.mp.app.controller.resp.AgentActivityParentInfoResp;

import java.util.List;

/**
 * <p>
 * 代理商活动参与家长信息服务类
 * </p>
 *
 * @author Lingma
 * @since 2025-12-30
 */
public interface IAppAgentActivityParentInfoService {

    /**
     * 根据活动ID获取参与的家长信息列表
     *
     * @param activityId 活动ID
     * @param agentId 代理商ID
     * @param userId 用户ID
     * @return 参与活动的家长信息列表
     */
    List<AgentActivityParentInfoResp> getParentsByActivityAndAgent(Integer activityId, Integer agentId,Integer userId);

    /**
     * 分页获取参加指定活动的家长信息列表
     *
     * @param queryReq 查询请求参数
     * @return 分页的家长信息列表
     */
    PageListBean<AgentActivityParentInfoResp> getParentsByActivityAndAgent(Integer userId,AgentActivityParentQueryReq queryReq);

    /**
     * 记录代理商拨打电话联系家长的次数
     *
     * @param collectionId 活动信息收集记录ID
     * @param incrementCount 增加的联系次数
     * @param userId 用户ID
     * @return 更新后的联系次数
     */
    boolean recordContactCall(Integer collectionId, Integer incrementCount,Integer userId);
}