feat: API-Zugang endet mit der Buchung, optionales Ablaufdatum für API-Tokens

Bisher blieb ein einmal erstellter Token gültig, auch wenn Abo bzw. Buchung
längst beendet waren. EnsureApiAccessIsBooked prüft jetzt bei jeder Anfrage
(v1 und /service/…-Altpfade), ob das Konto API-Zugang hat
(ApiAccessEligibilityService::hasApiAccess), sonst 403. Die Tokens bleiben
erhalten und funktionieren nach erneuter Buchung wieder.

Kunden können beim Erstellen optional ein Ablaufdatum setzen (bis 5 Jahre);
die Token-Liste zeigt „Gültig bis“ und einen Hinweis, wenn der Zugang
pausiert ist. sanctum:prune-expired räumt abgelaufene Tokens nach 30 Tagen
täglich ab. API-Doku (public/api/v1.yml) ergänzt.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

resources/views/livewire/customer/tokens.blade.php

@@ -3,6 +3,7 @@
 use App\Actions\Admin\UserImpersonation;
 use App\Livewire\Concerns\ConfirmsIdentity;
 use App\Services\Api\ApiAccessEligibilityService;
+use Illuminate\Support\Carbon;
 use Illuminate\Validation\Rule;
 use Livewire\Attributes\Layout;
 use Livewire\Attributes\Title;
@@ -14,6 +15,12 @@ new #[Layout('components.layouts.app'), Title('API-Tokens')] class extends Compo
 
     public string $tokenName = '';
 
+    /**
+     * Optionales Ablaufdatum (08.10.2026): leer = gültig, solange gebucht
+     * ist. Gesetzt endet der Token am Ende dieses Tages.
+     */
+    public ?string $tokenExpiresOn = null;
+
     /** @var list<string> */
     public array $selectedAbilities = ['press-releases:read'];
 
@@ -49,6 +56,7 @@ new #[Layout('components.layouts.app'), Title('API-Tokens')] class extends Compo
 
         $validated = $this->validate([
             'tokenName' => ['required', 'string', 'max:80'],
+            'tokenExpiresOn' => ['nullable', 'date_format:Y-m-d', 'after:today', 'before_or_equal:'.now()->addYears(5)->toDateString()],
             'selectedAbilities' => ['required', 'array', 'min:1'],
             'selectedAbilities.*' => ['required', 'string', Rule::in(array_keys(self::ABILITIES))],
         ]);
@@ -60,12 +68,16 @@ new #[Layout('components.layouts.app'), Title('API-Tokens')] class extends Compo
         $token = auth()->user()->createToken(
             $validated['tokenName'],
             $validated['selectedAbilities'],
+            filled($validated['tokenExpiresOn'] ?? null)
+                ? Carbon::createFromFormat('Y-m-d', $validated['tokenExpiresOn'])->endOfDay()
+                : null,
         );
 
         $this->plainTextToken = $token->plainTextToken;
         $this->notification = __('Token wurde erstellt. Bitte kopieren Sie ihn jetzt, er wird später nicht erneut angezeigt.');
         $this->eligibilityMessage = null;
         $this->tokenName = '';
+        $this->tokenExpiresOn = null;
         $this->selectedAbilities = ['press-releases:read'];
     }
 
@@ -92,6 +104,7 @@ new #[Layout('components.layouts.app'), Title('API-Tokens')] class extends Compo
             'abilityOptions' => self::ABILITIES,
             'securityProofKind' => $this->securityProofKind(auth()->user()),
             'canCreateApiToken' => $denialReason === null && ! $isImpersonating,
+            'hasApiAccess' => $denialReason === null,
             'canRevokeApiTokens' => ! $isImpersonating,
             'apiTokenDenialReason' => $isImpersonating
                 ? __(self::IMPERSONATION_DENIAL_MESSAGE)
@@ -99,7 +112,7 @@ new #[Layout('components.layouts.app'), Title('API-Tokens')] class extends Compo
             'tokens' => auth()->user()
                 ->tokens()
                 ->latest()
-                ->get(['id', 'name', 'abilities', 'last_used_at', 'created_at']),
+                ->get(['id', 'name', 'abilities', 'last_used_at', 'created_at', 'expires_at']),
         ];
     }
 
