package cn.meowrain.aioj.backend.blogservice.service;

import cn.meowrain.aioj.backend.blogservice.dao.entity.Tag;
import cn.meowrain.aioj.backend.blogservice.dto.req.TagCreateRequestDTO;
import cn.meowrain.aioj.backend.blogservice.dto.req.TagUpdateRequestDTO;
import cn.meowrain.aioj.backend.blogservice.dto.resp.TagResponseDTO;
import com.baomidou.mybatisplus.extension.service.IService;

import java.util.List;

/**
 * 文章标签服务接口
 *
 * @author AIOJ
 */
public interface TagService extends IService<Tag> {

    /**
     * 创建标签
     *
     * @param request 标签创建请求
     * @return 标签ID
     */
    Long createTag(TagCreateRequestDTO request);

    /**
     * 更新标签
     *
     * @param request 标签更新请求
     * @return 是否成功
     */
    Boolean updateTag(TagUpdateRequestDTO request);

    /**
     * 删除标签
     *
     * @param tagId 标签ID
     * @return 是否成功
     */
    Boolean deleteTag(Long tagId);

    /**
     * 根据ID查询标签详情
     *
     * @param tagId 标签ID
     * @return 标签详情
     */
    TagResponseDTO getTagById(Long tagId);

    /**
     * 根据slug查询标签详情
     *
     * @param slug 标签别名
     * @return 标签详情
     */
    TagResponseDTO getTagBySlug(String slug);

    /**
     * 查询所有标签列表
     *
     * @return 标签列表
     */
    List<TagResponseDTO> getAllTags();

    /**
     * 查询启用的标签列表
     *
     * @return 标签列表
     */
    List<TagResponseDTO> getEnabledTags();

    /**
     * 根据文章ID查询标签列表
     *
     * @param articleId 文章ID
     * @return 标签列表
     */
    List<TagResponseDTO> getTagsByArticleId(Long articleId);
}
