Besseres Handling Rückerstattungen

app/Domains/ParticipantRefund/Actions/CreateRefundDocument/CreateRefundDocumentCommand.php

@@ -27,6 +27,12 @@ class CreateRefundDocumentCommand
     /** Name des `page_texts`-Eintrags mit der Erklärung -- dieselbe Quelle wie die Bestätigungsseite. */
     public const string DECLARATION_TEXT = 'CONFIRMATION_PARTICIPANT_REFUND';
 
+    /** Die zweite Erklärung des Auszahlungswegs: dass es das Konto der Ursprungszahlung ist. */
+    public const string ACCOUNT_DECLARATION_TEXT = 'CONFIRMATION_PARTICIPANT_REFUND_ACCOUNT';
+
+    /** Tritt im Spendenweg an die Stelle beider anderen -- dort gibt es kein Konto. */
+    public const string DONATION_DECLARATION_TEXT = 'CONFIRMATION_PARTICIPANT_REFUND_DONATION';
+
     private ParticipantRefund $refund;
 
     private EventParticipant $participant;
@@ -148,12 +154,54 @@ class CreateRefundDocumentCommand
 
     private function declarationText(): string
     {
-        $text = PageText::where('name', self::DECLARATION_TEXT)->first()?->content;
+        if ($this->request->donation) {
+            return $this->pageText(
+                self::DONATION_DECLARATION_TEXT,
+                'Ich verzichte auf die Auszahlung des genannten Betrags und spende ihn an den Verband. '
+                    . 'Mir ist bewusst, dass dieser Verzicht nicht rückgängig gemacht werden kann.'
+            );
+        }
 
-        return trim((string) $text) !== ''
-            ? (string) $text
-            : 'Ich versichere, dass ich den genannten Betrag beglichen habe und nicht anderweitig '
-                . 'zurückerstattet bekomme.';
+        // Beide Sätze, weil die Person beide angekreuzt hat -- der Beleg schreibt ihr nur zu, was sie
+        // gelesen hat, und die Kontoerklärung ist der Grund, warum die Auszahlung zulässig ist.
+        return $this->pageText(
+            self::DECLARATION_TEXT,
+            'Ich versichere, dass ich den genannten Betrag beglichen habe und nicht anderweitig '
+                . 'zurückerstattet bekomme.'
+        ) . '<br /><br />' . $this->pageText(
+            self::ACCOUNT_DECLARATION_TEXT,
+            'Ich bestätige, dass das angegebene Konto dasselbe ist, von dem der Teilnahmebeitrag '
+                . 'gezahlt wurde.'
+        );
+    }
+
+    /**
+     * Ein Seitentext mit Rückfallwert: Fehlt die Zeile in der Datenbank, soll der Beleg trotzdem
+     * entstehen. Ohne den Fallback stünde hier ein Fatal Error auf `null` -- so steht es heute im
+     * Deckblatt-Code der Auslagenerstattung, und daran soll sich der Beleg kein Beispiel nehmen.
+     */
+    private function pageText(string $name, string $fallback): string
+    {
+        $text = PageText::where('name', $name)->first()?->content;
+
+        return trim((string) $text) !== '' ? (string) $text : $fallback;
+    }
+
+    /**
+     * Der Einleitungssatz des Belegs, passend zum gewählten Weg.
+     *
+     * Als Platzhalter und nicht fest in der Vorlage, weil er sich zwischen Auszahlung und Spende
+     * unterscheidet -- `{if:…}` kennt keine Verneinung, mit der eine Vorlage den einen Satz gegen den
+     * anderen tauschen könnte. Ältere, bereits installierte Vorlagen tragen den festen Satz weiter; dass
+     * gespendet wurde, steht dort in der Angabentabelle und in der Erklärung.
+     */
+    private function introText(): string
+    {
+        return $this->request->donation
+            ? 'Ich konnte an der Veranstaltung nicht oder nur teilweise teilnehmen. Auf die Auszahlung '
+                . 'des erstattungsfähigen Betrags verzichte ich und spende ihn an den Verband:'
+            : 'Ich konnte an der Veranstaltung nicht oder nur teilweise teilnehmen und bitte um die '
+                . 'Rückerstattung wie folgt:';
     }
 
     /**
@@ -222,6 +270,7 @@ class CreateRefundDocumentCommand
             'retained_amount' => $this->money($refund->retained_amount?->getAmount() ?? 0.0),
             'retention_note' => $this->retentionNote(),
 
+            'intro_text' => $this->introText(),
             'declaration_text' => $this->declarationText(),
             'capture_note' => $this->captureNote(),
 
@@ -272,8 +321,17 @@ class CreateRefundDocumentCommand
             $rows[] = ['Grund der Einbehaltung', e($this->retentionNote())];
         }
 
-        $rows[] = ['Kontoinhaber*in', e((string) $refund->account_owner)];
-        $rows[] = ['IBAN', e($this->formatIban((string) $refund->account_iban))];
+        // Bei einer Spende gibt es keine Bankverbindung. Statt zwei leerer Zeilen steht dort, warum --
+        // der Beleg wandert in die Buchhaltung, und "keine IBAN" allein sähe nach einer Lücke aus.
+        if ($this->request->donation) {
+            $rows[] = [
+                'Auszahlung',
+                'Auf die Auszahlung wird verzichtet; der Betrag verbleibt als Spende beim Verband.',
+            ];
+        } else {
+            $rows[] = ['Kontoinhaber*in', e((string) $refund->account_owner)];
+            $rows[] = ['IBAN', e($this->formatIban((string) $refund->account_iban))];
+        }
 
         $html = '';
         foreach ($rows as [$key, $value]) {

app/Domains/ParticipantRefund/Actions/CreateRefundDocument/CreateRefundDocumentRequest.php

@@ -8,6 +8,14 @@ class CreateRefundDocumentRequest
 {
     public function __construct(
         public readonly ParticipantRefund $refund,
+        /**
+         * Ob der Betrag gespendet statt ausgezahlt wird.
+         *
+         * Ausdrücklich und nicht über {@see ParticipantRefund::isDonation()}: Beim Einreichen entsteht
+         * dieser Beleg vor der Abrechnung, die die Spende führt -- er ist ihr Anhang. Wer ihn später
+         * erneut zieht, liest sie dort und gibt sie hier weiter.
+         */
+        public readonly bool $donation = false,
     ) {
     }
 }