# 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`.