# BILL-18 · Registrierungs-Tarifwahl und CAPTCHA-Retry launchfest machen | | | | ----------------- | -------------------------------------------------------- | | **Typ** | Launch-Fix · Registrierung / Billing-UX / CAPTCHA | | **Owner** | Raffael | | **Phase** | Pilot-Härtung | | **Cycle/Fenster** | gestartet 2026-08-01 | | **Status** | Done | | **Plane** | HIVEGRID-239 | ## Abhängigkeiten & Parallelität - **Blocked by:** kein technischer Blocker. `BILL-14` liefert den zweistufigen Registrierungsvertrag, die serverseitige Tarifempfehlung und den Checkout- Prefill. Die bestehende self-hosted CAP-Integration liefert Challenge und serverseitige Verifikation. - **Blocks:** visuelle und funktionale Pilotabnahme der öffentlichen Registrierung. - **Abhängigkeitsschutz:** Tarifcodes, Preise, Sitzberechnung, E-Mail- Verifikation, Mollie-/Lago-Checkout und Entitlement-Aktivierung bleiben unverändert. Der Registrierungs-POST erhält nur einen opaken Retry-Schlüssel für eine neue clientseitige CAPTCHA-Instanz. ## Was / Warum Der Team-/Tarif-Schritt zeigte alle Tarife dauerhaft untereinander, verwendete rohe Zahlenfelder und platzierte CAPTCHA, Einwilligungen und Aktion ohne klare Entscheidungshierarchie in einer schmalen Card. Auf Mobile entstand dadurch ein langer, schwer erfassbarer Screen. Zusätzlich war am gesamten Formular `noValidate` gesetzt und die UI kannte den CAP-`solve`-Status nicht. Ein Klick auf „Fortfahren“ konnte deshalb ohne Token beim Server landen. CAP-Proofs sind außerdem einmalig: Lehnte der Server den Request nach erfolgreicher CAPTCHA-Prüfung später aus einem anderen Grund ab, blieb derselbe bereits verbrauchte Token im weiterhin gelöst aussehenden Widget und vergiftete den nächsten Versuch bis zum manuellen Reload. ## Nicht im Scope - Keine Änderung an Tarifpreisen, Seat-Formeln oder Produktausstattung. - Keine Änderung an E-Mail-Verifikation, Mollie Hosted Checkout, Lago, Rechnungen oder Entitlements. - Kein neuer CAPTCHA-Provider, kein Fail-open und keine schwächere serverseitige Prüfung. - Keine neue Registrierungsstufe und kein neues Produktfeature. ## Definition of Done - [x] Teamgrößen werden über zugängliche Plus-/Minus-Steuerungen erfasst; die bestehenden sicheren 1..10.000- bzw. 0..10.000-Grenzen bleiben erhalten. - [x] Der gewählte bzw. empfohlene Tarif steht als klare Zusammenfassung neben der Teamkonfiguration; andere Tarife sind standardmäßig eingeklappt und bleiben manuell wählbar. - [x] Ein Konto/Team-&-Tarif/Zahlung-Stepper, kleineres Branding und eine eigene Bestätigungszone erklären Reihenfolge und „noch keine Zahlung“ korrekt. - [x] Der CAP-CTA bleibt bis zum echten `solve`-Event gesperrt; `reset` und Clientfehler nehmen die Freigabe zurück. - [x] Jeder fehlgeschlagene initiale Registrierungs-POST liefert einen neuen opaken Reset-Key und remountet damit eine frische Challenge für den Retry. - [x] Texte sind de/en sowie informell/formell vorhanden; fokussierte Unit- und Component-Tests sowie Desktop-/Mobile-Pixelbaselines sind grün. - [x] Typecheck, Lint, vollständige Testsuite und passende i18n-/Source-Gates sind grün. - [x] PR-CI, normaler Merge, Staging-Deploy und Live-Registrierungsproof mit Mollie-Testumgebung sind grün; Review-Screenshots liegen auf dem Desktop. **BILL-18: 8/8 DoD = 100 % done. Offen: nichts.** 2026-08-02 · Abhängiger Erstaktivierungs-Nachzug - `BILL-19` konsumiert den hier gehärteten Konto-/Tarif-/CAPTCHA-Vertrag und korrigiert die danach sichtbare Erstaktivierung. CAPTCHA-Events, Retry-Key, Tarifempfehlung und alle BILL-18-DoD bleiben unverändert. ## Technische Bausteine - `apps/web/app/modules/users/components/RegisterScreen.tsx` - `apps/web/app/components/captcha/Captcha.tsx` - `apps/web/app/modules/users/services/AuthService.ts` - `apps/web/app/routes/register.tsx` - React-Router-Component-Fixture und Playwright-CT-Pixelbaselines - CR-016 in `docs/CHANGE-REQUESTS.md` ## Rollback Reiner Code-/UI-Rollback auf den bisherigen Registrierungs-Screen. Es gibt keine Migration, keinen Backfill und keine Provider-Mutation. Bestehende Registrierungen, Tarifauswahlen, Zahlungen und Entitlements bleiben unverändert. Beim Rollback ginge nur die neue Client-Freigabe und automatische CAPTCHA-Retry-Erneuerung verloren; die serverseitige Prüfung bliebe fail-closed. ## Umsetzungs-Notiz 2026-08-01 · Diagnose, Interim-UI und lokaler Proof - Abhängigkeiten geprüft: `BILL-14` bleibt in seinem Request-/Katalogvertrag unverändert; keine nachgelagerte Checkout- oder Entitlement-Schnittstelle ändert sich. - Root Cause nach Quellcode- und Provider-Widget-Prüfung: `noValidate` erlaubte fehlende CAP-Proofs; der Client beobachtete `solve`/`reset`/`error` nicht und remountete nach verbrauchtem oder abgelaufenem Proof keine neue Challenge. - Der neue Screen verwendet ausschließlich vorhandene `~/ui`-/Subframe- Komponenten. Desktop ordnet Team und Empfehlung nebeneinander; Mobile stapelt ohne horizontalen Überlauf. Andere Tarife bleiben einklappbar. - Lokaler Zwischenproof: Typecheck grün, 43/43 fokussierte Unit-/Service-Tests grün, Playwright-CT Desktop und Mobile 2/2 grün einschließlich exaktem `scrollWidth=390`-Vertrag. - Vollständiges lokales Release-Gate: Lint und Typecheck grün, 1.174/1.174 ausführbare Testdateien mit 8.262/8.262 Tests grün, i18n-Parität mit 15.691 Keys grün, Source-Health 22/22 grün, CI-Baseline 35/35 grün und Hot-Swap- Drill grün. - Plane-Identität als `raffael@tool-ctrl.de` bestätigt; `HIVEGRID-239` angelegt, Raffael zugewiesen und auf In Progress gesetzt. 2026-08-02 · PR-, Deploy- und Live-Proof - PR `#341` wurde nach 11/11 grünen Checks normal gemergt. Der erste Docker- Smoke lief wegen Runner-Contention ins Zeitlimit; nur dieser Job wurde gezielt wiederholt und war als Job `49449` grün. Merge-Commit: `b6501b0eafb8a6f6a93fd1520530caffb040a418`. - Staging-Deploy-Run `11724` ist grün. `/healthz` und `/readyz` melden exakt den Merge-Commit. Es gab keinen Production-Deploy. - Live-Registrierungs-UAT auf Staging: Der CTA blieb vor der echten CAP-Lösung gesperrt. Ein absichtlich abgelehnter Proof remountete eine neue Challenge und sperrte den CTA wieder; der folgende frische Proof registrierte erfolgreich. - Die Auswahl 5 Büro- und 15 Baustellen-Nutzer empfahl Swarm und blieb ohne URL-Query im Billing erhalten. Die ausschließlich im Mollie-Testmodus simulierte Zahlung aktivierte erst nach Bestätigung Swarm und 250 GB Speicher; die Rechnung über 593,81 EUR brutto ist finalisiert und bezahlt. - Review-Proof liegt unter `~/Desktop/HiveGrid-BILL-18-Registration-CAPTCHA-2026-08-01/` mit Konto-, Tarif-, CAPTCHA-Retry-, Preis-, Zahlungs-, Entitlement- und Rechnungs- Screenshots sowie einer `README.md`. **BILL-18: 8/8 DoD = 100 % done. Offen: nichts.**