images: Datenmodell, Textarchiv, Herkunftsprüfung und gemeinsamer Uploader für Formular v2 (Bildkennzeichnung Block A)

- press_release_images: Kundenangabe/Portalkennzeichnung getrennt, Herkunftsbefund, Beweisoriginal, Snapshot-Pfade, published_ever_at, rules_version, Fokus/Letterbox; Bestand unangetastet
- legal_texts (insert-only) mit img-confirm-v1 (alter Wortlaut), v2 (AGB 0.6), v3 (AGB 0.7, noch ohne Datum); image-rights:backfill-confirmations
- image_rights_confirmations polymorph, insert-only, IP als versionierter HMAC; Löschung nur für nie veröffentlichte Uploads
- ImageProvenanceInspector (Imagick/exif): IPTC, XMP, EXIF; algorithmicallyEnhanced nur Vermerk; unlesbare Datei = error
- PressReleaseImageUploader: Original vor Derivaten, Hash-Bindung, Titelbild-Regel unter Sperre, Dateien bei Fehlern zurückgerollt; Admin-Upload ohne Bestätigung
- ImageService: kein Rückfall auf die Quelldatei, og-Variante, Fokuspunkt und no_crop

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>

app/Models/PressReleaseImage.php

@@ -2,15 +2,33 @@
 
 namespace App\Models;
 
+use App\Enums\AiDeclarationSource;
 use App\Enums\AiImageDeclaration;
+use App\Enums\CreditSource;
 use App\Enums\ImageLicenseType;
+use App\Enums\ImageProvenanceStatus;
+use Database\Factories\PressReleaseImageFactory;
+use Illuminate\Database\Eloquent\Factories\HasFactory;
 use Illuminate\Database\Eloquent\Model;
 use Illuminate\Database\Eloquent\Relations\BelongsTo;
+use Illuminate\Database\Eloquent\Relations\MorphMany;
+use Illuminate\Database\Eloquent\Relations\MorphOne;
 use Illuminate\Database\Eloquent\SoftDeletes;
 use Illuminate\Support\Facades\URL;
 
+/**
+ * Bild einer Pressemitteilung. Seit Formular v2 (Bildkennzeichnung,
+ * 22.09.2026) gilt: `ai_declaration` ist die öffentliche Portalkennzeichnung,
+ * `ai_declaration_user` die Angabe des Einreichers, `ai_declaration_source`
+ * sagt, woher die Portalkennzeichnung stammt. `rules_version` NULL markiert
+ * den Bestand vor der Umstellung; solche Bilder haben kein Beweisoriginal
+ * und kein Bestätigungsprotokoll.
+ */
 class PressReleaseImage extends Model
 {
+    /** @use HasFactory<PressReleaseImageFactory> */
+    use HasFactory;
+
     use SoftDeletes;
 
     protected $fillable = [
@@ -33,6 +51,25 @@ class PressReleaseImage extends Model
         'rights_confirmed_at',
         'is_ai_generated',
         'ai_declaration',
+        'ai_declaration_user',
+        'ai_declaration_source',
+        'ai_declaration_locked',
+        'credit_source',
+        'provenance_status',
+        'provenance',
+        'provenance_checked_at',
+        'provenance_tool_version',
+        'original_disk',
+        'original_path',
+        'original_sha256',
+        'published_snapshot_path',
+        'published_snapshot_sha256',
+        'published_ever_at',
+        'customer_confirmation_requested_at',
+        'rules_version',
+        'focus_x',
+        'focus_y',
+        'no_crop',
         'is_preview',
         'sort_order',
         'width',
@@ -51,6 +88,18 @@ class PressReleaseImage extends Model
             'rights_confirmed_at' => 'datetime',
             'is_ai_generated' => 'boolean',
             'ai_declaration' => AiImageDeclaration::class,
+            'ai_declaration_user' => AiImageDeclaration::class,
+            'ai_declaration_source' => AiDeclarationSource::class,
+            'ai_declaration_locked' => 'boolean',
+            'credit_source' => CreditSource::class,
+            'provenance_status' => ImageProvenanceStatus::class,
+            'provenance' => 'array',
+            'provenance_checked_at' => 'datetime',
+            'published_ever_at' => 'datetime',
+            'customer_confirmation_requested_at' => 'datetime',
+            'focus_x' => 'integer',
+            'focus_y' => 'integer',
+            'no_crop' => 'boolean',
             'is_preview' => 'boolean',
             'sort_order' => 'integer',
             'width' => 'integer',
@@ -67,6 +116,60 @@ class PressReleaseImage extends Model
         return $this->belongsTo(PressRelease::class);
     }
 
+    /**
+     * @return MorphMany<ImageRightsConfirmation, $this>
+     */
+    public function rightsConfirmations(): MorphMany
+    {
+        return $this->morphMany(ImageRightsConfirmation::class, 'subject');
+    }
+
+    /**
+     * @return MorphOne<ImageRightsConfirmation, $this>
+     */
+    public function latestRightsConfirmation(): MorphOne
+    {
+        return $this->morphOne(ImageRightsConfirmation::class, 'subject')->latestOfMany('confirmed_at');
+    }
+
+    /**
+     * Bestand vor Formular v2: kein Beweisoriginal, kein Protokoll. Nach der
+     * Legacy-Bereinigung (E.5) sind das nur noch Bilder veröffentlichter PMs.
+     */
+    public function isLegacyRules(): bool
+    {
+        return $this->rules_version === null;
+    }
+
+    /**
+     * Eine Bestätigung zählt nur, wenn sie zur aktuellen Datei gehört
+     * (Feedback F09): Bildtausch verlangt eine neue Bestätigung.
+     */
+    public function hasValidRightsConfirmation(): bool
+    {
+        $confirmation = $this->relationLoaded('latestRightsConfirmation')
+            ? $this->latestRightsConfirmation
+            : $this->latestRightsConfirmation()->first();
+
+        return $confirmation !== null
+            && $this->original_sha256 !== null
+            && hash_equals($this->original_sha256, (string) $confirmation->file_sha256);
+    }
+
+    /**
+     * Admin-Upload, dessen Kundenbestätigung per Magic-Link noch aussteht
+     * (Decision-Update E10). Blockiert die Veröffentlichung (E.1).
+     */
+    public function awaitsCustomerConfirmation(): bool
+    {
+        return $this->customer_confirmation_requested_at !== null && ! $this->hasValidRightsConfirmation();
+    }
+
+    public function wasEverPublished(): bool
+    {
+        return $this->published_ever_at !== null;
+    }
+
     public function url(bool $signed = false): ?string
     {
         if (blank($this->path)) {