Bestandskunden aus dem Altsystem zahlen per Ueberweisung; nach dem 04:30-Lauf fehlte bisher der gesamte Bearbeitungsweg (kein PDF, keine Mail, kein Zahlungseingang, kein Bestandsschutz-Ende). Plan und Befund: dev/lagacy-rechnungen/entwicklungsplan-2026-09-16.md. Bereinigung (legacy:settle-unpaid, wiederholbar): - Legacy-Status hold = nie bezahlt, ersatzlos erledigt. 9 daraus abgeleitete Bestandsschutz-Buendel werden gekuendigt, MAN-00001/00002 storniert. Archivzeilen bleiben erhalten, sind aber in Admin-Archiv und Kundenkonto standardmaessig ausgeblendet. - pending/reminder (recurring) = offene Vorgaenge: Periode auf den Leistungsbeginn der unbezahlten Rechnung zurueckgedreht und als MAN-Rechnung neu ausgestellt (Archiv-Status superseded, replaces_legacy_invoice_number). - pending/reminder (single) = abgeschrieben (uncollectible). - legacy:grandfather-subscriptions wertet den Zahlungsstatus jetzt selbst aus. Workflow in /admin/payments (ManualInvoiceDunningService, je Aktion mit Eintrag im Aktivitaets-Verlauf): - Rechnung senden: Mail mit PDF-Anhang, Bankverbindung aus billing.issuer, Hinweis auf Bestandsschutz-Ende; Zahlungsziel zaehlt ab Versand. - Erinnerung: gleiche Mail im Mahn-Ton, Nachfrist bei verstrichener Frist. - Bezahlt: Zahlungseingang laut Kontoauszug verbuchen. - Bestandsschutz beenden: Rechnung storniert (nie geloescht), Buendel gekuendigt, weitere offene MAN-Rechnungen des Kunden storniert, optionale Kundenmail. - Panel "Blockierte Vereinbarungen": faellige Posten ohne Rechnung (meist fehlende Rechnungsadresse) mit "Jetzt abrechnen" oder "Entfernen". Schema: invoices bekommt user_payment_option_id, sent_at, reminded_at, reminder_count, voided_at, void_reason, replaces_legacy_invoice_number (inkl. Backfill der bestehenden MAN-Rechnungen). PDF-Primitiven des Archiv-Renderers in den Trait DrawsPdf ausgelagert; MAN-PDF on-demand ueber admin.invoices.pdf / me.invoices.manual-pdf (InvoicePolicy). Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
86 lines
2.6 KiB
PHP
86 lines
2.6 KiB
PHP
<?php
|
|
|
|
namespace App\Mail;
|
|
|
|
use App\Models\Invoice;
|
|
use App\Models\User;
|
|
use App\Services\Billing\ManualInvoicePdfRenderer;
|
|
use Illuminate\Bus\Queueable;
|
|
use Illuminate\Contracts\Queue\ShouldQueue;
|
|
use Illuminate\Mail\Attachment;
|
|
use Illuminate\Mail\Mailable;
|
|
use Illuminate\Mail\Mailables\Content;
|
|
use Illuminate\Mail\Mailables\Envelope;
|
|
use Illuminate\Queue\SerializesModels;
|
|
|
|
/**
|
|
* Rechnung an einen Legacy-Überweisungskunden (MAN-Kreis) mit PDF im
|
|
* Anhang, Bankverbindung, Zahlungsziel und dem Hinweis, dass der
|
|
* Bestandsschutz ohne Zahlung zum Zahlungsziel endet. Als Zahlungs-
|
|
* erinnerung (`$isReminder`) mit gleichem Inhalt im Mahn-Ton.
|
|
*
|
|
* Transaktionsmail: bewusst ohne Opt-out. Die Bounce-Sperrliste greift
|
|
* über `GateOutgoingMail`; der Service prüft sie zusätzlich vorab.
|
|
*/
|
|
class ManualInvoiceIssued extends Mailable implements ShouldQueue
|
|
{
|
|
use Queueable, SerializesModels;
|
|
|
|
public string $invoicesUrl;
|
|
|
|
public string $bookingUrl;
|
|
|
|
public string $serviceName;
|
|
|
|
/** @var array{0: string, 1: string}|null */
|
|
public ?array $servicePeriod;
|
|
|
|
/** @var array<string, string> */
|
|
public array $issuer;
|
|
|
|
public function __construct(
|
|
public readonly User $user,
|
|
public readonly Invoice $invoice,
|
|
public readonly bool $isReminder = false,
|
|
) {
|
|
$renderer = app(ManualInvoicePdfRenderer::class);
|
|
|
|
$this->invoicesUrl = route('me.invoices.index');
|
|
$this->bookingUrl = route('me.bookings.index');
|
|
$this->serviceName = $renderer->serviceName($invoice);
|
|
$this->servicePeriod = $renderer->servicePeriod($invoice);
|
|
$this->issuer = array_map(fn (mixed $value): string => (string) $value, (array) config('billing.issuer', []));
|
|
}
|
|
|
|
public function envelope(): Envelope
|
|
{
|
|
$bcc = (string) config('legal.contact_email');
|
|
|
|
$subject = $this->isReminder
|
|
? 'Zahlungserinnerung — Rechnung '.$this->invoice->number
|
|
: 'Ihre Rechnung '.$this->invoice->number.' — Bestandsschutz auf pressekonto';
|
|
|
|
return new Envelope(
|
|
subject: $subject,
|
|
bcc: $bcc !== '' ? [$bcc] : [],
|
|
);
|
|
}
|
|
|
|
public function content(): Content
|
|
{
|
|
return new Content(view: 'emails.billing.manual-invoice-issued');
|
|
}
|
|
|
|
/**
|
|
* @return array<int, Attachment>
|
|
*/
|
|
public function attachments(): array
|
|
{
|
|
$renderer = app(ManualInvoicePdfRenderer::class);
|
|
|
|
return [
|
|
Attachment::fromData(fn (): string => $renderer->render($this->invoice), $renderer->filename($this->invoice))
|
|
->withMime('application/pdf'),
|
|
];
|
|
}
|
|
}
|