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

import com.seer.teach.common.PageListBean;
import com.seer.teach.mp.app.controller.resp.AppActivityResp;
import com.seer.teach.mp.app.controller.req.AppAgentActivityQueryReq;

/**
 * <p>
 * APP端代理商活动服务类
 * </p>
 *
 * @author Lingma
 * @since 2025-12-30
 */
public interface IAppActivityService {

    /**
     * 分页查询代理商活动列表
     *
     * @param query 查询条件
     * @param agentId 代理商ID
     * @return 代理商活动分页列表
     */
    PageListBean<AppActivityResp> pageList(AppAgentActivityQueryReq query, Integer agentId);

    /**
     * 根据ID获取活动详情
     *
     * @param id 活动ID
     * @return 活动详情
     */
    AppActivityResp getById(Integer id);

    /**
     * 获取活动二维码
     *
     * @param userId 用户ID
     * @param agentId 代理商ID
     * @param activityId 活动ID
     * @return 活动二维码
     */
    String getQrCode(Integer userId,Integer agentId,Integer activityId,String appId);
}