2026-03-09 21:28:58 +08:00
|
|
|
|
package service
|
|
|
|
|
|
|
|
|
|
|
|
import (
|
|
|
|
|
|
"context"
|
|
|
|
|
|
"time"
|
|
|
|
|
|
|
|
|
|
|
|
"carrot_bbs/internal/cache"
|
2026-03-13 09:38:18 +08:00
|
|
|
|
apperrors "carrot_bbs/internal/errors"
|
2026-03-09 21:28:58 +08:00
|
|
|
|
"carrot_bbs/internal/model"
|
feat(api): add cursor-based pagination for posts, comments, messages, groups, and notifications
Implement cursor-based pagination across multiple API endpoints to improve performance and enable efficient infinite scrolling. This replaces traditional offset-based pagination for high-volume data retrieval.
Changes:
- Add cursor pagination DTOs for all entity types (Post, Comment, Message, Conversation, Group, Notification, GroupMember, GroupAnnouncement)
- Implement cursor pagination methods in repositories with support for various sort orders (created_at, updated_at, join_time, seq)
- Add cursor pagination handlers that maintain backward compatibility with existing offset pagination
- Add new API routes for cursor-based endpoints (/cursor suffix)
- Add helper converter functions for pointer slice types in DTO conversions
2026-03-20 23:03:23 +08:00
|
|
|
|
"carrot_bbs/internal/pkg/cursor"
|
2026-03-09 21:28:58 +08:00
|
|
|
|
"carrot_bbs/internal/repository"
|
|
|
|
|
|
)
|
|
|
|
|
|
|
|
|
|
|
|
// 缓存TTL常量
|
|
|
|
|
|
const (
|
|
|
|
|
|
NotificationUnreadCountTTL = 30 * time.Second // 通知未读数缓存30秒
|
|
|
|
|
|
NotificationNullTTL = 5 * time.Second
|
|
|
|
|
|
NotificationCacheJitter = 0.1
|
|
|
|
|
|
)
|
|
|
|
|
|
|
|
|
|
|
|
// NotificationService 通知服务
|
|
|
|
|
|
type NotificationService struct {
|
2026-03-26 18:14:16 +08:00
|
|
|
|
notificationRepo repository.NotificationRepository
|
2026-03-09 21:28:58 +08:00
|
|
|
|
cache cache.Cache
|
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
|
|
// NewNotificationService 创建通知服务
|
2026-03-26 18:14:16 +08:00
|
|
|
|
func NewNotificationService(notificationRepo repository.NotificationRepository, cacheBackend cache.Cache) *NotificationService {
|
2026-03-09 21:28:58 +08:00
|
|
|
|
return &NotificationService{
|
|
|
|
|
|
notificationRepo: notificationRepo,
|
2026-03-13 09:38:18 +08:00
|
|
|
|
cache: cacheBackend,
|
2026-03-09 21:28:58 +08:00
|
|
|
|
}
|
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
|
|
// Create 创建通知
|
|
|
|
|
|
func (s *NotificationService) Create(ctx context.Context, userID string, notificationType model.NotificationType, title, content string) (*model.Notification, error) {
|
|
|
|
|
|
notification := &model.Notification{
|
|
|
|
|
|
UserID: userID,
|
|
|
|
|
|
Type: notificationType,
|
|
|
|
|
|
Title: title,
|
|
|
|
|
|
Content: content,
|
|
|
|
|
|
IsRead: false,
|
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
|
|
err := s.notificationRepo.Create(notification)
|
|
|
|
|
|
if err != nil {
|
|
|
|
|
|
return nil, err
|
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
|
|
// 失效未读数缓存
|
|
|
|
|
|
cache.InvalidateUnreadSystem(s.cache, userID)
|
|
|
|
|
|
|
|
|
|
|
|
return notification, nil
|
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
|
|
// GetByUserID 获取用户通知
|
|
|
|
|
|
func (s *NotificationService) GetByUserID(ctx context.Context, userID string, page, pageSize int, unreadOnly bool) ([]*model.Notification, int64, error) {
|
|
|
|
|
|
return s.notificationRepo.GetByUserID(userID, page, pageSize, unreadOnly)
|
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
|
|
// MarkAsRead 标记为已读
|
|
|
|
|
|
func (s *NotificationService) MarkAsRead(ctx context.Context, id string) error {
|
|
|
|
|
|
err := s.notificationRepo.MarkAsRead(id)
|
|
|
|
|
|
if err != nil {
|
|
|
|
|
|
return err
|
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
|
|
// 注意:这里无法获取userID,所以不在缓存中失效
|
|
|
|
|
|
// 调用方应该使用MarkAsReadWithUserID方法
|
|
|
|
|
|
|
|
|
|
|
|
return nil
|
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
|
|
// MarkAsReadWithUserID 标记为已读(带用户ID,用于缓存失效)
|
|
|
|
|
|
func (s *NotificationService) MarkAsReadWithUserID(ctx context.Context, id, userID string) error {
|
|
|
|
|
|
err := s.notificationRepo.MarkAsRead(id)
|
|
|
|
|
|
if err != nil {
|
|
|
|
|
|
return err
|
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
|
|
// 失效未读数缓存
|
|
|
|
|
|
cache.InvalidateUnreadSystem(s.cache, userID)
|
|
|
|
|
|
|
|
|
|
|
|
return nil
|
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
|
|
// MarkAllAsRead 标记所有为已读
|
|
|
|
|
|
func (s *NotificationService) MarkAllAsRead(ctx context.Context, userID string) error {
|
|
|
|
|
|
err := s.notificationRepo.MarkAllAsRead(userID)
|
|
|
|
|
|
if err != nil {
|
|
|
|
|
|
return err
|
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
|
|
// 失效未读数缓存
|
|
|
|
|
|
cache.InvalidateUnreadSystem(s.cache, userID)
|
|
|
|
|
|
|
|
|
|
|
|
return nil
|
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
|
|
// Delete 删除通知
|
|
|
|
|
|
func (s *NotificationService) Delete(ctx context.Context, id string) error {
|
|
|
|
|
|
return s.notificationRepo.Delete(id)
|
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
|
|
// GetUnreadCount 获取未读数量(带缓存)
|
|
|
|
|
|
func (s *NotificationService) GetUnreadCount(ctx context.Context, userID string) (int64, error) {
|
|
|
|
|
|
cacheSettings := cache.GetSettings()
|
|
|
|
|
|
unreadTTL := cacheSettings.UnreadCountTTL
|
|
|
|
|
|
if unreadTTL <= 0 {
|
|
|
|
|
|
unreadTTL = NotificationUnreadCountTTL
|
|
|
|
|
|
}
|
|
|
|
|
|
nullTTL := cacheSettings.NullTTL
|
|
|
|
|
|
if nullTTL <= 0 {
|
|
|
|
|
|
nullTTL = NotificationNullTTL
|
|
|
|
|
|
}
|
|
|
|
|
|
jitter := cacheSettings.JitterRatio
|
|
|
|
|
|
if jitter <= 0 {
|
|
|
|
|
|
jitter = NotificationCacheJitter
|
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
|
|
// 生成缓存键
|
|
|
|
|
|
cacheKey := cache.UnreadSystemKey(userID)
|
|
|
|
|
|
return cache.GetOrLoadTyped[int64](
|
|
|
|
|
|
s.cache,
|
|
|
|
|
|
cacheKey,
|
|
|
|
|
|
unreadTTL,
|
|
|
|
|
|
jitter,
|
|
|
|
|
|
nullTTL,
|
|
|
|
|
|
func() (int64, error) {
|
|
|
|
|
|
return s.notificationRepo.GetUnreadCount(userID)
|
|
|
|
|
|
},
|
|
|
|
|
|
)
|
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
|
|
// DeleteNotification 删除通知(带用户验证)
|
|
|
|
|
|
func (s *NotificationService) DeleteNotification(ctx context.Context, id, userID string) error {
|
|
|
|
|
|
// 先检查通知是否属于该用户
|
|
|
|
|
|
notification, err := s.notificationRepo.GetByID(id)
|
|
|
|
|
|
if err != nil {
|
|
|
|
|
|
return err
|
|
|
|
|
|
}
|
|
|
|
|
|
if notification.UserID != userID {
|
|
|
|
|
|
return ErrUnauthorizedNotification
|
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
|
|
err = s.notificationRepo.Delete(id)
|
|
|
|
|
|
if err != nil {
|
|
|
|
|
|
return err
|
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
|
|
// 失效未读数缓存
|
|
|
|
|
|
cache.InvalidateUnreadSystem(s.cache, userID)
|
|
|
|
|
|
|
|
|
|
|
|
return nil
|
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
|
|
// ClearAllNotifications 清空所有通知
|
|
|
|
|
|
func (s *NotificationService) ClearAllNotifications(ctx context.Context, userID string) error {
|
|
|
|
|
|
err := s.notificationRepo.DeleteAllByUserID(userID)
|
|
|
|
|
|
if err != nil {
|
|
|
|
|
|
return err
|
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
|
|
// 失效未读数缓存
|
|
|
|
|
|
cache.InvalidateUnreadSystem(s.cache, userID)
|
|
|
|
|
|
|
|
|
|
|
|
return nil
|
|
|
|
|
|
}
|
|
|
|
|
|
|
feat(api): add cursor-based pagination for posts, comments, messages, groups, and notifications
Implement cursor-based pagination across multiple API endpoints to improve performance and enable efficient infinite scrolling. This replaces traditional offset-based pagination for high-volume data retrieval.
Changes:
- Add cursor pagination DTOs for all entity types (Post, Comment, Message, Conversation, Group, Notification, GroupMember, GroupAnnouncement)
- Implement cursor pagination methods in repositories with support for various sort orders (created_at, updated_at, join_time, seq)
- Add cursor pagination handlers that maintain backward compatibility with existing offset pagination
- Add new API routes for cursor-based endpoints (/cursor suffix)
- Add helper converter functions for pointer slice types in DTO conversions
2026-03-20 23:03:23 +08:00
|
|
|
|
// GetNotificationsByCursor 游标分页获取用户通知
|
|
|
|
|
|
func (s *NotificationService) GetNotificationsByCursor(ctx context.Context, userID string, unreadOnly bool, req *cursor.PageRequest) (*cursor.CursorPageResult[*model.Notification], error) {
|
|
|
|
|
|
return s.notificationRepo.GetNotificationsByCursor(ctx, userID, unreadOnly, req)
|
|
|
|
|
|
}
|
|
|
|
|
|
|
2026-03-09 21:28:58 +08:00
|
|
|
|
// 错误定义
|
2026-03-13 09:38:18 +08:00
|
|
|
|
var ErrUnauthorizedNotification = apperrors.ErrUnauthorizedNotification
|