ieplus/ie-system/src/main/java/com/ruoyi/dz/service/IDzCardsService.java

package com.ruoyi.dz.service;

import java.util.List;

import com.ruoyi.common.core.domain.entity.SysUser;
import com.ruoyi.common.enums.ExamType;
import com.ruoyi.dz.domain.DzCards;
import com.ruoyi.dz.domain.DzCardsOpen;
import com.ruoyi.enums.CardAction;
import com.ruoyi.enums.CardType;

/**
 * 学习卡Service接口
 * 
 * @author ruoyi
 * @date 2025-09-12
 */
public interface IDzCardsService 
{
    /**
     * 查询学习卡
     * 
     * @param cardId 学习卡主键
     * @return 学习卡
     */
    public DzCards selectDzCardsByCardId(Long cardId);

    public DzCards selectDzCardsByCardNo(String cardNo);

    /**
     * 查询学习卡列表
     * 
     * @param dzCards 学习卡
     * @return 学习卡集合
     */
    public List<DzCards> selectDzCardsList(DzCards dzCards);

    /**
     * 新增学习卡
     * 
     * @param dzCards 学习卡
     * @return 结果
     */
    public int insertDzCards(DzCards dzCards);

    /**
     * 修改学习卡
     * 
     * @param dzCards 学习卡
     * @return 结果
     */
    public int updateDzCards(DzCards dzCards);

    /**
     * 批量删除学习卡
     * 
     * @param cardIds 需要删除的学习卡主键集合
     * @return 结果
     */
    public int deleteDzCardsByCardIds(Long[] cardIds);

    /**
     * 删除学习卡信息
     * 
     * @param cardId 学习卡主键
     * @return 结果
     */
    public int deleteDzCardsByCardId(Long cardId);

    /**
     * 制卡
     * @param deptId
     * @param type
     * @param count
     */
    public void issueCard(Long deptId, CardType type, Integer count);

    /**
     * 分配卡
     * @param agentId
     * @param leafAgentId
     * @param beginNo
     * @param endNo
     */
    public void assignCard(Long agentId, Long leafAgentId, String beginNo, String endNo, String location, ExamType examType, Long schoolId);

    /**
     * 开卡
     * @param schoolId
     * @param agentId
     * @param beginNo
     * @param endNo
     * @return
     */
    public Boolean openCard(Long schoolId, Long agentId, String beginNo, String endNo);

    /**
     * 申请开卡
     * @param dzCardsOpen
     */
    public Boolean requestOpenCard(DzCardsOpen dzCardsOpen);

    /**
     * 审核开卡
     * @param dzCardsOpen
     * @param sysUser
     */
    public Boolean confirmOpenCard(DzCardsOpen dzCardsOpen, SysUser sysUser);

    /**
     * 修改卡
     * @param action
     * @param cardIds
     */
    public void changeCard(CardAction action, Long[] cardIds);

    /**
     * 分配校区
     * @param campusId
     * @param beginNo
     * @param endNo
     * @return
     */
    public Boolean changeCampus(Long campusId, String beginNo, String endNo);
}