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-14undBILL-18sind Done und liefern die zweistufige Registrierung, persistierte Tarif-/Sitzpräferenz sowie den gehärteten CAPTCHA-Retry. - Blocks:
BILL-20und 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-22ersetzt 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.tsxapps/web/app/routes/app.$tenant.tsxapps/web/app/routes/app.$tenant/settings/billing.tsxapps/web/app/routes/app.$tenant/settings/billing/index.tsxapps/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-14undBILL-18in 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.debestätigt;HIVEGRID-240angelegt, 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-OrdnerHiveGrid-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
1176bestandenen Dateien /8280bestandenen 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-20konsumiert den hier gelieferten Aktivierungscheckout und setzt erst nach bestaetigtem Return mit Welcome/Setup fort. Subscription-Gate, Preisvorschau und Mollie-Vertrag bleiben unveraendert. Der finaleBILL-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-20zieht diesen blockierenden Vertrag mit92845ec15fail-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,#351und#352sind normal nachmaingemergt. Der finale Merge0172889382, Main-Runs11817bis11820und 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-requiredabgefangen. - 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 EURnetto,85,31 EURUSt. und534,31 EURZahlbetrag 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.pngim BILL-20-Desktop-Review-Ordner.
BILL-19: 8/8 DoD = 100 % done. 0 Punkte offen.