3.6 KiB
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
BILL-00— Legacy-Provider-Recut und Planungs-Docs bereinigenBILL-01— Lago-Staging sauber betreibenBILL-02— Billing-Domain fuer Plans/Seats festziehenBILL-03— Lago-Gateway integrierenBILL-04— Mollie-Payment-Gateway integrierenBILL-05— Sync, Entitlements und Read-only/Frozen-StateBILL-06— interne Admin-Billing-BasisBILL-07— E2E-Sandbox-FlowBILL-09— Kunden-Rechnungszugriff in HiveGridBILL-10— Self-Service-Checkout fuer PlanwechselBILL-11— Pricing-Katalog, Jahresbindung und Recurring PaymentsBILL-12— Kundenplan-Namen in Billing-Oberflaechen konsistent haltenBILL-13— Immersiver Mollie-Checkout, Add-on-Wechsel und read-only Usage-TransparenzBILL-14— Zweistufige Registrierung mit Teamgröße, Tarifempfehlung und Checkout-PrefillBILL-18— Responsive Registrierungs-Tarifwahl und sicherer CAPTCHA-RetryBILL-21— Beträge über 1.000 EUR brutto in Erst- und Folgezahlungen ausschließlich per Mollie-Karte einziehenBILL-22— geführter Checkout mit Teamgröße vor Tarif, getrennten Speicher-/E-Mail-Upsells und freier Mollie-Zahlart bis 1.000 EURBILL-08— Prod-Prep; technisch vorbereitet, wartet nur aufEXT-16Mollie-Live/KYC und Legal-/SteuerfreigabeBILL-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-16fail-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.