feat: Die Kartenrechnung findet ihre Gegenbuchung von selbst

Eine Kreditkarte bekommt Geld nur aus einem Grund: weil ihre Rechnung
bezahlt wird. Das genuegt als Hinweis – und es wird gebraucht, denn im
Buchungstext steht bei so einer Zahlung oft weder ein Schlagwort noch
der Name des Gegenkontos. Die Erkennung fand das Paar deshalb, liess es
aber als Vorschlag liegen.

Entscheidend ist die RICHTUNG, nicht dass eine Karte beteiligt ist. Die
naheliegende Fassung "Kartenkonto auf einer Seite" haette einen
Karteneinkauf ueber 50,00 mit einer zufaelligen Gutschrift ueber 50,00
am selben Tag verknuepft – eine echte Ausgabe UND eine echte Einnahme
waeren still aus der Auswertung gefallen. Genau davor schuetzt die
Huerde, die hier gelockert wird. Ein Test haelt die Gegenprobe fest.

Die Schlagwortliste bleibt unberuehrt: "visa" und "mastercard" stehen in
gewoehnlichen Buchungstexten jedes Kontos.

Und der Import sagt jetzt, was er getan hat. Bisher lief die Suche nach
dem Buchen still; wer wissen wollte, ob die Kartenrechnung erkannt
wurde, musste auf "Zu erledigen" wechseln – und ahnte nicht, dass es da
etwas zu sehen gab. Was nicht automatisch geht, erscheint als Vorschlag
direkt auf der Import-Seite.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>

backend/app/schemas.py

@@ -587,6 +587,10 @@ class ImportBatchOut(BaseModel):
     imported_count: int
     status: ImportStatus
     created_at: datetime
+    # Wie viele Uebertraege beim Buchen erkannt wurden. Nicht gespeichert –
+    # nur die Rueckmeldung eines Vorgangs. Sonst erfaehrt niemand, dass eine
+    # Kartenrechnung gerade still mit ihrer Gegenbuchung verbunden wurde.
+    uebertraege_verknuepft: int = 0
 
 
 class ImportCommitIn(BaseModel):

backend/app/services/csv_import.py

@@ -1100,9 +1100,10 @@ def commit_import(db: Session, user: User, account: Account, template_id: int |
     # Frisch gebuchte Zeilen auf Überträge prüfen. Läuft NACH dem Buchen, nicht
     # währenddessen: Der Import bleibt damit unangetastet, und wenn die Suche
     # etwas falsch macht, ist es ein Etikett – keine Buchung.
+    verknuepft = 0
     try:
         from . import uebertraege
-        uebertraege.finde(db, user)
+        verknuepft = uebertraege.finde(db, user).get("verknuepft", 0)
     except Exception:                      # Nie den Import daran scheitern lassen
         log.exception("Übertrags-Suche nach dem Import fehlgeschlagen")
 
@@ -1116,6 +1117,10 @@ def commit_import(db: Session, user: User, account: Account, template_id: int |
         log.exception("Vertrags-Zuordnung nach dem Import fehlgeschlagen")
 
     db.refresh(batch)
+    # Kein Datenbankfeld, sondern die Rueckmeldung dieses Vorgangs: Was still
+    # verknuepft wurde, soll der Nutzer erfahren. Danach interessiert es
+    # niemanden mehr.
+    batch.uebertraege_verknuepft = verknuepft
     return batch
 
 

backend/app/services/uebertraege.py

@@ -32,6 +32,7 @@ from sqlalchemy.orm import Session
 from ..models import (
     Account,
     AccountIdentifier,
+    AccountType,
     IdentifierKind,
     LinkIgnored,
     Transaction,
@@ -92,7 +93,38 @@ def _kontobezeichner(db: Session, user: User) -> dict[int, list[str]]:
     return je_konto
 
 
-def _hat_hinweis(a: Transaction, b: Transaction, bezeichner: dict[int, list[str]]) -> bool:
+def _kontotypen(db: Session, user: User) -> dict[int, AccountType]:
+    return dict(db.query(Account.id, Account.type).filter(Account.owner_id == user.id))
+
+
+def _ist_kartenzahlung(a: Transaction, b: Transaction,
+                       typen: dict[int, AccountType]) -> bool:
+    """Geht hier eine Kreditkartenrechnung auf?
+
+    Eine Karte bekommt Geld nur aus einem Grund: weil ihre Rechnung bezahlt
+    wird. Das ist Hinweis genug – und noetig, denn im Buchungstext steht bei
+    so einer Zahlung oft weder ein Schlagwort noch der Name des Gegenkontos.
+
+    Entscheidend ist die RICHTUNG, nicht bloss, dass eine Karte beteiligt ist.
+    Die weitere Fassung „Kartenkonto auf einer Seite" wuerde einen
+    Karteneinkauf ueber 50,00 mit einer zufaelligen Gutschrift ueber 50,00 am
+    selben Tag verknuepfen – eine echte Ausgabe UND eine echte Einnahme fielen
+    still aus der Auswertung. Genau der Schaden, gegen den _hat_hinweis
+    gebaut wurde.
+
+    Zwei Karten untereinander bleiben aussen vor: Karten zahlen einander
+    nicht.
+    """
+    for karte, quelle in ((a, b), (b, a)):
+        if (karte.type == TxnType.income
+                and typen.get(karte.account_id) == AccountType.kreditkarte
+                and typen.get(quelle.account_id) != AccountType.kreditkarte):
+            return True
+    return False
+
+
+def _hat_hinweis(a: Transaction, b: Transaction, bezeichner: dict[int, list[str]],
+                 typen: dict[int, AccountType] | None = None) -> bool:
     """Deutet mindestens eine der beiden Zeilen auf einen Übertrag hin?
 
     Ohne diese Hürde würde ein zufälliger Treffer – 50.00 im Laden bezahlt, am
@@ -100,6 +132,8 @@ def _hat_hinweis(a: Transaction, b: Transaction, bezeichner: dict[int, list[str]
     gelten und eine echte Ausgabe samt echter Einnahme aus der Statistik
     nehmen. Der Saldo bliebe richtig, die Auswertung nicht.
     """
+    if typen and _ist_kartenzahlung(a, b, typen):
+        return True
     for txn, gegen in ((a, b), (b, a)):
         text = _text(txn)
         if any(h in text for h in HINWEISE):
@@ -235,6 +269,7 @@ def finde(db: Session, user: User, nur_vorschlaege: bool = False) -> dict:
     """
     kandidaten = _kandidaten(db, user)
     bezeichner = _kontobezeichner(db, user)
+    typen = _kontotypen(db, user)
     nach_id = {}
     for a_id, liste in kandidaten.items():
         for b in liste:
@@ -262,7 +297,7 @@ def finde(db: Session, user: User, nur_vorschlaege: bool = False) -> dict:
         if a.category_id is not None or gegen.category_id is not None:
             vorschlaege.append((a, gegen))
             continue
-        if not _hat_hinweis(a, gegen, bezeichner):
+        if not _hat_hinweis(a, gegen, bezeichner, typen):
             vorschlaege.append((a, gegen))
             continue
         if nur_vorschlaege: