Files
HiveGrid-Wireframes/03 Quellen und Referenzen/hivegrid-cloud/.planning/designer-briefs/P20-billing-onboarding-branding.md
T
2026-07-08 16:15:37 +02:00

6.6 KiB

Designer-Brief · P20 — Billing, Onboarding & Branding

Phase: 20/21 · Module: M28 / M29 / M31 · Owner-Dev: Akeshan (AK-P20) · Designer: David Quellen: ROADMAP.md §Phase 20 · ENTITY-MODEL.md Domäne 12 (Billing/Abo-Baukasten) + Domäne 13 (Onboarding, Branding) · SCREEN-MAP.md §6 (Billing/Onboarding-Compose) · _bmad-output/specs/M28-subscriptions-billing.md (⚠ M154-Recut), M29-onboarding.md (Wizard-UI → v2), M31-branding.md · Legacy-Referenz: archive/hivegrid-cloud/app/config/pricing-plans.ts Subframe: Pflicht je Route. Archetypen aus D0 (A2 Liste, A6 Settings, KPI/Charts, A5 Modal).

🟡 Drei kleine v1-Module gebündelt — wichtige Schnitte (verbindlich):

  • Billing = Abo-Baukasten (M154-Recut): Basis-Preis pro Nutzer + Feature-Module als daten-getriebene Positionen. KEINE Seat-Typen (kein „Büro vs. Monteur"-Seat-Modell). In-App keine Pricing-/Upgrade-/Plan-Wechsel-UI (Apple-Compliance LP-8) — nur Read-Only-Übersicht + Verweis nach hivegrid.de/Account-Manager. Verbrauchs-Zähler + Drossel aktiv, Aufschlags-Abrechnung → v2.
  • Onboarding: v1 = Auto-SHK-Provisionierung (Seeds M158 beim Signup, ohne Wizard). Der Onboarding-Wizard-UI ist v2 — bitte KEINEN mehrstufigen Setup-Wizard designen. KI-Walkthrough → v2. v1-Screens: Demo-Daten-Verwaltung + Erste-Schritte-Checkliste.
  • Branding: v1 = nur Hell/Dunkel-Toggle (bewusst nur 2 Optionen, kein System-Modus). Logo/Farben/White-Label → v2; keine /admin/branding-Route v1. Toggle lebt im Profil/User-Menü (P2/D0).

Was dieses Modul tut (Kurzfassung)

Ein neuer Betrieb kommt vom Self-Service-Signup per Auto-SHK-Provisionierung ins Produkt, läuft auf Legacy-Provider-Billing als Abo-Baukasten (Basis pro Nutzer + Feature-Module als Positionen, Trial mit Dunning + Frozen-Modus), kann optional Demo-Daten anlegen/löschen, sieht eine Erste-Schritte-Checkliste und schaltet flash-frei zwischen Hell und Dunkel um.

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, AI-Tokens, Speicher · aktueller Verbrauch vs. inklusiv · Klartext bei Limit-Erreichen KPI + Charts
AI-Credits-Detail [/admin/usage/ai-credits] Saldo, Verbrauch je Use-Case (Donut), Verlauf, 80%-Warnbanner, Hochrechnung, Aufgebraucht-Klartext (Verweis extern) KPI + Charts
Rechnungen/Zahlung [/admin/billing] Legacy-Provider-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 integriert (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-Auth. Mitarbeiter-Einladung → P2/P20-Seeds. Kein Onboarding-Setup-Wizard v1. Payment-Checkout läuft extern über Marketing-Site.)

Geplante Features (muss abgedeckt sein)

  • Billing über Legacy-Provider als Abo-Baukasten: Basis-Preis pro Nutzer + Feature-Module als daten-getriebene Positionen (keine Seat-Typen — M154-Recut); konkrete Preise geparkt (AD-15)
  • Trial mit Dunning (Tag 1/3/7) und Frozen-Modus (Read-Only-Middleware) greift; Status-Banner pro Zustand mit Klartext + Action; Verbrauchs-Zähler + Drossel aktiv (Aufschlags-Abrechnung → v2)
  • In-App keine Pricing-Tabelle/Upgrade-Buttons/Plan-Wechsel-UI (LP-8) — Abo-Übersicht read-only + externer Verweis; Pause/Kündigen sind erlaubt
  • Neuer Tenant wird nach Signup automatisch SHK-provisioniert (Seeds M158: Pipelines, Custom-Felder, Rollen, Form-Templates, Checkliste) — ohne Wizard-UI (die folgt v2); Trial-Freischaltung durch Plattform-Admin
  • Optionale Demo-Daten (5 Contacts, 3 Deals, 2 Projekte, Tasks) per Settings-Knopf provisionierbar und via is_demo_data-Flag löschbar; „Demo ausblenden"-Filter in Listen (KI-Walkthrough → v2; einfaches Löschen statt Multi-Step-Bulk)
  • Erste-Schritte-Checkliste mit auto-erkanntem Status, CTA-Links, manuell abhakbar/ausblendbar (als Dashboard-Widget)
  • Nutzer schaltet zwischen Hell und Dunkel um, flash-frei (SSR-Cookie) (kein System-Modus — bewusst nur 2 Optionen; next-themes)

Benötigte 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), 80%-Warnbanner, externer Verweis-Box („Plan-Wechsel über hivegrid.de", neuer Tab), Pause-Button + Kündigen-Button mit Bestätigungs-Modal, Legacy-Provider-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 (Klartext mit Lösungs-Knopf).

Davids Delta (David füllt aus)

  • Überschriebene/geänderte Spec-Punkte:
  • Neue UI/UX-Entscheidungen:
  • Subframe-Screen-Link(s):
  • Offene Fragen an Dev:

Dev-Nachzug (wir nach Davids Delta)

  • Spec/ENTITY-MODEL an Davids Entscheidungen angepasst:
  • REQUIREMENTS/PHASE-SOURCES nachgezogen:
  • Plane-Ticket (AK-P20) aktualisiert: