<?php

namespace App\Models;

use App\Enums\ArchiveReasonCategory;
use Illuminate\Database\Eloquent\Model;
use Illuminate\Support\Carbon;

/**
 * Ausstehender Beweisarchiv-Eintrag (Umsetzungsaudit 29.09.2026, A-02):
 * einer je Vorgang, angelegt in der fachlichen Transaktion, gelöscht mit
 * dem geschriebenen Eintrag. `event` ist ein Wert aus ArchiveEvent oder
 * eine der Sonderarten unten. Anlegen und Abschließen nur über
 * App\Services\Archive\ArchivePendingQueue.
 *
 * @property int $id
 * @property int $press_release_id
 * @property string $event
 * @property string|null $subject_type
 * @property int|null $subject_id
 * @property ArchiveReasonCategory|null $reason_category
 * @property int|null $legal_request_id
 * @property int|null $actor_id
 * @property string|null $note
 * @property array<string, mixed>|null $payload
 * @property int $attempts
 * @property string|null $last_error
 * @property Carbon|null $last_attempted_at
 * @property Carbon|null $created_at
 */
class ArchivePendingJob extends Model
{
    /**
     * Nie veröffentlichtes Bild, dessen Sofortlöschung gescheitert ist
     * (A-10): kein Archiveintrag, sondern die Löschung wird nachgeholt.
     */
    public const EVENT_IMAGE_PURGE = 'image_purge';

    /**
     * Marker `archive_pending_at` aus der Zeit vor den Aufträgen (Deploy
     * vom 28.09.2026). Der Nachholer wendet darauf die bisherige Heuristik
     * einmalig an.
     */
    public const EVENT_LEGACY_MARKER = 'legacy_marker';

    public const UPDATED_AT = null;

    protected $fillable = [
        'press_release_id',
        'event',
        'subject_type',
        'subject_id',
        'reason_category',
        'legal_request_id',
        'actor_id',
        'note',
        'payload',
        'attempts',
        'last_error',
        'last_attempted_at',
        'created_at',
    ];

    protected function casts(): array
    {
        return [
            'reason_category' => ArchiveReasonCategory::class,
            'payload' => 'encrypted:array',
            'attempts' => 'integer',
            'last_attempted_at' => 'datetime',
            'created_at' => 'datetime',
        ];
    }
}