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

138 lines
7.1 KiB
Markdown

# 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.**