Files
HiveGrid-Wireframes/hivegrid-cloud/.planning/ticket-docs/VA-P24a.md
T

4.5 KiB

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.

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

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.

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).

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

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)

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.

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)

Dev-Nachzug (nach Davids D-P24-Delta)

  • Spec/ENTITY-MODEL an Davids UI-Entscheidungen angepasst
  • REQUIREMENTS/PHASE-SOURCES nachgezogen
  • Plane-Ticket VA-P24a aktualisiert