presseportale/app/Models/Invoice.php

<?php

namespace App\Models;

use App\Enums\InvoiceStatus;
use Illuminate\Database\Eloquent\Builder;
use Illuminate\Database\Eloquent\Factories\HasFactory;
use Illuminate\Database\Eloquent\Model;
use Illuminate\Database\Eloquent\Relations\BelongsTo;
use Illuminate\Database\Eloquent\SoftDeletes;

class Invoice extends Model
{
    use HasFactory, SoftDeletes;

    protected $fillable = [
        'user_id',
        'user_payment_id',
        'user_payment_option_id',
        'invoice_billing_address_id',
        'number',
        'status',
        'amount_cents',
        'tax_cents',
        'total_cents',
        'currency',
        'is_netto',
        'tax_note',
        'invoice_date',
        'due_date',
        'paid_at',
        'sent_at',
        'reminded_at',
        'reminder_count',
        'voided_at',
        'void_reason',
        'replaces_legacy_invoice_number',
        'stripe_invoice_id',
        'pdf_path',
    ];

    protected function casts(): array
    {
        return [
            'status' => InvoiceStatus::class,
            'amount_cents' => 'integer',
            'tax_cents' => 'integer',
            'total_cents' => 'integer',
            'is_netto' => 'boolean',
            'invoice_date' => 'date',
            'due_date' => 'date',
            'paid_at' => 'datetime',
            'sent_at' => 'datetime',
            'reminded_at' => 'datetime',
            'reminder_count' => 'integer',
            'voided_at' => 'datetime',
            'deleted_at' => 'datetime',
        ];
    }

    /**
     * @return BelongsTo<User, $this>
     */
    public function user(): BelongsTo
    {
        return $this->belongsTo(User::class);
    }

    /**
     * @return BelongsTo<UserPayment, $this>
     */
    public function userPayment(): BelongsTo
    {
        return $this->belongsTo(UserPayment::class, 'user_payment_id');
    }

    /**
     * Abgerechnete Zahlungsvereinbarung (MAN-Kreis). Für STR-Rechnungen NULL.
     *
     * @return BelongsTo<UserPaymentOption, $this>
     */
    public function userPaymentOption(): BelongsTo
    {
        return $this->belongsTo(UserPaymentOption::class);
    }

    /**
     * @return BelongsTo<InvoiceBillingAddress, $this>
     */
    public function invoiceBillingAddress(): BelongsTo
    {
        return $this->belongsTo(InvoiceBillingAddress::class);
    }

    /**
     * MAN-Kreis: lokal ausgestellte Rechnung, per Überweisung zu zahlen.
     */
    public function isManual(): bool
    {
        return $this->stripe_invoice_id === null;
    }

    public function isOverdue(): bool
    {
        return $this->status === InvoiceStatus::Open
            && $this->due_date !== null
            && $this->due_date->isBefore(today());
    }

    /**
     * Rechnungen des manuellen Kreises (ohne Stripe-Beleg).
     */
    public function scopeManual(Builder $query): Builder
    {
        return $query->whereNull('stripe_invoice_id');
    }

    public function scopeOpen(Builder $query): Builder
    {
        return $query->where('status', InvoiceStatus::Open->value);
    }

    public function scopeOverdue(Builder $query): Builder
    {
        return $this->scopeOpen($query)->whereDate('due_date', '<', today());
    }
}