Document Paddle sync recovery

docs/ops/billing-ops.md

@@ -130,4 +130,26 @@ Diese Sektion ist bewusst generisch gehalten, damit sie auch nach Implementation
   - Bei Katalog‑Abweichungen `paddle:sync-packages --dry-run` verwenden, um Snapshots zu prüfen, bevor tatsächliche Änderungen gesendet werden.
   - Fehlgeschlagene Syncs in den Logs (`Paddle package sync failed`, `Paddle discount sync failed`) beobachten.
 
+### 6.5 Recovery-Playbook: Katalog‑Sync fehlgeschlagen
+
+Wenn der Katalog‑Sync fehlschlägt oder Pakete nicht mehr korrekt verknüpft sind:
+
+1. **Status im Admin prüfen**
+   - `PackageResource` → Felder `paddle_sync_status`, `paddle_synced_at` und `Letzter Fehler`.
+   - Fehlermeldung stammt aus `paddle_snapshot.error.message`.
+2. **Trockenlauf ausführen**
+   - `php artisan paddle:sync-packages --package=<id|slug> --dry-run`
+   - Prüfe die erzeugten Payload‑Snapshots (in `paddle_snapshot`) auf falsche IDs/Preise.
+3. **Mapping prüfen**
+   - Falls `paddle_product_id` oder `paddle_price_id` fehlt oder falsch ist: im Paket‑Admin korrigieren.
+   - Bulk‑Sync blockiert unmapped Pakete; gezielte Korrektur vor dem nächsten Lauf ist Pflicht.
+4. **Sync erneut anstoßen**
+   - `php artisan paddle:sync-packages --package=<id|slug> --queue`
+   - Bei Bedarf: `--allow-unmapped` nur bewusst verwenden (z.B. initiales Mapping).
+5. **Pull für Abgleich**
+   - `php artisan paddle:sync-packages --package=<id|slug> --pull` zum Abgleich mit Paddle.
+6. **Logs prüfen**
+   - Erwartete Logeinträge: `Paddle package sync failed`, `Paddle addon sync failed`, `Paddle discount sync failed`.
+   - 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.