Tell members which reference to put on a transfer

A data-review mail that lists the payment frequency but not how to pay leaves the
board matching anonymous transfers by hand. The mail now closes with the
reference to quote -- member number and full name, joined only where both exist
so a missing half cannot leave a dangling dash. Both are offered because either
identifies the payment on its own: a member who has forgotten their number falls
back on the name, and two members sharing a name are told apart by the number.

The note about the shortened IBAN moved out of the fixed template text into
{{data.iban_hint}}, filled only for members whose bank details are actually
listed -- it used to explain a masked IBAN to members who pay by transfer and see
no IBAN at all. It sits directly under the record as a parenthesised footnote,
which also keeps the dropped line from leaving a blank one behind.

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

src/ccma/assets/CHANGELOG.json

@@ -42,7 +42,7 @@
       "Die Texte aller erzeugten E-Mails (Willkommen, Mahnung, SEPA-Vorabinformation) stecken jetzt in bearbeitbaren Vorlagen: Sie werden als Standard mitgeliefert, landen beim ersten Start im Mitglieder-Store unter templates/mail/ und können unter Optionen → E-Mail-Vorlagen mit Betreff, Text und Platzhaltern angepasst oder auf den Standardtext zurückgesetzt werden.",
       "Für neue Mitglieder kann direkt aus der Mitgliederakte eine Willkommens- und Erstrechnungsmail erzeugt werden: Sie begrüßt das Mitglied, nennt Mitgliedsnummer und Beginn der Mitgliedschaft und stellt die noch offenen Forderungen (Aufnahmegebühr und erster Beitrag) mit Zahlungshinweis zusammen; einzelne Forderungen lassen sich abwählen und die fertige Mail vorab ansehen.",
       "CCMA startet jetzt auch, wenn der Mitglieder-Store schreibgeschützt eingebunden ist (z. B. ein nur lesend gemountetes Crypt-Laufwerk): Die Daten lassen sich wie gewohnt ansehen, der Hausmeister wird übersprungen und alle schreibenden Aktionen werden mit einer verständlichen Meldung abgelehnt statt mit einem Systemfehler. Ein dauerhaft sichtbarer Warnhinweis über den Tabs sowie Markierungen in Fenstertitel und Statusleiste weisen auf den Nur-Lese-Betrieb hin; wird der Store wieder mit Schreibrechten eingebunden, genügt „Erneut prüfen“ ohne Neustart.",
