Files
HiveGrid-Wireframes/03 Quellen und Referenzen/hivegrid-cloud/.planning/ticket-docs/D-P20.md
T

7.4 KiB

D-P20 · Screens P20 — Billing, Onboarding & Branding

⚠️ Billing-Recut 2026-07-04 (AD-27): v1-Billing nutzt Lago self-hosted fuer Billing/Invoicing, Mollie nur fuer Payments und HiveGrid fuer Entitlements. Legacy-Provider-Customer-Portal, Payment-Checkout und Legacy-Provider-Pricing sind kein Zielpfad mehr. v1 bleibt Plans + Seats, kein Usage-Billing.

⚠️ KI→MCP-Pivot (AD-26): Der AI-Credits-Screen + AI-Token-Quota entfallen. Die Verbrauchs-Übersicht bleibt fuer Automation-Läufe und Speicher, aber nicht als abrechenbares Usage-Billing.

Typ Screen (Design)
Owner David
Phase P20 — Billing, Onboarding & Branding (bedient AK-P20/BILL-*)
Cycle/Fenster W4 — USP, Härtung & Launch · 2026-07-08 · Gate W4
Status Design-Nachzug offen; AK-P20-Interim-UI steht

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): finale Optik fuer AK-P20 sowie BILL-02 bis BILL-06; nach AD-28 blockiert dieses Design-Ticket den Dev-Abschluss nicht mehr
  • Subframe: Pflicht je Route (A6 Settings, KPI/Charts, A5 Modal, Banner in A1-Shell)

Was wir bauen

