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

160 lines
8.1 KiB
Markdown

# BILL-21 · Mollie-Zahlungen über 1.000 € ausschließlich per Karte einziehen
| | |
| ----------------- | --------------------------------------------- |
| **Typ** | Launch-Fix · Billing-/Payment-Sicherheit |
| **Owner** | Raffael |
| **Phase** | Pilot-Härtung |
| **Cycle/Fenster** | gestartet 2026-08-02 |
| **Status** | Done |
| **Plane** | HIVEGRID-242 |
## Abhängigkeiten & Parallelität
- **Blocked by:** `BILL-11` definiert Katalog und invoice-getriebenes
Recurring, `BILL-13` die Mollie-Methodenauswahl und `BILL-14` den
Registrierungs-/Erstkaufpfad. Alle drei Tickets sind Done.
- **Blocks:** `BILL-08` Production-Aktivierung. Der bisherige externe Blocker
„SEPA-Limit anheben“ wird durch einen fail-closed Kartenvertrag ersetzt.
- **Abhängigkeitsschutz:** Preise, Vertragslaufzeit, technische
`annual_sepa`-Codes, Lago-Rechnungen, Entitlements und Hosted Checkout
bleiben unverändert. Der Code ist aus Kompatibilitätsgründen weiterhin ein
Katalogname, aber keine Zusage, Zahlungen oberhalb des Providerlimits per
Lastschrift einzuziehen.
## Was / Warum
Mollie dokumentiert für SEPA Direct Debit standardmäßig maximal 1.000 EUR je
Transaktion. Colony kostet bereits ohne Zusatznutzer oder Speicher 899 EUR
netto beziehungsweise 1.069,81 EUR brutto. HiveGrid filterte bei
12-Monatsverträgen Karten bislang vollständig heraus und erzwang im Worker
später erneut `directdebit`. Im aktivierten Testprofil blieb dadurch sichtbar
nur iDEAL: Die kundenpräsente iDEAL-Erstzahlung erzeugt ein SEPA-Mandat, löst
aber das Limit der späteren Lastschrift nicht.
Der verbindliche Vertrag lautet:
- Bis einschließlich 1.000,00 EUR brutto bleibt die bisherige, von Mollie für
`sequenceType=first` freigegebene Mandatsauswahl gültig.
- Ab 1.000,01 EUR brutto ist `creditcard` die einzige zulässige Methode.
- Dieselbe Grenze gilt für Basisplan-, Änderungs- und Add-on-Checkouts sowie
für die invoice-getriebene wiederkehrende Zahlung.
- Bietet das konkrete Mollie-Profil für den Betrag keine Karte an, bricht
HiveGrid vor Lago-/Mollie-Mutationen ab und erklärt den Zustand im UI.
## Nicht im Scope
- Keine eigenen Kartenfelder, kein Iframe und keine Speicherung von Karten-,
Bank- oder Mandatsdaten in HiveGrid.
- Keine Preis-, Rabatt-, Vertragslaufzeit-, Steuer- oder Entitlement-Änderung.
- Keine Production-Live-Zahlung und keine Umgehung der übrigen `BILL-08`-Gates.
- Keine automatische Aufteilung einer Rechnung in mehrere Teilzahlungen.
## Definition of Done
- [x] Ein zentraler, reiner Payment-Policy-Contract definiert die exakte
Grenze: 100.000 Cent erlaubt SEPA, 100.001 Cent verlangt Karte.
- [x] Basisplan- und Planwechsel-Previews zeigen oberhalb der Grenze nur die
aktuell verfügbare Mollie-Kartenmethode.
- [x] Ohne verfügbare Karte bricht der Basischeckout vor jeder Lago-/Mollie-
Mutation mit einem sicheren Klartextzustand ab.
- [x] Wiederkehrende und einmalige Add-on-Käufe verwenden oberhalb der Grenze
denselben Kartenvertrag.
- [x] Der Recurring-Worker setzt für Rechnungen oberhalb der Grenze
`sequenceType=recurring` plus `creditcard`, statt `directdebit` aus dem
technischen Katalogcode abzuleiten.
- [x] Die Billing-UI erklärt die Kartenpflicht, zeigt eine fehlende Karte als
Fehler und deaktiviert die Checkout-Aktion.
- [x] Unit-, Service-, Worker-, UI-, i18n- und Grenzwerttests decken 1.000,00
EUR, 1.000,01 EUR und fehlende Kartenverfügbarkeit ab.
- [x] Typecheck, Lint, vollständige Testsuite und passende Billing-/Source-
Verifier sind grün.
- [x] Plane, abhängige Ticket-Docs und Change-Request dokumentieren Ergebnis,
Proof und verbleibende Production-Gates konsistent.
**BILL-21: 9/9 DoD = 100 % done. Kein selbst machbarer Punkt offen.**
2026-08-02 · Abhängigkeitsschutz für `BILL-22`
- `BILL-22` erhält die harte Grenze von 100.000/100.001 Cent, öffnet darunter
aber die kundenseitige Wahl einschließlich Kreditkarte. Außerdem wird der
hier gefundene Worker-/Gateway-Widerspruch geschlossen: Recurring-Karte ist
nur mit passendem gültigem Mandat zulässig; ein fehlendes Mandat bleibt
fail-closed und fällt nie auf SEPA zurück.
2026-08-02 · Release-Proof
- PR `#354` lief auf Head `0b9351eef` mit 13/13 grünen Checks und wurde
ausschließlich per normalem Merge-Commit `86eb01825` in `main` übernommen;
die drei atomaren Feature-Commits bleiben vollständig in der Historie.
- Main-/Staging-Run `3082` sowie alle vier Main-Statuschecks sind grün. Der
Run baute und promotete die unveränderlichen Images und schloss den
Coolify-/Readiness-Pfad erfolgreich ab.
- `https://staging-app.hivegrid.de/healthz` und `/readyz` melden
`hivegrid-web`, `core`, `86eb01825af39d9c28fcd663887d3189cfeb0854` als
gesund beziehungsweise bereit. Die beiden entsprechenden Endpunkte auf
`https://staging-api.hivegrid.de` melden dieselbe Revision für `api`.
- Es wurde keine Production-Zahlung und keine Production-Promotion ausgelöst.
**BILL-21: 9/9 DoD = 100 % done. Kein selbst machbarer Punkt offen.**
## Rollback
- Der zentrale Resolver und seine drei Konsumenten können gemeinsam auf den
vorherigen Methodenvertrag zurückgesetzt werden. Bereits erzeugte Zahlungen,
Rechnungen und Mandate bleiben append-only und werden nicht gelöscht.
- Der bestehende Provider-Side-Effect-Gate kann das Recurring-Inkasso stoppen.
Ein Rollback darf niemals eine Rechnung oberhalb von 1.000 EUR automatisch
auf `directdebit` zurückfallen lassen; bis zur Korrektur bleibt sie offen.
## Quellen
- https://docs.mollie.com/docs/sepa-direct-debit
- https://docs.mollie.com/docs/cards
- https://docs.mollie.com/docs/recurring-payments
- https://docs.mollie.com/reference/create-customer-payment
- `.planning/ticket-docs/BILL-08.md`
- `.planning/ticket-docs/BILL-11.md`
- `.planning/ticket-docs/BILL-13.md`
- `.planning/ticket-docs/BILL-14.md`
## Umsetzungs-Notiz
2026-08-02 · gestartet
- Plane-Ticket `HIVEGRID-242` angelegt, Raffael zugewiesen und auf In Progress
gesetzt. Die Plane-Identität wurde als `raffael@tool-ctrl.de` geprüft.
- `blocked-by` und `blocks` wurden in Plane sowie in den vier abhängigen
Ticket-Docs in beide Richtungen gelesen. `CR-019` genehmigt den Ersatz des
externen SEPA-Limit-Gates durch die harte Kartenregel.
- Baseline vor dem ersten Edit: Typecheck grün, Core-Suite 8.244 Tests grün
(60 übersprungen), EU-Provider-Guard leer.
**BILL-21: 0/9 DoD = 0 % done. 9 Punkte selbst machbar.**
2026-08-02 · umgesetzt
- `1ff12656c` zentralisiert das dokumentierte EUR-1.000-SEPA-Limit und
erzwingt ab 100.001 Cent `creditcard` in Basis-/Änderungscheckout, Add-ons
und invoice-getriebenem Recurring-Worker. Die serverseitige Methods-Abfrage
prüft den konkreten Betrag und bricht ohne angebotene Karte vor
Lago-/Mollie-Mutationen ab.
- `70765fae3` ergänzt den expliziten Kartenstatus im View-Model, Klartext in
de/en, automatische Auswahl der einzigen Kartenmethode, deaktivierte
Checkout-Aktionen sowie UI-/A11y-Regressionsproof.
- Ein 0,00-EUR-`first`-Payment für Kreditkarte bleibt bei Trial und
periodischem Planwechsel zulässig und erzeugt laut Mollie-Dokumentation das
für die spätere Kartenbelastung benötigte Mandat. Der tatsächlich fällige
Folgebetrag steuert bereits bei dieser Autorisierung die Kartenregel.
- Proof: `pnpm typecheck`, `pnpm lint`, vollständige Core-Suite mit 1.185
Testdateien / 8.252 bestandenen Tests / 60 bewusst übersprungenen Tests,
zusätzlich 127 fokussierte Billing-/Worker-/UI-Tests sowie
`verify:i18n`, `verify:billing-boundary-baseline`, `verify:source-health`
und `verify:ci-baseline` grün. `git diff --check` ist sauber; keine
Schema-/Migration-/Secret-Änderung.
- Die verbleibenden Production-Gates sind unverändert in `BILL-08`: Mollie
Live/KYC und Legal-/Steuerfreigabe. Eine echte Production-Zahlung wurde
nicht ausgelöst.
**BILL-21: 9/9 DoD = 100 % done. Kein selbst machbarer Punkt offen.**