feat(analytics): add reading analytics feature with stats display and weekly chart

Author: logan676

lib/features/analytics/data/analytics_service.dart

@@ -0,0 +1,39 @@
+import 'package:flutter_riverpod/flutter_riverpod.dart';
+import 'package:readmigo/core/network/api_client.dart';
+
+final analyticsServiceProvider = Provider<AnalyticsService>((ref) {
+  return AnalyticsService(apiClient: ref.watch(apiClientProvider));
+});
+
+class AnalyticsService {
+  final ApiClient _apiClient;
+
+  AnalyticsService({required ApiClient apiClient}) : _apiClient = apiClient;
+
+  Future<Map<String, dynamic>> getOverview() async {
+    final response = await _apiClient.get('/analytics/overview');
+    return response.data as Map<String, dynamic>;
+  }
+
+  Future<List<Map<String, dynamic>>> getDailyStats({int days = 7}) async {
+    final response = await _apiClient.get(
+      '/analytics/daily',
+      queryParameters: {'days': days},
+    );
+    final data = response.data;
+    if (data is List) {
+      return data.map((e) => e as Map<String, dynamic>).toList();
+    }
+    return (data as Map)['stats'] as List<Map<String, dynamic>>? ?? [];
+  }
+
+  Future<Map<String, dynamic>> getReadingTrend() async {
+    final response = await _apiClient.get('/analytics/reading-trend');
+    return response.data as Map<String, dynamic>;
+  }
+
+  Future<Map<String, dynamic>> getInsights() async {
+    final response = await _apiClient.get('/analytics/insights');
+    return response.data as Map<String, dynamic>;
+  }
+}

lib/features/analytics/domain/analytics_state.dart

@@ -0,0 +1,119 @@
+import 'package:flutter_riverpod/flutter_riverpod.dart';
+import 'package:readmigo/features/analytics/data/analytics_service.dart';
+
+class AnalyticsState {
+  final int totalReadingMinutes;
+  final int booksCompleted;
+  final int currentStreak;
+  final int wordsLearned;
+  final int totalSessions;
+  final double avgSessionMinutes;
+  final List<DailyReading> dailyStats;
+  final bool isLoading;
+  final String? error;
+
+  const AnalyticsState({
+    this.totalReadingMinutes = 0,
+    this.booksCompleted = 0,
+    this.currentStreak = 0,
+    this.wordsLearned = 0,
+    this.totalSessions = 0,
+    this.avgSessionMinutes = 0,
+    this.dailyStats = const [],
+    this.isLoading = false,
+    this.error,
+  });
+
+  String get totalReadingFormatted {
+    final hours = totalReadingMinutes ~/ 60;
+    final mins = totalReadingMinutes % 60;
+    if (hours > 0) return '${hours}h ${mins}m';
+    return '${mins}m';
+  }
+
+  AnalyticsState copyWith({
+    int? totalReadingMinutes,
+    int? booksCompleted,
+    int? currentStreak,
+    int? wordsLearned,
+    int? totalSessions,
+    double? avgSessionMinutes,
+    List<DailyReading>? dailyStats,
+    bool? isLoading,
+    String? Function()? error,
+  }) {
+    return AnalyticsState(
+      totalReadingMinutes: totalReadingMinutes ?? this.totalReadingMinutes,
+      booksCompleted: booksCompleted ?? this.booksCompleted,
+      currentStreak: currentStreak ?? this.currentStreak,
+      wordsLearned: wordsLearned ?? this.wordsLearned,
+      totalSessions: totalSessions ?? this.totalSessions,
+      avgSessionMinutes: avgSessionMinutes ?? this.avgSessionMinutes,
+      dailyStats: dailyStats ?? this.dailyStats,
+      isLoading: isLoading ?? this.isLoading,
+      error: error != null ? error() : this.error,
+    );
+  }
+}
+
+class DailyReading {
+  final DateTime date;
+  final int minutes;
+  final int wordsLearned;
+
+  const DailyReading({
+    required this.date,
+    this.minutes = 0,
+    this.wordsLearned = 0,
+  });
+
+  factory DailyReading.fromJson(Map<String, dynamic> json) {
+    return DailyReading(
+      date: DateTime.parse(json['date'] as String),
+      minutes: json['minutes'] as int? ?? json['readingMinutes'] as int? ?? 0,
+      wordsLearned: json['wordsLearned'] as int? ?? 0,
+    );
+  }
+}
+
+class AnalyticsNotifier extends Notifier<AnalyticsState> {
+  @override
+  AnalyticsState build() => const AnalyticsState();
+
+  AnalyticsService get _service => ref.read(analyticsServiceProvider);
+
+  Future<void> loadAnalytics() async {
+    state = state.copyWith(isLoading: true, error: () => null);
+    try {
+      final results = await Future.wait([
+        _service.getOverview(),
+        _service.getDailyStats(),
+      ]);
+      final overview = results[0] as Map<String, dynamic>;
+      final daily = results[1] as List<Map<String, dynamic>>;
+
+      state = state.copyWith(
+        totalReadingMinutes: overview['totalReadingMinutes'] as int? ?? 0,
+        booksCompleted: overview['booksCompleted'] as int? ?? 0,
+        currentStreak:
+            overview['currentStreak'] as int? ??
+            overview['streakDays'] as int? ??
+            0,
+        wordsLearned:
+            overview['wordsLearned'] as int? ??
+            overview['totalWordsLearned'] as int? ??
+            0,
+        totalSessions: overview['totalSessions'] as int? ?? 0,
+        avgSessionMinutes:
+            (overview['avgSessionMinutes'] as num?)?.toDouble() ?? 0,
+        dailyStats: daily.map((e) => DailyReading.fromJson(e)).toList(),
+        isLoading: false,
+      );
+    } catch (e) {
+      state = state.copyWith(isLoading: false, error: () => e.toString());
+    }
+  }
+}
+
+final analyticsProvider =
+    NotifierProvider<AnalyticsNotifier, AnalyticsState>(AnalyticsNotifier.new);