Die Billing-/Onboarding-/Branding-Flächen fuer v1:

  • read-only Abo-Übersicht mit Plan, Seats, Trial/Status und gebuchten Feature-Modulen
  • Rechnungen/Zahlung als Lago-/Mollie-basierte Status-/Dokumentansicht, nicht als Legacy-Provider-Portal-Embed
  • Verbrauchs-Übersicht fuer nicht abrechenbare Limits wie Automation-Läufe und Speicher
  • Demo-Daten-Verwaltung
  • Erste-Schritte-Checkliste
  • Tenant-Status-Banner-System
  • Light/Dark-Unterbau bleibt erhalten; der Toggle ist vorerst deaktiviert (PR #81)

🟡 v1-Schnitte (verbindlich):

  • Billing: Plans + Seats, read-only fuer Endkunden. Keine In-App Pricing-Tabelle, keine Upgrade-/Downgrade-UI, kein Add-on-Metering, kein Usage-Billing.
  • Zahlung/Rechnung: UI zeigt Status, letzte Rechnung/Invoice-Referenz, Payment-Status und Hilfe-/Kontaktweg. Zahlung selbst laeuft ueber Mollie; Rechnung/Invoice-Record kommt aus Lago. Rechnungssteller-/Steuerfreigabe bleibt bis BILL-08 offen.
  • Onboarding: v1 = Auto-SHK-Provisionierung beim Signup, kein Setup-Wizard.
  • Branding: Der vorhandene Light/Dark-Unterbau bleibt erhalten, wird aber im App-/Admin-Bereich vorerst nicht angeboten (DARK_MODE_IN_APP=false, PR #81). Kein System-Modus, kein White-Label.

Benötigte Screens

Screen [Route] Kern-Inhalt Archetyp
Abo-Übersicht [/:tenant/settings/subscription] Plan + Seats + gebuchte Feature-Module, Status/Trial-Countdown, externer Kontakt-/Account-Manager-Hinweis, Kündigen falls fachlich freigegeben A6 + KPI
Verbrauchs-Übersicht [/:tenant/settings/usage] Quota-Balken fuer Automation-Läufe und Speicher, aktueller Verbrauch vs. inklusiv, Klartext bei Limit-Erreichen; nicht als Abrechnungs-/Usage-Billing-Screen formulieren KPI + Charts
Rechnungen/Zahlung [/:tenant/settings/billing] Lago-Invoice-Referenzen, Mollie-Payment-Status, Download-/Kontaktzustand, Zahlungsproblem-Klartext; kein Legacy-Provider-Portal/iFrame A6
Demo-Daten [/:tenant/settings/onboarding/demo-data] Settings-Knopf „Beispieldaten anlegen", Klartext-Liste was kommt, Demo-Liste mit Zähler + Lösch-Funktion, „Demo ausblenden"-Filter A6
Erste-Schritte-Checkliste [/:tenant/onboarding/checklist] Items mit Status-Häkchen, Klartext + Beschreibung, CTA-Link je Item, manuell abhakbar, dauerhaft ausblendbar, Glückwunsch bei 100 %; auch als Dashboard-Widget A2
Status-Banner-System (Shell) Trial-Ende-3-Tage / past_due / frozen mit Klartext + Abo-Aktion. deletion_pending samt Shell-Aktion gehört zu AK-P21/D-P21. Die bestehende 423-Klartext-Hülle bleibt; der finale Read-only-Toast ist offener Design-Nachzug. in A1-Shell (D0)
Light/Dark-Toggle [Profil / User-Menü] Vorerst nicht sichtbar und im App-/Admin-Bereich deaktiviert (DARK_MODE_IN_APP=false); kein neuer Screen keiner

Features (muss abgedeckt sein)

  • Abo-Übersicht read-only: Plan, Seats, Feature-Module, Status, Trial.
  • Kein Pricing-/Upgrade-/Downgrade-/Add-on-Kauf im v1-Kundenscreen.
  • Verbrauchs-Übersicht fuer Automation-Läufe/Speicher als Limit-Transparenz, nicht als Usage-Billing.
  • Rechnungen/Zahlung ohne Legacy-Provider: Lago-Invoice-Status + Mollie-Payment-Status + Klartext-Hilfe.
  • 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 für trial/past_due/frozen finalisieren + Read-only-Toast gestalten; deletion_pending liegt in D-P21.
  • Light/Dark-Toggle vorerst deaktiviert; App-/Admin-Bereich bleibt bewusst hell (PR #81).
  • Empty/Loading/Fehler/Permission-Denied-States (Klartext + Lösungs-Knopf).

UI-Elemente (Liste, KEIN Layout — Anordnung = Davids freie Hand)

Plan-/Seat-/Feature-Positionsliste; Trial-Countdown-Badge; Billing-Status-Badge; Payment-Status-Badge; letzte Invoice-/Rechnungsreferenz; Button/Link fuer Rechnung ansehen, wenn verfuegbar; Kontakt-/Account-Manager-Hinweis; Quota-Balken fuer Automation/Speicher; Kündigen-Button nur falls fachlich freigegeben; Demo-Daten-Anlege-Knopf; Demo-Zähler + Lösch-Button; „Demo ausblenden"-Filter-Toggle; Checklisten-Items mit Status-Icon und CTA-Link + manuell-abhaken + ausblenden; Status-Banner-Stack; Read-only-Toast; Empty-/Loading-/ Fehler-/Permission-Denied-States.

Quellen (granular)

  • docs/ARCHITECTURE-DECISIONS.md → AD-27 (Billing-Recut) und AD-26 (KI→MCP)
  • BILL-README.md, BILL-00.md bis BILL-08.md
  • designer-briefs/P20-billing-onboarding-branding.md ist auf AD-27 und den deaktivierten Theme-Toggle aktualisiert
  • ENTITY-MODEL.md → Domäne 12/13, soweit nicht durch AD-27 ueberholt
  • Dev-Pendant: AK-P20.md

Interim-UI-Handoff (AD-28, Stand 2026-07-12)

Die Dev-Vorschau ist auf den fünf kanonischen Tenant-Routen integriert. Reine VMs liegen unter packages/view-models/src/billing/ und packages/view-models/src/onboarding/; die app-chrome-freien Screens unter apps/web/app/components/screens/billing/ und .../onboarding/ erhalten ausschließlich VM + Action-Callbacks. Das Dashboard nutzt dasselbe First-Steps-VM. Der Visual-/Hot-Swap-Nachweis ist packages/ui-mock/visual-baseline/ak-p20-interim.*; der echte M016-Pixelnachweis liegt in tests/component/ak-p20-interim.ct.tsx mit fünf PNG-Baselines unter tests/component/__screenshots__/. Der schnelle React-Markup-Nachweis bleibt in apps/web/app/components/screens/ak-p20-interim.visual.test.tsx.

Nicht Teil des AK-P20-100%-Proofs sind deletion_pending und dessen Shell-Aktion (AK-P21/D-P21) sowie die finale Read-only-Toast-Optik; für blockierte Root-Aktionen besteht bereits die 423-Klartext-Hülle.

Offen bleibt Davids finales Layout-/Copy-Delta inklusive Subframe-Links. Beim Nachzug werden nur die Screen-Internals getauscht und die Interim-Baseline neu gezogen; Routen, Loader und VM-Verträge bleiben stabil. Die Feature-Checkboxen dieses Design-Tickets bleiben deshalb bewusst offen.

Davids Delta (David füllt aus)

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