Update hivegrid-cloud reference to latest main
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
This commit is contained in:
1 parent
e98d38e716
commit
7b21524c86
3781 files changed
+373484
-225607
No files matched your search
@@ -1,6 +1,11 @@
|
||||
# VA-P24a · P24 Self-Service-Abo-Baukasten-UI (M28-Delta)
|
||||
|
||||
> ⚠️ **KI→MCP-Pivot ([[AD-26]]):** Das **„AI-Credits"-Add-On entfällt** im Add-On-Katalog (kein LLM-Gateway/AiCredits in v1 — HiveGrid wird MCP-Server, [[VR-MCP]]). Seats + übrige Add-Ons bleiben.
|
||||
> ⚠️ **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.
|
||||
|
||||
| | |
|
||||
|---|---|
|
||||
@@ -8,45 +13,65 @@
|
||||
| **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 |
|
||||
| **Status** | geplant / nach Billing-Recut neu bewerten |
|
||||
|
||||
## Abhängigkeiten & Parallelität
|
||||
- **Blocked by:** `AK-P20` (Billing-Fundament — Stripe-Checkout + Webhook-Handler + `StripeWebhookLog` + `SubscriptionFeature`/`ProductFeature` + Read-Only-Middleware aus v1, **NICHT** neu bauen)
|
||||
- **Blocks:** `VA-P24b` (Onboarding-Wizard baut auf demselben Branchen-Template-Mechanismus auf)
|
||||
- **Läuft parallel zu:** `VA-P23` (Postfach-Sync) im selben Fenster v2-W1 — disjunkte Domänen. Erweitert `prisma/schema/billing.prisma` (AK-P20) additiv um Self-Service-Felder (AD-21).
|
||||
- **Konflikt-Risiko:** gering — additives Delta auf v1-Billing, kein Kern-Umbau.
|
||||
|
||||
- **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** (M28, Block P): Tenants buchen und wechseln Pläne self-service über den **Web-Checkout** (Trial **ohne** Vertriebs-Freigabe, Add-On-Käufe) — der **Abo-Baukasten** wird zum kundengeführten UI mit Modul-Toggle und Preis-Vorschau. **PWA-only (AD-17):** komplett über Web-Checkout, **keine App-Store-Billing-Auflage** (Apple-Guideline 3.1.3 entfällt), Plan-Wechsel direkt im Web. Self-Service ist v2, weil die **Preise feststehen müssen** (v1 EXT-14 fixiert).
|
||||
|
||||
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, verfügbare Pläne (Web-Checkout), Upgrade/Downgrade, **Zahlungsmethoden-Pflicht**, Checkout-Return-Status |
|
||||
| Add-On-Kauf-Flächen [`/admin/subscription` · `/admin/usage`] | Add-On-Katalog (z.B. ~~AI-Credits~~ (entfällt [[AD-26]]), Seats), Kauf via Web-Checkout, Usage-/Quota-Anzeige |
|
||||
| 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** (`requires_manual_activation=false`) mit **Zahlungsmethoden-Pflicht**
|
||||
- [ ] **Modul-Toggle + Preis-Vorschau** (Abo-Baukasten als kundengeführtes UI)
|
||||
- [ ] Plan-Wechsel + Add-On-Käufe über **Web-Checkout-Flow** — App-Store-konform (PWA-only → **kein Pricing-Store-UI**, reiner Web-Flow)
|
||||
- [ ] Wiederverwendung v1: Stripe-Checkout + Webhook-Handler + `StripeWebhookLog` + `SubscriptionFeature`/`ProductFeature` (Feature-Gate) + Read-Only-Middleware (Frozen)
|
||||
- [ ] Konnektor `tenantHasModule('billing')`; **RLS** auf allen Tenant-Tabellen (globale Produkt-/Preis-Tabellen ohne RLS)
|
||||
|
||||
- [ ] 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
|
||||
- **Entities** (Delta auf `prisma/schema/billing.prisma` aus AK-P20, AD-21): `TenantSubscription` (status trial/active/past_due/cancelled/frozen + Self-Service-Flag `requires_manual_activation`), `TenantSubscriptionProductPrice` (quantity=Seats, is_metered), Add-On-Käufe über `SubscriptionFeature`/`ProductFeature` (quota_value JSON) + `CheckoutSessionStatus`. Globale Definitions-Tabellen (`SubscriptionProduct`/`SubscriptionPrice`) ohne RLS.
|
||||
- **Web-Checkout-Flow:** v1-Stripe-Checkout-Session + Webhook-Handler (Signatur) + `StripeWebhookLog` wiederverwenden; Checkout-Return-Handler aktualisiert `TenantSubscription`.
|
||||
- **Abo-Baukasten-UI:** `SubscriptionFeature.code` (z.B. `kwp_integration`) = Entitlement-Schicht; Modul-Toggle berechnet Preis-Vorschau aus der Kostenmatrix (AD-15) **clientseitig**, Buchung serverseitig validiert.
|
||||
- **PWA-only:** kein Pricing-Store-UI, keine App-Store-Compliance — reiner Web-Checkout (AD-17). **RLS** auf Tenant-Tabellen.
|
||||
|
||||
- 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)
|
||||
- `ROADMAP-V2.md` → **§v2-P3 Self-Service-Billing** (Screens/Features = Hauptquelle; Depends-on/Success-Criteria/Recut)
|
||||
- `ENTITY-MODEL.md` → **Domäne 12: Billing & Abo-Baukasten** (TenantSubscription/SubscriptionFeature/CheckoutSessionStatus)
|
||||
- `ROADMAP.md` → Phase 24 · `PHASE-SOURCES.md` → Phase 24 (M28-Self-Service-Delta, Block P)
|
||||
- `designer-briefs/P24-self-service-billing-wizard.md` (Plan-Vergleich, Web-Checkout, PWA-only-Hinweis)
|
||||
- `_bmad-output/specs/M28-subscriptions-billing.md` (Block P Self-Service)
|
||||
- Querverweis: `ticket-docs/AK-P20.md` (Billing-Fundament, das hier erweitert wird)
|
||||
|
||||
- `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
|
||||
Reference in new issue
Block a user