package com.yolo.keyboard.service.userinvitecodes;

import java.util.*;
import jakarta.validation.*;
import com.yolo.keyboard.controller.admin.userinvitecodes.vo.*;
import com.yolo.keyboard.dal.dataobject.userinvitecodes.KeyboardUserInviteCodesDO;
import com.yolo.keyboard.framework.common.pojo.PageResult;
import com.yolo.keyboard.framework.common.pojo.PageParam;

/**
 * 用户生成的邀请码表，用于邀请新用户注册/安装并建立邀请关系 Service 接口
 *
 * @author ziin
 */
public interface KeyboardUserInviteCodesService {

    /**
     * 创建用户生成的邀请码表，用于邀请新用户注册/安装并建立邀请关系
     *
     * @param createReqVO 创建信息
     * @return 编号
     */
    Long createUserInviteCodes(@Valid KeyboardUserInviteCodesSaveReqVO createReqVO);

    /**
     * 更新用户生成的邀请码表，用于邀请新用户注册/安装并建立邀请关系
     *
     * @param updateReqVO 更新信息
     */
    void updateUserInviteCodes(@Valid KeyboardUserInviteCodesSaveReqVO updateReqVO);

    /**
     * 删除用户生成的邀请码表，用于邀请新用户注册/安装并建立邀请关系
     *
     * @param id 编号
     */
    void deleteUserInviteCodes(Long id);

    /**
    * 批量删除用户生成的邀请码表，用于邀请新用户注册/安装并建立邀请关系
    *
    * @param ids 编号
    */
    void deleteUserInviteCodesListByIds(List<Long> ids);

    /**
     * 获得用户生成的邀请码表，用于邀请新用户注册/安装并建立邀请关系
     *
     * @param id 编号
     * @return 用户生成的邀请码表，用于邀请新用户注册/安装并建立邀请关系
     */
    KeyboardUserInviteCodesDO getUserInviteCodes(Long id);

    /**
     * 获得用户生成的邀请码表，用于邀请新用户注册/安装并建立邀请关系分页
     *
     * @param pageReqVO 分页查询
     * @return 用户生成的邀请码表，用于邀请新用户注册/安装并建立邀请关系分页
     */
    PageResult<KeyboardUserInviteCodesDO> getUserInviteCodesPage(KeyboardUserInviteCodesPageReqVO pageReqVO);

}