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

197 lines
10 KiB
Markdown

# BILL-19 · Registrierung bis Zahlung als klaren Aktivierungsflow führen
| | |
| ----------------- | ------------------------------------------------------ |
| **Typ** | Launch-Fix · Registrierungs-/Billing-UX |
| **Owner** | Raffael |
| **Phase** | Pilot-Härtung |
| **Cycle/Fenster** | gestartet 2026-08-02 |
| **Status** | Done |
| **Plane** | HIVEGRID-240 |
## Abhängigkeiten & Parallelität
- **Blocked by:** `BILL-14` und `BILL-18` sind Done und liefern die
zweistufige Registrierung, persistierte Tarif-/Sitzpräferenz sowie den
gehärteten CAPTCHA-Retry.
- **Blocks:** `BILL-20` und damit die visuelle und funktionale Pilotabnahme des
kompletten Signup-zu-Zahlung-zu-Welcome-Flows.
- **Abhängigkeitsschutz:** Workspace-Bootstrap, Katalog, Preise,
Mollie-/Lago-Checkout, Testphasen-Policy, Rechnungen und Entitlement-
Aktivierung bleiben unverändert. `BILL-19` ändert ausschließlich frühe
Clientvalidierung, Navigation/Gating und die Darstellung der bestehenden
Erstaktivierung.
## Was / Warum
Die Konto-Seite ließ ein nach der sichtbaren Passwort-Checkliste noch
ungültiges Passwort in den Tarifschritt wechseln. Der verbindliche Fehler
erschien dadurch erst beim finalen Registrierungs-POST auf der folgenden
Seite.
Nach erfolgreicher Registrierung wird der Workspace technisch vor der Zahlung
angelegt, damit Checkout, Rechnung und spätere Entitlements tenantgebunden
gespeichert werden können. Der Nutzer landete jedoch in der vollständigen
Workspace-/Settings-Hülle. Die Erstaktivierung mischte dort Abonnement,
Nutzung, Testphasenhinweis, alle Tarife, Sitzplätze, Speicher, E-Mail-Marketing
und Rechnungsnavigation. Obwohl Fachmodule serverseitig gesperrt blieben,
wirkte der Workspace bereits freigeschaltet und der notwendige Mollie-Schritt
war visuell nachrangig.
Der Flow wird deshalb als eigener Aktivierungszustand dargestellt: Konto und
Workspace sind angelegt, Produktzugriff bleibt bis bestätigter Zahlung oder
einer tatsächlich im Katalog hinterlegten Testphase gesperrt. Die bestehende
serverseitige Preisvorschau und der Mollie-Checkout bilden die eine primäre
nächste Aktion.
## Nicht im Scope
- Keine Änderung an Tarifpreisen, Sitzformeln, Speicherpaketen oder Features.
- Keine neue oder automatisch gewährte Testphase.
- Keine Zahlung während des Pre-Auth-POSTs und kein eingebetteter
Mollie-Checkout.
- Keine Änderung an Mollie, Lago, Webhooks, Rechnungen oder Entitlements.
- Kein Redesign der laufenden Billing-Verwaltung für bereits aktive Kunden.
## Definition of Done
- [x] Die Konto-Seite zeigt Passwortverletzungen beim Tippen/Verlassen des
Feldes und verhindert den Wechsel zu Team & Tarif, solange die
synchron prüfbaren Policy-Regeln nicht erfüllt sind.
- [x] Nach der Registrierung erklärt ein eigener Aktivierungszustand klar:
Workspace angelegt, noch kein Produktzugriff, Zahlung oder echte
Testphase als nächster Schritt.
- [x] Unbezahlte Tenants sehen auf der Erstaktivierung weder App-Sidebar noch
Settings-Hub; alle anderen App-/Settings-Ziele bleiben serverseitig am
bestehenden Plan-Gate hängen.
- [x] Der Aktivierungsscreen übernimmt Tarif und Büro-/Baustellenplätze,
trennt Pflichtauswahl von optionalem Speicher und zeigt höchstens eine
primäre Checkout-Aktion.
- [x] Die serverseitige Preisvorschau erscheint im Aktivierungsflow mit
Netto, Umsatzsteuer, Zahlbetrag, Abrechnungszeitraum und eindeutiger
Testphasen-/Sofortzahlungsinformation vor Mollie.
- [x] Laufende Billing-Verwaltung für aktive oder echte Trial-Tenants bleibt
funktional und visuell unverändert; E-Mail-Marketing wird nicht vor der
Basisaktivierung angeboten.
- [x] Unit-, Route-, Component-, Accessibility- und Desktop-/Mobile-
Visualtests decken Passwortgrenze, Gate und Aktivierungszustand ab.
- [x] Typecheck, Lint, vollständige Testsuite, passende Verifier, PR-CI,
Staging-Deploy und ein ausschließlich mit Mollie TEST ausgeführter
Signup-zu-Zahlung-UAT sind grün.
**BILL-19: 8/8 DoD = 100 % done. 0 Punkte offen.**
2026-08-02 · Abhängigkeitsschutz für `BILL-22`
- `BILL-22` ersetzt die dichte Aktivierungsdarstellung durch einen geführten
Team-/Tarif-/Upsell-/Zahlungsablauf. Das appweite Gate aus diesem Ticket
bleibt unverändert: ohne bestätigte Basiszahlung oder echte Katalog-
Testphase gibt es keinen Produktzugriff.
## Technische Bausteine
- `apps/web/app/modules/users/components/RegisterScreen.tsx`
- `apps/web/app/routes/app.$tenant.tsx`
- `apps/web/app/routes/app.$tenant/settings/billing.tsx`
- `apps/web/app/routes/app.$tenant/settings/billing/index.tsx`
- `apps/web/app/components/screens/billing/SelfServiceSubscriptionPage.tsx`
- bestehende Billing-/Registration-View-Models und `~/ui`-Komponenten
- CR-017 in `docs/CHANGE-REQUESTS.md`
## Rollback
Reiner Code-/UI-Rollback auf die bisherige Workspace-/Billing-Hülle. Es gibt
keine Migration, keinen Backfill und keine Provider-Mutation. Bereits
angelegte Workspaces, Zahlungen, Rechnungen und Entitlements bleiben
unverändert. Der bestehende serverseitige Subscription-Gate bleibt auch beim
Rollback aktiv.
## Umsetzungs-Notiz
2026-08-02 · Diagnose und Start
- Staging-Screenshot und Quellcode gemeinsam geprüft. Das Backend schaltet
Fachmodule ohne Subscription-Produkt oder aktive Testphase nicht frei.
Die gesamte Settings-Hülle war jedoch ausgenommen und vermittelte dadurch
fälschlich einen bereits nutzbaren Workspace.
- Die bestehende Erstkaufseite vermischt sechs Informationsaufgaben. Der
notwendige Preis-/Mollie-Schritt liegt erst unter Status, Nutzung und
allgemeiner Testphaseninformation.
- Die Passwort-Checkliste berechnet die synchronen Policy-Regeln bereits,
bindet sie aber nicht an die native Feldvalidität oder den Übergang in den
Tarifschritt.
- `BILL-14` und `BILL-18` in Ticket-Docs und Plane in beide Richtungen gelesen.
Der neue Slice konsumiert ihre Verträge, ohne Katalog-, Provider- oder
Entitlement-Schnittstellen zu ändern.
- Plane-Identität als `raffael@tool-ctrl.de` bestätigt; `HIVEGRID-240`
angelegt, Raffael zugewiesen und auf In Progress gesetzt.
- Preflight auf aktuellem `origin/main`: EU-Provider-Guard leer, Typecheck und
Core-Testlauf grün.
**BILL-19: 0/8 DoD = 0 % done. 8 Punkte selbst machbar.**
2026-08-02 · Lokale Umsetzung und Re-Audit
- `9bff9e550`: Die sichtbare Passwort-Policy ist jetzt eine echte
Schrittgrenze. Ungültige Werte erzeugen einen lokalisierten Inline-Fehler,
bleiben im Kontoschritt und fokussieren das Passwortfeld.
- `80dcefbb8`: Unbezahlte Tenants dürfen ausschließlich die exakte
Billing-Aktivierung öffnen. Die Route rendert ohne App-/Settings-Chrome und
übernimmt Tarif, Rollenplätze und optionalen Speicher in einen fokussierten
Checkout mit genau einer primären Aktion.
- Preisvorschau und Hosted-Checkout-Vertrag bleiben serverautoritativ. Die
Vorschau unterscheidet echte Trial-Tage von sofort erforderlicher Zahlung
und zeigt Netto, Umsatzsteuer und Brutto vor dem Mollie-Redirect.
- Visueller Re-Audit: `23/24`; Desktop, Mobile, Passwortzustand und
Mollie-Vorschau liegen als Playwright-Baselines im Repo und im Desktop-Ordner
`HiveGrid-BILL-19-UX-Review-2026-08-02`.
- Proof lokal: Typecheck, Lint, i18n, CI-Baseline, Source-Health, Hot-Swap,
A11y-Coverage, vier Chromium-Component-Tests und die vollständige Suite mit
`1176` bestandenen Dateien / `8280` bestandenen Tests sind grün.
**BILL-19: 7/8 DoD = ~88 % done. Offen: PR-CI, Staging-Deploy und
ausschließlich mit Mollie TEST ausgeführter Signup-zu-Zahlung-UAT.**
2026-08-02 · Abhaengiger Welcome-/Billing-Nachzug
- `BILL-20` konsumiert den hier gelieferten Aktivierungscheckout und setzt erst
nach bestaetigtem Return mit Welcome/Setup fort. Subscription-Gate,
Preisvorschau und Mollie-Vertrag bleiben unveraendert. Der finale
`BILL-19`-UAT wird deshalb gemeinsam mit der kompletten Folge-Journey belegt.
2026-08-02 · Staging-Gate-Nachzug aus BILL-20
- Der echte Signup-UAT deckte auf, dass die Billing-Aktivierung bei global
optionaler Subscription-Konfiguration nicht aus der persistierten Tarifwahl
der Registrierung abgeleitet wurde. Dadurch blieb die Fachnavigation auf
Staging sichtbar, obwohl der Workspace noch unbezahlt war.
- `BILL-20` zieht diesen blockierenden Vertrag mit `92845ec15` fail-closed nach:
Persistierte Signup-Praeferenz plus fehlender Subscription-Zugriff erzwingt
die appweite Aktivierungsroute; ein bestaetigtes Abo oder eine echte
Katalog-Testphase hebt den Gate wieder auf. Die vorhandenen Preis-, Mollie-
und Entitlement-Vertraege bleiben unveraendert.
**BILL-19: 7/8 DoD = ~88 % done. Offen: Hotfix-CI, Staging-Deploy und der
fortgesetzte Mollie-TEST-UAT.**
2026-08-02 · Finaler Aktivierungs-UAT
- PRs `#350`, `#351` und `#352` sind normal nach `main` gemergt. Der finale
Merge `0172889382`, Main-Runs `11817` bis `11820` und der vollstaendige
Coolify-Staging-Deploy sind gruen.
- Der komplette frische Signup bestaetigt die fruehe Passwortgrenze, den
Team-/Tarifschritt, Test-CAPTCHA und den fokussierten Aktivierungszustand.
Die verschachtelten App-/Settings-Layouts liefern dort keine Sidebar, keine
Icon-Rail und keine Billing-Tabs; ein direkter Dashboard-Aufruf wird
serverseitig auf `plan-required` abgefangen.
- Die Basisaktivierung wurde ausschliesslich mit Mollie TEST als Swarm-Jahres-
SEPA fuer 5 Buero-/15 Baustellen-Nutzer bezahlt. Preisvorschau,
Providerbetrag, Return und Rechnung stimmen bei `449,00 EUR` netto,
`85,31 EUR` USt. und `534,31 EUR` Zahlbetrag ueberein. Ohne bestaetigte
Zahlung blieb ein zweiter Test-Workspace gesperrt.
- Desktop-/Mobile- und Live-Nachweise wurden nach vollstaendigem Laden visuell
geprueft; die finale Aktivierung liegt als `36-activation-final-no-settings-
chrome.png` im BILL-20-Desktop-Review-Ordner.
**BILL-19: 8/8 DoD = 100 % done. 0 Punkte offen.**