v2.46 — Jahres-Recap (Spotify-Wrapped-Stil) mit Hörstatistiken

## Neuer Recap-Screen
- lib/screens/recap_screen.dart: Full-Screen mit 7 animierten Seiten (Intro, Top 5 Songs, Top 3 Künstler, Hörzeit, häufigster Tag, Nachtaktive %, Gesamtzahl + Teilen)
- Wrapped-Stil: Verlaufs-Gradienten, große Zahlen mit Count-up-Animation, Fade+Scale-Seitenwechsel, Fortschritts-Punkte, Weiter-Button
- Teilen-Button kopiert Recap-Text in die Zwischenablage (kein neues Package)

## Datenbasis
- lib/services/recap_service.dart: aggregiert lokale Abspiel-Historie zu Top-5-Songs, Top-3-Künstler, Hörzeit, Wochentag, Nacht-%, Gesamtzahl
- Fallback auf Gesamt-Historie wenn im Zieljahr keine Daten; freundlicher Leer-Zustand ohne History

## DB + Tracking
- db_helper.dart: Migration v6→v7 mit neuer Tabelle abspiel_historie (song_id, played_at) + Backfill aus wiedergabe_verlauf
- player_service.dart: registriert jeden Abspielvorgang in der Historie

## Einstieg
- Home-Screen: Karte 'Jahres-Recap 2026' unter der Statistik-Card
- Einstellungen: Kachel 'Jahres-Recap' in Sektion Daten & Privatsphäre

flutter analyze: 0 Issues, Tests 4/4

lib/services/player_service.dart

