Optimierung Phase 0: Korrektheit & Security

Konsolidierter Entwicklungsplan aus den zwei Analyse-Dokumenten plus
Umsetzung der Phase-0-Massnahmen (Korrektheit/Security, je mit Tests):

0.1 BasicAuth: timing-sicherer Vergleich (hash_equals, beide Felder ohne
    Short-Circuit); Enabled-Check zur Laufzeit via config('auth.basic.*')
    statt env() im Bootstrap-Closure (greift jetzt unter config:cache);
    Config-Block + .env.example. Fund: auth.basic.* war nie als Config
    definiert, Gate war faktisch unkonfigurierbar.
0.2 Legacy-Invoice-"latest"-Abfrage zentralisiert (LegacyInvoice::
    scopeLatestFirst + User::latestLegacyInvoice); beide Consumer N+1-frei
    umgestellt; unterschiedliches null-Verhalten bewusst erhalten.
0.3 Payment-Option-Eligibility vereinheitlicht (period-aware, strikt):
    UserPaymentOption::scopeActiveNow/grandfatheredNow + User::
    hasActivePaymentOption; hasActiveBooking/hasUnlimitedPressReleaseQuota
    und ApiAccessEligibilityService darauf umgestellt; $hasGrandfathered-
    Mislabel behoben.
0.4 Theme->Portal-Vokabular: totes, projektfremdes ThemeMiddleware
    geloescht; Mapping in Portal::fromTheme() zentralisiert; fremden
    b2in-Default im ThemeServiceProvider auf Portal-Default korrigiert.
0.5 InvoiceNumberGenerator: Erst-Insert race-sicher via insertOrIgnore
    (Unique-Index auf circle existiert bereits). CreditWalletService war
    bereits abgesichert (Unique-Index + createOrFirst).

Tests: 4 neue Dateien, 5 bestehende auf gueltiges grandfathered_until
angepasst. Volle Suite gruen (793 passed, 1 skipped).

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

app/Models/UserPaymentOption.php

@@ -3,6 +3,7 @@
 namespace App\Models;
 
 use App\Enums\UserPaymentOptionStatus;
+use Illuminate\Database\Eloquent\Builder;
 use Illuminate\Database\Eloquent\Factories\HasFactory;
 use Illuminate\Database\Eloquent\Model;
 use Illuminate\Database\Eloquent\Relations\BelongsTo;
@@ -58,4 +59,33 @@ class UserPaymentOption extends Model
     {
         return $this->hasMany(UserPayment::class);
     }
+
+    /**
+     * Aktuell gültige Zahlungsoption (period-aware): aktives Abo innerhalb der
+     * laufenden Periode ODER laufender Bestandsschutz. Single Source of Truth
+     * für „aktive Zahlungsoption" in API-Gate, Buchungs- und Kontingent-Checks.
+     */
+    public function scopeActiveNow(Builder $query): Builder
+    {
+        return $query->where(function (Builder $query): void {
+            $query
+                ->where(function (Builder $active): void {
+                    $active
+                        ->where('status', UserPaymentOptionStatus::Active->value)
+                        ->whereDate('current_period_start', '<=', now())
+                        ->whereDate('current_period_end', '>=', now());
+                })
+                ->orWhere(fn (Builder $grandfathered): Builder => $grandfathered->grandfatheredNow());
+        });
+    }
+
+    /**
+     * Laufender Bestandsschutz (Grandfathered mit gültigem grandfathered_until).
+     */
+    public function scopeGrandfatheredNow(Builder $query): Builder
+    {
+        return $query
+            ->where('status', UserPaymentOptionStatus::Grandfathered->value)
+            ->whereDate('grandfathered_until', '>=', now());
+    }
 }