PayPal-Name aus der manuellen Zuordnung lernen

Die automatische Zuordnung verlangt exakte Uebereinstimmung des
Zahlernamens mit Anzeigename oder PayPal-Name des Mitglieds. Heisst jemand
bei PayPal anders, landet jede Zahlung in der Warteschlange - auch die
zehnte, obwohl der Fall laengst einmal von Hand geklaert wurde.

Nach einer manuellen Zuordnung wird der Zahlername deshalb beim Mitglied
hinterlegt. Zurueckhaltend: ein gepflegter PayPal-Name wird nie
ueberschrieben, ein Name gleich dem Anzeigenamen bringt nichts, und passt
der Name auch auf ein anderes Mitglied, wird nichts gelernt - das wuerde
die Zuordnung mehrdeutig machen und damit blockieren.

Was gelernt wurde, steht in der Erfolgsmeldung und im Audit-Log; eine
stillschweigende Aenderung am Mitglied waere sonst schwer nachvollziehbar.

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

docs/backoffice.md

@@ -204,3 +204,21 @@ automatisch gutgeschrieben.
 - Die Zuordnungsseite bleibt für offene Zahlungen erreichbar (siehe
   `paypal_inbox_accessible()`), der Mandant sieht die geparkte Zahlung
   also und kann sie zuordnen oder abhaken.
+
+### PayPal-Name lernen
+
+Die automatische Zuordnung verlangt **exakte** Übereinstimmung des
+Zahlernamens mit `display_name` oder `paypal_name` des Mitglieds
+(`imports_find_participant()`, genau ein Treffer). Heißt jemand bei PayPal
+anders — Zweitname, Firmenkonto, anderer Nachname —, landet jede Zahlung in
+der Warteschlange, auch die zehnte.
+
+`paypal_assign_payment()` hinterlegt den Zahlernamen deshalb beim Mitglied,
+sobald eine Zahlung von Hand zugeordnet wurde; die nächste Zahlung desselben
+Zahlers wird automatisch gebucht. Bewusst zurückhaltend
+(`paypal_remember_payer_name()`): ein bereits gepflegter PayPal-Name wird nie
+überschrieben, ein Name gleich dem Anzeigenamen bringt nichts, und passt der
+Name auch auf ein anderes Mitglied, wird nichts gelernt — sonst wäre die
+Zuordnung mehrdeutig und würde gar nicht mehr greifen. Was gelernt wurde,
+steht in der Erfolgsmeldung und im Audit-Log
+(`paypal_import.manual_assigned`, Feld `learned_paypal_name`).