# 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-P20` fuer Onboarding/Branding/Frozen-Vorarbeit sowie `BILL-02` bis `BILL-06` fuer 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-08` offen. > - **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) und `AD-26` (KI→MCP) - `BILL-README.md`, `BILL-00.md` bis `BILL-08.md` - `designer-briefs/P20-billing-onboarding-branding.md` bleibt historische Screen-Quelle, muss aber nach AD-27 recuttet werden - `ENTITY-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: