presseportale/app/Models/LegacyInvoice.php

<?php

namespace App\Models;

use App\Enums\Portal;
use Illuminate\Database\Eloquent\Builder;
use Illuminate\Database\Eloquent\Model;
use Illuminate\Database\Eloquent\Relations\BelongsTo;

class LegacyInvoice extends Model
{
    /**
     * Legacy-Status: nie bezahlt, überfällig, Kunde meist nicht mehr
     * erreichbar. Gilt als ersatzlos erledigt (Einordnung 16.09.2026) und
     * wird in Kunden- und Admin-Ansicht standardmäßig ausgeblendet.
     */
    public const STATUS_HOLD = 'hold';

    /** Offene Alt-Rechnung, im Altsystem noch nicht gemahnt. */
    public const STATUS_PENDING = 'pending';

    /** Offene Alt-Rechnung, im Altsystem bereits gemahnt. */
    public const STATUS_REMINDER = 'reminder';

    /** Durch eine MAN-Rechnung des neuen Systems ersetzt (Phase B). */
    public const STATUS_SUPERSEDED = 'superseded';

    /** Abgeschrieben — Forderung wird nicht weiter verfolgt. */
    public const STATUS_UNCOLLECTIBLE = 'uncollectible';

    public $timestamps = false;

    protected $fillable = [
        'legacy_portal',
        'legacy_id',
        'user_id',
        'legacy_user_id',
        'number',
        'amount_cents',
        'tax_cents',
        'total_cents',
        'status',
        'invoice_date',
        'due_date',
        'paid_at',
        'payment_method',
        'pdf_path',
        'raw_snapshot',
        'pdf_payload',
        'pdf_generated_at',
        'imported_at',
    ];

    protected function casts(): array
    {
        return [
            'legacy_portal' => Portal::class,
            'amount_cents' => 'integer',
            'tax_cents' => 'integer',
            'total_cents' => 'integer',
            'invoice_date' => 'date',
            'due_date' => 'date',
            'paid_at' => 'datetime',
            'raw_snapshot' => 'array',
            'pdf_payload' => 'array',
            'pdf_generated_at' => 'datetime',
            'imported_at' => 'datetime',
        ];
    }

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

    /**
     * Neueste Rechnung zuerst: nach Rechnungsdatum, dann ID als Tiebreaker.
     * Single Source of Truth für die „latest legacy invoice"-Ordnung.
     */
    public function scopeLatestFirst(Builder $query): Builder
    {
        return $query->orderByDesc('invoice_date')->orderByDesc('id');
    }

    /**
     * Ohne die erledigten `hold`-Rechnungen (Default in allen Ansichten).
     */
    public function scopeWithoutHold(Builder $query): Builder
    {
        return $query->where(function (Builder $query): void {
            $query->whereNull('status')->orWhere('status', '!=', self::STATUS_HOLD);
        });
    }

    /**
     * Noch offene Alt-Vorgänge, die im neuen System abgearbeitet werden.
     */
    public function scopeOpenLegacy(Builder $query): Builder
    {
        return $query->whereIn('status', [self::STATUS_PENDING, self::STATUS_REMINDER]);
    }

    public function isHold(): bool
    {
        return $this->status === self::STATUS_HOLD;
    }
}