4.5 KiB
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. Erweitertprisma/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. |
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.prismaaus AK-P20, AD-21):TenantSubscription(status trial/active/past_due/cancelled/frozen + Self-Service-Flagrequires_manual_activation),TenantSubscriptionProductPrice(quantity=Seats, is_metered), Add-On-Käufe überSubscriptionFeature/ProductFeature(quota_value JSON) +CheckoutSessionStatus. Globale Definitions-Tabellen (SubscriptionProduct/SubscriptionPrice) ohne RLS. - Web-Checkout-Flow: v1-Stripe-Checkout-Session + Webhook-Handler (Signatur) +
StripeWebhookLogwiederverwenden; Checkout-Return-Handler aktualisiertTenantSubscription. - 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-P24aaktualisiert