Files
HiveGrid-Wireframes/03 Quellen und Referenzen/hivegrid-cloud/.planning/ticket-docs/VA-P24a.md
T
2026-07-08 16:15:37 +02:00

78 lines
4.2 KiB
Markdown

# VA-P24a · P24 Self-Service-Abo-Baukasten-UI (M28-Delta)
> ⚠️ **Billing-Recut 2026-07-04 ([[AD-27]]):** Self-Service-Billing baut auf
> **Lago + Mollie + HiveGrid-Entitlements** auf. Payment-Checkout, Legacy-Provider-Webhooks und Legacy-Provider-Customer-Portal werden
> nicht wiederverwendet. v1 bleibt Plans + Seats; die funktionale Self-Service-Checkout-Basis wurde am 2026-07-05 in
> `BILL-10` vorgezogen. Dieses Ticket bleibt fuer finale Screens, Preisvorschau-UX und Produkt-/Wizard-Delta.
> ⚠️ **KI→MCP-Pivot ([[AD-26]]):** Das **„AI-Credits"-Add-On entfällt**. Kein LLM-Gateway/AiCredits in v1.
| | |
|---|---|
| **Typ** | Dev (Code) |
| **Owner** | Akeshan |
| **Phase** | P24 — Self-Service-Billing & Onboarding-Wizard · v2-P3 |
| **Cycle/Fenster** | v2-W1 — Public-API/Postfach/Abo/KI-Start · fällig 2026-07-15 |
| **Status** | geplant / nach Billing-Recut neu bewerten |
## Abhängigkeiten & Parallelität
- **Blocked by:** `BILL-02` bis `BILL-07` plus `BILL-09`/`BILL-10` (Plans/Seats-Domain, Lago-Gateway, Mollie-Gateway, Sync/Entitlements, Admin-Basis, Sandbox-E2E, Kunden-Rechnungszugriff, Self-Service-Checkout-Basis)
- **Blocks:** `VA-P24b` nur fuer gemeinsame Onboarding-/Plan-Kontexte, nicht fuer den Wizard-Kern
- **Läuft parallel zu:** `VA-P23` im selben v2-Fenster, sofern Billing-Interfaces stabil sind
- **Konflikt-Risiko:** mittel — Self-Service berührt Billing-State, Payment-Callbacks und Entitlements; keine Legacy-Provider-Altpfade erweitern
## Was wir bauen
Das **Self-Service-Delta auf dem v1-Billing**: Die Basis fuer Plan-/Seat-Auswahl, Mollie-Zahlungsstart und
Return/Webhook-Sync existiert in `BILL-10`. Dieses Ticket klaert/ergaenzt darauf aufbauend finale Screens,
Preisvorschau-UX, Wizard-/Onboarding-Kontext und noch fehlende Produktentscheidungen. Lago bleibt
Billing-Source-of-Truth fuer Subscription und Invoice, HiveGrid bleibt Entitlement-Source fuer Feature-Gates.
Nicht im Scope dieses Recut-Standes:
- Usage-Billing
- Credits
- Add-on-Metering
- Legacy-Provider-Kompatibilitaet
- finale Rechnungssteller-/Steuerfreigabe
## Benötigte Screens (Backend bedient — Design liefert `D-P24`)
| Screen [Route] | Kern-Inhalt |
|---|---|
| Self-Service-Plan-Wechsel [`/admin/subscription`] | Aktueller Plan, Seats, verfügbare Pläne, Preis-Vorschau, Mollie-Zahlungsstart, Checkout-Return-/Payment-Status |
| Seat-Verwaltung [`/admin/subscription`] | Seat-Anzahl erhöhen/reduzieren, sofortige Vorschau, serverseitige Validierung, Audit/Reason bei Sonderfällen |
| Billing-Status [`/admin/billing`] | Lago-Invoice-Status, Mollie-Payment-Status, Fehlzahlung/Expired/Refund-Klartext |
## Definition of Done
- [ ] Self-Service-Trial ohne Vertriebs-Freigabe ist fachlich entschieden und serverseitig modelliert.
- [x] Basis-Plan-Wechsel und Seat-Auswahl nutzen Lago-Subscription-State, nicht Legacy-Provider-Checkout. (`BILL-10`)
- [x] Zahlung wird ueber Mollie erzeugt und nach Return/Webhook idempotent verarbeitet. (`BILL-10`)
- [ ] Preis-Vorschau ist serverseitig validiert und nutzt keine oeffentlich hartkodierten Preisversprechen.
- [ ] `tenantHasModule()`/Entitlements reagieren auf den lokalen Billing-State.
- [ ] RLS/Tenant-Scope auf allen Tenant-Tabellen, globale Produkt-/Preisdefinitionen bewusst getrennt.
## Technische Bausteine
- Delta auf `BILL-02` bis `BILL-05` und Rechnungsanzeige aus `BILL-09`, keine neue Legacy-Provider-Domain.
- Funktionale Self-Service-Checkout-Basis aus `BILL-10`.
- `BillingGateway`/`LagoBillingGateway` fuer Plans, Seats, Subscriptions, Invoices.
- `PaymentGateway`/`MolliePaymentGateway` fuer Zahlungsstart und Payment-Status.
- Checkout-Return-Handler aktualisiert lokalen Billing-State nur ueber idempotente Sync-Events.
- PWA-only: reiner Web-Flow, kein App-Store-Billing.
## Quellen (granular)
- `docs/ARCHITECTURE-DECISIONS.md` → `AD-27`
- `BILL-README.md`, `BILL-02` bis `BILL-07`, `BILL-09`
- `ROADMAP-V2.md` → v2-P3 Self-Service-Billing
- `ENTITY-MODEL.md` → Domäne 12, nach AD-27 zu recutten
- `designer-briefs/P24-self-service-billing-wizard.md` muss nach AD-27 aktualisiert werden
## Dev-Nachzug (nach Davids `D-P24`-Delta)
- [ ] Spec/ENTITY-MODEL an Davids UI-Entscheidungen angepasst
- [ ] REQUIREMENTS/PHASE-SOURCES nachgezogen
- [ ] Plane-Ticket `VA-P24a` aktualisiert