feat(mdm): 统一物料分类管理并迁移至MDM模块

云

2026-10-26 63ba72f5d65a3a4dcd56d9228582042448af61d7

 yudao-module-mdm/src/main/java/cn/iocoder/yudao/module/mdm/api/category/MdmItemCategoryApi.java

¶Ô±ÈÐÂÎļþ
@@ -0,0 +1,88 @@
package cn.iocoder.yudao.module.mdm.api.category;

import cn.iocoder.yudao.framework.common.pojo.CommonResult;
import cn.iocoder.yudao.module.mdm.api.category.dto.MdmItemCategoryRespDTO;
import cn.iocoder.yudao.module.mdm.api.category.dto.MdmItemCategorySaveReqDTO;

import java.util.Collection;
import java.util.List;

/**
 * MDM ç‰©æ–™åˆ†ç±» API æŽ¥å£
 *
 * @author è¶…级管理员
 */
public interface MdmItemCategoryApi {

    String PREFIX = "/rpc-api/mdm/category";

    /**
     * èŽ·å–物料分类
     *
     * @param id åˆ†ç±»ç¼–号
     * @return ç‰©æ–™åˆ†ç±»
     */
    CommonResult<MdmItemCategoryRespDTO> getItemCategory(Long id);

    /**
     * æ ¹æ®ç¼–码获取物料分类
     *
     * @param code åˆ†ç±»ç¼–码
     * @return ç‰©æ–™åˆ†ç±»
     */
    CommonResult<MdmItemCategoryRespDTO> getItemCategoryByCode(String code);

    /**
     * èŽ·å–物料分类列表
     *
     * @param ids åˆ†ç±»ç¼–号列表
     * @return ç‰©æ–™åˆ†ç±»åˆ—表
     */
    CommonResult<List<MdmItemCategoryRespDTO>> getItemCategoryList(Collection<Long> ids);

    /**
     * æ ¡éªŒç‰©æ–™åˆ†ç±»å­˜åœ¨
     *
     * @param id åˆ†ç±»ç¼–号
     * @return ç‰©æ–™åˆ†ç±»
     */
    CommonResult<MdmItemCategoryRespDTO> validateItemCategoryExists(Long id);

    /**
     * æ ¹æ®ç‰©æ–™/产品标识获取分类
     *
     * @param itemOrProduct ç‰©æ–™/产品标识
     * @return ç‰©æ–™åˆ†ç±»
     */
    CommonResult<MdmItemCategoryRespDTO> getItemCategoryByItemOrProduct(String itemOrProduct);

    /**
     * èŽ·å–全部分类列表（含禁用）
     *
     * @return åˆ†ç±»åˆ—表
     */
    CommonResult<List<MdmItemCategoryRespDTO>> getItemCategoryAllList();

    /**
     * åˆ›å»ºç‰©æ–™åˆ†ç±»
     *
     * @param createReqDTO åˆ›å»ºä¿¡æ¯
     * @return åˆ†ç±»ç¼–号
     */
    CommonResult<Long> createItemCategory(MdmItemCategorySaveReqDTO createReqDTO);

    /**
     * æ›´æ–°ç‰©æ–™åˆ†ç±»
     *
     * @param updateReqDTO æ›´æ–°ä¿¡æ¯
     */
    CommonResult<Boolean> updateItemCategory(MdmItemCategorySaveReqDTO updateReqDTO);

    /**
     * åˆ é™¤ç‰©æ–™åˆ†ç±»
     *
     * @param id åˆ†ç±»ç¼–号
     */
    CommonResult<Boolean> deleteItemCategory(Long id);

}