@@ -151,7 +164,12 @@ new #[Layout('components.layouts.app'), Title('API-Tokens')] class extends Compo
         <div class="px-4 py-3 rounded-[5px] border text-[12.5px] flex items-start gap-3
                     bg-[color:var(--color-warn-soft)] border-[color:var(--color-warn)]/30 text-[color:var(--color-ink-2)]">
             <flux:icon.lock-closed class="size-[16px] flex-shrink-0 mt-0.5 text-[color:var(--color-accent-deep)]" />
-            <div class="flex-1">{{ $eligibilityMessage ?? $apiTokenDenialReason }}</div>
+            <div class="flex-1">
+                {{ $eligibilityMessage ?? $apiTokenDenialReason }}
+                @if ($tokens->isNotEmpty() && ! $hasApiAccess)
+                    <span class="block mt-1">{{ __('Ihre vorhandenen Tokens sind bis dahin gesperrt. Sie bleiben gespeichert und funktionieren wieder, sobald eine Buchung aktiv ist.') }}</span>
+                @endif
+            </div>
         </div>
     @endif
 
@@ -189,6 +207,13 @@ new #[Layout('components.layouts.app'), Title('API-Tokens')] class extends Compo
                     <flux:error name="tokenName" />
                 </flux:field>
 
+                <flux:field>
+                    <flux:label>{{ __('Gültig bis (optional)') }}</flux:label>
+                    <flux:input type="date" wire:model="tokenExpiresOn" min="{{ now()->addDay()->toDateString() }}" max="{{ now()->addYears(5)->toDateString() }}" class="max-w-[220px]" />
+                    <flux:description>{{ __('Leer lassen: Der Token gilt, solange Ihre Buchung läuft. Mit Datum endet er an diesem Tag um 23:59 Uhr — in jedem Fall spätestens mit dem Ende Ihrer Buchung.') }}</flux:description>
+                    <flux:error name="tokenExpiresOn" />
+                </flux:field>
+
                 <div>
                     <flux:label>{{ __('Berechtigungen') }}</flux:label>
                     <div class="mt-3 grid gap-3 md:grid-cols-2">
@@ -228,6 +253,7 @@ new #[Layout('components.layouts.app'), Title('API-Tokens')] class extends Compo
                 <flux:table.column>{{ __('Berechtigungen') }}</flux:table.column>
                 <flux:table.column>{{ __('Erstellt') }}</flux:table.column>
                 <flux:table.column>{{ __('Zuletzt genutzt') }}</flux:table.column>
+                <flux:table.column>{{ __('Gültig bis') }}</flux:table.column>
                 <flux:table.column>{{ __('Aktionen') }}</flux:table.column>
             </flux:table.columns>
 
@@ -253,6 +279,15 @@ new #[Layout('components.layouts.app'), Title('API-Tokens')] class extends Compo
                             {{ $token->last_used_at?->format('d.m.Y H:i') ?? __('Nie') }}
                         </span>
                     </flux:table.cell>
+                    <flux:table.cell>
+                        @if ($token->expires_at?->isPast())
+                            <span class="badge warn">{{ __('Abgelaufen am :date', ['date' => $token->expires_at->format('d.m.Y')]) }}</span>
+                        @elseif ($token->expires_at)
+                            <span class="text-[12px] text-[color:var(--color-ink-3)]">{{ $token->expires_at->format('d.m.Y') }}</span>
+                        @else
+                            <span class="text-[12px] text-[color:var(--color-ink-3)]">{{ __('Solange gebucht') }}</span>
+                        @endif
+                    </flux:table.cell>
                     <flux:table.cell>
                         <flux:button
                             size="sm"
@@ -268,7 +303,7 @@ new #[Layout('components.layouts.app'), Title('API-Tokens')] class extends Compo
                 </flux:table.row>
             @empty
                 <flux:table.row>
-                    <flux:table.cell colspan="5">
+                    <flux:table.cell colspan="6">
                         <div class="flex flex-col items-center justify-center px-4 py-10 text-center">
                             <div class="w-14 h-14 rounded-[6px] flex items-center justify-center mb-3
                                         bg-[color:var(--color-hub-soft)] border border-[color:var(--color-hub-soft-2)] text-[color:var(--color-hub)]">