package jnpf.cultivate.v2.service;

import com.baomidou.mybatisplus.extension.service.IService;
import jnpf.model.cultivate.po.label.FtbCultivateLabel;
import jnpf.model.cultivate.v2.label.dto.FtbCultivateLabelReq;
import jnpf.model.cultivate.v2.label.dto.FtbCultivateUpdateLabelReq;
import jnpf.model.cultivate.v2.label.vo.FtbCultivateLabelVo;
import jnpf.model.cultivate.v2.position.req.V2CultivateCommonCourseForAppReq;

import javax.validation.Valid;
import java.util.List;
import java.util.Map;

/**
 * 培训标签关联表 服务接口
 */
public interface FtbCultivateLabelService extends IService<FtbCultivateLabel> {


    /**
     * 根据类型获取培训标签列表
     *
     * @param type   类型标识，用于筛选特定类型的培训标签
     * @param source 来源：0-自定义，1-系统默认 null 全部
     * @return 返回符合条件的培训标签列表
     */
    List<FtbCultivateLabelVo> getList(Integer type, Integer source);

    /**
     * 获取培训标签关联表信息
     *
     * @param id 主键ID，用于唯一标识一条培训标签记录
     * @return 返回对应的培训标签详细信息
     */
    FtbCultivateLabelVo getInfo(String id);

    /**
     * 新增培训标签关联表
     *
     * @param req 包含新增培训标签所需数据的请求对象
     * @return 返回新增成功的培训标签信息
     */
    FtbCultivateLabelVo addData(FtbCultivateLabelReq req);

    /**
     * 更新培训标签关联表信息
     *
     * @param id  主键ID，用于定位需要更新的培训标签记录
     * @param req 包含更新培训标签所需数据的请求对象，需通过@Valid注解进行校验
     * @return 返回更新后的培训标签信息
     */
    FtbCultivateLabelVo updateData(String id, @Valid FtbCultivateUpdateLabelReq req);

    /**
     * 删除培训标签关联表信息
     *
     * @param id 主键ID，用于定位需要删除的培训标签记录
     */
    void deleteData(String id);

    /**
     * 获取通用课程标签列表
     *
     * @param req 请求参数对象，包含查询通用课程标签所需的条件
     * @return 返回通用课程标签列表，每个标签封装为FtbCultivateLabelVo对象
     */
    List<FtbCultivateLabelVo> commonCourseLabelList(V2CultivateCommonCourseForAppReq req);

    /**
     * 根据分类名称查询map数据
     *
     * @param categoryNameList 分类名称
     * @return java.util.Map<java.lang.String, jnpf.model.cultivate.po.label.FtbCultivateLabel>
     */
    Map<String, FtbCultivateLabel> getLabelMapByName(List<String> categoryNameList);
}