# BILL-00 · Billing-Recut: Legacy-Provider-Annahmen durch Lago/Mollie ersetzen | | | |---|---| | **Typ** | Dev/Docs | | **Owner** | Raffael | | **Phase** | Billing-Recut nach AD-27 | | **Cycle/Fenster** | zuerst im Billing-Track | | **Status** | Umgesetzt / bereit fuer Review | ## Abhaengigkeiten & Parallelitaet - **Blocked by:** AD-27 entschieden. - **Blocks:** alle weiteren `BILL-*`-Tickets. - **Parallelitaet:** keine Produktcode-Implementierung; Doku-/Planungs-Recut. ## Was wir bauen Die bestehenden Legacy-Provider-basierten Billing-Docs wurden dependency-aware auf die neue Zielarchitektur gezogen: Lago fuer Billing/Invoicing, Mollie nur fuer Payments, HiveGrid fuer Entitlements. Vorhandene Arbeit aus `AK-P20` wird nicht verworfen, sondern als wiederverwendbare Billing-/Feature-Gate-/Read-only-Grundlage markiert. ## Definition of Done - [x] `AK-P20` beschreibt nicht mehr Legacy-Provider als Zielsystem, sondern Lago/Mollie-Recut. - [x] `D-P20`, `VA-P24a`, `VD-P24`, `AK-P19`, `AK-P21` sind an AD-27 angepasst oder mit klarem Recut-Hinweis versehen. - [x] `EXT-07`/`EXT-16` sind nicht mehr Legacy-Provider-Blocker; Mollie-Test-/Live-Setup ist als neue Setup-Arbeit beschrieben. - [x] `H-PAYLINK` ist als alter Legacy-Provider-Vertriebsweg ersetzt durch Mollie-/manuellen Zahlungsweg; `H-FOUND` verweist nicht mehr auf Mollie Payment Link. - [x] Offene Legacy-Provider-Codepfade sind inventarisiert: behalten, entfernen, migrieren oder deaktivieren. - [x] DoD-Stand der betroffenen Tickets bleibt nachvollziehbar; nichts wurde still auf Done gesetzt. **Fortschritt:** `BILL-00`: 6/6 DoD = 100 % done. Ticket kann nach Review/Plane-Kommentar weitergeschoben werden. ## Code-Inventar fuer `BILL-02` bis `BILL-05` **Migrieren auf Lago/Mollie/HiveGrid-Billing:** - Core-Subscription-Schema: Legacy-Provider-zentrierte Felder in `prisma/schema/subscriptions.prisma` (`legacyProviderId`, `legacyProviderCustomerId`, `legacyProviderSubscriptionId`, `legacyProviderSubscriptionItemId`, `Legacy-ProviderWebhookLog`). - DB-Service-Schicht: Legacy-Provider-spezifische Helfer und Typen in `packages/db/src/subscriptions.server.ts`. - Web-Billing-Adapter: `apps/web/app/utils/legacyProvider.server.ts`, `apps/web/app/routes/webhooks.legacyProvider.tsx`, `apps/api/src/billing/legacyProvider-webhook-route.ts` und die zugehoerigen Tests als Migrationsvorlage. - Dunning/Frozen-Vorarbeit: `billingDunningService` und `billingStatusService` behalten fachlich, aber Provider- Kopplung auf generische Billing-/Payment-Events umbauen. - Admin-/Settings-Routen: Subscription-/Invoice-/PaymentMethod-Komponenten und Admin-Subscription-Routen, die heute Legacy-Provider-Typen oder Legacy-Provider-IDs anzeigen. - Mail-Templates: Invoice/Subscription-Erfolgs-/Fehlertexte von Legacy-Provider-Bezug auf generische Billing-/Payment-Texte umstellen. **Deaktivieren oder spaeter separat entscheiden:** - Portal/Sites-Legacy-Provider-Connect-Code in der Plugin-/Portal-Altlast. Das ist nicht HiveGrid-v1-Core-Billing und darf nicht in den neuen Billing-Pfad gezogen werden. - Legacy-Provider-Metering-/Usage-Dokumente und Ops-Runbooks. v1 hat kein Usage-Billing. **Behalten als harmlose Beispiele/Test-Fixtures, bis ein eigener Cleanup folgt:** - Plugin-Runtime-Testdaten mit `legacyProvider_*` als generischem Secret-Key-Muster. - Alte Migrationshistorie, solange sie fuer bestehende DB-Reproduzierbarkeit noetig ist. ## Betroffene Planungsdocs - `AK-P20`: alter Legacy-Provider-Abschluss ersetzt durch `BILL-02` bis `BILL-05`; AK-P20 bleibt Vorarbeit fuer Trial, Frozen, Onboarding, Demo-Daten, Checkliste, Theme und Entitlement-Gates. - `D-P20`: v1-Screens zeigen Plan/Seats, Lago-Invoices, Mollie-Payment-Status, kein Legacy-Provider-Portal. - `VA-P24a`/`VD-P24`: v2-Self-Service baut auf Lago/Mollie, nicht auf Legacy-Provider-Reuse. - `AK-P19`: Admin-Abo-Zusammenstellung = Entitlements + Billing-State; Legacy-Provider-Positionen ersetzt durch `BILL-06`. - `AK-P21`: Tenant-Löschung nutzt generischen Billing-Cancel-Vertrag, nicht Legacy-Provider-Cancel. - `EXT-07`/`EXT-16`: Mollie-Test-/Live-Setup + Lago-Staging/Prod statt Legacy-Provider. - `H-PAYLINK`/`H-FOUND`: Founding-Deal-Zahlungsweg ohne Legacy-Provider. ## Technische Bausteine - Keine Produktcode-Aenderung in `BILL-00`. - Ergebnis ist ein sauberer Planungsstand fuer `BILL-01` bis `BILL-08`. ## Quellen - `docs/ARCHITECTURE-DECISIONS.md` AD-15, AD-27 - `.planning/ticket-docs/BILL-README.md` - `.planning/ticket-docs/AK-P20.md` - `.planning/ticket-docs/D-P20.md` - `.planning/ticket-docs/VA-P24a.md`, `.planning/ticket-docs/VD-P24.md` - `.planning/ticket-docs/EXT-07.md`, `.planning/ticket-docs/EXT-16.md`, `.planning/ticket-docs/H-PAYLINK.md` ## Umsetzungsnotiz 2026-07-04: Doku-Recut umgesetzt. `git diff --check` ist der passende Proof fuer dieses Docs-only-Ticket; Produktcode wurde bewusst nicht geaendert. Plane-Status/Kommentar stehen noch aus.