import 'package:lunchpick/domain/entities/recommendation_record.dart';

abstract class RecommendationRepository {
  /// 모든 추천 기록을 가져옵니다
  Future<List<RecommendationRecord>> getAllRecommendationRecords();

  /// 특정 맛집의 추천 기록을 가져옵니다
  Future<List<RecommendationRecord>> getRecommendationsByRestaurantId(String restaurantId);

  /// 날짜별 추천 기록을 가져옵니다
  Future<List<RecommendationRecord>> getRecommendationsByDate(DateTime date);

  /// 날짜 범위로 추천 기록을 가져옵니다
  Future<List<RecommendationRecord>> getRecommendationsByDateRange({
    required DateTime startDate,
    required DateTime endDate,
  });

  /// 새로운 추천 기록을 추가합니다
  Future<void> addRecommendationRecord(RecommendationRecord record);

  /// 추천 기록을 업데이트합니다
  Future<void> updateRecommendationRecord(RecommendationRecord record);

  /// 추천 기록을 삭제합니다
  Future<void> deleteRecommendationRecord(String id);

  /// 추천 후 방문 여부를 업데이트합니다
  Future<void> markAsVisited(String recommendationId);

  /// 오늘의 추천 횟수를 가져옵니다
  Future<int> getTodayRecommendationCount();

  /// 추천 기록을 스트림으로 감시합니다
  Stream<List<RecommendationRecord>> watchRecommendationRecords();

  /// 월별 추천 통계를 가져옵니다
  Future<Map<String, int>> getMonthlyRecommendationStats(int year, int month);
}