Files
HiveGrid-Wireframes/03 Quellen und Referenzen/hivegrid-cloud/.planning/ticket-docs/BILL-README.md
T

3.6 KiB

BILL-README · Billing-Recut Track

Typ Planungs-/Dev-Track
Owner Raffael
Phase Billing-Recut nach AD-27
Cycle/Fenster nach MCP-/P12-Arbeit einplanen
Status Technischer Pfad umgesetzt; BILL-08 wartet auf externe Production-Gates

Ziel

Legacy-Provider wird als Billing-/Payment-Default abgeloest. HiveGrid nutzt:

  • Lago self-hosted als Billing-Engine fuer Plans, Seats, Subscriptions und Invoices.
  • Mollie nur als Payment Processor.
  • HiveGrid als Produkt-/Entitlement-Schicht.

Der umgesetzte Scope umfasst die drei Basispakete Core / Swarm / Colony, rollenbasierte Zusatzsitze, feste wiederkehrende Speicherpakete, Lago-Rechnungen und Mollie-Zahlungen. Es gibt kein Usage-Metering, keine Credits und keine automatische Enterprise-Buchung.

Ticket-Reihenfolge

  1. BILL-00 — Legacy-Provider-Recut und Planungs-Docs bereinigen
  2. BILL-01 — Lago-Staging sauber betreiben
  3. BILL-02 — Billing-Domain fuer Plans/Seats festziehen
  4. BILL-03 — Lago-Gateway integrieren
  5. BILL-04 — Mollie-Payment-Gateway integrieren
  6. BILL-05 — Sync, Entitlements und Read-only/Frozen-State
  7. BILL-06 — interne Admin-Billing-Basis
  8. BILL-07 — E2E-Sandbox-Flow
  9. BILL-09 — Kunden-Rechnungszugriff in HiveGrid
  10. BILL-10 — Self-Service-Checkout fuer Planwechsel
  11. BILL-11 — Pricing-Katalog, Jahresbindung und Recurring Payments
  12. BILL-12 — Kundenplan-Namen in Billing-Oberflaechen konsistent halten
  13. BILL-13 — Immersiver Mollie-Checkout, Add-on-Wechsel und read-only Usage-Transparenz
  14. BILL-14 — Zweistufige Registrierung mit Teamgröße, Tarifempfehlung und Checkout-Prefill
  15. BILL-18 — Responsive Registrierungs-Tarifwahl und sicherer CAPTCHA-Retry
  16. BILL-21 — Beträge über 1.000 EUR brutto in Erst- und Folgezahlungen ausschließlich per Mollie-Karte einziehen
  17. BILL-22 — geführter Checkout mit Teamgröße vor Tarif, getrennten Speicher-/E-Mail-Upsells und freier Mollie-Zahlart bis 1.000 EUR
  18. BILL-08 — Prod-Prep; technisch vorbereitet, wartet nur auf EXT-16 Mollie-Live/KYC und Legal-/Steuerfreigabe
  19. BILL-25 — egress-resiliente Speicherpreise, Download-Traffic- Transparenz und erneuter Staging-Journey-Proof vor Production-Sync

Architektur-Grenzen

  • Lago ist Billing-Source-of-Truth fuer Rechnungs-/Subscription-Berechnung.
  • HiveGrid cached den Zustand, der fuer Feature-Gates und UI noetig ist.
  • Mollie bekommt nur Payment-Minimum: Betrag, Invoice-Referenz, Customer-Referenz, noetige Kontaktdaten.
  • Keine HiveGrid-Fachdaten an Lago oder Mollie.
  • Staging und Production nutzen getrennte Lago-Instanzen und denselben versionierten Katalog-Contract.
  • Kein Lago-Core-Fork ohne separate Lizenz-/Legal-Entscheidung wegen AGPL-3.0.

Aktueller Betriebsstand

  • Lago Staging und Production laufen auf v1.50.0; der Katalog-Driftcheck ist fuer beide Umgebungen identisch.
  • Staging hat Monats- und 12-Monatsvertrag, Rollen-Sitze, Speicherpaket, erste Mollie-Zahlung, Mandat und recurring Folgezahlung bewiesen.
  • Am 2026-07-29 entstand im vollstaendigen Staging-Checkout die Rechnung HIV-25FE-002-015; Status und PDF sind in HiveGrid abrufbar.
  • Production-Side-Effects bleiben bis BILL-08 / EXT-16 fail-closed.

Legacy-Drift

BILL-00 hat die aktiven Ticketdocs fuer den Billing-Pfad auf AD-27 recuttet. Alte Legacy-Provider-Erwaehnungen in historischen Umsetzungsnotizen, breiteren Roadmap-/Milestone-Dokumenten oder Legacy-Code sind Migrationsinventar und duerfen nicht als Zielarchitektur gelesen werden. Neue Billing-Arbeit startet bei BILL-01/BILL-02.