87 lines
4.8 KiB
Markdown
87 lines
4.8 KiB
Markdown
# 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.
|