Refresh HiveGrid Cloud reference snapshot
This commit is contained in:
1 parent
5e99e14772
commit
7f88026f79
5955 files changed
+1177325
-188362
No files matched your search
@@ -13,12 +13,12 @@
|
||||
| **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 |
|
||||
| **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):** `AK-P20` fuer Onboarding/Branding/Frozen-Vorarbeit sowie `BILL-02` bis `BILL-06` fuer neue Billing-Architektur
|
||||
- **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
|
||||
@@ -31,7 +31,7 @@ Die **Billing-/Onboarding-/Branding-Flächen fuer v1**:
|
||||
- Demo-Daten-Verwaltung
|
||||
- Erste-Schritte-Checkliste
|
||||
- Tenant-Status-Banner-System
|
||||
- Hell/Dunkel-Toggle
|
||||
- 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,
|
||||
@@ -40,19 +40,19 @@ Die **Billing-/Onboarding-/Branding-Flächen fuer v1**:
|
||||
> 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.
|
||||
> - **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 [`/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 |
|
||||
| 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)
|
||||
|
||||
@@ -62,27 +62,44 @@ Die **Billing-/Onboarding-/Branding-Flächen fuer v1**:
|
||||
- [ ] 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).
|
||||
- [ ] Status-Banner-System für trial/past_due/frozen finalisieren + Read-only-Toast gestalten; `deletion_pending` liegt in `D-P21`.
|
||||
- [x] 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; 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-/
|
||||
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` bleibt historische Screen-Quelle, muss aber nach AD-27 recuttet werden
|
||||
- `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:
|
||||
|
||||
Reference in new issue
Block a user