7.1 KiB
D-P20 · Screens P20 — Billing, Onboarding & Branding
⚠️ KI→MCP-Pivot (AD-26): Der AI-Credits-Screen + AI-Token-Quota entfallen (kein LLM-Gateway in v1 — HiveGrid wird MCP-Server, VR-MCP). Die Verbrauchs-Übersicht bleibt für Automation-Läufe + Speicher. Alle AI-Credits/AI-Token-Stellen unten sind durchgestrichen.
| Typ | Screen (Design) |
| Owner | David |
| Phase | P20 — Billing, Onboarding & Branding (bedient AK-P20) |
| Cycle/Fenster | W4 — USP, Härtung & Launch · 2026-07-08 · Gate W4 |
| Status | geplant (NEU — ex-Teil von D-REST, jetzt eigenes P20-Ticket) |
Abhängigkeiten & Parallelität
- Blocked by:
D-D0a(App-Shell + A1-Status-Banner-System),D-D0b(Archetypen A2 Liste, A6 Settings, KPI/Charts, A5 Modal) - Bedient (Dev):
AK-P20(Billing Stripe Abo-Baukasten + Onboarding + Branding) - Compose-Paket: Status-Banner-System integriert in die A1-Shell (D0); Hell/Dunkel-Toggle lebt im Profil/User-Menü (P2/D-P2);
AI-Credits-Detail teilt Charts-Bausteine mit D-P13→ AI-Credits-Detail entfällt (AD-26; D-P13 gelöscht) - Subframe: Pflicht je Route (A6 Settings, KPI/Charts, A5 Modal, Banner in A1-Shell)
Was wir bauen
Die Billing-/Onboarding-/Branding-Flächen (alle v1): read-only Abo-Übersicht (Abo-Baukasten), Verbrauchs-Übersicht /AI-Credits-Übersicht (AI-Credits entfällt — AD-26), Stripe-Customer-Portal-Embed, Demo-Daten-Verwaltung, Erste-Schritte-Checkliste, das Tenant-Status-Banner-System und den Hell/Dunkel-Toggle.
🟡 v1-Schnitte (verbindlich):
- Billing = Abo-Baukasten (M154-Recut): Basis-Preis pro Nutzer + Feature-Module als daten-getriebene Positionen. KEINE Seat-Typen. In-App keine Pricing-/Upgrade-/Plan-Wechsel-UI (Apple-Compliance LP-8) — nur Read-Only-Übersicht + externer Verweis (
hivegrid.de/Account-Manager). Pause/Kündigen erlaubt.- Onboarding: v1 = Auto-SHK-Provisionierung beim Signup (ohne Wizard). Kein mehrstufiger Setup-Wizard, kein KI-Walkthrough (→ v2). v1-Screens: Demo-Daten-Verwaltung + Erste-Schritte-Checkliste.
- Branding: v1 = nur Hell/Dunkel-Toggle (bewusst 2 Optionen, kein System-Modus). Logo/Farben/White-Label → v2; keine
/admin/branding-Route v1.
Benötigte Screens
| Screen [Route] | Kern-Inhalt | Archetyp |
|---|---|---|
Abo-Übersicht [/admin/subscription] |
Basis-Plan + gebuchte Feature-Module als Positionsliste mit Preisen · Status/Trial-Countdown · KEIN Upgrade-Button (Hinweis-Box „Plan-Wechsel über Account-Manager / hivegrid.de", extern) · Pausieren (Frozen) + Kündigen-Button | A6 + KPI |
Verbrauchs-Übersicht [/admin/usage] |
Quota-Balken je Metrik: Automation-Läufe, |
KPI + Charts |
/admin/usage/ai-credits] |
||
Rechnungen/Zahlung [/admin/billing] |
Stripe-Customer-Portal-Embed (Rechnungs-History/PDF, Zahlungsmethode, Steuer-/USt-Daten) | A6 |
Demo-Daten [/admin/onboarding/demo-data] |
Settings-Knopf „Beispieldaten anlegen" (~25 Datensätze, Klartext-Liste was kommt) · Demo-Liste mit Zähler + Lösch-Funktion (Multi-Step-Confirm) · „Demo ausblenden"-Filter erscheint in allen Listen (kein Wizard, kein KI-Walkthrough — v2) | A6 |
Erste-Schritte-Checkliste [/onboarding/checklist] |
Items mit Status-Häkchen (auto-erkannt), Klartext + Beschreibung, CTA-Link je Item, manuell abhakbar, dauerhaft ausblendbar, Glückwunsch bei 100% (KWP-Item ausgeblendet — v2) · auch als Dashboard-Widget (P11) | A2 |
| Status-Banner-System (Shell) | Tenant-Status-Banner: Trial-Ende-3-Tage / past_due (Zahlung fehlgeschlagen + „Zahlungsmethode aktualisieren") / frozen (pausiert + „Reaktivieren") / deletion_pending — je eigener Klartext + Action-Button · Read-Only-Toast bei blockiertem Schreib-Button |
in A1-Shell (D0) |
| Hell/Dunkel-Toggle [im Profil / User-Menü] | Zwei Optionen Hell / Dunkel, sofortige Anwendung ohne Reload, flash-frei (SSR-Cookie) (kein System-Modus v1) | A6 (Teil von Profil-Settings P2) |
(Signup-Formular → P2/D-P2. Kein Onboarding-Setup-Wizard v1. Stripe-Checkout läuft extern über Marketing-Site.)
Features (muss abgedeckt sein)
- Abo-Übersicht read-only (Abo-Baukasten: Basis + Feature-Module als Positionen, keine Seat-Typen); kein In-App-Upgrade/Plan-Wechsel (LP-8) — externer Verweis; Pause/Kündigen erlaubt
- Verbrauchs-Übersicht (Quota-Balken Automation-Läufe/
AI-Tokens(entfällt AD-26)/Speicher, Klartext bei Limit) AI-Credits-Detail (Saldo, Donut je Use-Case, Verlauf, 80%-Warnbanner, Hochrechnung)→ entfällt (AD-26)- Stripe-Customer-Portal-Embed (Rechnungs-History/PDF, Zahlungsmethode, Steuer-/USt-Daten)
- Demo-Daten-Verwaltung (Anlege-Knopf mit Klartext-Inhaltsliste, Zähler + Lösch-Funktion, „Demo ausblenden"-Filter)
- Erste-Schritte-Checkliste (auto-erkannter Status, CTA-Links, manuell abhakbar/ausblendbar, Dashboard-Widget)
- Status-Banner-System (trial/past_due/frozen/deletion_pending je Klartext + Action) + Read-Only-Toast
- Hell/Dunkel-Toggle (2 Optionen, flash-frei, kein System-Modus)
- Empty/Loading/Fehler/Permission-Denied-States (Klartext + Lösungs-Knopf)
UI-Elemente (Liste, KEIN Layout — Anordnung = Davids freie Hand)
Plan-Positionsliste (Basis + Feature-Module mit Preisen, read-only); Trial-Countdown-Badge; KPI-/Quota-Balken (Verbrauch vs. inklusiv); Donut-Chart (AI-Verbrauch je Use-Case) (entfällt AD-26); 80%-Warnbanner; externer Verweis-Box („Plan-Wechsel über hivegrid.de", neuer Tab); Pause-Button + Kündigen-Button mit Bestätigungs-Modal; Stripe-Customer-Portal-Embed (iFrame/Redirect); Demo-Daten-Anlege-Knopf mit Klartext-Inhaltsliste; Demo-Zähler + Lösch-Button mit Multi-Step-Confirm; „Demo ausblenden"-Filter-Toggle; Checklisten-Items mit Status-Icon + CTA-Link + manuell-abhaken + ausblenden; Status-Banner-Stack (trial/past_due/frozen/deletion_pending) mit Action-Button; Read-Only-Toast bei blockiertem Schreib-Button; Hell/Dunkel-Toggle (2 Optionen); Empty-/Loading-/Fehler-/Permission-Denied-States.
Quellen (granular)
designer-briefs/P20-billing-onboarding-branding.md(vollständiger Brief — alle v1-Screens)ENTITY-MODEL.md→ Domäne 12 (Billing/Abo-Baukasten) + Domäne 13 (Onboarding, Branding)ROADMAP.md→ Phase 20 ·REQUIREMENTS.md→ Modul 28/29/31 ·PHASE-SOURCES.md→ P20_bmad-output/specs/M28-subscriptions-billing.md(⚠ M154-Recut — keine Seat-Typen),M29-onboarding.md(Wizard-UI → v2),M31-branding.md- Legacy-Referenz:
archive/hivegrid-cloud/app/config/pricing-plans.ts· Dev-Pendant:ticket-docs/AK-P20.md
Davids Delta (David füllt aus)
- Überschriebene/geänderte Spec-Punkte:
- Neue UI/UX-Entscheidungen:
- Subframe-Screen-Link(s):
- Offene Fragen an Dev: