77 lines
3.6 KiB
Markdown
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`.
|