Document Paddle cutover

docs/ops/billing-ops.md

@@ -178,3 +178,32 @@ Wenn der Katalog‑Sync fehlschlägt oder Pakete nicht mehr korrekt verknüpft s
    - Achte auf wiederkehrende Fehler (z.B. invalid product/price IDs).
 
 Diese Untersektion soll dir als Operator helfen zu verstehen, wie Paddle‑Aktionen im System abgebildet sind und an welchen Stellen du im Fehlerfall ansetzen kannst.
+
+## 7. Production Cutover: Paddle Migration
+
+Diese Checkliste beschreibt den kontrollierten Wechsel auf Paddle in Produktion.
+
+1. **Vorbereitung (T‑1 Woche)**
+   - Confirm: `PADDLE_ENVIRONMENT=production`, `PADDLE_API_KEY`, `PADDLE_CLIENT_TOKEN`, `PADDLE_WEBHOOK_SECRET`.
+   - Package IDs validieren: alle aktiven Packages haben `paddle_product_id` und `paddle_price_id`.
+   - `paddle:sync-packages --dry-run` auf eine Stichprobe anwenden.
+   - Event‑Liste prüfen: `config/paddle.php` (`webhook_events`).
+2. **Staging Smoke (T‑2 Tage)**
+   - `paddle:webhooks:register --traffic-source=simulation` auf Staging ausfuehren.
+   - Testkauf via Paddle Sandbox und Webhook Replay verifizieren.
+3. **Cutover Window (T‑0)**
+   - Marketing‑Checkout kurz einfrieren (kein Checkout waehrend der Umschaltung).
+   - Production Webhook registrieren:
+     - `paddle:webhooks:register --traffic-source=platform --url=https://<prod-domain>/paddle/webhook`
+   - Queue worker laufen lassen (Queue: `webhooks`/`billing` sofern konfiguriert).
+4. **Activation**
+   - Erstes Produktions‑Checkout ausfuehren.
+   - Verify: `checkout_sessions.provider_metadata` wird mit `paddle_*` Feldern befuellt.
+   - Verify: `TenantPackage` aktiv und `subscription_status` korrekt.
+5. **Rollback (falls notwendig)**
+   - Checkout wieder deaktivieren (Marketing‑Checkout ausblenden).
+   - Paddle Webhook Destination im Paddle Dashboard deaktivieren.
+   - Status und Logs sichern (Webhooks, `paddle_sync` Log).
+6. **Post‑Cutover (T+1)**
+   - Stichproben auf neue Tenants/Packages.
+   - Monitoring: Fehlgeschlagene Webhooks, Sync‑Fehler, Support Tickets.