Files
HiveGrid-Wireframes/03 Quellen und Referenzen/hivegrid-cloud/.planning/ticket-docs/BILL-00.md
T
2026-07-08 16:15:37 +02:00

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.