12 KiB
BILL-22 · Geführter Checkout mit freier Zahlart und Add-on-Upsells
| Typ | Launch-Fix · Registrierungs-/Billing-/Payment-UX |
| Owner | Raffael |
| Phase | Pilot-Härtung |
| Cycle/Fenster | gestartet 2026-08-02 |
| Status | In Arbeit · auf Staging deployed |
| Plane | HIVEGRID-244 |
🎨 design-nachzug: offen (seit 2026-08-02) — der Pilot-Slice nutzt gemäß
AD-28 ausschließlich bestehende ~/ui-Bausteine; ein finales Subframe-Delta
für den neu geschnittenen Checkout liegt noch nicht vor.
Abhängigkeiten & Parallelität
- Blocked by:
BILL-11,BILL-14,BILL-19,BILL-20undBILL-21sind Done und liefern Katalog, Registrierungspräferenz, Aktivierungs-Gate, Welcome-Journey und die EUR-1.000-Kartenregel. - Blocks:
BILL-08Production-Aktivierung. Dessen Mollie-Live-/Legal-Gates bleiben unverändert extern blockiert. - Abhängigkeitsschutz: Plan-/Preis-/Entitlement-Codes, Lago-Rechnungen,
bestätigungsgebundene Freischaltung, Hosted Checkout und bestehende aktive
Abos bleiben autoritativ. Der technische Cadence-Code
annual_sepableibt aus Kompatibilitätsgründen bestehen, erzwingt im Checkout aber keine SEPA- Auswahl mehr.
Was / Warum
Die aktuelle Registrierung und Erstaktivierung vermischen Teamgröße, Tarif,
Laufzeit, Speicher, Preisprüfung und Zahlung in langen Karten. Die Empfehlung
ist dadurch weniger klar als die Eingabe, aus der sie entsteht. Zugleich
filtert der 12-Monatsvertrag unterhalb von 1.000 EUR Kreditkarten heraus,
obwohl Mollie diese Zahlart anbietet. Der Recurring-Adapter akzeptiert intern
außerdem nur directdebit, obwohl BILL-21 oberhalb der Grenze creditcard
anfordert.
Der neue Vertrag ist ein geführter, responsiver Ablauf:
- Büro- und Baustellen-Nutzer zuerst erfassen; Slider, Zahleneingabe und Rollen-Icons bleiben synchron und tastaturbedienbar.
- Die günstigste passende Konfiguration live serverseitig berechnen, verständlich begründen und alle Tarife samt echtem Teampreis vergleichen.
- Zusatzspeicher auf einer eigenen, überspringbaren Seite anbieten und den im Tarif enthaltenen Speicher klar gegen den Mehrbedarf stellen.
- E-Mail-Marketing auf einer eigenen Ja/Nein-Seite erklären. Die optionale Produktbuchung bleibt ein separater, bestätigter Add-on-Checkout nach der Basisaktivierung; es gibt keine vorgetäuschte Bündelzahlung.
- Netto, Umsatzsteuer, Brutto, Laufzeit und verfügbare Mollie-Zahlarten auf einer fokussierten Zahlungsseite zusammenfassen. Bis einschließlich 1.000,00 EUR kann der Kunde einschließlich Kreditkarte frei wählen; ab 1.000,01 EUR ist Karte Pflicht.
- Wiederkehrende Belastungen verwenden ein gültiges Mandat der gewählten Methodenfamilie. Eine Rechnung fällt nie still von Karte auf SEPA zurück.
Nicht im Scope
- Keine eigenen Kartenfelder, kein Mollie-Iframe und keine Speicherung sensibler Karten-/Bankdaten in HiveGrid.
- Keine Änderung der öffentlichen Speicherpreise in diesem Ticket. Die Hetzner-Margen werden separat mit Quelle und Preisempfehlung dokumentiert; eine Preisänderung braucht eine eigene Produktentscheidung.
- Keine neue Testphase, kein Enterprise-Self-Service und keine automatische Aufteilung großer Rechnungen.
- Keine Production-Live-Zahlung vor den offenen
BILL-08-Gates.
Definition of Done
- Registrierung trennt Konto, Teamgröße und Tarifentscheidung; Slider, Zahleneingabe, Rollen-Icons und vorhandene serverseitige Empfehlung sind synchron, responsiv und barrierearm.
- Aktivierung führt in klar getrennten Schritten durch Team, Tarif, Speicher, E-Mail-Marketing und Zahlung; jeder optionale Upsell ist explizit überspringbar.
- Plan- und Zahlungsseiten zeigen den live serverseitig berechneten Netto-, Umsatzsteuer- und Bruttobetrag sowie enthaltene und zusätzliche Nutzer/ Speicher ohne zweite clientseitige Preisquelle.
- Unterhalb und einschließlich 1.000 EUR bleiben alle für den konkreten Betrag von Mollie angebotenen Erstzahlarten wählbar, einschließlich Kreditkarte; oberhalb bleibt ausschließlich Kreditkarte zulässig.
- Wiederkehrende Mollie-Zahlungen akzeptieren Karte und Lastschrift nur mit einem gültigen, betragskonformen Mandat; ein fehlendes Kartenmandat bricht oberhalb der Grenze fail-closed ab.
- E-Mail-Marketing wird als eigener, optionaler Folgeschritt transparent vom Basischeckout getrennt; Freischaltung erfolgt weiterhin erst nach bestätigtem Add-on-Checkout.
- Unit-, Service-, Worker-, Route-, Component-, i18n-, A11y-, Hot-Swap- und Desktop-/Mobile-Visualtests decken Schrittfolge, Livepreise, Zahlartwahl, Grenze und Mandatsfehler ab.
- Typecheck, Lint, vollständige Testsuite und passende Billing-/Source-/ i18n-/A11y-/Visual-Verifier sind grün.
- PR-CI, normaler Merge, Staging-Deploy und ein ausschließlich mit Mollie TEST ausgeführter Signup-zu-Zahlung-UAT sind grün; fertige Screenshots liegen im Desktop-Review-Ordner.
BILL-22: 8/9 DoD = ~89 % done. Offen: interaktiver Mollie-TEST-UAT. PR-CI, normaler Merge, Staging-Deploy und nichtinteraktive Live-Probes sind grün.
Technische Bausteine
apps/web/app/modules/users/components/RegisterScreen.tsxapps/web/app/modules/users/components/RegistrationPlanStep.tsxapps/web/app/components/screens/billing/SelfServiceSubscriptionPage.tsxapps/web/app/routes/app.$tenant/settings/billing/index.tsxapps/web/app/services/billing/payment-methods.server.tspackages/billing/src/mollie-payment-policy.tspackages/billing/src/mollie.tsundpackages/billing/src/types.tsapps/worker/src/jobs/recurring-invoice-collection.ts- bestehende
~/ui-Komponenten und serverautoritatives Billing-View-Model docs/CHANGE-REQUESTS.md· CR-021
Rollback
- UI-Schrittfolge und freie Auswahl unterhalb der Grenze können gemeinsam auf den bisherigen Aktivierungsbuilder zurückgesetzt werden. Serverseitige Preis-, Gate- und Entitlement-Verträge bleiben bestehen.
- Bereits erzeugte Mollie-Zahlungen, Mandate und Lago-Rechnungen werden nie gelöscht oder umgeschrieben. Bei einem Payment-Rollback bleibt die EUR-1.000-Grenze mindestens fail-closed; es gibt keinen SEPA-Fallback.
Quellen
docs/CHANGE-REQUESTS.md· CR-021.planning/ticket-docs/BILL-11.md.planning/ticket-docs/BILL-14.md.planning/ticket-docs/BILL-19.md.planning/ticket-docs/BILL-20.md.planning/ticket-docs/BILL-21.md- https://docs.mollie.com/docs/recurring-payments
- https://docs.mollie.com/reference/mandates-api
- https://docs.hetzner.com/storage/object-storage/overview/
- https://www.hetzner.com/storage/object-storage/
Dev-Nachzug
- Interim-UI wird gegen Desktop und Mobile visuell geprüft. Nach Davids finalem Delta müssen ausschließlich Adapter/Visual-Baselines nachgezogen werden; View-Model-, Payment- und Entitlement-Verträge bleiben stabil.
Umsetzungs-Notiz
2026-08-02 · gestartet
- Explizite Produktfreigabe im Chat für freie Kreditkartenwahl auch unter 1.000 EUR, Teamgröße vor Tarif, live berechnete Preise und getrennte Speicher-/E-Mail-Marketing-Upsells.
blocked-byundblocksin Plane sowie den betroffenen Ticket-Docs in beide Richtungen geprüft. Plane-Identität alsraffael@tool-ctrl.debestätigt;HIVEGRID-244angelegt, Raffael zugewiesen und auf In Progress gesetzt.- Neuer Worktree
HiveGrid-Cloud-feat-bill-22-guided-checkoutauf aktuellemorigin/main; EU-Provider-Guard leer, Typecheck und vollständige Baseline mit 1.187 Testdateien / 8.278 Tests grün (60 bewusst übersprungen). - Diagnose:
BILL-21wählt für wiederkehrende Rechnungen über 1.000 EUR zwarcreditcard, der Mollie-Adapter lehnte fürsequenceType=recurringjedoch weiterhin jede Methode außerdirectdebitab. Gemockte Worker-Tests hatten diesen Integrationswiderspruch nicht erkannt. Der Nachzug ist Teil dieses Tickets.
2026-08-02 · lokale Umsetzung und Verifikation
- Registrierung in Konto, Team und Tarif getrennt. Büro-/Baustellen-Nutzer lassen sich per Slider, Zahleneingabe und Plus/Minus bedienen; die serverseitige Empfehlung und alle Teampreise aktualisieren sich live.
- Aktivierung in Team, Tarif, Speicher, E-Mail und Zahlung geteilt. Speicher und E-Mail-Marketing sind eigene überspringbare Upsells. Ein ausgewähltes E-Mail-Paket wird erst nach bestätigter Basiszahlung in einen eigenen Add-on-Checkout überführt.
- Mollie lässt bis einschließlich 1.000,00 EUR alle für den Betrag verfügbaren Erstzahlarten inklusive Kreditkarte zu. Ab 1.000,01 EUR wird ausschließlich Kreditkarte angefordert. Recurring Collections prüfen die passende Mandatsfamilie und brechen ohne erforderliches Kartenmandat fail-closed ab.
- Commits:
90c4f4079,c1fa42867,b15d3b5f6,9242ab48c,3f3aa7903,cbb0a071f,aee4fb301,2cd062114. - Vollständige Testsuite: 1.187 Testdateien und 8.293 Tests grün, 60 bewusst übersprungen. Package-Tests, Coverage-Vertrag, Typecheck, Lint, i18n, Billing-Boundary/-Catalog, Source-Health, Hot-Swap, A11y-Coverage und Visual-Verifier grün. Component-Visualtests: 6/6 Desktop/Mobile grün.
- Bekannte globale Baseline-Altlast:
verify:a11y-baselinemeldet auf diesem Branch unverändert 66 historischeautoFocus-Treffer gegenüber 56 in der Baseline. BILL-22 fügt keinen Treffer hinzu; A11y-Coverage und die neuen interaktiven Flows sind grün. Dieser repo-weite Nachzug ist nicht Teil des Tickets. - 13 fertig gerenderte und visuell geprüfte Screens liegen unter
/Users/raffaelsheikh/Desktop/HiveGrid-BILL-22-Checkout-Review-2026-08-02/. Live-Staging-Screens folgen nach dem Deploy. - Hetzner-Recherche: 1 TB ist im Object-Storage-Grundpreis von 6,49 EUR/Monat
enthalten; zusätzlicher Speicher kostet 6,26 EUR/TB/Monat. Die aktuellen
HiveGrid-Aufpreise erzielen vor Grundpreis, Redundanz, Betrieb und Traffic
rund 93,0 % (100 GB), 89,2 % (500 GB), 87,2 % (1 TB) und 84,3 % (5 TB)
Rohmarge. Eine niedrigere Preisstaffel ist in
docs/pricing-draft.mdvorgeschlagen, aber bewusst nicht ohne Produktentscheidung aktiviert.
2026-08-02 · Merge, Deploy und Live-Probes
- PR
#360nach grüner Bundle-, Coverage- und 11/11-Haupt-CI normal gemergt; BILL-22-Head69f74183c, Merge-Commita44a239e7. - Ein durch den unmittelbar vorausgehenden Parallel-Merge
#359sichtbar gewordener i18n-Paritätskonflikt wurde separat in PR#362behoben. Der Hotfix lief lokal mit Typecheck, Lint, 8.320 Tests, i18n und Coverage grün und wurde nach vollständiger PR-CI normal als54dab6304gemergt. - Main-Runs
11881(Bundle),11882(Coverage),11883(Images, Migration, Coolify-Staging) und11884(Repository-Metriken) sind grün. Alle zwölf Coolify-Ressourcen wurden mit dem immutable Merge-SHA ausgerollt; der revisionsgebundene Portal-Domain-Controller-Healthcheck ist grün. - Live auf
staging-app.hivegrid.de:/healthz,/readyzund/registerantworten mit HTTP 200; Health und Readiness melden Revision54dab6304. Die serverseitige Tarifberatung empfiehlt und berechnet für 1/0 Core mit 199 EUR, für 5/15 Swarm mit 499 EUR und für 10/20 Swarm inklusive Extras mit 789 EUR netto. - Der ausschließlich mit Mollie TEST auszuführende interaktive Signup-zu-Zahlung-UAT bleibt offen, weil in der ausführenden Sitzung keine unterstützte Browser-Verbindung verfügbar war. Es wurde weder eine echte Zahlung ausgelöst noch ein Browser-UAT vorgetäuscht.
BILL-22: 8/9 DoD = ~89 % done. Offen: interaktiver Mollie-TEST-UAT (extern durch fehlende Browser-Verbindung blockiert; 0 weitere selbst machbare Implementierungspunkte).
2026-08-02 · Abhängigkeitsschutz für BILL-23:
- Die getrennte Speicher-Upsell-Seite bleibt strukturell bestehen und zeigt
künftig den lizenzbasierten gemeinsamen Workspace-Pool sowie die fairen
Cloud-Speicher Plus-Preise aus derselben serverseitigen Vorschau. - Team-, Tarif-, E-Mail- und Zahlartfluss sowie das offene Mollie-TEST-UAT
ändern sich nicht.
BILL-22bleibt 8/9 DoD = ~89 % done.