package com.jeesharp.business.modules.setting.service;

import com.jeesharp.business.modules.setting.entity.HelpArticle;
import com.jeesharp.business.modules.setting.vo.HelpArticleQueryVO;
import com.jeesharp.framework.mybatis.core.service.BaseInterface;

import java.util.List;

/**
 * 帮助文章服务接口
 *
 * @author jeesharp
 * @version 2026-02-05
 */
public interface HelpArticleService extends BaseInterface<HelpArticle, HelpArticleQueryVO> {

    /**
     * 根据应用标识查询文章列表
     *
     * @param app 应用标识
     * @return 文章列表
     */
    List<HelpArticle> listByApp(String app);

    /**
     * 根据分类ID查询文章列表
     *
     * @param categoryId 分类ID
     * @return 文章列表
     */
    List<HelpArticle> listByCategoryId(String categoryId);

    /**
     * 根据应用标识查询常见问题列表
     *
     * @param app 应用标识
     * @return 常见问题列表
     */
    List<HelpArticle> listFaqByApp(String app);

    void createArticle(HelpArticle article);

    void updateArticle(HelpArticle article);
void updateStatus(String id, Integer status);

    /**
     * 增加浏览次数
     *
     * @param id 文章ID
     */
    void incrementViewCount(String id);

    /**
     * 增加点赞次数
     *
     * @param id 文章ID
     */
    void incrementLikeCount(String id);
}