@@ -67,6 +67,14 @@ class PlayerService {
       if (position > 0) await _p.seek(Duration(seconds: position));
       await _p.play();
       _songWechsel.add(song);
+      // Abspiel-Historie für den Jahres-Recap registrieren
+      if (song.id != null) {
+        try {
+          await DbHelper().abspielRegistrieren(song.id!);
+        } catch (e) {
+          debugPrint('Abspiel-Historie fehlgeschlagen: $e');
+        }
+      }
     } catch (e) {
       debugPrint('Fehler beim Abspielen: $e');
       MeloLogger().fehler('player_abspiel_fehler', e);

lib/services/recap_service.dart

@@ -0,0 +1,145 @@
+import '../database/db_helper.dart';
+import '../models/song.dart';
+
+/// Ein Song mit seiner Abspiel-Anzahl im Recap
+class RecapSongStat {
+  final Song song;
+  final int anzahl;
+
+  RecapSongStat(this.song, this.anzahl);
+}
+
+/// Ein Künstler mit seiner Abspiel-Anzahl im Recap
+class RecapKuenstlerStat {
+  final String name;
+  final int anzahl;
+
+  RecapKuenstlerStat(this.name, this.anzahl);
+}
+
+/// Aggregierte Recap-Daten (wie Spotify Wrapped)
+class RecapDaten {
+  final int jahr;
+  final int gesamtAnzahl; // Gesamtzahl aller Abspielungen
+  final int gesamtSekunden; // Geschätzte Hörzeit (Summe Songdauer je Abspielung)
+  final String haeufigsterTag; // z.B. "Freitag"
+  final double nachtProzent; // % der Abspielungen nach 22 Uhr (0–100)
+  final List<RecapSongStat> topSongs; // Top 5
+  final List<RecapKuenstlerStat> topKuenstler; // Top 3
+
+  RecapDaten({
+    required this.jahr,
+    required this.gesamtAnzahl,
+    required this.gesamtSekunden,
+    required this.haeufigsterTag,
+    required this.nachtProzent,
+    required this.topSongs,
+    required this.topKuenstler,
+  });
+
+  String get hoerzeitFormatiert {
+    final stunden = gesamtSekunden ~/ 3600;
+    final minuten = (gesamtSekunden % 3600) ~/ 60;
+    if (stunden > 0) return '$stunden Std $minuten Min';
+    return '$minuten Min';
+  }
+}
+
+/// Aggregiert die lokale Abspiel-Historie zu Recap-Statistiken.
+///
+/// Datenquelle ist die lokale `abspiel_historie`-Tabelle (nicht der Server),
+/// da die History lokal aufgezeichnet wird.
+class RecapService {
+  final DbHelper _db = DbHelper();
+
+  static const List<String> _wochentage = [
+    'Montag', 'Dienstag', 'Mittwoch', 'Donnerstag',
+    'Freitag', 'Samstag', 'Sonntag',
+  ];
+
+  /// Berechnet den Recap. Filtert auf [jahr] (Standard: aktuelles Jahr).
+  /// Falls im gewählten Jahr keine Daten existieren, wird auf die
+  /// Gesamt-Historie zurückgegriffen. Liefert `null` bei leerer History.
+  Future<RecapDaten?> berechne({int? jahr}) async {
+    final zielJahr = jahr ?? DateTime.now().year;
+    var rows = await _db.abspielHistorie();
+
+    if (rows.isEmpty) return null;
+
+    final gefiltert = rows.where((r) {
+      final t = DateTime.tryParse(r['played_at'] as String? ?? '');
+      return t != null && t.year == zielJahr;
+    }).toList();
+
+    // Fallback: wenn im Zieljahr nichts gehört wurde → gesamte History
+    final daten = gefiltert.isNotEmpty ? gefiltert : rows;
+
+    // ── Aggregation ──
+    final songCounts = <int, int>{};
+    final songMap = <int, Song>{};
+    final kuenstlerCounts = <String, int>{};
+    final wochentagCounts = List<int>.filled(7, 0);
+    var nachtCount = 0;
+    var gesamtSekunden = 0;
+
+    for (final r in daten) {
+      final songId = r['song_id'] as int;
+      songCounts[songId] = (songCounts[songId] ?? 0) + 1;
+      songMap[songId] ??= Song.fromMap({
+        'id': songId,
+        'titel': r['titel'] ?? '',
+        'kuenstler': r['kuenstler'] ?? 'Unbekannt',
+        'dauer_sekunden': r['dauer_sekunden'] ?? 0,
+        'datei_pfad': '',
+      });
+
+      final kuenstler = (r['kuenstler'] as String?) ?? 'Unbekannt';
+      kuenstlerCounts[kuenstler] = (kuenstlerCounts[kuenstler] ?? 0) + 1;
+
+      final t = DateTime.tryParse(r['played_at'] as String? ?? '');
+      if (t != null) {
+        wochentagCounts[t.weekday - 1]++;
+        if (t.hour >= 22) nachtCount++;
+      }
+
+      gesamtSekunden += (r['dauer_sekunden'] as int?) ?? 0;
+    }
+
+    final gesamtAnzahl = daten.length;
+    final nachtProzent = gesamtAnzahl == 0
+        ? 0.0
+        : (nachtCount * 100 / gesamtAnzahl).roundToDouble();
+
+    // Häufigster Wochentag (bei Gleichstand der erste)
+    var maxTag = 0;
+    for (var i = 1; i < 7; i++) {
+      if (wochentagCounts[i] > wochentagCounts[maxTag]) maxTag = i;
+    }
+
+    // Top 5 Songs
+    final sortierteSongs = songCounts.entries.toList()
+      ..sort((a, b) => b.value.compareTo(a.value));
+    final topSongs = sortierteSongs
+        .take(5)
+        .map((e) => RecapSongStat(songMap[e.key]!, e.value))
+        .toList();
+
+    // Top 3 Künstler
+    final sortierteKuenstler = kuenstlerCounts.entries.toList()
+      ..sort((a, b) => b.value.compareTo(a.value));
+    final topKuenstler = sortierteKuenstler
+        .take(3)
+        .map((e) => RecapKuenstlerStat(e.key, e.value))
+        .toList();
+
+    return RecapDaten(
+      jahr: zielJahr,
+      gesamtAnzahl: gesamtAnzahl,
+      gesamtSekunden: gesamtSekunden,
+      haeufigsterTag: _wochentage[maxTag],
+      nachtProzent: nachtProzent,
+      topSongs: topSongs,
+      topKuenstler: topKuenstler,
+    );
+  }
+}