4.8 KiB
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
AK-P20beschreibt nicht mehr Legacy-Provider als Zielsystem, sondern Lago/Mollie-Recut.D-P20,VA-P24a,VD-P24,AK-P19,AK-P21sind an AD-27 angepasst oder mit klarem Recut-Hinweis versehen.EXT-07/EXT-16sind nicht mehr Legacy-Provider-Blocker; Mollie-Test-/Live-Setup ist als neue Setup-Arbeit beschrieben.H-PAYLINKist als alter Legacy-Provider-Vertriebsweg ersetzt durch Mollie-/manuellen Zahlungsweg;H-FOUNDverweist nicht mehr auf Mollie Payment Link.- Offene Legacy-Provider-Codepfade sind inventarisiert: behalten, entfernen, migrieren oder deaktivieren.
- 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.tsund die zugehoerigen Tests als Migrationsvorlage. - Dunning/Frozen-Vorarbeit:
billingDunningServiceundbillingStatusServicebehalten 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 durchBILL-02bisBILL-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 durchBILL-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-01bisBILL-08.
Quellen
docs/ARCHITECTURE-DECISIONS.mdAD-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.