feat: Ein Uebertrag faengt seine Gegenseite ab

Ein Uebertrag legte auf dem Zielkonto nichts an. Der Duplikatschutz konnte die
Gegenseite deshalb nicht sehen – er vergleicht import_hash, den eine
Uebertrags-Buchung nicht hat, und Eingangs-Eintraege, die es dort nicht gab.
Die schon vorliegende Gegenseite liess sich ein zweites Mal buchen, die
spaeter von der Bank gelieferte kam ungeprueft an: das Geld zweimal auf dem
Zielkonto.

Jetzt entsteht auf dem Zielkonto ein Eingangs-Eintrag, der auf DIESELBE Buchung
zeigt. Liegt dort schon ein passender offener Eintrag, wird dieser verbraucht
statt einen zweiten anzulegen – ueber denselben Abgleich wie beim Import, nicht
ueber eine zweite Vergleichslogik. Damit greift auch der vorhandene Schutz
gegen die spaeter eintreffende Gegenseite, ohne dass etwas Neues dafuer gebaut
werden musste.

Die Uebertrags-Logik liegt dafuer in einem eigenen Dienst. Zwei Wege fuehren
hinein – ein offener Vorschlag und eine schon gebuchte Buchung – und beide
brauchen dieselben vier Regeln. Der PATCH-Weg des Buchungs-Routers taete es
nicht: Er dreht die Richtung bei einer Einnahme nicht um und legt keine
Gegenseite an.

Die Sperre richtet sich nicht mehr nach der Waehrung, sondern danach, ob der
Betrag der Gegenseite BEKANNT oder geschaetzt ist. Bei gleicher Waehrung ist er
exakt, die Gegenseite wird sicher wiedererkannt – dann geht ein Uebertrag auf
ein angebundenes Konto ohne Nachfrage durch. Ueber Waehrungen hinweg bleibt die
Warnung, weil der EZB-Kurs nicht der Kurs der Bank ist.

