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

import cn.meowrain.aioj.backend.blogservice.dao.entity.Notification;
import cn.meowrain.aioj.backend.blogservice.dto.req.NotificationQueryRequestDTO;
import cn.meowrain.aioj.backend.blogservice.dto.resp.NotificationResponseDTO;
import com.baomidou.mybatisplus.core.metadata.IPage;
import com.baomidou.mybatisplus.extension.service.IService;

/**
 * 通知服务接口
 *
 * @author AIOJ
 */
public interface NotificationService extends IService<Notification> {

    /**
     * 分页查询通知列表
     *
     * @param request 查询请求
     * @return 通知列表
     */
    IPage<NotificationResponseDTO> getNotificationList(NotificationQueryRequestDTO request);

    /**
     * 标记通知为已读
     *
     * @param notificationId 通知ID
     * @return 是否成功
     */
    Boolean markAsRead(Long notificationId);

    /**
     * 批量标记通知为已读
     *
     * @param notificationIds 通知ID列表
     * @return 是否成功
     */
    Boolean batchMarkAsRead(java.util.List<Long> notificationIds);

    /**
     * 标记所有通知为已读
     *
     * @return 是否成功
     */
    Boolean markAllAsRead();

    /**
     * 清空所有通知
     *
     * @return 是否成功
     */
    Boolean clearAllNotifications();

    /**
     * 获取未读通知数量
     *
     * @return 未读通知数量
     */
    Long getUnreadCount();

    /**
     * 创建通知
     *
     * @param userId  接收用户ID
     * @param type    通知类型
     * @param title   通知标题
     * @param content 通知内容
     * @param linkUrl 跳转链接
     * @param senderId 发送者ID
     * @param targetId 关联目标ID
     * @return 通知ID
     */
    Long createNotification(Long userId, Integer type, String title, String content,
                           String linkUrl, Long senderId, Long targetId);
}
