Statistiken/Abo: Kundenfeedback 2026-07-24 komplett umgesetzt + Steuern: DATEV-Fixes 08+09/2025 (Sammel-Commit Branch-WIP)

Feedback-Umsetzung (dev/2026-07-22/feedback-analyse-2026-07-24.md, alle 10 Punkte):
- VIP-Statistik: eigener Berater ('ich', Linie 0) in Neue-Kundenabos- und beiden Top-10-Listen; Top-10-Umsatz sortiert nach abgerechneten Ist-Punkten + Abo-Anzahl-Spalte; Fußnote nicht-payline-wirksame Punkte (SalesVolumePoints::nonPaylinePoints)
- Führungskräfte-Liste: beide Sichten 'direkt' (an nächster FK abgeschnitten, additiv) und 'gesamt' (komplette Downline), Gesamt-Spalte nach Kundenzählweise
- Team-Abos: je Ebene 'abgerechnet (Monat)' und 'bis zum 25. erwartet'; Payline-Karte mit Teamabo-/Kundenabo-Zählern
- Incentive-Live-Ranking: Qualifizierte zuerst nummeriert (fixt auch isWinner rank<=max_winners)
- Porto: Netto-/Brutto-Kennzeichnung (Berater netto, Endkunden inkl. MwSt., portal_view-Flag; auch CRM-/Shop-Warenkorb + Checkout), Yard::shipping_tax-Fix
- Struktur-Ansicht: Abo-Badges 'A' (eigenes Abo) und '(n)' (Kundenabos) je Teampartner, gebatcht
- Abo-Löschung: Softdelete setzt active=0 (UserAbo deleting-Hook) + Bereinigungs-Migration für gelöschte-aber-aktive Abos
- Doku: technische Analyse + Kundinnen-Feedback-Dokument unter dev/2026-07-22/
- Tests: IncentiveRankingTest, TeamStructureAboBadgesTest, YardShippingTaxTest (neu); BackofficeStatisticsListsTest, TeamAboOverviewTest, PaylineForecastServiceTest, AboAdminDeleteTest, AboOneTimeViewTest erweitert

Außerdem enthalten (Branch-WIP vor dem Feedback): DATEV-Abgleich-Fixes 08+09/2025, USt-ID-Live-Validierung sowie restliche unkommittete Stände (u. a. Abo-Pause-Sprachkeys).

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

app/Services/AboHelper.php

@@ -32,6 +32,26 @@ class AboHelper
      */
     public const DEFAULT_ONETIME_WINDOW_DAYS = 4;
 
+    /**
+     * Standard-Mindestlaufzeit (bezahlte Lieferungen) bis zur Kündigung, falls
+     * das Setting `abo-min-duration` nicht gepflegt ist.
+     */
+    public const DEFAULT_ABO_MIN_DURATION = 6;
+
+    /**
+     * Abo-Status, die ein Abo endgültig beenden (4 = gekündigt, 5 = beendet).
+     * Solche Abos blockieren die Anlage eines neuen Abos nicht mehr
+     * (Ein-Abo-Regel gilt nur für laufende Abos).
+     */
+    public const ENDED_STATUSES = [4, 5];
+
+    /**
+     * Standard-Abstand (Monate) zwischen zwei Pausen, falls das Setting
+     * `abo-pause-interval-months` nicht gepflegt ist (max. 1 Pause pro X Monate,
+     * rollierend ab der letzten Pause).
+     */
+    public const DEFAULT_PAUSE_INTERVAL_MONTHS = 6;
+
     public static $txaction_filter_text = [
         'paid' => 'paymend_paid',
         'appointed' => 'paymend_open',
@@ -48,7 +68,7 @@ class AboHelper
     {
         $user = $user ? $user : \Auth::user();
 
-        return UserAbo::where('user_id', $user->id)->where('is_for', 'me')->where('status', '>=', 1)->first() === null ? false : true;
+        return UserAbo::where('user_id', $user->id)->where('is_for', 'me')->where('status', '>=', 1)->whereNotIn('status', self::ENDED_STATUSES)->first() === null ? false : true;
     }
 
     public static function memberHasAbo(ShoppingUser $shopping_user)
@@ -57,12 +77,12 @@ class AboHelper
             return false;
         }
 