-      "Über „Datenüberprüfung anfragen“ in der Mitgliederliste kann eine Bitte um Datenprüfung an beliebig viele Mitglieder auf einmal verschickt werden: Jede Mail listet den eigenen Datensatz des Empfängers auf (fehlende Angaben werden als solche ausgewiesen, die IBAN nur mit den letzten vier Stellen), vorausgewählt sind alle laufenden Mitgliedschaften mit E-Mail-Adresse. Text und Betreff stammen aus der neuen Vorlage „Datenüberprüfung“; jede Mail wird in der Mitgliederakte archiviert und in der Chronik vermerkt."
+      "Über „Datenüberprüfung anfragen“ in der Mitgliederliste kann eine Bitte um Datenprüfung an beliebig viele Mitglieder auf einmal verschickt werden: Jede Mail listet den eigenen Datensatz des Empfängers auf (fehlende Angaben werden als solche ausgewiesen, die IBAN nur mit den letzten vier Stellen), vorausgewählt sind alle laufenden Mitgliedschaften mit E-Mail-Adresse. Text und Betreff stammen aus der neuen Vorlage „Datenüberprüfung“; jede Mail wird in der Mitgliederakte archiviert und in der Chronik vermerkt. Die Mail nennt außerdem die Zahlweise und den Verwendungszweck, den das Mitglied bei Überweisungen angeben soll (Mitgliedsnummer und voller Name)."
     ]
   },
   {

src/ccma/assets/mail_templates/datenpruefung.txt

@@ -5,8 +5,11 @@ Liebes Mitglied,
 folgende Daten haben wir über dich gespeichert. Wir bitten dich, diese einmal zu überprüfen und uns Änderungen ggf. mitzuteilen.
 
 {{data.sheet}}
+{{data.iban_hint}}
 
-Deine IBAN zeigen wir hier absichtlich nur verkürzt an – die letzten vier Stellen genügen zum Abgleich.
+Bitte gib bei Überweisungen an uns immer deine Mitgliedsnummer und/oder deinen vollen Namen (Vorname und Nachname) als Verwendungszweck an – dann können wir deine Zahlung sofort zuordnen:
+
+    {{payment.reference}}
 
 Stimmt etwas nicht oder fehlt eine Angabe? Dann antworte einfach auf diese Mail oder schreib uns an {{organization.email}}, dann pflegen wir die Änderung ein. Wenn alles passt, musst du nichts weiter tun.
 

src/ccma/domain/mail_templates.py

@@ -215,6 +215,14 @@ MAIL_TEMPLATES: tuple[MailTemplateSpec, ...] = (
         + (
             ("data.sheet", "Alle gespeicherten Daten als Liste, eine Zeile je Feld"),
             ("data.count", "Anzahl der aufgeführten Felder"),
+            (
+                "data.iban_hint",
+                "Hinweis zur verkürzten IBAN, nur gefüllt wenn Bankdaten aufgeführt werden",
+            ),
+            (
+                "payment.reference",
+                "Vorgeschlagener Verwendungszweck aus Mitgliedsnummer und vollem Namen",
+            ),
         ),
         blocks=(
             MailTemplateBlock(

src/ccma/services/member_data_mail.py

@@ -38,6 +38,15 @@ DEFAULT_RECIPIENT_STATUSES: tuple[str, ...] = (
 # empty line the eye skips over.
 NOT_STORED = "(nicht hinterlegt)"
 
+# Only makes sense next to a masked IBAN, so it is filled per member rather than
+# written into the template as a fixed line. It sits directly under the record and
+# reads as a footnote to it, which is also why it carries its own parentheses: a
+# dropped line must not leave a blank one behind.
+IBAN_HINT = (
+    "(Die IBAN zeigen wir absichtlich nur verkürzt an – die letzten vier Stellen "
+    "genügen zum Abgleich.)"
+)
+
 
 @dataclass(frozen=True, slots=True)
 class GeneratedDataReviewMail:
@@ -106,9 +115,7 @@ def member_data_fields(member: Member) -> list[tuple[str, str]]:
             ),
         ]
     )
-    if any(
-        value.strip() for value in (member.iban, member.mandate_reference, member.account_holder)
-    ):
+    if has_bank_details(member):
         signed = format_date_for_display(member.mandate_signed_at)
         fields.extend(
             [
@@ -125,6 +132,30 @@ def member_data_fields(member: Member) -> list[tuple[str, str]]:
     return [(label, value.strip() or NOT_STORED) for label, value in fields]
 
 
+def has_bank_details(member: Member) -> bool:
+    """Whether the club stores anything about this member's account at all. Members
+    who pay by transfer have nothing here, and asking them to check a mandate they
+    never gave is noise."""
+    return any(
+        value.strip() for value in (member.iban, member.mandate_reference, member.account_holder)
+    )
+
+
+def payment_reference(member: Member) -> str:
+    """What the member should write on a transfer. Both halves are offered because
+    either one identifies the payment on its own: a member who has forgotten their
+    number can fall back on the name, and a name shared by two members is told apart
+    by the number."""
+    return " – ".join(
+        part
+        for part in (
+            member.member_number.strip(),
+            " ".join(value for value in (member.first_name, member.last_name) if value).strip(),
+        )
+        if part
+    )
+
+
 def data_review_recipients(
     repository: MemberRepository, *, statuses: tuple[str, ...] | None = None
 ) -> list[Member]:
@@ -156,6 +187,8 @@ def data_review_mail_bytes(
             "member.iban_masked": mask_iban(member.iban),
             "data.sheet": "\n".join(f"{label}: {value}" for label, value in fields),
             "data.count": str(len(fields)),
+            "data.iban_hint": IBAN_HINT if has_bank_details(member) else "",
+            "payment.reference": payment_reference(member),
         }
     )
     rendered = render_template(repository, "data_review", values, {"data": entries})