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

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-P20 beschreibt nicht mehr Legacy-Provider als Zielsystem, sondern Lago/Mollie-Recut.
  • D-P20, VA-P24a, VD-P24, AK-P19, AK-P21 sind an AD-27 angepasst oder mit klarem Recut-Hinweis versehen.
  • EXT-07/EXT-16 sind nicht mehr Legacy-Provider-Blocker; Mollie-Test-/Live-Setup ist als neue Setup-Arbeit beschrieben.
  • H-PAYLINK ist als alter Legacy-Provider-Vertriebsweg ersetzt durch Mollie-/manuellen Zahlungsweg; H-FOUND verweist 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.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.