Phase 9F: Tarif-Seite mit Stripe-Checkout und Billing Portal

- Buchungs-Seite zeigt das echte 4-Tier-Raster aus plans (Monat/Jahr-
  Toggle, Jahrespreis als "2 Monate gratis") mit Checkout-Buttons,
  Einzel-PM als separaten No-Abo-Block und Enterprise-Hinweis;
  Credit-Konzept-Mock entfernt (Credits folgen mit 9I bzw. Phase 2)
- Aktueller-Tarif-Panel real: Abo (Preis, Kontingent, Kündigungsstatus),
  Bestandstarif (unbegrenzt, nächste MAN-Rechnung), offene Einzelkäufe;
  Kontingent-Kachel zeigt "Unbegrenzt" bei Bestandsschutz
- "Abo verwalten" über das Stripe Billing Portal
  (me.checkout.billing-portal; Zahlungsmethode, Rechnungen, Kündigung)
- Aktive Buchungen + Verlauf aus echten Daten (Abo, Legacy-Vereinbarung,
  offene/eingelöste Einzelkäufe mit PM-Verknüpfung)
- Tests: BookingsPageTest (9 Tests), PanelConsolidationTest angepasst;
  Suite 519 passed / 4 skipped
- Doku: PHASE-9-Plan 9F ✅, Billing-Doku (Routen, Stripe Tax aktiviert),
  STATUS-ABGLEICH, Checkliste, PROGRESS

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

docs/PHASE-9-FLOW-UND-TARIFE-PLAN.md

@@ -42,7 +42,7 @@ Phase 9 setzt das Decision-Update vom 11./12.06.2026 um — in zwei Blöcken:
 | — | **Review-Stopp mit User** | | |
 | **9D** ✅ | Tarif-Datenmodell: Pläne, Einzelkäufe, Cashier, Rechnungskreise STR-/MAN-, MAN-Fälligkeitslauf (Stub-Ablösung folgt mit 9E) | L | hoch (Datenmodell) |
 | **9E** ✅ | Stripe-Anbindung: Produkt-Sync (Tarife + Einzel-PM), Webhook-Verarbeitung (STR-Spiegelung, Einmalkauf-Erfüllung, Endpoint registriert), Checkout-Flows (Backend), Slot-Logik auf Plan-Kontingent (Grandfathered = unbegrenzt), Stripe Tax | L | mittel |
