package cn.iocoder.yudao.module.archive.service.category;

import cn.iocoder.yudao.module.archive.controller.admin.category.vo.ArchiveCategoryListReqVO;
import cn.iocoder.yudao.module.archive.controller.admin.category.vo.ArchiveCategorySaveReqVO;
import cn.iocoder.yudao.module.archive.dal.dataobject.category.ArchiveCategoryDO;

import java.util.List;

/**
 * 档案分类 Service 接口
 *
 * @author 超级管理员
 */
public interface ArchiveCategoryService {

    /**
     * 创建档案分类
     *
     * @param createReqVO 创建信息
     * @return 分类编号
     */
    Long createCategory(ArchiveCategorySaveReqVO createReqVO);

    /**
     * 更新档案分类
     *
     * @param updateReqVO 更新信息
     */
    void updateCategory(ArchiveCategorySaveReqVO updateReqVO);

    /**
     * 删除档案分类（存在子分类或档案时不允许删除）
     *
     * @param id 分类编号
     */
    void deleteCategory(Long id);

    /**
     * 获得档案分类
     *
     * @param id 分类编号
     * @return 分类
     */
    ArchiveCategoryDO getCategory(Long id);

    /**
     * 获得档案分类列表（按排序值升序）
     *
     * @param reqVO 查询条件
     * @return 分类列表
     */
    List<ArchiveCategoryDO> getCategoryList(ArchiveCategoryListReqVO reqVO);

    /**
     * 获得全部档案分类（构建分类树用）
     *
     * @return 分类列表
     */
    List<ArchiveCategoryDO> getCategoryList();

    /**
     * 按编码获得档案分类
     *
     * @param code 分类编码
     * @return 分类
     */
    ArchiveCategoryDO getCategoryByCode(String code);

}