-        return UserAbo::where('email', $shopping_user->billing_email)->where('is_for', 'ot')->where('status', '>=', 1)->first() === null ? false : true;
+        return UserAbo::where('email', $shopping_user->billing_email)->where('is_for', 'ot')->where('status', '>=', 1)->whereNotIn('status', self::ENDED_STATUSES)->first() === null ? false : true;
     }
 
     public static function hasAboByEmail($email)
     {
-        return UserAbo::where('email', $email)->where('status', '>=', 1)->first() === null ? false : true;
+        return UserAbo::where('email', $email)->where('status', '>=', 1)->whereNotIn('status', self::ENDED_STATUSES)->first() === null ? false : true;
     }
 
     public static function setAboStatus(ShoppingOrder $shopping_order, $status, $paid = false)
@@ -97,7 +117,9 @@ class AboHelper
 
     public static function getAboMinDuration()
     {
-        return Setting::getContentBySlug('abo-min-duration');
+        $minDuration = Setting::getContentBySlug('abo-min-duration');
+
+        return $minDuration === false || $minDuration === null || $minDuration === '' ? self::DEFAULT_ABO_MIN_DURATION : $minDuration;
     }
 
     public static function canCancelAbo(UserAbo $user_abo, $view = 'user')
@@ -120,6 +142,59 @@ class AboHelper
         return ! self::canCancelAbo($user_abo, $view);
     }
 
+    /**
+     * Konfigurierter Mindestabstand (Monate) zwischen zwei Pausen.
+     */
+    public static function getPauseIntervalMonths(): int
+    {
+        $months = (int) Setting::getContentBySlug('abo-pause-interval-months');
+
+        return $months > 0 ? $months : self::DEFAULT_PAUSE_INTERVAL_MONTHS;
+    }
+
+    /**
+     * Darf das Abo aktuell um einen Monat pausiert werden?
+     * Voraussetzungen (außer Admin): Abo läuft (aktiv, Status 2), Mindestlaufzeit
+     * erreicht (gleiche Basis wie die Kündigung, Setting `abo-min-duration`) und
+     * die letzte Pause liegt mindestens {@see getPauseIntervalMonths()} Monate
+     * zurück (rollierend). Die Sperrfrist vor der Ausführung
+     * (`abo-lock-days-pause-cancel`) wird separat in der Pause-Aktion geprüft.
+     */
+    public static function canPauseAbo(UserAbo $user_abo, $view = 'user'): bool
+    {
+        if (! $user_abo->active || (int) $user_abo->status !== 2) {
+            return false;
+        }
+
+        if ($view === 'admin') {
+            return true;
+        }
+
+        if (! self::canCancelAbo($user_abo, $view)) {
+            return false;
+        }
+
+        return self::nextPossiblePauseDate($user_abo) === null;
+    }
+
+    /**
+     * Frühestes Datum, ab dem wieder pausiert werden darf — oder null, wenn die
+     * Pause bereits jetzt möglich ist (keine oder ausreichend lange zurückliegende
+     * letzte Pause). Dient auch dem UI-Hinweis "wieder möglich ab".
+     */
+    public static function nextPossiblePauseDate(UserAbo $user_abo): ?Carbon
+    {
+        $lastPauseDate = $user_abo->getRawOriginal('last_pause_date');
+
+        if (! $lastPauseDate) {
+            return null;
+        }
+
+        $nextPossible = Carbon::parse($lastPauseDate)->startOfDay()->addMonthsNoOverflow(self::getPauseIntervalMonths());
+
+        return $nextPossible->lte(Carbon::today()) ? null : $nextPossible;
+    }
+
     /**
      * Prüft, ob das Bearbeiten des Abos (Liefertag/Intervall) aktuell durch die
      * Sperrfrist vor der Ausführung blockiert ist. Admins umgehen die Sperre.