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

10 KiB

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

  • 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.
  • Nach der Registrierung erklärt ein eigener Aktivierungszustand klar: Workspace angelegt, noch kein Produktzugriff, Zahlung oder echte Testphase als nächster Schritt.
  • 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.
  • Der Aktivierungsscreen übernimmt Tarif und Büro-/Baustellenplätze, trennt Pflichtauswahl von optionalem Speicher und zeigt höchstens eine primäre Checkout-Aktion.
  • Die serverseitige Preisvorschau erscheint im Aktivierungsflow mit Netto, Umsatzsteuer, Zahlbetrag, Abrechnungszeitraum und eindeutiger Testphasen-/Sofortzahlungsinformation vor Mollie.
  • 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.
  • Unit-, Route-, Component-, Accessibility- und Desktop-/Mobile- Visualtests decken Passwortgrenze, Gate und Aktivierungszustand ab.
  • 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.