5.8 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 | Recut noetig |
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-P20fuer Onboarding/Branding/Frozen-Vorarbeit sowieBILL-02bisBILL-06fuer neue Billing-Architektur - 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
- Hell/Dunkel-Toggle
🟡 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-08offen.- Onboarding: v1 = Auto-SHK-Provisionierung beim Signup, kein Setup-Wizard.
- Branding: v1 = Hell/Dunkel-Toggle, kein System-Modus, kein White-Label.
Benötigte Screens
| Screen [Route] | Kern-Inhalt | Archetyp |
|---|---|---|
Abo-Übersicht [/admin/subscription] |
Plan + Seats + gebuchte Feature-Module, Status/Trial-Countdown, externer Kontakt-/Account-Manager-Hinweis, Pausieren/Kündigen falls fachlich freigegeben | A6 + KPI |
Verbrauchs-Übersicht [/admin/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 [/admin/billing] |
Lago-Invoice-Referenzen, Mollie-Payment-Status, Download-/Kontaktzustand, Zahlungsproblem-Klartext; kein Legacy-Provider-Portal/iFrame | A6 |
Demo-Daten [/admin/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 [/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 / 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 via SSR-Cookie | A6 |
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 (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-/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; Pause-/Kündigen-Button nur falls fachlich freigegeben; Demo-Daten-Anlege-Knopf; Demo-Zähler + Lösch-Button mit Multi-Step-Confirm; „Demo ausblenden"-Filter-Toggle; Checklisten-Items mit Status-Icon und CTA-Link + manuell-abhaken + ausblenden; Status-Banner-Stack; Read-only-Toast; Hell/Dunkel-Toggle; Empty-/Loading-/ Fehler-/Permission-Denied-States.
Quellen (granular)
docs/ARCHITECTURE-DECISIONS.md→AD-27(Billing-Recut) undAD-26(KI→MCP)BILL-README.md,BILL-00.mdbisBILL-08.mddesigner-briefs/P20-billing-onboarding-branding.mdbleibt historische Screen-Quelle, muss aber nach AD-27 recuttet werdenENTITY-MODEL.md→ Domäne 12/13, soweit nicht durch AD-27 ueberholt- Dev-Pendant:
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: