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,159 @@
|
||||
# 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.**
|
||||
Reference in new issue
Block a user