package com.microservices.zone.resource.mapper;

import com.microservices.zone.resource.domain.ZoneResource;
import com.microservices.zone.resource.domain.vo.ZoneResourceOpenSearchVo;
import org.apache.ibatis.annotations.Mapper;
import org.apache.ibatis.annotations.Param;

import java.util.List;

/**
 * 特色专区资源聚合Mapper接口
 *
 * @author otto
 * @date 2023-06-27
 */
@Mapper
public interface ZoneResourceMapper {
    /**
     * 查询特色专区资源聚合
     *
     * @param id 特色专区资源聚合主键
     * @return 特色专区资源聚合
     */
    public ZoneResource selectZoneResourceById(Long id);

    /**
     * 查询特色专区资源聚合列表
     *
     * @param zoneResource 特色专区资源聚合
     * @return 特色专区资源聚合集合
     */
    public List<ZoneResource> selectZoneResourceList(ZoneResource zoneResource);

    List<ZoneResource> selectZoneResourceListBySearchVo(ZoneResourceOpenSearchVo zoneResourceOpenSearchVo);

    /**
     * 新增特色专区资源聚合
     *
     * @param zoneResource 特色专区资源聚合
     * @return 结果
     */
    public int insertZoneResource(ZoneResource zoneResource);

    /**
     * 修改特色专区资源聚合
     *
     * @param zoneResource 特色专区资源聚合
     * @return 结果
     */
    public int updateZoneResource(ZoneResource zoneResource);

    /**
     * 删除特色专区资源聚合
     *
     * @param id 特色专区资源聚合主键
     * @return 结果
     */
    public int deleteZoneResourceById(Long id);

    /**
     * 批量删除特色专区资源聚合
     *
     * @param ids 需要删除的数据主键集合
     * @return 结果
     */
    public int deleteZoneResourceByIds(Long[] ids);

    /**
     * 通过名称查询资源
     *
     * @param name
     * @param zoneId
     * @param resourceCategory
     * @return
     */
    ZoneResource selectZoneResourceByNameAndZoneId(@Param("name") String name, @Param("zoneId") Long zoneId, @Param("resourceCategory") String resourceCategory);

    /**
     * 获取资源数量
     *
     * @param zoneResource
     * @return
     */
    Integer selectZoneResourceCount(ZoneResource zoneResource);

    /**
     * 获取所有专区资源
     *
     * @return
     */
    List<ZoneResource> selectAllZoneResourceList();

    /**
     * 通过专区Id删除资源
     *
     * @param zoneId 专区Id
     */
    void deleteZoneResourceByZoneId(Long zoneId);

    /**
     * 全局搜索结果计数
     *
     * @param keyword 搜索关键词
     * @param zoneId 专区ID（可选）
     * @return 结果数量
     */
    Long globalSearchCount(@Param("keyword") String keyword, @Param("zoneId") Long zoneId);

    /**
     * 全局搜索 - 全文索引查询（含评分）
     *
     * @param keyword 搜索关键词
     * @param zoneId 专区ID
     * @param offset 偏移量
     * @param pageSize 每页数量
     * @return 搜索结果列表（含评分）
     */
    List<com.microservices.zone.resource.domain.ZoneResourceWithScore> globalSearchWithScore(
            @Param("keyword") String keyword,
            @Param("zoneId") Long zoneId,
            @Param("offset") int offset,
            @Param("pageSize") int pageSize);

    /**
     * 通过名称查询Skill资源（resource_category='SKILL'）
     *
     * @param name Skill名称
     * @return 资源
     */
    ZoneResource selectSkillResourceByName(@Param("name") String name);

    /**
     * 查询已发布的Skill推荐列表
     *
     * @param resourceCategory 资源分类
     * @param auditStatus      审核状态
     * @param limit            数量限制
     * @return 资源列表
     */
    List<ZoneResource> selectSkillRecommendations(@Param("resourceCategory") String resourceCategory,
                                                   @Param("auditStatus") String auditStatus,
                                                   @Param("limit") int limit);

    /**
     * 增加浏览次数
     *
     * @param id 资源ID
     */
    int incrementViewCount(@Param("id") Long id);

    /**
     * 增加点赞次数
     *
     * @param id    资源ID
     * @param delta 变化量（正数加、负数减）
     */
    int updateLikeCount(@Param("id") Long id, @Param("delta") int delta);
}
