138 lines
7.1 KiB
Markdown
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.**
|