Дмитрий
cdfae077a3
Клиент сам выставляет PDF-счёт (TopupDialog вкладка «По счёту»), счета и акты — в отдельной вкладке «Счета». Админ (/admin/invoices) отмечает оплату одной кнопкой → атомарно зачисляет баланс (BillingTopupService), формирует Акт (без НДС, saas_upd_documents ДОП) и шлёт клиенту письмо «Счёт оплачен» с вложением PDF-акта. PDF открываются inline в браузере (ASCII-имя). - Сервисы InvoiceNumberGenerator/InvoiceService/ActService/InvoicePaymentService/PdfRenderer - Контроллеры InvoiceController (клиент) + AdminInvoiceController (список+mark-paid) - Модели SaasInvoice/SaasInvoiceItem/SaasUpdDocument; шаблоны pdf/invoice|act - Нумерация СЧ-ГГГГ-NNNNN (advisory-lock); просрочка invoices:expire (cron) - Наименование услуги: «Оплата генерации рекламных лидов» - Зависимость barryvdh/laravel-dompdf (default_font dejavu sans); схема БД не менялась - Этап 2 (автомат через ВТБ API) — отдельно, спека/план в docs/superpowers Тесты: счета 13, Billing 138, фронт зелёные; larastan baseline +6 (Pest false-pos). Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
83 lines
2.4 KiB
PHP
83 lines
2.4 KiB
PHP
<?php
|
|
|
|
declare(strict_types=1);
|
|
|
|
namespace App\Mail;
|
|
|
|
use App\Models\Tenant;
|
|
use App\Models\User;
|
|
use Illuminate\Bus\Queueable;
|
|
use Illuminate\Mail\Mailable;
|
|
use Illuminate\Mail\Mailables\Attachment;
|
|
use Illuminate\Mail\Mailables\Content;
|
|
use Illuminate\Mail\Mailables\Envelope;
|
|
use Illuminate\Queue\SerializesModels;
|
|
use Illuminate\Support\Str;
|
|
|
|
/**
|
|
* Email-уведомление об оплате тарифного счёта (ТЗ §18.5, событие
|
|
* invoice_paid).
|
|
*
|
|
* Триггер: после смены статуса saas_invoice на 'paid'. Endpoint
|
|
* биллинга / webhook ЮKassa — отдельный коммит; этот Mailable готов
|
|
* к подключению.
|
|
*/
|
|
class InvoicePaidNotification extends Mailable
|
|
{
|
|
use Queueable;
|
|
use SerializesModels;
|
|
|
|
public function __construct(
|
|
public User $recipient,
|
|
public Tenant $tenant,
|
|
public string $amountRub,
|
|
public ?string $invoiceNumber,
|
|
public ?string $tariffName,
|
|
/** Относительный путь PDF-акта на диске 'local' (для вложения). */
|
|
public ?string $actPdfPath = null,
|
|
/** Номер акта — для имени файла вложения. */
|
|
public ?string $actNumber = null,
|
|
) {}
|
|
|
|
public function envelope(): Envelope
|
|
{
|
|
return new Envelope(
|
|
subject: 'Лидерра. Счёт оплачен',
|
|
);
|
|
}
|
|
|
|
public function content(): Content
|
|
{
|
|
return new Content(
|
|
view: 'emails.invoice_paid',
|
|
with: [
|
|
'recipient' => $this->recipient,
|
|
'tenant' => $this->tenant,
|
|
'amountRub' => $this->amountRub,
|
|
'invoiceNumber' => $this->invoiceNumber,
|
|
'tariffName' => $this->tariffName,
|
|
],
|
|
);
|
|
}
|
|
|
|
/**
|
|
* Вложение: PDF закрывающего документа (Акт), если он сформирован.
|
|
*
|
|
* @return array<int, Attachment>
|
|
*/
|
|
public function attachments(): array
|
|
{
|
|
if ($this->actPdfPath === null) {
|
|
return [];
|
|
}
|
|
|
|
$name = 'Akt-'.Str::ascii((string) $this->actNumber).'.pdf';
|
|
|
|
return [
|
|
Attachment::fromStorageDisk('local', $this->actPdfPath)
|
|
->as($name)
|
|
->withMime('application/pdf'),
|
|
];
|
|
}
|
|
}
|