Und Verwerfen raeumt beide Seiten: Bei einem Uebertrag zeigen zwei Eintraege
auf dieselbe Buchung, und der Fremdschluessel haette die andere als 'gebucht'
ohne Buchung zurueckgelassen.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
This commit is contained in:
Guido
2026-08-27 10:13:52 +02:00
co-authored by Claude Opus 5
parent 90bda6b161
commit 8ceee5c5b1
8 changed files with 468 additions and 103 deletions
+42
View File
@@ -835,3 +835,45 @@ def test_takt_wird_geprueft(admin, fake_bank):
params={"minutes": 0}).json()["poll_minutes"] == 0
assert admin.put(f"/api/bank/connections/{verbindung}/takt",
params={"minutes": 240}).json()["poll_minutes"] == 240
def test_spaeter_gelieferte_gegenseite_wird_nicht_noch_einmal_gebucht(admin, fake_bank):
"""Der eigentliche Zweck der Gegenseite: Die Bank meldet den Zugang selbst.
Ohne den Eingangs-Eintrag auf dem Zielkonto stuende das Geld zweimal da."""
_app(admin)
uid = f"acc-{secrets.token_hex(4)}"
heute = date.today()
betrag = 30000 + secrets.randbelow(9000)
fake_bank(
konten=[{"uid": uid, "name": "Ziel", "currency": "CHF"}],
umsaetze=[{
"entry_reference": f"tx-{secrets.token_hex(4)}",
"booking_date": heute.isoformat(),
"transaction_amount": {"amount": f"{betrag / 100:.2f}", "currency": "CHF"},
"credit_debit_indicator": "CRDT",
"debtor": {"name": "Eigenes Konto"},
}],
)
state = admin.post("/api/bank/connect",
json={"aspsp_name": f"Gegen-{secrets.token_hex(3)}",
"country": "CH"}).json()["state"]
admin.post(f"/api/bank/callback?state={state}&code=guter-code")
link = [v for v in admin.get("/api/bank/links").json() if v["remote_uid"] == uid][0]
ziel = _konto(admin, name=f"Bank-Ziel {secrets.token_hex(3)}", currency="CHF")
admin.post(f"/api/bank/links/{link['id']}/account/{ziel['id']}")
quelle = _konto(admin, name=f"Quelle {secrets.token_hex(3)}", currency="CHF")
# Den Uebertrag von Hand buchen – die Gegenseite entsteht dabei auf `ziel`.
from tests.test_inbox import _eingang
eintrag = _eingang(admin, quelle, -betrag, datum=heute.isoformat())
r = admin.post(f"/api/inbox/{eintrag['id']}/transfer", json={"to_account_id": ziel["id"]})
assert r.status_code == 200, r.text
vorher = admin.get(f"/api/accounts/{ziel['id']}").json()["balance_cents"]
assert vorher == betrag
# Jetzt liefert die Bank denselben Zugang.
abruf = admin.post(f"/api/bank/links/{link['id']}/sync").json()
assert abruf["geholt"] == 1, "der Umsatz kam an"
assert abruf["neu"] == 0, "und wurde als Gegenseite erkannt"
assert admin.get(f"/api/accounts/{ziel['id']}").json()["balance_cents"] == vorher
+119 -8
View File
@@ -129,27 +129,38 @@ def _binde_an(konto):
db.close()
def test_angebundenes_zielkonto_wird_abgefangen(admin):
"""Der teuerste Fehler an dieser Stelle: Das Zielkonto haengt selbst an
einer Bank und meldet den Zugang von allein – eine Gegenbuchung hier
bedeutet das Geld zweimal."""
def test_angebundenes_ziel_gleicher_waehrung_geht_durch(admin):
"""Bei gleicher Waehrung ist der Betrag exakt – die Gegenseite wird beim
Bankabruf sicher als dieselbe erkannt. Dann muss man nicht fragen."""
ziel = _konto(admin, name=f"Angebunden {secrets.token_hex(3)}", currency="CHF")
_binde_an(ziel)
quelle = _konto(admin, name=f"Quelle {secrets.token_hex(3)}", currency="CHF")
eintrag = _eingang(admin, quelle, -10000)
r = admin.post(f"/api/inbox/{eintrag['id']}/transfer", json={"to_account_id": ziel["id"]})
assert r.status_code == 200, r.text
assert admin.get(f"/api/accounts/{ziel['id']}").json()["balance_cents"] == 10000
def test_angebundenes_ziel_anderer_waehrung_fragt_nach(admin):
"""Ueber Waehrungen hinweg rechnet Certain mit dem EZB-Kurs, die Bank mit
ihrem eigenen. Der geschaetzte Betrag laesst sich beim Abruf nicht
wiedererkennen – dann kaeme der Zugang ein zweites Mal."""
ziel = _konto(admin, name=f"Angebunden EUR {secrets.token_hex(3)}", currency="EUR")
_binde_an(ziel)
quelle = _konto(admin, name=f"Quelle CHF {secrets.token_hex(3)}", currency="CHF")
eintrag = _eingang(admin, quelle, -10000)
r = admin.post(f"/api/inbox/{eintrag['id']}/transfer", json={"to_account_id": ziel["id"]})
assert r.status_code == 409, r.text
assert "angebunden" in r.json()["detail"]
# Nichts gebucht, nichts verschoben.
assert "EZB" in r.json()["detail"]
assert admin.get(f"/api/accounts/{ziel['id']}").json()["balance_cents"] == 0
# Wer es besser weiss, kommt trotzdem durch.
r = admin.post(f"/api/inbox/{eintrag['id']}/transfer",
json={"to_account_id": ziel["id"], "trotzdem": True})
assert r.status_code == 200, r.text
assert admin.get(f"/api/accounts/{ziel['id']}").json()["balance_cents"] == 10000
assert admin.get(f"/api/accounts/{ziel['id']}").json()["balance_cents"] > 0
def test_uebertrag_nennt_das_gegenkonto_und_nimmt_keine_kategorie(admin):
@@ -191,3 +202,103 @@ def test_normale_buchung_nimmt_weiterhin_eine_kategorie(admin):
assert r.json()["transfer_account_id"] is None
txn = admin.get(f"/api/transactions/{r.json()['transaction_id']}").json()
assert txn["category_id"] == kat, "die Kategorie muss auch an der Buchung stehen"
def test_gegenseite_wird_verbraucht_statt_gespiegelt(admin):
"""Liegt die Gegenseite schon im Eingang, wuerde sie sonst ein zweites Mal
gebucht – das Geld staende zweimal auf dem Zielkonto."""
von = _konto(admin, name=f"Paar-Von {secrets.token_hex(3)}", currency="CHF")
nach = _konto(admin, name=f"Paar-Nach {secrets.token_hex(3)}", currency="CHF")
betrag = 40000 + secrets.randbelow(9000)
ab = _eingang(admin, von, -betrag, datum="2026-08-10")
an = _eingang(admin, nach, betrag, datum="2026-08-11") # einen Tag spaeter
r = admin.post(f"/api/inbox/{ab['id']}/transfer", json={"to_account_id": nach["id"]})
assert r.status_code == 200, r.text
txn_id = r.json()["transaction_id"]
eintraege = {e["id"]: e for e in admin.get("/api/inbox").json()}
assert eintraege[an["id"]]["status"] == "booked", "die Gegenseite blieb offen"
assert eintraege[an["id"]]["transaction_id"] == txn_id, "muss dieselbe Buchung sein"
# Genau eine Bewegung, kein doppeltes Geld.
assert admin.get(f"/api/accounts/{von['id']}").json()["balance_cents"] == -betrag
assert admin.get(f"/api/accounts/{nach['id']}").json()["balance_cents"] == betrag
def test_ohne_gegenseite_entsteht_genau_eine(admin):
von = _konto(admin, name=f"Spiegel-Von {secrets.token_hex(3)}", currency="CHF")
nach = _konto(admin, name=f"Spiegel-Nach {secrets.token_hex(3)}", currency="CHF")
betrag = 50000 + secrets.randbelow(9000)
eintrag = _eingang(admin, von, -betrag)
r = admin.post(f"/api/inbox/{eintrag['id']}/transfer", json={"to_account_id": nach["id"]})
txn_id = r.json()["transaction_id"]
gegen = [e for e in admin.get("/api/inbox").json()
if e["transaction_id"] == txn_id and e["id"] != eintrag["id"]]
assert len(gegen) == 1
assert gegen[0]["source"] == "transfer"
assert gegen[0]["account_id"] == nach["id"]
assert gegen[0]["amount_cents"] == betrag
assert gegen[0]["transfer_account_id"] == von["id"], "aus ihrer Sicht das andere Konto"
def test_verwerfen_raeumt_beide_seiten(admin):
"""Sonst bliebe die andere Seite als „gebucht" ohne Buchung stehen."""
von = _konto(admin, name=f"Weg-Von {secrets.token_hex(3)}", currency="CHF")
nach = _konto(admin, name=f"Weg-Nach {secrets.token_hex(3)}", currency="CHF")
betrag = 60000 + secrets.randbelow(9000)
eintrag = _eingang(admin, von, -betrag)
r = admin.post(f"/api/inbox/{eintrag['id']}/transfer", json={"to_account_id": nach["id"]})
txn_id = r.json()["transaction_id"]
assert admin.delete(f"/api/inbox/{eintrag['id']}").status_code == 204
offen = admin.get("/api/inbox").json()
assert not [e for e in offen if e["transaction_id"] == txn_id], \
"ein Eintrag zeigt noch auf die geloeschte Buchung"
assert admin.get(f"/api/accounts/{von['id']}").json()["balance_cents"] == 0
assert admin.get(f"/api/accounts/{nach['id']}").json()["balance_cents"] == 0
def test_gebuchte_ausgabe_laesst_sich_nachtraeglich_zum_uebertrag_machen(admin):
"""Ohne diesen Weg bliebe eine per CSV eingelesene Umbuchung fuer immer
eine Ausgabe."""
von = _konto(admin, name=f"Nachtraeglich {secrets.token_hex(3)}", currency="CHF")
nach = _konto(admin, name=f"Nachziel {secrets.token_hex(3)}", currency="CHF")
betrag = 80000 + secrets.randbelow(9000)
txn = admin.post("/api/transactions", json={
"type": "expense", "date": "2026-08-12", "account_id": von["id"],
"amount_cents": betrag, "payee": "Umbuchung"}).json()
r = admin.post(f"/api/transactions/{txn['id']}/transfer",
json={"to_account_id": nach["id"]})
assert r.status_code == 200, r.text
assert r.json()["type"] == "transfer"
assert r.json()["category_id"] is None
assert admin.get(f"/api/accounts/{von['id']}").json()["balance_cents"] == -betrag
assert admin.get(f"/api/accounts/{nach['id']}").json()["balance_cents"] == betrag
# Und die Gegenseite ist da, damit die Bank sie nicht noch einmal liefert.
gegen = [e for e in admin.get("/api/inbox").json() if e["transaction_id"] == txn["id"]]
assert len(gegen) == 1 and gegen[0]["account_id"] == nach["id"]
def test_nachtraeglicher_uebertrag_dreht_eine_einnahme_um(admin):
"""Der PATCH-Weg des Buchungs-Routers taete das nicht – die Buchung liefe
falsch herum und beide Salden waeren verkehrt."""
hier = _konto(admin, name=f"Ein-Hier {secrets.token_hex(3)}", currency="CHF")
dort = _konto(admin, name=f"Ein-Dort {secrets.token_hex(3)}", currency="CHF")
betrag = 90000 + secrets.randbelow(9000)
txn = admin.post("/api/transactions", json={
"type": "income", "date": "2026-08-13", "account_id": hier["id"],
"amount_cents": betrag}).json()
r = admin.post(f"/api/transactions/{txn['id']}/transfer",
json={"to_account_id": dort["id"]})
assert r.status_code == 200, r.text
assert r.json()["account_id"] == dort["id"], "der Abgang gehoert zum Gegenkonto"
assert r.json()["to_account_id"] == hier["id"]
assert admin.get(f"/api/accounts/{hier['id']}").json()["balance_cents"] == betrag
assert admin.get(f"/api/accounts/{dort['id']}").json()["balance_cents"] == -betrag