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