Refresh HiveGrid Cloud reference snapshot
This commit is contained in:
1 parent
5e99e14772
commit
7f88026f79
5955 files changed
+1177325
-188362
No files matched your search
@@ -0,0 +1,196 @@
|
||||
# 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.**
|
||||
Reference in new issue
Block a user