Update hivegrid-cloud reference to latest main
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
This commit is contained in:
1 parent
e98d38e716
commit
7b21524c86
3781 files changed
+373484
-225607
No files matched your search
@@ -1,65 +1,90 @@
|
||||
# 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.
|
||||
> ⚠️ **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`) |
|
||||
| **Phase** | P20 — Billing, Onboarding & Branding (bedient `AK-P20`/`BILL-*`) |
|
||||
| **Cycle/Fenster** | W4 — USP, Härtung & Launch · 2026-07-08 · Gate W4 |
|
||||
| **Status** | geplant (NEU — ex-Teil von D-REST, jetzt eigenes P20-Ticket) |
|
||||
| **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` (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)**
|
||||
- **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 (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.
|
||||
|
||||
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 = 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.
|
||||
> - **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`] | 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~~ (entfällt [[AD-26]]), Speicher · aktueller Verbrauch vs. inklusiv · Klartext bei Limit-Erreichen | KPI + Charts |
|
||||
| ~~AI-Credits-Detail [`/admin/usage/ai-credits`]~~ → **entfällt ([[AD-26]])** | ~~Saldo, Verbrauch je Use-Case (Donut), Verlauf, 80%-Warnbanner, Hochrechnung, Aufgebraucht-Klartext (Verweis extern)~~ | ~~KPI + Charts~~ |
|
||||
| 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.)*
|
||||
| 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 (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)
|
||||
|
||||
- [ ] 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-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.
|
||||
|
||||
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)
|
||||
- `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`
|
||||
|
||||
- `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):
|
||||
|
||||
Reference in new issue
Block a user