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

77 lines
3.6 KiB
Markdown

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