-| **9F** | Tarif-Seite + Checkout-UI (Raster, Einzel-PM-Block, „2 Monate gratis", Enterprise-Hinweis) | M | gering |
+| **9F** ✅ | Tarif-Seite + Checkout-UI: Buchungs-Seite mit echtem 4-Tier-Raster (Monat/Jahr-Toggle, „2 Monate gratis"), Einzel-PM-Block, Bestandstarif-Anzeige, „Abo verwalten" (Stripe Billing Portal), Enterprise-Hinweis | M | gering |
 | **9G** | Tageslimit je Tier (Business 2 / Pro 3 / Agency 5; gilt auch für Extra-PMs) | S | gering |
 | **9H** | Einzel-PM-Kauf (19 €) + Einzel→Abo-Brücke (Anrechnung 30 Tage) | M | mittel |
 | **9I** | Launch-Credits: Extra-PM, Boost (nur Grün), Veröffentlichungsnachweis-PDF | L | mittel |
@@ -201,12 +201,22 @@ ist hybrid mit zwei getrennten Rechnungskreisen (plus Altbestand):
 - Offen → §7 der Billing-Doku: Stripe Tax im Dashboard aktivieren,
   Live-Mode-Sync vor Relaunch.
 
-### 9F · Tarif-Seite + Checkout-UI
+### 9F · Tarif-Seite + Checkout-UI ✅ (12.06.2026)
 
-- Raster mit 4 Tiers; Einzel-PM als separater No-Abo-Block (nicht als
-  billigste Spalte); Enterprise als dezenter Sales-Hinweis unter der Tabelle.
-- Jahrespreis kommuniziert als „2 Monate gratis".
-- Einstieg aus dem Submit-Gate-Hinweis (9C) und aus „Buchungen & Add-ons".
+- ✅ „Buchungen & Add-ons" zeigt das echte 4-Tier-Raster aus `plans`
+  (Monat/Jahr-Toggle, Jahrespreis als „2 Monate gratis") mit
+  Checkout-Buttons auf `me.checkout.subscription`; Einzel-PM als
+  separater No-Abo-Block (`me.checkout.single-pm`); Enterprise als
+  dezenter Hinweis unter dem Raster. Der Credit-Konzept-Mock ist
+  abgelöst (Credits → 9I bzw. Phase 2).
+- ✅ Aktueller Tarif real: Abo (Preis, Kontingent, Kündigungsstatus),
+  Bestandstarif (unbegrenzt, nächste MAN-Rechnung) oder offene
+  Einzelkäufe; Kontingent-Kachel (`Unbegrenzt` bei Bestandsschutz).
+- ✅ „Abo verwalten" → Stripe Billing Portal (`me.checkout.billing-portal`:
+  Zahlungsmethode, Rechnungen, Kündigung).
+- ✅ Aktive Buchungen + Verlauf aus echten Daten (Abo, Legacy-Vereinbarung,
+  offene/eingelöste Einzelkäufe mit PM-Verknüpfung).
+- Einstieg aus dem Submit-Gate-Hinweis (9C) führt bereits hierher.
 
 ### 9G · Tageslimit
 

docs/STATUS-ABGLEICH-USER-PANEL.md

@@ -128,8 +128,8 @@ Zentrale Billing-Referenz: [`user-admin/Billing-und-Rechnungskreise.md`](./user-
 | Rechnungen mit Legacy-Archiv | umgesetzt | ✅ |
 | Hybride Rechnungskreise STR-/MAN- (Decision 12.06.) | umgesetzt (Phase 9D) — Nummern-Generator, MAN-Fälligkeitslauf, Grandfather-Migration, USt-Logik (`VatResolver`) | ✅ |
 | Tarif-Datenmodell + Cashier | umgesetzt (Phase 9D) — `plans`, `single_purchases`, `User` ist Billable | ✅ |
-| Stripe-Checkout/Webhooks + STR-Spiegelung | umgesetzt (Phase 9E) — Produkt-Sync, Webhook-Verarbeitung, Checkout-Backend, Plan-Kontingent | ✅ (UI → 9F) |
-| Buchungen & Add-ons (UI) | nur Stub | 📝 (mit 9F Tarif-Seite) |
+| Stripe-Checkout/Webhooks + STR-Spiegelung | umgesetzt (Phase 9E) — Produkt-Sync, Webhook-Verarbeitung, Checkout-Backend, Plan-Kontingent | ✅ |
+| Buchungen & Add-ons (UI) | umgesetzt (Phase 9F) — Tarif-Raster, Einzel-PM-Block, Bestandstarife, Billing Portal | ✅ |
 | Zahlungsmethoden firmenscharf | **fehlt** | 📝 (Phase 2) |
 
 ---

docs/user-admin/Billing-und-Rechnungskreise.md

@@ -1,8 +1,8 @@
 # Billing & Rechnungskreise (hybrides Modell)
 
 Stand: 12.06.2026 — Datenmodell, MAN-Kreis, USt-Behandlung (Phase 9D) sowie
-Stripe-Sync, Webhook-Verarbeitung, Checkout-Flows und Plan-Kontingent
-(Phase 9E) umgesetzt. Es fehlt die Checkout-UI (Phase 9F).
+Stripe-Sync, Webhook-Verarbeitung, Checkout-Flows, Plan-Kontingent
+(Phase 9E) und Tarif-Seite/Checkout-UI (Phase 9F) umgesetzt.
 
 Dieses Dokument ist die zentrale Referenz für das Abrechnungssystem:
 Rechnungskreise, Tarif-Datenmodell, Steuerlogik, Befehle und Konfiguration.
@@ -61,12 +61,13 @@ monatlicher Reset), danach wird der älteste bezahlte Einmalkauf eingelöst
 (`single_purchases.status → consumed`, verknüpft mit der PM). Die frühere
 Stub-Spalte `users.press_release_quota` ist entfernt.
 
-**Checkout-Einstiege** (Phase 9E; UI-Anbindung folgt in 9F):
+**Checkout-Einstiege** (Phase 9E/9F — verdrahtet auf der Buchungs-Seite):
 
 | Route | Zweck |
 |---|---|
 | `me.checkout.subscription` (`/admin/me/checkout/abo/{slug}/{monthly\|yearly}`) | Stripe-Checkout für ein Tarif-Abo |
 | `me.checkout.single-pm` (`/admin/me/checkout/einzel-pm`) | Stripe-Checkout Einzel-PM (legt `single_purchases`-Eintrag `pending` an; Webhook setzt `paid`) |
+| `me.checkout.billing-portal` (`/admin/me/checkout/abo-verwalten`) | Stripe Billing Portal (Zahlungsmethode, Rechnungen, Kündigung) |
 
 Erfolg/Abbruch landen auf der Buchungs-Seite (`?checkout=erfolg|abbruch`).
 Die Steuer ergänzt **Stripe Tax** automatisch (`Cashier::calculateTaxes()`
@@ -180,12 +181,12 @@ CLI ausgegebene `whsec_…` temporär als `STRIPE_WEBHOOK_SECRET` in die `.env`.
    Routen siehe Abschnitt 2), Slot-Logik auf Plan-Kontingent umgestellt
    (Grandfathered = unbegrenzt, Entscheidung 12.06.2026), Stub-Spalte
    entfernt, Stripe Tax aktiviert (`Cashier::calculateTaxes()`).
-1. **Phase 9F**: Tarif-Seite/Buchungs-UI an die Checkout-Routen anbinden
-   (die Buchungs-Seite ist noch Konzept-Mock mit deaktivierten Buttons);
-   echte Tarif-/Buchungsdaten statt Platzhalter anzeigen.
-2. **Stripe Tax im Dashboard aktivieren** (Ursprungsadresse/Registrierung
-   hinterlegen) — ohne das schlägt der Checkout mit automatischer Steuer
-   fehl. Im Test-Mode prüfen, dann im Live-Mode wiederholen; dort auch
+1. **Phase 9F erledigt** (12.06.2026): Die Buchungs-Seite zeigt das echte
+   Tarif-Raster (Monat/Jahr-Toggle), den Einzel-PM-Block, Bestandstarife
+   und „Abo verwalten" (Stripe Billing Portal, `me.checkout.billing-portal`).
+2. **Stripe Tax**: im Dashboard aktiviert (12.06.2026, Produkt-Steuercode
+   „SaaS – business use", Steuer nicht im Preis enthalten — passt zu den
+   Netto-Preisen). Vor Relaunch im **Live-Mode** wiederholen; dort auch
    `billing:sync-stripe-plans` erneut ausführen (Live-Produkt-IDs).
 3. **VIES-Validierung** der USt-ID (aktuell Formatprüfung; Stripe prüft
    die im Checkout erfasste USt-ID asynchron selbst).

docs/user-admin/checkliste-user-backend.md

@@ -129,6 +129,7 @@ Verbindliche Entscheidungen: `docs/Decision-Update Preisstruktur & Veröffentlic
 - [x] USt-Behandlung (12.06.): alle neuen Preise netto; `VatResolver` (DE immer Steuer, EU nur mit USt-ID befreit/Reverse Charge, Drittland befreit), `vat_id` an Rechnungsadresse + Rechnungs-Snapshot, `tax_note` auf Rechnungen; Grandfathered rechnen auf Netto-Basis der letzten Legacy-Rechnung (Brutto bleibt fuer DE-Bestandskunden gleich).
 - [ ] VIES-Validierung der USt-ID (aktuell Formatpruefung) — vor Gate-/Checkout-Aktivierung.
 - [x] Stripe-Checkout + Webhooks (Phase 9E, 12.06.): Produkt-Sync nach Stripe (Tarife + Einzel-PM, netto, Stripe Tax), STR-Rechnungsspiegelung + Einmalkauf-Erfuellung per Webhook (Endpoint registriert), Checkout-Flows als Backend (`me.checkout.subscription`/`me.checkout.single-pm`), Slot-Logik auf Plan-Kontingent umgestellt (Grandfathered = unbegrenzt, Bestandsschutz), Quota-Stub-Spalte entfernt. UI-Anbindung folgt in 9F. Doku: `docs/user-admin/Billing-und-Rechnungskreise.md`.
+- [x] Tarif-Seite + Checkout-UI (Phase 9F, 12.06.): Buchungs-Seite mit echtem 4-Tier-Raster (Monat/Jahr-Toggle, "2 Monate gratis"), Einzel-PM-Block, Bestandstarif-Anzeige (unbegrenzt), "Abo verwalten" via Stripe Billing Portal; Credit-Mock abgeloest (Credits → 9I/Phase 2).
 - [ ] Tageslimit je Tier (Business 2 / Pro 3 / Agency 5), gilt auch fuer Extra-PMs.
 - [ ] Launch-Credits: Extra-PM, Boost (nur gruene PMs), Veroeffentlichungsnachweis-PDF; Credit-Anker 1 Credit = 1 €.
 - [ ] Einzel→Abo-Bruecke (19 € Anrechnung innerhalb 30 Tagen).