portal/app/app/Models/SaasInvoice.php

<?php

declare(strict_types=1);

namespace App\Models;

use Illuminate\Database\Eloquent\Model;
use Illuminate\Database\Eloquent\Relations\HasMany;
use Illuminate\Support\Carbon;

/**
 * Счёт на оплату (schema.sql table saas_invoices). RLS по tenant_id.
 *
 * Этап 1 «оплата по счёту»: выставляется клиентом, оплачивается банковским
 * переводом, отмечается администратором (InvoicePaymentService).
 *
 * @property int $id
 * @property int $tenant_id
 * @property int $legal_entity_id
 * @property string $invoice_number
 * @property string $payer_type
 * @property string|null $payer_name
 * @property string|null $payer_inn
 * @property string|null $payer_kpp
 * @property string|null $payer_address
 * @property string|null $payer_email
 * @property string $amount_net
 * @property string|null $vat_rate
 * @property string|null $vat_amount
 * @property string $amount_total
 * @property string|null $payment_purpose
 * @property string $credit_target
 * @property int|null $transaction_id
 * @property string|null $pdf_path
 * @property string $status
 * @property Carbon|null $issued_at
 * @property Carbon|null $expires_at
 * @property Carbon|null $paid_at
 * @property Carbon|null $cancelled_at
 * @mixin IdeHelperSaasInvoice
 */
class SaasInvoice extends Model
{
    public $timestamps = false;

    public const STATUS_DRAFT = 'draft';

    public const STATUS_ISSUED = 'issued';

    public const STATUS_PAID = 'paid';

    public const STATUS_OVERDUE = 'overdue';

    public const STATUS_CANCELLED = 'cancelled';

    protected $fillable = [
        'tenant_id', 'legal_entity_id', 'invoice_number',
        'payer_type', 'payer_name', 'payer_inn', 'payer_kpp', 'payer_address', 'payer_email',
        'amount_net', 'vat_rate', 'vat_amount', 'amount_total', 'payment_purpose', 'credit_target',
        'transaction_id', 'pdf_path', 'status',
        'issued_at', 'expires_at', 'paid_at', 'cancelled_at',
    ];

    protected function casts(): array
    {
        return [
            'amount_net' => 'decimal:2',
            'vat_amount' => 'decimal:2',
            'amount_total' => 'decimal:2',
            'issued_at' => 'datetime',
            'expires_at' => 'datetime',
            'paid_at' => 'datetime',
            'cancelled_at' => 'datetime',
        ];
    }

    /** @return HasMany<SaasInvoiceItem, $this> */
    public function items(): HasMany
    {
        return $this->hasMany(SaasInvoiceItem::class, 'invoice_id');
    }
}