Statistiken: Review-Fixes vor Livegang (Fehldarstellungen + Test-Regression)

Ergebnis des Senior-Reviews über dev/2026-07-22 (Konzept 22.07., Feedback 24.07.,
Plan 19.08.). Rechnerisch war nichts zu korrigieren: Payline-Punkte und Provision
des Prognose-Blocks (N4) stimmen exakt mit der Provisions-Engine überein
(54.718,5 P. bzw. 3.772,88 EUR gegengerechnet an User 454). Behoben sind
Darstellungs- und Konsistenzfehler, die der Beraterin als falsche Zahlen
aufgefallen wären:

- "+N neu" schrumpfte rückwirkend, der Bestand daneben nicht: newAboCount() nutzte
  weiter activeAbo(), während aboStockCount() auf das Monatsende zurückrechnet.
  Beide teilen sich jetzt aboStockQuery(); die Jahres-Wachstumstabelle ebenso.
- Level-Kachel widersprach sich ("Zum nächsten Level Diamant fehlen X" über
  "Karriere-Level: Diamant"): Text auf die Monats-Qualifikation umformuliert
  (de/en/es/fr), Überschrift "Qualifikation in diesem Monat", Karriere-Level nur
  noch bei Abweichung.
- Firstlines-Kachel zählte alle direkten Partner, "Teampartner gesamt" daneben nur
  aktive (F1): Kachel nutzt jetzt isActiveConsultant(), die Detailseite listet
  weiter alle und weist beide Zahlen aus.
- Neupartnerzahlen vergangener Monate sanken auf dem Home-Dashboard, sobald
  Jahresgebühren ausliefen: neue User::newPartnerReferenceDate() (laufender Monat =
  heute, abgeschlossener Monat = Monatsende). Dabei die drei Inline-Kopien der
  Neupartner-Regel auf scopeNewPartnerIn()/isNewPartnerIn() zusammengeführt.
- Top-3-Karte ließ den Betrachter aus, obwohl "ich gehört in die Liste" in der
  Juli-Runde für alle anderen Ranglisten umgesetzt wurde: zählt jetzt mit, inkl.
  is_self und "ich"-Badge.
- Neues Profilfoto zeigte bis zu 6 h ein totes Bild: die URL steckt nicht mehr im
  Cache, sondern entsteht beim Lesen (withProfileImages()).
- Test-Regression seit der Juli-Runde: Unit/Services/BackofficeDashboardServiceTest
  fiel über die fehlende Spalte status_points (kam mit nonPaylinePoints() dazu).
- Kleinigkeiten: ProfileImageController gab die komplette Exception als
  Flash-Message aus (jetzt Log + Sprachkey), BackofficeDrilldownService formatierte
  Datumsangaben hart auf d.m.Y statt über Util::formatDateDB().

Tests: neuer HomeMonthlyStatsTest (buildMonthlyStats war ungetestet) plus Tests für
Stichtags-Zählung und Foto-Cache. Fünf Tests kodierten das alte Verhalten
(Betrachter zählt nicht mit, abgelaufener Account zählt nie) und wurden auf die
neue Semantik umgestellt, jeweils mit Gegenprobe. Suite: 861 grün (vorher 855),
89 rot — ausschließlich die in docs/2026-06-11-test-suite-vorbestehende-fehler.md
dokumentierten Altlasten.

Offen und bewusst nicht enthalten:
- Deploy-Schritt: backoffice:store-statistics-snapshots --force (vorher dumpen).
  Kein vorhandener Snapshot enthält recruiter_ranking, Mai/Juni zusätzlich weder
  non_payline_points noch die Führungskräfte-"gesamt"-Spalten; der Cron überspringt
  vorhandene Snapshots ohne --force. Achtung: die Neuberechnung ist nicht
  verlustfrei.
- TreeHtmlRendererTest/TreeCalcBotIntegrationTest: die Abo-Badges machten den
  Renderer datenbankabhängig; die Dateien waren schon vorher rot und gehören in die
  separate Test-Aufräumaufgabe.
- deleteImage bleibt ein GET-Route (gleiches Muster wie das Shop-Bild).

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>

app/User.php

@@ -232,11 +232,23 @@ class User extends Authenticatable
             ->whereNull('deleted_at');
     }
 
+    /**
+     * Stichtag der Neupartner-Prüfung: im laufenden (oder einem zukünftigen)
+     * Monat gilt „heute", für abgeschlossene Monate das Monatsende. Sonst würde
+     * die Neupartnerzahl eines vergangenen Monats rückwirkend sinken, sobald
+     * Jahresgebühren auslaufen — die Zahl muss aber stabil bleiben.
+     */
+    public static function newPartnerReferenceDate(int $month, int $year): Carbon
+    {
+        $endOfMonth = Carbon::create($year, $month, 1)->endOfMonth();
+
+        return $endOfMonth->isFuture() ? now() : $endOfMonth;
+    }
+
     /**
      * Neupartner-Definition der Statistik (eine Regel für KPI, Recruiter-Ranking
-     * und Top-3-Karte): Mitgliedsebene gesetzt, Abrechnungskonto aktuell gültig,
-     * im Monat aktiv geworden. Achtung: `payment_account > now()` macht die
-     * Zählung rückwirkend kleiner, sobald Accounts ablaufen (bewusster Ist-Stand).
+     * und Top-3-Karte): Mitgliedsebene gesetzt, Abrechnungskonto zum Stichtag
+     * gültig ({@see newPartnerReferenceDate()}), im Monat aktiv geworden.
      *
      * @param  Builder  $query
      * @return Builder
@@ -248,10 +260,30 @@ class User extends Authenticatable
 
         return $query->whereNotNull('m_level')
             ->whereNotNull('payment_account')
-            ->where('payment_account', '>', now())
+            ->where('payment_account', '>', self::newPartnerReferenceDate($month, $year))
             ->whereBetween('active_date', [$startDate, $endDate]);
     }
 
+    /**
+     * PHP-seitiges Gegenstück zu {@see scopeNewPartnerIn()} für bereits geladene
+     * User-Collections (Linien-Auswertung, Recruiter-Ranking) — damit die
+     * Neupartner-Regel nur an einer Stelle definiert ist.
+     */
+    public function isNewPartnerIn(int $month, int $year): bool
+    {
+        if ($this->m_level === null || $this->active_date === null || $this->payment_account === null) {
+            return false;
+        }
+
+        if (Carbon::parse($this->payment_account)->lte(self::newPartnerReferenceDate($month, $year))) {
+            return false;
+        }
+
+        $startDate = Carbon::create($year, $month, 1)->startOfMonth();
+
+        return Carbon::parse($this->active_date)->betweenIncluded($startDate, $startDate->copy()->endOfMonth());
+    }
+
     public function user_pre_sponsor()
     {
         return $this->belongsTo('App\User', 'pre_sponsor');